Modifying account settings

You can use the AWS Management Console and AWS CLI tools to modify your account settings.

To modify account settings (Console)

1. Open the Amazon ECS console at https://console.aws.amazon.com/ecs/.

2. In the navigation bar at the top of the screen, select the Region for which to modify your account settings.

3. From the dashboard, choose Account Settings.

4. On the Amazon ECS ARN and resource ID settings, AWSVPC Trunking, and CloudWatch Container Insights sections, you can select or deselect the check boxes for each account setting for the authenticated IAM user and role. Choose Save once finished.

   Important

   IAM users and IAM roles need the ecs:PutAccountSetting permission to perform this action.

5. On the confirmation screen, choose Confirm to save the selection.

To modify the default account settings for all IAM users or roles on your account (AWS CLI)

Use one of the following commands to modify the default account setting for all IAM users or roles on your account. These changes apply to the entire AWS account unless an IAM user or role explicitly overrides these settings for themselves.

• put-account-setting-default (AWS CLI)

  aws ecs put-account-setting-default --name serviceLongArnFormat --value enabled --region us-east-2

  You can also use this command to modify other account settings. To do this, replace the name parameter with the corresponding account setting.

• Write-ECSAccountSetting (AWS Tools for Windows PowerShell)

  Write-ECSAccountSettingDefault -Name serviceLongArnFormat -Value enabled -Region us-east-1 -Force

To modify the account settings for your IAM user account (AWS CLI)

Use one of the following commands to modify the account settings for your IAM user. If you’re using these commands as the root user, changes apply to the entire AWS account unless an IAM user or role explicitly overrides these settings for themselves.

• put-account-setting (AWS CLI)

  aws ecs put-account-setting --name serviceLongArnFormat --value enabled --region us-east-1

  You can also use this command to modify other account settings. To do this, replace the name parameter with the corresponding account setting.

• Write-ECSAccountSetting (AWS Tools for Windows PowerShell)

  Write-ECSAccountSetting -Name serviceLongArnFormat -Value enabled -Force

To modify the account settings for a specific IAM user or IAM role (AWS CLI)

Use one of the following commands and specify the ARN of an IAM user, IAM role, or root user in the request to modify the account settings for a specific IAM user or IAM role.

• put-account-setting (AWS CLI)

  aws ecs put-account-setting --name serviceLongArnFormat --value enabled --principal-arn arn:aws:iam::aws_account_id:user/principalName --region us-east-1

  You can also use this command to modify other account settings. To do this, replace the name parameter with the corresponding account setting.

• Write-ECSAccountSetting (AWS Tools for Windows PowerShell)

  Write-ECSAccountSetting -Name serviceLongArnFormat -Value enabled -PrincipalArn arn:aws:iam::aws_account_id:user/principalName -Region us-east-1 -Force