GET – Account properties

Use the GET method to retrieve properties in Account resource for Redfish service.

Request URL

GET https://<BMC_IPADDR>/redfish/v1/AccountService/Accounts/{1...14}

Request body

None

Response body

Field		Type	Description
Id		String	“1” ~ ”14”
Name		String	The format is UserX (X=1~14).
Description		String	This resource is used to represent an account for the manager for a Redfish implementation.
UserName		String	The value of this property is the user name for this account.
Password		String	The password of the account. Display null on a GET.
RoleId		String	The value of this property is the ID of the role for this account.
AccountTypes		Array	This property contains an array of the various manager services that the account is allowed to access. Items: string Item count: 5
	AccountTypes[N]	String	“Redfish”, “SNMP”, “ManagerConsole”, “IPMI”, “WebUI”
AccountTypes@Redfish. AllowableValues		Array	Items: string Item count: 5
	AccountTypes@Redfish. AllowableValues[N]	String	“Redfish”, “SNMP”, “ManagerConsole”, “IPMI”, “WebUI”
Enabled		Boolean	Indicates if this account is enabled.
PasswordChangeRequired		Boolean	The value of this property is true if the password for this account must be changed before further access is allowed.
Locked		Boolean	This property indicates that the account has been auto-locked by the account service because the lockout threshold has been exceeded. When set to true, the account is locked. The account service will unlock it once the lockout duration period has passed.
HostBootstrapAccount		Boolean	Indicates whether this account is a bootstrap account for the host interface. Always set to false.
Links		Object	Expanded.
	Role	Link	Link to the Role instance which this account is mapped to.
Keys		Link	/redfish/v1/AccountService/Accounts/{X}/Keys
SNMP		Object	Expanded. This property contains the SNMP settings for this account when AccountTypes contains “SNMP”.
	AuthenticationProtocol	String	This value indicates authentication conforms to the authentication protocol.
	EncryptionKey	String	The secret authentication key for SNMPv3. Display null on a GET.
	EncryptionKeySet	Boolean	The value of this property is true if a valid value was provided for the AuthenticationKey property. Otherwise, the value is false.
	EncryptionProtocol	String	This value indicates encryption conforms to the encryption protocol.

Status code

HTTP Status Code	Error Message ID
500	InternalError

Example

The following example JSON response is returned:

{
    "@odata.context": "/redfish/v1/$metadata#ManagerAccount.ManagerAccount",
    "@odata.etag": "\"20B1B6F4\"",
    "@odata.id": "/redfish/v1/AccountService/Accounts/1",
    "@odata.type": "#ManagerAccount.v1_9_0.ManagerAccount",
    "AccountTypes": [
        "Redfish",
        "ManagerConsole",
        "WebUI"
    ],
    "AccountTypes@Redfish.AllowableValues": [
        "WebUI",
        "Redfish",
        "ManagerConsole",
        "IPMI",
        "SNMP"
    ],
    "Description": "This resource is used to represent an account                     for the manager for a Redfish implementation.",
    "Enabled": true,
    "HostBootstrapAccount": false,
    "Id": "1",
    "Keys": {
        "@odata.id": "/redfish/v1/AccountService/Accounts/1/Keys"
    },
    "Links": {
        "Role": {
            "@odata.id": "/redfish/v1/AccountService/Roles/Administrator"
        }
    },
    "Locked": false,
    "Name": "User1",
    "Oem": {
        ...
        }
    },
    "Password": null,
    "PasswordChangeRequired": false,
    "PasswordExpiration": null,
    "RoleId": "Administrator",
    "SNMP": {
        "AuthenticationProtocol": "HMAC_SHA96",
        "EncryptionKey": null,
        "EncryptionKeySet": false,
        "EncryptionProtocol": "CFB128_AES128"
    },
    "UserName": "USERID"
}

Give documentation feedback

GET – Account properties

Request URL​

Request body​

Response body​

Status code​

Example​

Request URL

Request body

Response body

Status code

Example