Create Nsx V Cloud Account

Create Nsx V Cloud Account

Create a NSX-V cloud account within the current organization

Request
URI
POST
https://{api_host}/iaas/api/cloud-accounts-nsx-v
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

CloudAccountNsxV specification

CloudAccountNsxVSpecification of type(s) application/json
Required
{
    "hostName": "nsxv.mycompany.com",
    "acceptSelfSignedCertificate": false,
    "password": "cndhjslacd90ascdbasyoucbdh",
    "dcid": "23959a1e-18bc-4f0c-ac49-b5aeb4b6eef4",
    "name": "string",
    "description": "string",
    "username": "[email protected]",
    "tags": [
        {
            "value": "string",
            "key": "string"
        }
    ]
}
string
hostName
Required

Host name for the Nsx-T endpoint

boolean
acceptSelfSignedCertificate
Optional

Accept self signed certificate when connecting.

string
password
Required

Password for the user used to authenticate with the cloud Account

string
dcid
Required

Identifier of a data collector vm deployed in the on premise infrastructure. Refer to the data-collector API to create or list data collectors

string
name
Required

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

string
description
Optional

A human-friendly description.

string
username
Required

Username 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 CloudAccountNsxV of type(s) application/json
{
    "owner": "[email protected]",
    "hostName": "nsxv.vmware.com",
    "description": "my-description",
    "orgId": "9e49",
    "tags": [
        {
            "value": "string",
            "key": "string"
        }
    ],
    "organizationId": "deprecated",
    "createdAt": "2012-09-27",
    "dcid": "23959a1e-18bc-4f0c-ac49-b5aeb4b6eef4",
    "name": "my-name",
    "id": "9e49",
    "updatedAt": "2012-09-27",
    "username": "[email protected]"
}
string
owner
Optional

Email of the user that owns the entity.

string
hostName
Required

Host name for the Nsx-V cloud account

object
_links
Required

HATEOAS of the entity

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 6801 and UTC.

object
customProperties
Optional

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

string
dcid
Optional

Identifier of a data collector vm deployed in the on premise infrastructure.

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.

string
username
Required

Username to authenticate with the cloud account


400

Invalid Request - bad data

Operation doesn't return any data structure

403

Forbidden

Operation doesn't return any data structure