Config Vcd

Config Vcd

This request configures the service to use the given VMware Cloud Director's API endpoint.

Request
URI
POST
https://{api_host}/config/vcloud
COPY
Header Parameters
string
operationID
Optional

Operation ID for correlating logs across multiple services

Request Body

VMware Cloud Director configuration request.

ConfigureVcdRequest of type(s) application/json
Required 
{
    "vcdPassword": "somepassword",
    "vcdThumbprint": "SHA-256:D3:A3:4B:1F:B6:42:AB:F9:D6:FF:D5:AB:F4:14:9F:B5:F8:3B:E7:42:09:53:2D:6E:28:32:28:CE:B3:CB:DB:2A",
    "vcdUrl": "https://vcdaddr:443/api",
    "vcdUsername": "root@System"
}
string
vcdPassword
Optional

The VMware Cloud Director system account password.

string
vcdThumbprint
Optional

The thumbprint of the VMware Cloud Director API endpoint. When present, the certificate of VMware Cloud Director will be trusted if its thumbprint matches the thumbprint given here. When omitted, full certificate verification is performed when connecting to VMware Cloud Director.

string
vcdUrl
Optional

The URL API endpoint of the VMware Cloud Director.

string
vcdUsername
Optional

The VMware Cloud Director system account username.

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns CloudConfigResponse of type(s) application/json;charset=UTF-8
This response body class contains all of the following: ConfigResponse 
{
    "id": "3b0f0539-869d-4e37-8005-e1c6f01a2ef3",
    "lsUrl": "https://s2-vcav-v1248-252-234.eng.vmware.com:443/lookupservice/sdk",
    "lsThumbprint": "SHA-256:8F:96:C8:A4:59:75:42:CE:6B:5E:E2:7A:D5:CF:05:E5:FB:39:89:C2:A5:6C:0E:92:D7:AF:6C:F7:38:E3:8C:E4",
    "localSite": "site1",
    "localSiteDescription": "site1 descirption",
    "vcdUrl": "https://vcdaddr:443/api",
    "vcdThumbprint": "SHA-256:D3:A3:4B:1F:B6:42:AB:F9:D6:FF:D5:AB:F4:14:9F:B5:F8:3B:E7:42:09:53:2D:6E:28:32:28:CE:B3:CB:DB:2A",
    "vcdUsername": "root@System",
    "isCombined": false
}
boolean
isCombined
Optional

Indicates whether the appliance was deployed in the 'combined' role.

string
localSite
Optional

Site name of the site this Cloud Service is running on.

string
localSiteDescription
Optional

Description of the site this Cloud Service is running on.

string
vcdThumbprint
Optional

The thumbprint of the VMware Cloud Director API endpoint.

string
vcdUrl
Optional

The URL API endpoint of the VMware Cloud Director.

string
vcdUsername
Optional

The VMware Cloud Director system account username.


401

The returned error codes include (but are not limited to): NotAuthenticated

Returns ApiError of type(s) application/vnd.vmware.h4-v4.7+json;charset=UTF-8 
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.


500

The returned error codes include (but are not limited to): GeneralServerFailure

Returns ApiError of type(s) application/vnd.vmware.h4-v4.7+json;charset=UTF-8 
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.


On This Page
Configs Operations
POST
Change Root Password
GET
Check Root Password Expiration
GET
Config Is Configured
POST
Config Site
POST
Config Vcd
GET
Configure Get
GET
Configure Get Endpoints
POST
Configure Set Lookup Service
POST
Configure Update Endpoints