Skip to main content

account_properties

Creates, updates, deletes, gets or lists an account_properties resource.

Overview

Nameaccount_properties
TypeResource
Idaws.iam.account_properties

Fields

The following fields are returned by SELECT queries:

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

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_account_propertiesselectregionRetrieves the account-level properties for the caller's Amazon Web Services 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.
put_account_propertiesreplaceregionPropertiesSets account-level properties for the caller's Amazon Web Services account. Account properties are configuration settings that control account-wide IAM features such as Role Manager. Specify properties as key-value pairs in Namespace/PropertyName format. All properties in a single request must belong to the same namespace. Use GetAccountProperties to view the current properties.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
PropertiesobjectA map of property key-value pairs to set. All keys must belong to the same namespace. Each key uses the format Namespace/PropertyName. The key must contain exactly one / separating the namespace from the property name, and cannot start or end with /. The service validates each value based on the property key's expected type. For example, boolean properties expect true or false.

SELECT examples

Retrieves the account-level properties for the caller's Amazon Web Services 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.

SELECT
properties
FROM aws.iam.account_properties
WHERE region = '{{ region }}' -- required
;

REPLACE examples

Sets account-level properties for the caller's Amazon Web Services account. Account properties are configuration settings that control account-wide IAM features such as Role Manager. Specify properties as key-value pairs in Namespace/PropertyName format. All properties in a single request must belong to the same namespace. Use GetAccountProperties to view the current properties.

REPLACE aws.iam.account_properties
SET
-- No updatable properties
WHERE
region = '{{ region }}' --required
AND Properties = '{{ Properties}}';