Create Defined Entity

Create Defined Entity

Creates a defined entity based on the entity type (URN).

Request
URI
POST
https://{api_host}/cloudapi/1.0.0/entityTypes/{id}
COPY
Path Parameters
string
id
Required

id

Query Parameters
string
invokeHooks
Optional

Only users with Admin FullControl access to the Entity Type can pass this parameter. The default value is 'true'.

string
resolveEntity
Optional

The default value is 'false'.

Request Body
DefinedEntity of type(s) application/json
Optional

Show optional properties

{
    "name": "vspheresddc1",
    "entity": {}
}
{
    "id": "urn:vcloud:entity:vmware.vspheresddc:1.0.0:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "entityType": "urn:vcloud:type:vmware.vspheresddc:1.0.0",
    "name": "vspheresddc1",
    "externalId": "123",
    "entity": {
        "entity": {}
    },
    "state": "string",
    "entityState": "string",
    "creationDate": "string",
    "lastModificationDate": "string",
    "owner": {
        "name": "string",
        "id": "string"
    },
    "org": {
        "name": "string",
        "id": "string"
    }
}
Authentication
This operation uses the following authentication methods.
Responses
202

The request have been accepted and the task to monitor the request is in the Location header.

Operation doesn't return any data structure

400

Invalid configuration.

Returns Error of type(s) */*;version=39.1 
"Error Object"
string
minorErrorCode
Required

minorErrorCode

string
message
Required

message

string
stackTrace
Optional

stackTrace


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"entity:"object","name:"string"}' https://{api_host}/cloudapi/1.0.0/entityTypes/{id}
Availability
Added in 35.0
On This Page
Defined Entity Type Operations
GET
Get Defined Entity Types
POST
Create Defined Entity Type
GET
Get Defined Entity Type
POST
Create Defined Entity
PUT
Update Defined Entity Type
DELETE
Delete Defined Entity Type