Get Principal
Returns information about the STS used by this vCenter instance. if you do not have all of the privileges described as follows: - Operation execution requires TrustedAdmin.ReadStsInfo.
Request
URLURL
https://{api_host}/api/vcenter/trusted-infrastructure/principal
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, acquired from Create Session API under CIS product
vmware-api-session-id example
"b00db39f948d13ea1e59b4d6fce56389"
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
200 OK returns
TrustedInfrastructurePrincipalInfo
of type application/json
@{link Info} a summary containing the certificates used to sign tokens and the solution user used to retrieve them.
{
"certificates": [
{
"cert_chain": [
"string"
]
}
],
"issuer": "string",
"name": "string",
"principal": {
"id": {
"domain": "string",
"name": "string"
},
"type": "STS_USER"
}
}
array of
TrustedInfrastructureX509CertChain
certificates
Required
The certificates used by the STS to sign tokens for this vCenter.
string
issuer
Required
The service which created and signed the security token.
string
name
Required
The user-friednly name of the vCenter.
principal
Required
The principal used by this vCenter instance to retrieve tokens. Currently this is the vCenter solution user.
Errors
default
‘Default’ means this response is used for all HTTP codes that are not covered individually for this operation.
Code Samples
PowerCLI Client SDK Example
Invoke-GetTrustedInfrastructurePrincipal
cURL Command
curl -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" https://{api_host}/api/vcenter/trusted-infrastructure/principal
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-vmw-doc-operation: get
Availability
Added in 7.0.0.0
