REST API - get
  1. Operations
  2. vcenter
  3. trust
  4. vc trusts

vcenter trust vc trusts: get

Retrieve trust for given domain. Warning: This operation is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Request:

HTTP request

GET https://{server}/rest/vcenter/trust/vc-trusts/{domain}

Path Parameters

Name Type Description
Required
domain string Unique identifier for a domain.

Response:

HTTP Status Code: 200

Representation:

{
    "value" : {
        "label" : "string",
        "signing_cert_chains" : [
            {
                "cert_chain" : [
                    "string",
                    "string"
                ]
            },
            {
                "cert_chain" : [
                    "string",
                    "string"
                ]
            }
        ],
        "upn_suffixes" : [
            "string",
            "string"
        ],
        "type" : "string",
        "group_map" : [
            {
                "value" : [
                    "string",
                    "string"
                ],
                "key" : "string"
            }
        ]
    }
}

Response Type:

Name Type Description
bold = required
value info Trust information.
value.label string Label of the trust. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.
value.type string Type of trust. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.
value.signing_cert_chains x509_cert_chain[] List of signing certificate chains. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.
value.signing_cert_chains[].cert_chain string[] Certificate chain in base64 format. This attribute was added in vSphere API 6.7.2.
value.group_map list Mapping of group in existing token to a list of local SSO groups in the local domain for new token. If empty, no group mappings have been configured. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

List of {"key": string, "value": string[]}
value.upn_suffixes string[] Lists the UPN suffixes used in this trust relationship. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Errors:

HTTP Status Code Type Description
403 unauthorized if authorization is not given to caller.
404 not_found if a trust does not exist for given domain.