Get Principal MFA Status
Get principal MFA status.
Principal user is identified via a token. The token should be passed in a header called csp-auth-token.
Access Policy
| Role | User Accounts | Service Accounts (Client Credentials Applications) |
|---|---|---|
| All Roles | ✔️ | ❌ |
Request
Operation doesn't accept any path, query or header parameters.
URL
https://{api_host}/csp/gateway/iam/vmwid/api/principal/mfa/status
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
200 OK returns
UserMfaStatusDto of type application/json
{
"activated": false,
"deviceName": "string",
"turnedOn": false,
"username": "string"
}
boolean
activated
Optional
This property has no documentation
string
deviceName
Optional
This property has no documentation
boolean
turnedOn
Optional
This property has no documentation
string
username
Optional
This property has no documentation
Errors
Code Samples
Code Samples
cURL Command
curl https://{api_host}/csp/gateway/iam/vmwid/api/principal/mfa/status
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-required-roles: any
x-slo-tier: TIER2
