Your Amazon account ID and its alias - Amazon Identity and Access Management
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.

Your Amazon account ID and its alias

To sign in to an Amazon account as an IAM user, you must have an account alias or an account ID for the Amazon account. If you are signed in to the Amazon Web Services Management Console or have configured the Amazon CLI or an Amazon SDK with your account credentials, you can find the account alias or account ID for the Amazon account. If you cannot sign in, ask your administrator for the information that you need to sign in.

Note

Account aliases are not secrets, and they will appear in your public-facing sign-in page URL. Do not include any sensitive information in your account alias.

Finding your Amazon account ID

You can find the account ID for your Amazon account using the following methods.

Finding Your Account ID using the console

In the navigation bar, choose Support, and then Support Center. Your currently signed-in 12-digit account number (ID) appears in the Support Center navigation pane.

Finding Your Account ID using the Amazon CLI

Use the following command to view your user ID, account ID, and your user ARN:

Finding Your Account ID using the API

Use the following API to view your user ID, account ID, and your user ARN:

About account aliases

If you want the URL for your sign-in page to contain your company name (or other friendly identifier) instead of your Amazon account ID, you can create an account alias. This section provides information about Amazon account aliases and lists the API operations that you use to create an alias.

Your sign-in page URL has the following format, by default.

https://Your_Account_ID.signin.amazonaws.cn/console/

If you create an Amazon account alias for your Amazon account ID, your sign-in page URL looks like the following example.

https://Your_Account_Alias.signin.amazonaws.cn/console/

The original URL containing your Amazon account ID remains active and can be used after you create your Amazon account alias.

Tip

To create a bookmark for your account sign-in page in your web browser, you should manually type the sign-in URL in the bookmark entry. Don't use your web browser's "bookmark this page" feature.

Creating, deleting, and listing an Amazon account alias

You can use the Amazon Web Services Management Console, the IAM API, or the command line interface to create or delete your Amazon account alias.

Considerations

  • Your Amazon account can have only one alias. If you create a new alias for your Amazon account, the new alias overwrites the previous alias, and the URL containing the previous alias stops working.

  • The account alias must be unique across all Amazon Web Services products. It must contain only digits, lowercase letters, and hyphens. For more information on limitations on Amazon account entities, see IAM and Amazon STS quotas, name requirements, and character limits.

Creating, editing, and deleting aliases (console)

You can create, edit, and delete an account alias from the Amazon Web Services Management Console.

To create, edit, or remove an account alias (console)

  1. Sign in to the Amazon Web Services Management Console and open the IAM console at https://console.amazonaws.cn/iam/.

  2. In the navigation pane, choose Dashboard.

  3. In the Amazon Account section, find Account Alias, and choose Create. If an alias already exists, then choose Edit.

  4. Type the name you want to use for your alias, then choose Save changes.

  5. To remove the alias, next to Account Alias choose Delete, and then choose Delete. The sign-in URL reverts to using your Amazon account ID.

Creating, deleting, and listing aliases (Amazon CLI)

To create an alias for your Amazon Web Services Management Console sign-in page URL, run the following command:

To delete an Amazon account ID alias, run the following command:

To display your Amazon account ID alias, run the following command:

Creating, deleting, and listing aliases (Amazon API)

To create an alias for your Amazon Web Services Management Console sign-in page URL, call the following operation:

To delete an Amazon account ID alias, call the following operation:

To display your Amazon account ID alias, call the following operation: