Create External Endpoint

Create External Endpoint

Creates an external endpoint. Vendor, name and version cannot be modified post-creation and must be unique. Each external endpoint will proxy its' requests to the configured rootUrl.

Request
URI
POST
https://{api_host}/cloudapi/1.0.0/externalEndpoints
COPY
Request Body
ExternalEndpoint of type(s) application/json
Optional

Show optional properties

{
    "name": "string",
    "version": "1.0.0",
    "vendor": "VMware",
    "enabled": false,
    "rootUrl": "https://externalHost"
}
{
    "name": "string",
    "id": "urn:vcloud:externalEndpoint:vendor.name:1.0.0",
    "version": "1.0.0",
    "vendor": "VMware",
    "enabled": false,
    "description": "string",
    "rootUrl": "https://externalHost"
}
Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns ExternalEndpoint of type(s) application/json;version=39.1 
"ExternalEndpoint Object"
string
name
Required

The name of the external endpoint.

string
id
Optional

The unique id of the external endpoint.

string
version
Required

The external endpoint's version. The version should follow semantic versioning rules. Versions with pre-release extension are not allowed. The combination of vendor-namespace-version must be unique.

string
vendor
Required

The vendor name. The combination of vendor-namespace-version must be unique.

boolean
enabled
Required

Whether the external endpoint is enabled or not.

string
description
Optional

description

string
rootUrl
Required

The external endpoint which requests will be redirected to. The rootUrl must be a valid URL of https protocol.


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"enabled:"boolean","name:"string","rootUrl:"string","vendor:"string","version:"string"}' https://{api_host}/cloudapi/1.0.0/externalEndpoints
Availability
Added in 37.3
On This Page
External Endpoint Operations
GET
Get External Endpoints
POST
Create External Endpoint
GET
Get External Endpoint
PUT
Update External Endpoint
DELETE
Delete External Endpoint