REST API - repoint

vcenter system config psc registration: repoint

Repoint this vCenter Server appliance to a different external PSC. This operation was added in vSphere API 6.7

Request:

HTTP request

POST https://{server}/rest/vcenter/system-config/psc-registration

Request Body Structure:

JSON

{
    "spec": {
        "https_port": 1,
        "psc_hostname": "string",
        "ssl_thumbprint": "string",
        "ssl_verify": true,
        "sso_admin_password": "string"
    }
}

Request Body Parameters:

Name	Type	Description
bold = required
spec	remote_psc_spec	RemotePscSpec structure containing information about the external PSC node to repoint this vCenter Server appliance to.
spec.psc_hostname	string	The IP address or DNS resolvable name of the remote PSC to which this configuring vCenter Server will be registered to. This attribute was added in vSphere API 6.7
spec.https_port	long	The HTTPS port of the external PSC appliance. This attribute was added in vSphere API 6.7 Optional. If unset, port 443 will be used.
spec.sso_admin_password	string	The SSO administrator account password. This attribute was added in vSphere API 6.7
spec.ssl_thumbprint	string	SHA1 thumbprint of the server SSL certificate will be used for verification when ssl_verify field is set to true. This attribute was added in vSphere API 6.7 Optional. This field is only relevant if `ssl_verify` is unset or has the value true.
spec.ssl_verify	boolean	SSL verification should be enabled or disabled. If `ssl_verify` is true and and `ssl_thumbprint` is unset, the CA certificate will be used for verification. If `ssl_verify` is true and `ssl_thumbprint` is set then the thumbprint will be used for verification. No verification will be performed if `ssl_verify` value is set to false. This attribute was added in vSphere API 6.7 Optional. If unset, `ssl_verify` true will be used.

Response:

HTTP Status Code: 200

None

Errors:

HTTP Status Code	Type	Description
401	unauthenticated	if the caller is not authenticated.
400	invalid_argument	if the passed external PSC is not a replicating with the current PSC this appliance is registered with.
400	unsupported	if the current appliance is not of the type VCSA_EXTERNAL.
400	not_allowed_in_current_state	if the appliance is NOT in CONFIGURED state.