CreateAccountAlias
Creates an alias for your AWS account. For information about using an AWS account alias, see Creating, deleting, and listing an AWS account alias in the AWS Sign-In User Guide.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- AccountAlias
-
The account alias to create.
This parameter allows (through its regex pattern
) a string of characters consisting of lowercase letters, digits, and dashes. You cannot start or finish with a dash, nor can you have two dashes in a row. Type: String
Length Constraints: Minimum length of 3. Maximum length of 63.
Pattern:
^[a-z0-9]([a-z0-9]|-(?!-)){1,61}[a-z0-9]$
Required: Yes
Errors
For information about the errors that are common to all actions, see Common Errors.
- ConcurrentModification
-
The request was rejected because multiple requests to change this object were submitted simultaneously. Wait a few minutes and submit your request again.
HTTP Status Code: 409
- EntityAlreadyExists
-
The request was rejected because it attempted to create a resource that already exists.
HTTP Status Code: 409
- LimitExceeded
-
The request was rejected because it attempted to create resources beyond the current AWS account limits. The error message describes the limit exceeded.
HTTP Status Code: 409
- ServiceFailure
-
The request processing has failed because of an unknown error, exception or failure.
HTTP Status Code: 500
Examples
Example
This example illustrates one usage of CreateAccountAlias.
Sample Request
https://iam.amazonaws.com/?Action=CreateAccountAlias
&AccountAlias=example-corporation
&Version=2010-05-08
&AUTHPARAMS
Sample Response
<CreateAccountAliasResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/">
<ResponseMetadata>
<RequestId>36b5db08-f1b0-11df-8fbe-45274EXAMPLE</RequestId>
</ResponseMetadata>
</CreateAccountAliasResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: