View a markdown version of this page

GetAccountProperties - AWS Identity and Access Management

GetAccountProperties

Retrieves the account-level properties for the caller's AWS account. Account properties are configuration settings that control account-wide IAM features such as Role Manager.

The service returns properties as key-value pairs in Namespace/PropertyName format. Each namespace groups related configuration settings. Use PutAccountProperties to modify these properties.

Response Elements

The following element is returned by the service.

Properties
Properties.entry.N.key (key)
Properties.entry.N.value (value)

A map of account property key-value pairs. Keys are in the format Namespace/PropertyName.

Type: String to string map

Key Length Constraints: Minimum length of 1. Maximum length of 50.

Key Pattern: ^[A-Za-z][A-Za-z0-9/_-]*$

Value Length Constraints: Minimum length of 1. Maximum length of 1024.

Errors

For information about the errors that are common to all actions, see Common Error Types.

InvalidInput

The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

HTTP Status Code: 400

ServiceFailure

The request processing has failed because of an unknown error, exception or failure.

HTTP Status Code: 500

Examples

Retrieve account properties

This example retrieves all account-level properties for the calling account.

Sample Request

https://iam.amazonaws.com/?Action=GetAccountProperties &Version=2010-05-08 &AUTHPARAMS

Sample Response

<GetAccountPropertiesResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/"> <GetAccountPropertiesResult> <Properties> <entry> <key>RoleManager/Enabled</key> <value>true</value> </entry> </Properties> </GetAccountPropertiesResult> <ResponseMetadata> <RequestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</RequestId> </ResponseMetadata> </GetAccountPropertiesResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: