# vmware-archive/terraform-provider-nsxt-virtual-private-cloud architecture

> Architecture diagram of the GitHub repository vmware-archive/terraform-provider-nsxt-virtual-private-cloud, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud
- Repository: https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud

## Overview

This archived repository is a Terraform provider for managing VMware NSX-T Virtual Private Cloud resources. Terraform invokes the provider, which configures NSX connectivity; users can then declare and look up VPC networking, security, gateway, NAT, and related objects. Resource implementations expose Terraform lifecycle operations and communicate with NSX, while shared policy utilities support policy-related behavior. The graph preserves documented resource and data-source families, but their individual registration and internal helper calls were not all shown in the excerpts.

Main entry points: [`nsxt/provider.go`](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/provider.go) (Provider configuration), [`nsxt/resource_nsxt_vpc_subnet.go`](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_vpc_subnet.go) (VPC subnets), [`nsxt`](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/tree/main/nsxt) (Data sources), [`nsxt/clients/custom_nsxt_client.go`](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/clients/custom_nsxt_client.go) (NSX client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Provider entry"]
  node_provider["Provider configuration<br/>[provider.go]"]
end

subgraph group_network["VPC networking"]
  node_subnet["VPC subnets"]
  node_subnetport["Subnet ports"]
  node_allocation["IP allocations"]
  node_subnetallocation["Subnet allocations"]
  node_routes["Static routes"]
  node_dhcp["DHCP bindings"]
  node_vmtags["VM tags"]
end

subgraph group_policy["Policy and security"]
  node_security["Security policies"]
  node_secrules["Security rules"]
  node_gateway["Gateway policies"]
  node_gatewayrules["Gateway rules"]
  node_nat["VPC NAT rules"]
  node_groups["NSX groups"]
  node_lookups["Data sources"]
end

subgraph group_shared["Shared API layer"]
  node_dependants["Dependent resources"]
  node_policyutils["Policy utilities"]
  node_client["NSX client"]
  node_session["HTTP session"]
end

node_terraform(("Terraform"))
node_nsxt["NSX-T manager"]

node_terraform -->|"starts provider"| node_provider
node_provider -->|"checks connectivity"| node_nsxt
node_client -->|"creates session"| node_session
node_routes -->|"deletes route"| node_nsxt
node_secrules -->|"deletes rule"| node_nsxt
node_gatewayrules -->|"deletes rule"| node_nsxt
node_security -->|"deletes policy"| node_nsxt
node_nat -->|"creates and reads"| node_nsxt
node_subnetport -->|"creates and reads"| node_nsxt
node_subnet -->|"creates and reads"| node_nsxt
node_vmtags -->|"posts and searches"| node_nsxt
node_provider -.->|"configures client"| node_client
node_provider -.->|"registers resources"| node_subnet
node_provider -.->|"registers data sources"| node_lookups
node_lookups -.->|"queries objects"| node_nsxt

click node_provider "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/provider.go"
click node_subnet "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_vpc_subnet.go"
click node_subnetport "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_vpc_subnet_port.go"
click node_allocation "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_vpc_ip_address_allocation.go"
click node_subnetallocation "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_subnet_ip_address_allocation.go"
click node_routes "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_static_routes.go"
click node_dhcp "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_dhcp_v4_static_binding_config.go"
click node_vmtags "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/custom_resource_nsxt_vpc_vm_tags.go"
click node_security "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_security_policy.go"
click node_secrules "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_security_policy_rule.go"
click node_gateway "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_gateway_policy.go"
click node_gatewayrules "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_gateway_policy_rule.go"
click node_nat "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_policy_vpc_nat_rule.go"
click node_groups "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_group.go"
click node_lookups "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/tree/main/nsxt"
click node_dependants "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_rest_dependants.go"
click node_policyutils "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/custom_terraform_policy_utils.go"
click node_client "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/clients/custom_nsxt_client.go"
click node_session "https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/session/custom_nsxtsession.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_provider toneBlue
class node_subnet,node_subnetport,node_allocation,node_subnetallocation,node_routes,node_dhcp,node_vmtags toneAmber
class node_security,node_secrules,node_gateway,node_gatewayrules,node_nat,node_groups,node_lookups toneMint
class node_dependants,node_policyutils,node_client,node_session toneRose
class node_terraform,node_nsxt toneIndigo
```

## Components

### Provider entry

- [Provider configuration](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/provider.go): `nsxt/provider.go`

### VPC networking

- [VPC subnets](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_vpc_subnet.go): `nsxt/resource_nsxt_vpc_subnet.go`
- [Subnet ports](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_vpc_subnet_port.go): `nsxt/resource_nsxt_vpc_subnet_port.go`
- [IP allocations](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_vpc_ip_address_allocation.go): `nsxt/resource_nsxt_vpc_ip_address_allocation.go`
- [Subnet allocations](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_subnet_ip_address_allocation.go): `nsxt/resource_nsxt_subnet_ip_address_allocation.go`
- [Static routes](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_static_routes.go): `nsxt/resource_nsxt_static_routes.go`
- [DHCP bindings](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_dhcp_v4_static_binding_config.go): `nsxt/resource_nsxt_dhcp_v4_static_binding_config.go`
- [VM tags](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/custom_resource_nsxt_vpc_vm_tags.go): `nsxt/custom_resource_nsxt_vpc_vm_tags.go`

### Policy and security

- [Security policies](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_security_policy.go): `nsxt/resource_nsxt_security_policy.go`
- [Security rules](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_security_policy_rule.go): `nsxt/resource_nsxt_security_policy_rule.go`
- [Gateway policies](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_gateway_policy.go): `nsxt/resource_nsxt_gateway_policy.go`
- [Gateway rules](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_gateway_policy_rule.go): `nsxt/resource_nsxt_gateway_policy_rule.go`
- [VPC NAT rules](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_policy_vpc_nat_rule.go): `nsxt/resource_nsxt_policy_vpc_nat_rule.go`
- [NSX groups](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_group.go): `nsxt/resource_nsxt_group.go`
- [Data sources](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/tree/main/nsxt): `nsxt`

### Shared API layer

- [Dependent resources](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/resource_nsxt_rest_dependants.go): `nsxt/resource_nsxt_rest_dependants.go`
- [Policy utilities](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/custom_terraform_policy_utils.go): `nsxt/custom_terraform_policy_utils.go`
- [NSX client](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/clients/custom_nsxt_client.go): `nsxt/clients/custom_nsxt_client.go`
- [HTTP session](https://github.com/vmware-archive/terraform-provider-nsxt-virtual-private-cloud/blob/main/nsxt/session/custom_nsxtsession.go): `nsxt/session/custom_nsxtsession.go`

### Other components

- **Terraform**
- **NSX-T manager**

## Connections

- Terraform → Provider configuration: starts provider
- Provider configuration → NSX-T manager: checks connectivity (evidence: `nsxt/provider.go`)
- NSX client → HTTP session: creates session (evidence: `nsxt/clients/custom_nsxt_client.go`)
- Static routes → NSX-T manager: deletes route (evidence: `nsxt/resource_nsxt_static_routes.go`)
- Security rules → NSX-T manager: deletes rule (evidence: `nsxt/resource_nsxt_security_policy_rule.go`)
- Gateway rules → NSX-T manager: deletes rule (evidence: `nsxt/resource_nsxt_gateway_policy_rule.go`)
- Security policies → NSX-T manager: deletes policy (evidence: `nsxt/resource_nsxt_security_policy.go`)
- VPC NAT rules → NSX-T manager: creates and reads (evidence: `nsxt/resource_nsxt_policy_vpc_nat_rule.go`)
- Subnet ports → NSX-T manager: creates and reads (evidence: `nsxt/resource_nsxt_vpc_subnet_port.go`)
- VPC subnets → NSX-T manager: creates and reads (evidence: `nsxt/resource_nsxt_vpc_subnet.go`)
- VM tags → NSX-T manager: posts and searches (evidence: `nsxt/custom_resource_nsxt_vpc_vm_tags.go`)
- Provider configuration → NSX client: configures client
- Provider configuration → VPC subnets: registers resources
- Provider configuration → Data sources: registers data sources (evidence: `nsxt/provider.go`)
- Data sources → NSX-T manager: queries objects
