[{"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

Update Proxy

Description

Update a specific proxy.

Request

Request

URL

URL


put
https://{api_host}/cloudapi/1.0.0/proxies/{id}
Copy

Path Parameters

Path Parameters

string
id Required

Proxy ID URN


Request Body

Request Body

Proxy of type(s) application/json Required

The updated proxy model.

{
    "name": "Proxy Sample Name",
    "targetHost": "sampleVc.vmware.com"
}
string
proxyType Required

Possible values are: VCSSONSXESXGENERIC


string
targetHost Required

IP address or FQDN of the host being proxied. Lower case formatting will be applied to the value of the property. This is not editable once the proxy has been created.


string as .*[\S].*
name Required

parent Required

The EntityReference of the parent entity (e.g. vCenter Server, SDDC) . This is not editable once the proxy has been created.


string
id Optional

parentProxy Optional

The EntityReference of the parent proxy. If a proxy has a parent, the proxy is activated along with its parent and shares the token with its parent. Each proxy may only have one parent. A parent proxy cannot have a parent of its own.


boolean
active Optional

True if the proxy is currently active for the user session associated with the request made to get the proxy. An inactive proxy cannot be used.


boolean
enabled Optional

True if the proxy is enabled. Proxy can only be enabled/disabled by privileged users. A disabled proxy cannot be activated and thus, cannot be used. When a proxy is disabled, all active sessions are terminated.


boolean
tenantVisible Optional

Whether this proxy has been published to tenants.


string
token Optional

The generated read-only token that should be used as the password when using this proxy. To generate a new token, activate the proxy. The token is tied to the user session that activated the proxy. If the proxy is inactive, this value will be null.


string as uri
uiUrl Optional

The URL of the proxied component’s UI endpoint. This is the URL that the browser tab will be pointed to when the proxy is launched via the H5 UI of VCD.

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns Proxy of type(s) application/json;version=36.3
{
    "name": "Proxy Sample Name",
    "targetHost": "sampleVc.vmware.com",
    "uiUrl": "https://sampleVc.vmware.com"
}
string
proxyType Required

Possible values are: VCSSONSXESXGENERIC


string
targetHost Required

IP address or FQDN of the host being proxied. Lower case formatting will be applied to the value of the property. This is not editable once the proxy has been created.


string as .*[\S].*
name Required

parent Required

The EntityReference of the parent entity (e.g. vCenter Server, SDDC) . This is not editable once the proxy has been created.


string
id Optional

parentProxy Optional

The EntityReference of the parent proxy. If a proxy has a parent, the proxy is activated along with its parent and shares the token with its parent. Each proxy may only have one parent. A parent proxy cannot have a parent of its own.


boolean
active Optional

True if the proxy is currently active for the user session associated with the request made to get the proxy. An inactive proxy cannot be used.


boolean
enabled Optional

True if the proxy is enabled. Proxy can only be enabled/disabled by privileged users. A disabled proxy cannot be activated and thus, cannot be used. When a proxy is disabled, all active sessions are terminated.


boolean
tenantVisible Optional

Whether this proxy has been published to tenants.


string
token Optional

The generated read-only token that should be used as the password when using this proxy. To generate a new token, activate the proxy. The token is tied to the user session that activated the proxy. If the proxy is inactive, this value will be null.


string as uri
uiUrl Optional

The URL of the proxied component’s UI endpoint. This is the URL that the browser tab will be pointed to when the proxy is launched via the H5 UI of VCD.

No error details were provided in the OpenAPI specification.

Code Samples

Code Samples

cURL Command

curl -X PUT -H "Content-Type: application/json" -d '{"name":"Proxy Sample Name","targetHost":"sampleVc.vmware.com","uiUrl":"https://sampleVc.vmware.com"}' https://{api_host}/cloudapi/1.0.0/proxies/{id}


[{"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
Feedback

Was this page helpful?