Skip to content

Account Management

Account service provides APIs to manage your AWS account. You can use the Account APIs to retrieve information about your account, manage your contact information and alternate contacts. Additionally, you can use the Account APIs to enable or disable a region for your account, and delete alternate contacts in your account.

LocalStack allows you to use the Account API to retrieve information about your account. The supported APIs are available on our API Coverage section, which provides information on the extent of Account’s integration with LocalStack.

This guide is designed for users who are new to Account and assumes basic knowledge of the AWS CLI and our awslocal wrapper script.

Start your LocalStack container using your preferred method. We will demonstrate how to put contact information, fetch account details, and attach an alternate contact to your account.

You can use the PutContactInformation API to add or update the contact information for your AWS account. Run the following command to add contact information to your account:

Terminal window
awslocal account put-contact-information \
--contact-information '{
"FullName": "Jane Doe",
"PhoneNumber": "+XXXXXXXXX",
"AddressLine1": "XXXX Main St",
"City": "XXXX",
"PostalCode": "XXXXX",
"CountryCode": "US",
"StateOrRegion": "WA"
}'

You can use the GetContactInformation API to retrieve the contact information for your AWS account. Run the following command to fetch the contact information for your account:

Terminal window
awslocal account get-contact-information
Output
{
"ContactInformation": {
"AddressLine1": "XXXX Main St",
"City": "XXXX",
"CountryCode": "US",
"FullName": "Jane Doe",
"PhoneNumber": "+XXXXXXXXX",
"PostalCode": "XXXXX",
"StateOrRegion": "WA"
}
}

You can attach an alternate contact using PutAlternateContact API. Run the following command to attach an alternate contact to your account:

Terminal window
awslocal account put-alternate-contact \
--alternate-contact-type "BILLING" \
--email-address "bill@ing.com" \
--name "Bill Ing" \
--phone-number "+1 555-555-5555" \
--title "Billing"

The LocalStack Web Application provides a Resource Browser for managing contact information & alternate accounts for the Account service. You can access the Resource Browser by opening the LocalStack Web Application in your browser, navigating to the Resources section, and then clicking on Account under the Management & Governance section.

Account Resource Browser

The Resource Browser allows you to perform the following actions:

  • Create Contact Information: Add the contact information for your mocked AWS account by clicking on the Create button in the contact information section.
  • Create Alternate Contact: Add an alternate contact for your mocked AWS account by clicking on the Create button in the alternate contacts section.
  • View Contact Information: View the contact information for your mocked AWS account by clicking on the contact information.
  • Update Contact Information: Update the contact information for your mocked AWS account by clicking on the contact information.
  • Filter: Filter the contact information and alternate contacts by types, such as BILLING, OPERATIONS, and SECURITY.
OperationImplementedImage
Page 1 of 0