How Do I Associate a VMware Cloud on AWS SDDC

VMware Cloud Director service relies on an underlying VMware Cloud on AWS infrastructure for its CPU, memory, and storage resources. To start using these resources, you must associate your newly deployed VMware Cloud Director instance with a VMware Cloud on AWS SDDC.

Prerequisites

Verify that you are assigned the Provider Administrator role.
Obtain an API token from the organization you want to manage. The scope of the API token must contain the Administrator and NSX Cloud Admin service roles, as well as the Developer or the Organization Owner organization role. See How Do I Generate an API Token. Note the API token.
Use the API token to generate an access bearer token. Use the bearer token in the Authorization header when you run API calls.
Obtain the environment ID (URN). See How Do I Retrieve the List of Environments in My Organization.
Obtain the VMware Cloud Director instance ID (URN). See How Do I Retrieve a List of All VMware Cloud Director Instances in Your Organization.

Procedure

Log in to VMware Cloud Director service.
- If you are an enterprise customer, log in at https://console.cloud.vmware.com.
- If you are a Managed Service Provider (MSP) partner, log in at https://navigator.vmware.com.
Note the long organization ID for the VMware Cloud organization that contains your VMware Cloud on AWS SDDC.
1. Click your user name.
2. To display the full organization ID, click View Organization .
Prepare a JSON template with the required information for associating your VMware Cloud Director instance with a VMware Cloud on AWS SDDC.
```
{ "operationType": "associateVmc",
  "arguments": {
    "apiToken": "API-token",
    "vmcCspOrgId": "long-organization-ID-of-VMware-Cloud-Services-organization",
    "vmcName": "name-of-your-VMware-Cloud-on-AWS-SDDC" } 
}
```
Here, "vmcCspOrgId" is the long organization ID for the VMware Cloud services organization that contains your VMware Cloud on AWS SDDC instances. It must be in a Universally unique identifier (UUID) format. This means that the ID must be represented as a 128-bit value formatted into blocks of hexadecimal digits separated by a hyphen. The "apiToken" is the API token that you obtained from your organization.
Run a POST request with the contents of the JSON template in the body of the request.
```
POST https://operatorUrl/environment/environmentUrn/instances/vcdInstanceUrn/operations/invoke
```
Here operatorUrl is the operator URL, for example vcdc-operator-prod-us-west-2.vdp.vmware.com.

Results

You associated the VMware Cloud Director instance with a VMware Cloud on AWS SDDC.

Example: Associate a VMware Cloud on AWS SDDC

This example associates your VMware Cloud Director instance with a VMware Cloud on AWS SDDC.

POST https://vcdc-operator-prod-us-west-2.vdp.vmware.com/environments/urn:vcdc:environment:00000000-0000-0000-0000-00000000000/instances/urn:vcdc:vcdInstance:22222222-2222-2222-2222-222222222222/operations/invoke

Use the bearer token in the Authorization header of the request.

Authorization: 
Bearer eyJh…I1NiIs

Enter the required information in the POST request.

{ "operationType": "associateVmc",
  "arguments": {
    "apiToken": "123456789012345678901234567890123456789012345678901234567890",
    "vmcCspOrgId": "12345678-1234-1234-1234-123456789abc",
    "vmcName": "myVmcSddc" } 
}

The response is a confirmation that the association task is in progress.

{
  "id": "urn:vcdc:task:33333333-3333-3333-3333-333333333333",
  "name": "associateVmc",
  "entityId": "urn:vcdc:vcdInstance:22222222-2222-2222-2222-222222222222",
  "entityName": "myentity1-name",
  "ownerId": "urn:vcdc:organization:11111111-1111-1111-1111-111111111111",
  "userId": "[email protected]",
  "steps": null,
  "status": "IN_PROGRESS",
  "startTime": null,
  "endTime": null,
  "queuedTime": "2020-12-07T13:54:03.268466Z",
  "message": "Invoking operation on instance",
  "isolation": "ENTITY_EXCLUSIVE",
  "output": null,
  "activity": "activity://AssociateVmcWithVcdActivity/00000000-0000-0000-0000-000000000000/1111111111111"
}