Appliance LocalAccounts get

Appliance LocalAccounts get

Get the local user account information.

This operation was added in vSphere API 6.7.

Request
URI
GET
https://{api_host}/api/appliance/local-accounts/{username}
COPY
Path Parameters
string
username
Required

User login name


Authentication
This operation uses the following authentication methods.
Responses
200

Local user account information

Returns Appliance LocalAccounts Info of type(s) application/json
{
    "fullname": "string",
    "email": "string",
    "roles": [
        "string"
    ],
    "enabled": false,
    "has_password": false,
    "last_password_change": "string",
    "password_expires_at": "string",
    "inactive_at": "string",
    "min_days_between_password_change": 0,
    "max_days_between_password_change": 0,
    "warn_days_before_password_expiration": 0
}
string
fullname
Optional

Full name of the user

This property was added in vSphere API 6.7.

If missing or null, the value was never set.

string
email
Optional

Email address of the local account

This property was added in vSphere API 6.7.

If missing or null, the value was never set.

array of string
roles
Required

User roles

This property was added in vSphere API 6.7.

When clients pass a value of this schema as a parameter, the property must contain identifiers for the resource type: com.vmware.appliance.roles. When operations return a value of this schema as a response, the property will contain identifiers for the resource type: com.vmware.appliance.roles.

boolean
enabled
Required

Flag indicating if the account is enabled

This property was added in vSphere API 6.7.

boolean
has_password
Required

Is the user password set.

This property was added in vSphere API 6.7.

string As date-time As date-time
last_password_change
Optional

Date and time password was changed.

This property was added in vSphere API 6.7.

If missing or null, the password was never set.

string As date-time As date-time
password_expires_at
Optional

Date when the account's password will expire

This property was added in vSphere API 6.7.

If missing or null, the password never expires.

string As date-time As date-time
inactive_at
Optional

Date and time account will be locked after password expiration.

This property was added in vSphere API 6.7.

If missing or null, account will not be locked.

integer As int64 As int64
min_days_between_password_change
Optional

Minimum number of days between password change

This property was added in vSphere API 6.7.

If missing or null, pasword can be changed any time.

integer As int64 As int64
max_days_between_password_change
Optional

Maximum number of days between password change

This property was added in vSphere API 6.7.

If missing or null, password never expires.

integer As int64 As int64
warn_days_before_password_expiration
Optional

Number of days of warning before password expires

This property was added in vSphere API 6.7.

If missing or null, a user is never warned.


404

If the account is not found

Returns Vapi Std Errors NotFound of type(s) application/json
This response body class contains all of the following: InlineVapi Std Errors NotFound0
"Vapi Std Errors NotFound Object"

500

Generic error

Returns Vapi Std Errors Error of type(s) application/json
"Vapi Std Errors Error Object"
array of object
messages
Required

Stack of one or more localizable messages for human error consumers.

The message at the top of the stack (first in the list) describes the error from the perspective of the operation the client invoked.

Each subsequent message in the stack describes the "cause" of the prior message.

object
data
Optional

Data to facilitate clients responding to the operation reporting a standard error to indicating that it was unable to complete successfully.

Operations may provide data that clients can use when responding to errors. Since the data that clients need may be specific to the context of the operation reporting the error, different operations that report the same error may provide different data in the error. The documentation for each each operation will describe what, if any, data it provides for each error it reports.

The Vapi Std Errors ArgumentLocations, Vapi Std Errors FileLocations, and Vapi Std Errors TransientIndication schemas are intended as possible values for this property. Vapi Std DynamicID may also be useful as a value for this property (although that is not its primary purpose). Some resources may provide their own specific schemas for use as the value of this property when reporting errors from their operations.

Some operations will not set this property when reporting errors.

string
error_type
Required

Discriminator field to help API consumers identify the structure type.

For more information see: Vapi Std Errors Error Type.

This property was added in vSphere API 6.7.2.

Can be missing or null for compatibility with preceding implementations.


Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/api/appliance/local-accounts/{username}