# azure/azure-sdk-for-go architecture

> Architecture diagram of the GitHub repository azure/azure-sdk-for-go, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azure/azure-sdk-for-go
- Repository: https://github.com/azure/azure-sdk-for-go

## Overview

Azure SDK for Go provides service-specific client libraries for consuming Azure resources and management libraries for configuring them. A caller supplies a credential and creates a client; client operations construct and send HTTP requests through shared azcore pipeline capabilities, then return service responses or errors. The repository also includes distinct data, messaging, storage, and resource-management service families. The map emphasizes documented product boundaries and sampled client/pipeline behavior; many individual service implementations are not sampled, so their internal links are omitted.

Main entry points: [`sdk/azcore/arm/runtime/pipeline.go`](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/azcore/arm/runtime/pipeline.go) (ARM pipeline), [`sdk/azcore/runtime/pipeline.go`](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/azcore/runtime/pipeline.go) (Client pipeline), [`sdk/resourcemanager/monitor/armmonitor/scheduledqueryrules_client.go`](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/resourcemanager/monitor/armmonitor/scheduledqueryrules_client.go) (Resource management), [`sdk/azidentity/public_client.go`](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/azidentity/public_client.go) (Credentials)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity"]
  node_credentials["Credentials<br/>[public_client.go]"]
end

subgraph group_core["Core HTTP"]
  node_core_pipeline["Client pipeline<br/>[pipeline.go]"]
  node_arm_pipeline["ARM pipeline<br/>[pipeline.go]"]
  node_pipeline_impl["Pipeline engine<br/>[pipeline.go]"]
end

subgraph group_clients["Service clients"]
  node_cosmos["Cosmos queries"]
  node_batch["Batch client<br/>[client.go]"]
  node_servicebus["Service Bus entities<br/>[entity_manager.go]"]
  node_webpubsub["Web PubSub<br/>[client.go]"]
end

subgraph group_management["Management"]
  node_management_clients["Resource management"]
  node_resource_graph["Resource Graph"]
  node_query_packs["Query packs"]
  node_search_keys["Search keys"]
  node_legacy_profiles["Legacy profiles"]
end

node_developer(("Go application"))
node_azure_services{{"Azure services"}}

node_developer -->|"creates credential"| node_credentials
node_developer -->|"uses client"| node_cosmos
node_developer -->|"uses client"| node_batch
node_developer -->|"uses client"| node_servicebus
node_developer -->|"uses client"| node_webpubsub
node_developer -->|"manages resources"| node_management_clients
node_credentials -->|"authorizes client"| node_management_clients
node_cosmos -.->|"sends requests"| node_azure_services
node_batch -->|"uses core"| node_core_pipeline
node_servicebus -->|"builds pipeline"| node_core_pipeline
node_webpubsub -->|"uses core"| node_core_pipeline
node_management_clients -->|"sends requests"| node_arm_pipeline
node_resource_graph -->|"sends requests"| node_arm_pipeline
node_query_packs -->|"sends requests"| node_arm_pipeline
node_search_keys -.->|"sends requests"| node_arm_pipeline
node_legacy_profiles -->|"sends requests"| node_arm_pipeline
node_arm_pipeline -->|"configures policies"| node_core_pipeline
node_core_pipeline -->|"constructs engine"| node_pipeline_impl
node_management_clients -.->|"manages resources"| node_azure_services

