# harshithreddy01/azure-sdk-for-python architecture

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

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

## Overview

This is the Azure SDK for Python: a collection of service-specific client and management libraries, supported by shared authentication and HTTP runtime packages. The principal workflow is that an application uses a service client to make an Azure operation; shared core facilities handle request transport and common concerns, and the result comes from the Azure service. The README documents shared retries, logging, transport, authentication, policies, error handling, and tracing. Source excerpts are selective, so links between unsampled service subsystems are omitted rather than inferred.

Main entry points: [`sdk/core/azure-core/azure/core/_pipeline_client_async.py`](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/_pipeline_client_async.py) (Pipeline client), [`sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py`](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py) (Blob operations), [`sdk`](https://github.com/harshithreddy01/azure-sdk-for-python/tree/main/sdk) (Service clients), [`sdk/core/azure-core/azure/core/pipeline/__init__.py`](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/pipeline/__init__.py) (HTTP pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_service["Service SDKs"]
  node_clientlibs["Service clients"]
  node_blobops["Blob operations"]
  node_cosmos_inference["Cosmos inference"]
end

subgraph group_management["Management SDKs"]
  node_managementlibs["Resource clients"]
  node_management_ops["Resource operations"]
  node_mgmt_errors["ARM errors<br/>[exceptions.py]"]
  node_mgmt_polling["ARM polling<br/>[arm_polling.py]"]
end

subgraph group_core["Shared runtime"]
  node_pipeline_client["Pipeline client"]
  node_pipeline["HTTP pipeline<br/>[__init__.py]"]
  node_transport["HTTP transport<br/>[_base.py]"]
  node_aiohttp["Async transport<br/>[_aiohttp.py]"]
  node_http_models["HTTP messages<br/>[_rest_py3.py]"]
  node_core_errors["Core errors<br/>[exceptions.py]"]
  node_paging["Paging<br/>[paging.py]"]
  node_polling["Long-running polling<br/>[base_polling.py]"]
  node_tracing["Tracing<br/>[decorator.py]"]
end

subgraph group_identity["Authentication"]
  node_identity["Azure Identity<br/>[__init__.py]"]
end

node_app(("Application"))
node_azure{{"Azure services"}}

node_app -->|"uses"| node_clientlibs
node_app -->|"uses"| node_managementlibs
node_clientlibs -.->|"authenticates with"| node_identity
node_clientlibs -->|"uses shared core"| node_pipeline_client
node_managementlibs -->|"uses identity"| node_identity
node_managementlibs -->|"uses pipeline"| node_pipeline_client
node_blobops -->|"imports errors"| node_core_errors
node_blobops -->|"imports errors"| node_mgmt_errors
node_blobops -->|"imports polling"| node_mgmt_polling
node_blobops -->|"imports tracing"| node_tracing
node_pipeline_client -->|"runs requests"| node_pipeline
node_pipeline_client -->|"accepts requests"| node_http_models
node_pipeline -->|"uses transport"| node_transport
node_pipeline_client -->|"supports async transport"| node_aiohttp
node_pipeline_client -.->|"sends requests"| node_azure
node_azure -.->|"returns results"| node_app

click node_clientlibs "https://github.com/harshithreddy01/azure-sdk-for-python/tree/main/sdk"
click node_blobops "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py"
click node_cosmos_inference "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/cosmos/azure-cosmos/azure/cosmos/_inference_service.py"
click node_managementlibs "https://github.com/harshithreddy01/azure-sdk-for-python/tree/main/sdk"
click node_management_ops "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py"
click node_mgmt_errors "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-mgmt-core/azure/mgmt/core/exceptions.py"
click node_mgmt_polling "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-mgmt-core/azure/mgmt/core/polling/arm_polling.py"
click node_identity "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/identity/azure-identity/azure/identity/__init__.py"
click node_pipeline_client "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/_pipeline_client_async.py"
click node_pipeline "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/pipeline/__init__.py"
click node_transport "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/pipeline/transport/_base.py"
click node_aiohttp "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/pipeline/transport/_aiohttp.py"
click node_http_models "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/rest/_rest_py3.py"
click node_core_errors "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/exceptions.py"
click node_paging "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/paging.py"
click node_polling "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/polling/base_polling.py"
click node_tracing "https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/tracing/decorator.py"

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_clientlibs,node_blobops,node_cosmos_inference toneBlue
class node_managementlibs,node_management_ops,node_mgmt_errors,node_mgmt_polling toneAmber
class node_pipeline_client,node_pipeline,node_transport,node_aiohttp,node_http_models,node_core_errors,node_paging,node_polling,node_tracing toneMint
class node_identity toneRose
class node_app,node_azure toneIndigo
```

## Components

### Service SDKs

- [Service clients](https://github.com/harshithreddy01/azure-sdk-for-python/tree/main/sdk): `sdk`
- [Blob operations](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py): `sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py`
- [Cosmos inference](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/cosmos/azure-cosmos/azure/cosmos/_inference_service.py): `sdk/cosmos/azure-cosmos/azure/cosmos/_inference_service.py`

### Management SDKs

- [Resource clients](https://github.com/harshithreddy01/azure-sdk-for-python/tree/main/sdk): `sdk`
- [Resource operations](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py): `sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py`
- [ARM errors](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-mgmt-core/azure/mgmt/core/exceptions.py): `sdk/core/azure-mgmt-core/azure/mgmt/core/exceptions.py`
- [ARM polling](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-mgmt-core/azure/mgmt/core/polling/arm_polling.py): `sdk/core/azure-mgmt-core/azure/mgmt/core/polling/arm_polling.py`

### Shared runtime

- [Pipeline client](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/_pipeline_client_async.py): `sdk/core/azure-core/azure/core/_pipeline_client_async.py`
- [HTTP pipeline](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/pipeline/__init__.py): `sdk/core/azure-core/azure/core/pipeline/__init__.py`
- [HTTP transport](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/pipeline/transport/_base.py): `sdk/core/azure-core/azure/core/pipeline/transport/_base.py`
- [Async transport](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/pipeline/transport/_aiohttp.py): `sdk/core/azure-core/azure/core/pipeline/transport/_aiohttp.py`
- [HTTP messages](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/rest/_rest_py3.py): `sdk/core/azure-core/azure/core/rest/_rest_py3.py`
- [Core errors](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/exceptions.py): `sdk/core/azure-core/azure/core/exceptions.py`
- [Paging](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/paging.py): `sdk/core/azure-core/azure/core/paging.py`
- [Long-running polling](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/polling/base_polling.py): `sdk/core/azure-core/azure/core/polling/base_polling.py`
- [Tracing](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/core/azure-core/azure/core/tracing/decorator.py): `sdk/core/azure-core/azure/core/tracing/decorator.py`

### Authentication

- [Azure Identity](https://github.com/harshithreddy01/azure-sdk-for-python/blob/main/sdk/identity/azure-identity/azure/identity/__init__.py): `sdk/identity/azure-identity/azure/identity/__init__.py`

### Other components

- **Application**
- **Azure services**

## Connections

- Application → Service clients: uses (evidence: `README.md`)
- Application → Resource clients: uses (evidence: `README.md`)
- Service clients → Azure Identity: authenticates with (evidence: `README.md`)
- Service clients → Pipeline client: uses shared core (evidence: `README.md`)
- Resource clients → Azure Identity: uses identity (evidence: `README.md`)
- Resource clients → Pipeline client: uses pipeline (evidence: `README.md`)
- Blob operations → Core errors: imports errors (evidence: `sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py`)
- Blob operations → ARM errors: imports errors (evidence: `sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py`)
- Blob operations → ARM polling: imports polling (evidence: `sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py`)
- Blob operations → Tracing: imports tracing (evidence: `sdk/appcontainers/azure-mgmt-appcontainers/azure/mgmt/appcontainers/operations/_connected_environments_storages_operations.py`)
- Pipeline client → HTTP pipeline: runs requests (evidence: `sdk/core/azure-core/azure/core/_pipeline_client_async.py`)
- Pipeline client → HTTP messages: accepts requests (evidence: `sdk/core/azure-core/azure/core/_pipeline_client_async.py`)
- HTTP pipeline → HTTP transport: uses transport (evidence: `sdk/core/azure-core/azure/core/pipeline/__init__.py`)
- Pipeline client → Async transport: supports async transport (evidence: `sdk/core/azure-core/azure/core/_pipeline_client_async.py`)
- Pipeline client → Azure services: sends requests
- Azure services → Application: returns results
