Create Cloud Account

Create Cloud Account

Create a cloud account in the current organization

Request
URI
POST
https://api.mgmt.cloud.vmware.com//iaas/api/cloud-accounts
COPY
Query Parameters
string
apiVersion
Optional

The version of the API in yyyy-MM-dd format (UTC). For versioning information please refer to /iaas/api/about


Request Body
CloudAccountSpecification of type(s) application/json
Optional
{
    "privateKey": "gfsScK345sGGaVdds222dasdfDDSSasdfdsa34fS",
    "associatedCloudAccountIds": [
        "string"
    ],
    "createDefaultZones": true,
    "cloudAccountType": "vsphere, aws, azure, nsxv, nsxt",
    "name": "string",
    "description": "string",
    "regionIds": [
        "string"
    ],
    "privateKeyId": "ACDC55DB4MFH6ADG75KK",
    "tags": [
        {
            "value": "string",
            "key": "string"
        }
    ]
}
object
cloudAccountProperties
Required

Cloud Account specific properties supplied in as name value pairs

string
privateKey
Required

Secret access key or password to be used to authenticate with the cloud account

array of string
associatedCloudAccountIds
Optional

Cloud account to link with this cloud account

boolean
createDefaultZones
Optional

Create default cloud zones for the enabled regions.

object
customProperties
Optional

Additional custom properties that may be used to extend the Cloud Account.

string
cloudAccountType
Required

Cloud account type

string
name
Required

A human-friendly name used as an identifier in APIs that support this option.

string
description
Optional

A human-friendly description.

array of string
regionIds
Required

A set of Region names to enable provisioning on.Refer to /iaas/cloud-accounts/region-enumeration.

string
privateKeyId
Required

Access key id or username to be used to authenticate with the cloud account

array of Tag
tags
Optional

A set of tag keys and optional values to set on the Cloud Account

Responses
201

successful operation

Returns CloudAccount of type(s) application/json
{
    "owner": "[email protected]",
    "enabledRegionIds": [
        "string"
    ],
    "cloudAccountType": "vsphere, aws, azure, nsxv, nsxt",
    "description": "my-description",
    "orgId": "9e49",
    "tags": [
        {
            "value": "string",
            "key": "string"
        }
    ],
    "organizationId": "deprecated",
    "createdAt": "2012-09-27",
    "name": "my-name",
    "id": "9e49",
    "updatedAt": "2012-09-27"
}
string
owner
Optional

Email of the user that owns the entity.

object
cloudAccountProperties
Required

Cloud account specific properties

array of string
enabledRegionIds
Optional

A set of region names to enable provisioning on.

object
_links
Required

HATEOAS of the entity

string
cloudAccountType
Required

Cloud account type

string
description
Optional

A human-friendly description.

string
orgId
Optional

The id of the organization this entity belongs to.

array of Tag
tags
Optional

A set of tag keys and optional values that were set on the Cloud Account

string
organizationId
Optional

This field is deprecated. Use orgId instead. The id of the organization this entity belongs to.

string
createdAt
Optional

Date when the entity was created. The date is in ISO 8601 and UTC.

object
customProperties
Optional

Additional properties that may be used to extend the base type.

string
name
Optional

A human-friendly name used as an identifier in APIs that support this option.

string
id
Required

The id of this resource instance

string
updatedAt
Optional

Date when the entity was last updated. The date is ISO 8601 and UTC.


400

Invalid Request - bad data

Operation doesn't return any data structure

403

Forbidden

Operation doesn't return any data structure

Cloud Account Operations
POST
Create Aws Cloud Account
POST
Create Azure Cloud Account
POST
Create Cloud Account
POST
Create Gcp Cloud Account
POST
Create Nsx T Cloud Account
POST
Create Nsx V Cloud Account
POST
Create Vmc Cloud Account
POST
Create V Sphere Cloud Account
DELETE
Delete Aws Cloud Account
DELETE
Delete Azure Cloud Account
DELETE
Delete Cloud Account
DELETE
Delete Cloud Account Nsx T
DELETE
Delete Cloud Account Nsx V
DELETE
Delete Gcp Cloud Account
DELETE
Delete Vmc Cloud Account
DELETE
Delete V Sphere Cloud Account
POST
Enumerate Aws Regions
POST
Enumerate Azure Regions
POST
Enumerate Gcp Regions
POST
Enumerate Private Images
POST
Enumerate Private Images AWS
POST
Enumerate Private Images Azure
POST
Enumerate Private Images Gcp
POST
Enumerate Private Images VMC
POST
Enumerate Private Images V Sphere
POST
Enumerate Regions
POST
Enumerate Vmc Regions
POST
Enumerate V Sphere Regions
GET
Get Aws Cloud Account
GET
Get Aws Cloud Accounts
GET
Get Azure Cloud Account
GET
Get Azure Cloud Accounts
GET
Get Cloud Account
GET
Get Cloud Accounts
GET
Get Gcp Cloud Account
GET
Get Gcp Cloud Accounts
GET
Get Nsx T Cloud Account
GET
Get Nsx T Cloud Accounts
GET
Get Nsx V Cloud Account
GET
Get Nsx V Cloud Accounts
GET
Get Vmc Cloud Account
GET
Get Vmc Cloud Accounts
GET
Get V Sphere Cloud Account
GET
Get V Sphere Cloud Accounts
PATCH
Update Aws Cloud Account
PATCH
Update Azure Cloud Account
PATCH
Update Cloud Account
PATCH
Update Gcp Cloud Account
PATCH
Update Nsx T Cloud Account
PATCH
Update Nsx V Cloud Account
PATCH
Update Vmc Cloud Account
PATCH
Update V Sphere Cloud Account