click node_credentials "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/azidentity/public_client.go"
click node_core_pipeline "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/azcore/runtime/pipeline.go"
click node_arm_pipeline "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/azcore/arm/runtime/pipeline.go"
click node_pipeline_impl "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/azcore/internal/exported/pipeline.go"
click node_cosmos "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/data/azcosmos/cosmos_container_query_engine.go"
click node_batch "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/batch/azbatch/client.go"
click node_servicebus "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/messaging/azservicebus/internal/atom/entity_manager.go"
click node_webpubsub "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/messaging/azwebpubsub/client.go"
click node_management_clients "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/resourcemanager/monitor/armmonitor/scheduledqueryrules_client.go"
click node_resource_graph "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/resourcemanager/resourcegraph/armresourcegraph/graphquery_client.go"
click node_query_packs "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/resourcemanager/operationalinsights/armoperationalinsights/querypacks_client.go"
click node_search_keys "https://github.com/azure/azure-sdk-for-go/blob/main/sdk/resourcemanager/search/armsearch/querykeys_client.go"
click node_legacy_profiles "https://github.com/azure/azure-sdk-for-go/blob/main/profile/p20200901/resourcemanager/databoxedge/armdataboxedge/storageaccounts_client.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_credentials toneBlue
class node_core_pipeline,node_arm_pipeline,node_pipeline_impl toneAmber
class node_cosmos,node_batch,node_servicebus,node_webpubsub toneMint
class node_management_clients,node_resource_graph,node_query_packs,node_search_keys,node_legacy_profiles toneRose
class node_developer,node_azure_services toneIndigo
```

## Components

### Identity

- [Credentials](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/azidentity/public_client.go): `sdk/azidentity/public_client.go`

### Core HTTP

- [Client pipeline](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/azcore/runtime/pipeline.go): `sdk/azcore/runtime/pipeline.go`
- [ARM pipeline](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/azcore/arm/runtime/pipeline.go): `sdk/azcore/arm/runtime/pipeline.go`
- [Pipeline engine](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/azcore/internal/exported/pipeline.go): `sdk/azcore/internal/exported/pipeline.go`

### Service clients

- [Cosmos queries](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/data/azcosmos/cosmos_container_query_engine.go): `sdk/data/azcosmos/cosmos_container_query_engine.go`
- [Batch client](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/batch/azbatch/client.go): `sdk/batch/azbatch/client.go`
- [Service Bus entities](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/messaging/azservicebus/internal/atom/entity_manager.go): `sdk/messaging/azservicebus/internal/atom/entity_manager.go`
- [Web PubSub](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/messaging/azwebpubsub/client.go): `sdk/messaging/azwebpubsub/client.go`

### Management

- [Resource management](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/resourcemanager/monitor/armmonitor/scheduledqueryrules_client.go): `sdk/resourcemanager/monitor/armmonitor/scheduledqueryrules_client.go`
- [Resource Graph](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/resourcemanager/resourcegraph/armresourcegraph/graphquery_client.go): `sdk/resourcemanager/resourcegraph/armresourcegraph/graphquery_client.go`
- [Query packs](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/resourcemanager/operationalinsights/armoperationalinsights/querypacks_client.go): `sdk/resourcemanager/operationalinsights/armoperationalinsights/querypacks_client.go`
- [Search keys](https://github.com/azure/azure-sdk-for-go/blob/main/sdk/resourcemanager/search/armsearch/querykeys_client.go): `sdk/resourcemanager/search/armsearch/querykeys_client.go`
- [Legacy profiles](https://github.com/azure/azure-sdk-for-go/blob/main/profile/p20200901/resourcemanager/databoxedge/armdataboxedge/storageaccounts_client.go): `profile/p20200901/resourcemanager/databoxedge/armdataboxedge/storageaccounts_client.go`

### Other components

- **Go application**
- **Azure services**

## Connections

- Go application → Credentials: creates credential (evidence: `README.md`)
- Go application → Cosmos queries: uses client (evidence: `README.md`)
- Go application → Batch client: uses client (evidence: `README.md`)
- Go application → Service Bus entities: uses client (evidence: `README.md`)
- Go application → Web PubSub: uses client (evidence: `README.md`)
- Go application → Resource management: manages resources (evidence: `README.md`)
- Credentials → Resource management: authorizes client (evidence: `sdk/resourcemanager/monitor/armmonitor/scheduledqueryrules_client.go`)
- Cosmos queries → Azure services: sends requests
- Batch client → Client pipeline: uses core (evidence: `sdk/batch/azbatch/client.go`)
- Service Bus entities → Client pipeline: builds pipeline (evidence: `sdk/messaging/azservicebus/internal/atom/entity_manager.go`)
- Web PubSub → Client pipeline: uses core (evidence: `sdk/messaging/azwebpubsub/client.go`)
- Resource management → ARM pipeline: sends requests (evidence: `sdk/resourcemanager/monitor/armmonitor/scheduledqueryrules_client.go`)
- Resource Graph → ARM pipeline: sends requests (evidence: `sdk/resourcemanager/resourcegraph/armresourcegraph/graphquery_client.go`)
- Query packs → ARM pipeline: sends requests (evidence: `sdk/resourcemanager/operationalinsights/armoperationalinsights/querypacks_client.go`)
- Search keys → ARM pipeline: sends requests
- Legacy profiles → ARM pipeline: sends requests (evidence: `profile/p20200901/resourcemanager/databoxedge/armdataboxedge/storageaccounts_client.go`)
- ARM pipeline → Client pipeline: configures policies (evidence: `sdk/azcore/arm/runtime/pipeline.go`)
- Client pipeline → Pipeline engine: constructs engine (evidence: `sdk/azcore/runtime/pipeline.go`)
- Resource management → Azure services: manages resources
