Get Compatible Subnets

Gets a customer’s compatible subnets for account linking

This is necessary to get the list of subnets that are required to do the AWS account linking process. You have to also have the AWS account Linked account ID (which is not the AWS account number). Choosing the correct subnet allows customers to place their SDDC in the specified AWS availability zone (AZ), which can be very helpful if other resources are already deployed in an AZ.

URL

GET https://vmc.vmware.com/vmc/api/orgs/:org/account-link/compatible-subnets?linkedAccountId={{linkedAccountId}}&region={{region}}

Path Variables

KeyExample ValueHow do I find This
orgXXXXXXXXX-1111-XXXX-1111-XXXXXXXXXXXXFind My Org ID

Query Variables

KeyExample ValueHow do I find This
linkedAccountIdXXXXXXXXX-1111-XXXX-1111-XXXXXXXXXXXXFind Account Link ID
regionus-east-1AWS Regions

Key Headers

KeyExample ValueHow do I find This
csp-auth-tokeneyJhbGciOiJSUzI1XXXXXXXXXXXXXXXXXX
XXXXXXXXeyJzdWIiOiJ2bXdhcmUuY29
VMware Cloud API Authentication

Example JSON Payload

none


Example Response Body

{
    "vpc_map": {
        "vpc-12345678": {
            "vpc_id": "vpc-12345678",
            "description": "VPCNAME",
            "cidr_block": "172.31.0.0/16",
            "subnets": [
                {
                    "subnet_id": "subnet-123abc456",
                    "subnet_cidr_block": "172.31.16.0/20",
                    "vpc_cidr_block": "172.31.0.0/16",
                    "vpc_id": "vpc-12345678",
                    "availability_zone": "us-west-2b",
                    "availability_zone_id": "usw2-az2",
                    "region_name": "us-west-2",
                    "name": "SUBNETNAME",
                    "connected_account_id": "XXXXXXXXX-1111-YYYYY-1111-ZZZZZZZZZZZ",
                    "note": null,
                    "owner": "123456789012",
                    "ips_available": 3955,
                    "compatible": true
                },
                {
                    "subnet_id": "subnet-456def789",
                    "subnet_cidr_block": "172.31.0.0/20",
                    "vpc_cidr_block": "172.31.0.0/16",
                    "vpc_id": "vpc-12345678",
                    "availability_zone": "us-west-2c",
                    "availability_zone_id": "usw2-az3",
                    "region_name": "us-west-2",
                    "name": "SUBNETNAME",
                    "connected_account_id": "XXXXXXXXX-1111-YYYYY-1111-ZZZZZZZZZZZ",
                    "note": null,
                    "owner": "123456789012",
                    "ips_available": 4072,
                    "compatible": true
                },
                {
                    "subnet_id": "subnet-123geh789",
                    "subnet_cidr_block": "172.31.32.0/20",
                    "vpc_cidr_block": "172.31.0.0/16",
                    "vpc_id": "vpc-12345678",
                    "availability_zone": "us-west-2a",
                    "availability_zone_id": "usw2-az1",
                    "region_name": "us-west-2",
                    "name": "SUBNETNAME",
                    "connected_account_id": "XXXXXXXXX-1111-YYYYY-1111-ZZZZZZZZZZZ",
                    "note": null,
                    "owner": "123456789012",
                    "ips_available": 4084,
                    "compatible": true
                }
            ]
        },
    },
    "customer_available_zones": [
        "us-west-2a",
        "us-west-2b",
        "us-west-2c",
        "us-west-2d"
    ]
}