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: