# hashicorp/terraform-provider-aws architecture

> Architecture diagram of the GitHub repository hashicorp/terraform-provider-aws, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hashicorp/terraform-provider-aws
- Repository: https://github.com/hashicorp/terraform-provider-aws

## Overview

The Terraform AWS Provider lets Terraform manage AWS resources. Its main workflow is configuration and lifecycle requests entering the provider, dispatching to service-specific resource implementations, which call AWS APIs and reflect results into Terraform state. The repository also includes both SDKv2 and Terraform Plugin Framework implementations, shared client infrastructure, and broad resource, data-source, identity, import, list, and ephemeral-resource capabilities. Edges are limited to README statements and relationships visible in the provided excerpts or SOURCE INDEX; many unsampled service-level links are therefore omitted.

Main entry points: [`internal/provider/sdkv2/provider.go`](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/provider/sdkv2/provider.go) (SDKv2 provider), [`internal/conns/awsclient.go`](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/conns/awsclient.go) (AWS clients), [`internal/provider/sdkv2/service_packages_gen.go`](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/provider/sdkv2/service_packages_gen.go) (Service registry), [`internal/service/codepipeline/codepipeline.go`](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/service/codepipeline/codepipeline.go) (SDKv2 resources)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Provider entry"]
  node_main["Provider startup<br/>[main.go]"]
end

subgraph group_dispatch["Provider dispatch"]
  node_sdkprovider["SDKv2 provider<br/>[provider.go]"]
  node_fwprovider["Framework provider<br/>[provider.go]"]
  node_registry["Service registry"]
  node_import["Import support"]
end

subgraph group_runtime["Shared runtime"]
  node_servicepkg["Service package metadata<br/>[service_package.go]"]
  node_connections["AWS clients<br/>[awsclient.go]"]
  node_sharedframework["Framework support"]
  node_sharedsdk["SDKv2 support"]
end

subgraph group_services["AWS services"]
  node_legacyresources["SDKv2 resources<br/>[codepipeline.go]"]
  node_frameworkresources["Framework resources<br/>[pipeline.go]"]
  node_identity["Identity resources<br/>[policy_engine.go]"]
  node_additionalservices["Additional services"]
  node_dataresources["Data sources"]
  node_listresources["List resources"]
  node_ephemeral["Ephemeral resources"]
end

node_terraform(("Terraform"))
node_api["AWS APIs"]

node_terraform -->|"manages resources"| node_main
node_main -->|"loads provider"| node_sdkprovider
node_sdkprovider -->|"registers services"| node_registry
node_registry -.->|"builds metadata"| node_servicepkg
node_registry -->|"registers service"| node_legacyresources
node_sdkprovider -.->|"configures clients"| node_connections
node_fwprovider -.->|"configures clients"| node_connections
node_legacyresources -->|"calls AWS client"| node_connections
node_frameworkresources -.->|"gets client"| node_connections
node_identity -.->|"gets client"| node_connections
node_connections -.->|"calls AWS APIs"| node_api
node_registry -->|"registers services"| node_additionalservices
node_sdkprovider -.->|"dispatches requests"| node_dataresources
node_sdkprovider -.->|"dispatches requests"| node_listresources
node_sdkprovider -.->|"dispatches requests"| node_ephemeral
node_sdkprovider -.->|"supports imports"| node_import
node_legacyresources -->|"uses helpers"| node_sharedsdk
node_frameworkresources -->|"uses framework"| node_sharedframework
node_identity -->|"uses framework"| node_sharedframework

click node_main "https://github.com/hashicorp/terraform-provider-aws/blob/main/main.go"
click node_sdkprovider "https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/provider/sdkv2/provider.go"
click node_fwprovider "https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/provider/framework/provider.go"
click node_registry "https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/provider/sdkv2/service_packages_gen.go"
click node_servicepkg "https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/types/service_package.go"
click node_connections "https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/conns/awsclient.go"
click node_legacyresources "https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/service/codepipeline/codepipeline.go"
click node_frameworkresources "https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/service/osis/pipeline.go"
click node_identity "https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/service/bedrockagentcore/policy_engine.go"
click node_additionalservices "https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/service"
click node_dataresources "https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/service"
click node_listresources "https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/service"
click node_ephemeral "https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/service"
click node_import "https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/provider/sdkv2/importer"
click node_sharedframework "https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/framework"
click node_sharedsdk "https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/sdkv2"

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_main toneBlue
class node_sdkprovider,node_fwprovider,node_registry,node_import toneAmber
class node_servicepkg,node_connections,node_sharedframework,node_sharedsdk,node_api toneMint
class node_legacyresources,node_frameworkresources,node_identity,node_additionalservices,node_dataresources,node_listresources,node_ephemeral toneRose
class node_terraform toneIndigo
```

## Components

### Provider entry

- [Provider startup](https://github.com/hashicorp/terraform-provider-aws/blob/main/main.go): `main.go`

### Provider dispatch

- [SDKv2 provider](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/provider/sdkv2/provider.go): `internal/provider/sdkv2/provider.go`
- [Framework provider](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/provider/framework/provider.go): `internal/provider/framework/provider.go`
- [Service registry](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/provider/sdkv2/service_packages_gen.go): `internal/provider/sdkv2/service_packages_gen.go`
- [Import support](https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/provider/sdkv2/importer): `internal/provider/sdkv2/importer`

### Shared runtime

- [Service package metadata](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/types/service_package.go): `internal/types/service_package.go`
- [AWS clients](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/conns/awsclient.go): `internal/conns/awsclient.go`
- [Framework support](https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/framework): `internal/framework`
- [SDKv2 support](https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/sdkv2): `internal/sdkv2`

### AWS services

- [SDKv2 resources](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/service/codepipeline/codepipeline.go): `internal/service/codepipeline/codepipeline.go`
- [Framework resources](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/service/osis/pipeline.go): `internal/service/osis/pipeline.go`
- [Identity resources](https://github.com/hashicorp/terraform-provider-aws/blob/main/internal/service/bedrockagentcore/policy_engine.go): `internal/service/bedrockagentcore/policy_engine.go`
- [Additional services](https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/service): `internal/service`
- [Data sources](https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/service): `internal/service`
- [List resources](https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/service): `internal/service`
- [Ephemeral resources](https://github.com/hashicorp/terraform-provider-aws/tree/main/internal/service): `internal/service`

### Other components

- **Terraform**
- **AWS APIs**

## Connections

- Terraform → Provider startup: manages resources (evidence: `README.md`)
- Provider startup → SDKv2 provider: loads provider (evidence: `main.go`)
- SDKv2 provider → Service registry: registers services (evidence: `internal/provider/sdkv2/service_packages_gen.go`)
- Service registry → Service package metadata: builds metadata
- Service registry → SDKv2 resources: registers service (evidence: `internal/provider/sdkv2/service_packages_gen.go`)
- SDKv2 provider → AWS clients: configures clients
- Framework provider → AWS clients: configures clients
- SDKv2 resources → AWS clients: calls AWS client (evidence: `internal/service/codepipeline/codepipeline.go`)
- Framework resources → AWS clients: gets client
- Identity resources → AWS clients: gets client
- AWS clients → AWS APIs: calls AWS APIs
- Service registry → Additional services: registers services (evidence: `internal/provider/sdkv2/service_packages_gen.go`)
- SDKv2 provider → Data sources: dispatches requests
- SDKv2 provider → List resources: dispatches requests
- SDKv2 provider → Ephemeral resources: dispatches requests
- SDKv2 provider → Import support: supports imports
- SDKv2 resources → SDKv2 support: uses helpers (evidence: `internal/service/codepipeline/codepipeline.go`)
- Framework resources → Framework support: uses framework (evidence: `internal/service/osis/pipeline.go`)
- Identity resources → Framework support: uses framework (evidence: `internal/service/bedrockagentcore/policy_engine.go`)
