Modifying account settings - Amazon Elastic Container Service
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.

Modifying account settings

You can use the Amazon Web Services Management Console and Amazon CLI tools to modify your account settings.

To modify account settings (Console)

  1. Open the Amazon ECS console at https://console.amazonaws.cn/ecs/.

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

  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 after it's 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 (Amazon 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 Amazon Web Services account unless an IAM user or role explicitly overrides these settings for themselves.

  • put-account-setting-default (Amazon 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 (Amazon 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 (Amazon 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 Amazon Web Services account unless an IAM user or role explicitly overrides these settings for themselves.

  • put-account-setting (Amazon 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 (Amazon Tools for Windows PowerShell)

    Write-ECSAccountSetting -Name serviceLongArnFormat -Value enabled -Force

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

Use one of the following commands and specify the Amazon Resource Name (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 (Amazon 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 (Amazon Tools for Windows PowerShell)

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