Managing Amazon ECS account settings using the AWS CLI - Amazon Elastic Container Service

Managing Amazon ECS account settings using the AWS CLI

You can manage your account settings using the Amazon ECS API, AWS CLI or SDKs. The dualStackIPv6, fargateFIPSMode and the fargateTaskRetirementWaitPeriod account settings can only be viewed or changed using those tools.

Note

You can use dual-stack service endpoints to interact with Amazon ECS from the AWS CLI, SDKs, and the Amazon ECS API over both IPv4 and IPv6. For more information, see Using Amazon ECS dual-stack endpoints.

For information about the available API actions for task definitions see Account setting actions in the Amazon Elastic Container Service API Reference.

Use one of the following commands to modify the default account setting for all users or roles on your account. These changes apply to the entire AWS account unless a 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 user account (AWS CLI)

Use one of the following commands to modify the account settings for your user. If you’re using these commands as the root user, changes apply to the entire AWS account unless a; 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 user or role (AWS CLI)

Use one of the following commands and specify the ARN of a user, role, or root user in the request to modify the account settings for a specific user or 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