Create Vcd Instance

Create Vcd Instance

Create a new VCD instance.

This API is available to provider admins.

Request
URI
POST
https://{environmentid}.cloud.vmware.com//environment/{environmentId}/instances
COPY
Path Parameters
string
environmentId
Required

URN ID of an Environment

Request Body
VcdInstance of type(s) application/json
Required 
{
    "id": "string",
    "name": "string",
    "ownerId": "string",
    "environmentId": "string",
    "password": "string",
    "domain": "string",
    "publicCertificate": "string",
    "activeTask": {
        "id": "string",
        "name": "string",
        "entityId": "string",
        "entityName": "string",
        "ownerId": "string",
        "userId": "string",
        "steps": "string",
        "status": "string",
        "startTime": "string",
        "endTime": "string",
        "queuedTime": "string",
        "message": "string",
        "isolation": "string",
        "output": {
            "providerAdminUsername": "administrator",
            "providerAdminPassword": "mysecretpassword"
        },
        "activity": "string"
    },
    "environment": {
        "name": "name",
        "location": "us-west-2",
        "id": "id",
        "url": "url"
    },
    "environmentSettings": [
        {
            "id": "string",
            "name": "string",
            "type": "string",
            "subType": "string"
        }
    ],
    "statistics": [
        {
            "type": "string",
            "value": "number",
            "max": "number"
        }
    ],
    "upgradeAfter": "string",
    "upgradeCategory": "string",
    "oauthClientId": "string"
}
string
id
Optional

URN ID of vCD instance. This is immutable.

string
name
Optional

Name of vCD instance.

string
ownerId
Optional

URN ID of the organization for this task.

string
environmentId
Optional

URN ID of environment. This is immutable.

string As password As ((?=.*[a-z])(?=.*\d)(?=.*[ !#$%&\(\)*+,-./:;<=>?@\[\\\]^_`{\|}~])(?=.*[A-Z]).{6,128})
password
Optional

Provider administrator password for vCD instance. Password must follow the following rules:

  1. At least one lowercase letter.
  2. At least one digit i.e. 0-9.
  3. At least one special character
  4. At least one capital letter.
  5. Minimum 6 letters to maximum 128 This value is input only, the password cannot be retrieved via the API.
string As ^$|^((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}$
domain
Optional

The public domain of the instance (e.g. vcd.acme.example).

object
instanceParams
Optional

Free-form configuration object.

string
publicCertificate
Optional

Base64 encoded public certificate associated with this instance.

Task
activeTask
Optional

activeTask

Environment
environment
Optional

environment

array of VcdInstanceResource
environmentSettings
Optional

environmentSettings

array of VcdInstanceStatistic
statistics
Optional

statistics

string As date-time As date-time
upgradeAfter
Optional

Date which upgrade should be performed after

string
upgradeCategory
Optional

Category that defines the upgrade strategy

string
oauthClientId
Optional

ID of Oauth Client used by the instance's system org. Null if the instance's system org hasn't been integrated with CSP.

Authentication
This operation uses the following authentication methods.
Responses
202

Accepted

Returns Task of type(s) application/json 
{
    "id": "string",
    "name": "string",
    "entityId": "string",
    "entityName": "string",
    "ownerId": "string",
    "userId": "string",
    "steps": "string",
    "status": "string",
    "startTime": "string",
    "endTime": "string",
    "queuedTime": "string",
    "message": "string",
    "isolation": "string",
    "output": {
        "providerAdminUsername": "administrator",
        "providerAdminPassword": "mysecretpassword"
    },
    "activity": "string"
}
string
id
Optional

URN ID of task

string
name
Optional

name of task.

string
entityId
Optional

URN ID of entity for which task is created.

string
entityName
Optional

Name of the entity at the time the task was created.

string
ownerId
Optional

URN ID of the organization for this task.

string
userId
Optional

Username of the user who initiated the task.

string
steps
Optional

represents current_running_step/total_steps by this task.

string
status
Optional

Describe current status of task.

Possible values are : SUCCESS, FAILED, IN_PROGRESS,
string As date-time As date-time
startTime
Optional

Start time for task.

string As date-time As date-time
endTime
Optional

Finish time for task

string As date-time As date-time
queuedTime
Optional

The time the initial request for the task was queued.

string
message
Optional

Progress or error messages.

string
isolation
Optional

isolation

Possible values are : ENTITY_EXCLUSIVE, NONE,
object
output
Optional

Free-form configuration object.

string
activity
Optional

URN of the activity that corresponds to this Task


On This Page
Instances Operations
POST
Create Vcd Instance
DELETE
Delete Vcd Instance
GET
Get Vcd Instance
GET
Get Vcd Instance Operations
POST
Invoke Operation
POST
Invoke Vcd Instance Operation
GET
List Operations
GET
Query Vcd Instances For Org
PUT
Update Vcd Instance
POST
Validate Vcd Instance Operation