Get Compatible Subnets - Viewpoints from a VMware Cloud SA

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

Key	Example Value	How do I find This
org	XXXXXXXXX-1111-XXXX-1111-XXXXXXXXXXXX	Find My Org ID

Query Variables

Key	Example Value	How do I find This
linkedAccountId	XXXXXXXXX-1111-XXXX-1111-XXXXXXXXXXXX	Find Account Link ID
region	us-east-1	AWS Regions

Key Headers

Key	Example Value	How do I find This
csp-auth-token	eyJhbGciOiJSUzI1XXXXXXXXXXXXXXXXXX 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"
    ]
}