[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director

Create Interface

Description

Creates a defined interface. The version must follow semantic versioning rules.

Request

Request

URL

URL


post
https://{api_host}/cloudapi/1.0.0/interfaces
Copy

Request Body

Request Body

DefinedInterface of type(s) application/json Required
{
    "id": "urn:vcloud:interface:vmware.sddc:1.0.0",
    "name": "SDDC Interface",
    "nss": "myCustomEntity",
    "readonly": false,
    "vendor": "vmware",
    "version": "1.0.0"
}
string
id Optional

string
name Optional

string
nss Optional

A unique namespace associated with the interface.


boolean
readonly Optional

True if the entity type cannot be modified.


string
vendor Optional

The vendor name.


string
version Optional

The interface’s version. The version should follow semantic versioning rules.

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

201 Created

Returns DefinedInterface of type(s) application/json;version=36.3
{
    "id": "urn:vcloud:interface:vmware.sddc:1.0.0",
    "name": "SDDC Interface",
    "nss": "myCustomEntity",
    "readonly": false,
    "vendor": "vmware",
    "version": "1.0.0"
}
string
id Optional

string
name Optional

string
nss Optional

A unique namespace associated with the interface.


boolean
readonly Optional

True if the entity type cannot be modified.


string
vendor Optional

The vendor name.


string
version Optional

The interface’s version. The version should follow semantic versioning rules.

No error details were provided in the OpenAPI specification.

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"id":"urn:vcloud:interface:vmware.sddc:1.0.0","name":"SDDC Interface","nss":"myCustomEntity","readonly":false,"vendor":"vmware","version":"1.0.0"}' https://{api_host}/cloudapi/1.0.0/interfaces


[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director
Availability
Added in 35.0
Defined Interface Operations
Feedback

Was this page helpful?