REST API - repoint
  1. Operations
  2. vcenter
  3. system config
  4. psc registration

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:

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

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.