View a markdown version of this page

Actions, resources, and condition keys for Amazon Account Management - Service Authorization Reference
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Actions, resources, and condition keys for Amazon Account Management

Amazon Account Management (service prefix: account) provides the following service-specific operations, resources, actions, and condition keys for use in IAM permission policies.

References:

API operations defined by Amazon Account Management

The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.

Operation IAM action Condition key Possible value(s) Access level

AcceptPrimaryEmailUpdate

account:AcceptPrimaryEmailUpdate

Write

DeleteAlternateContact

account:DeleteAlternateContact

Write

DisableRegion

account:DisableRegion

Write

EnableRegion

account:EnableRegion

Write

GetAccountInformation

account:GetAccountInformation

Read

GetAlternateContact

account:GetAlternateContact

Read

GetContactInformation

account:GetContactInformation

Read

GetGovCloudAccountInformation

account:GetGovCloudAccountInformation

Read

GetPrimaryEmail

account:GetPrimaryEmail

Read

GetRegionOptStatus

account:GetRegionOptStatus

Read

ListRegions

account:ListRegions

List

PutAccountName

account:PutAccountName

Write

iam:UpdateAccountName

Write

PutAlternateContact

account:PutAlternateContact

Write

PutContactInformation

account:PutContactInformation

Write

StartPrimaryEmailUpdate

account:StartPrimaryEmailUpdate

Write

Actions defined by Amazon Account Management

You can specify the following actions in the Action element of an IAM policy statement. Use policies to grant permissions to perform an operation in Amazon. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions.

Actions Description Resource types (*required) Condition keys Access level

AcceptPrimaryEmailUpdate

Grants permission to accept the process to update the primary email address of an account

accountInOrganization

account:EmailTargetDomain

Write

DeleteAlternateContact

Grants permission to delete the alternate contacts for an account

account

account:AlternateContactTypes

Write

accountInOrganization

account:AlternateContactTypes

DisableRegion

Grants permission to disable use of a Region

account

account:TargetRegion

Write

accountInOrganization

account:TargetRegion

EnableRegion

Grants permission to enable use of a Region

account

account:TargetRegion

Write

accountInOrganization

account:TargetRegion

GetAccountInformation

Grants permission to retrieve the account information for an account

account

Read

accountInOrganization

GetAlternateContact

Grants permission to retrieve the alternate contacts for an account

account

account:AlternateContactTypes

Read

accountInOrganization

account:AlternateContactTypes

GetContactInformation

Grants permission to retrieve the primary contact information for an account

account

Read

accountInOrganization

GetGovCloudAccountInformation

Grants permission to retrieve the linked GovCloud account information for an account

account

Read

accountInOrganization

GetPrimaryEmail

Grants permission to retrieve the primary email address of an account

accountInOrganization

Read

GetRegionOptStatus

Grants permission to get the opt-in status of a Region

account

account:TargetRegion

Read

accountInOrganization

account:TargetRegion

ListRegions

Grants permission to list the available Regions

account

List

accountInOrganization

PutAccountName

Grants permission to update the name for an account

account

Write

accountInOrganization

PutAlternateContact

Grants permission to modify the alternate contacts for an account

account

account:AlternateContactTypes

Write

accountInOrganization

account:AlternateContactTypes

PutContactInformation

Grants permission to update the primary contact information for an account

account

Write

accountInOrganization

StartPrimaryEmailUpdate

Grants permission to start the process to update the primary email address of an account

accountInOrganization

account:EmailTargetDomain

Write

Permission-only actions for Amazon Account Management

The following actions are defined by Amazon Account Management but are not directly invocable through any API operation. They can only be used in IAM policy statements to grant or deny permissions.

Actions Description Resource types (*required) Condition keys Access level

CloseAccount

Grants permission to close an account

account

Write

Resource types defined by Amazon Account Management

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements.

Resource types ARN Condition keys

account

arn:${Partition}:account::${Account}:account

accountInOrganization

arn:${Partition}:account::${ManagementAccountId}:account/o-${OrganizationId}/${MemberAccountId}

Condition keys for Amazon Account Management

Amazon Account Management defines the following condition keys that can be used in the Condition element of an IAM policy.

Condition keys Description Type

account:AccountResourceOrgPaths

Filters access by the resource path for an account in an organization

ArrayOfString

account:AccountResourceOrgTags/${TagKey}

Filters access by resource tags for an account in an organization

String

account:AlternateContactTypes

Filters access by alternate contact types

ArrayOfString

account:EmailTargetDomain

Filters access by email domain of the target email address

String

account:TargetRegion

Filters access by a list of Regions. Enables or disables all the Regions specified here

String