

# Gerenciar configurações de conta do Amazon ECS usando o AWS CLI
<a name="account-setting-management-cli"></a>

É possível gerenciar suas configurações de conta usando a API do Amazon ECS, a AWS CLI ou os SDKs. As configurações da conta `dualStackIPv6`, `fargateFIPSMode`, `fargateTaskRetirementWaitPeriod` e `fargateEventWindows` só podem ser visualizadas ou alteradas por meio dessas ferramentas.

**nota**  
É possível usar endpoints de serviço de pilha dupla para interagir com o Amazon ECS via AWS CLI, SDKs e API do Amazon ECS sobre IPv4 e IPv6. Para obter mais informações, consulte [Usar endpoints de pilha dupla do Amazon ECS](dual-stack-endpoint.md).

Para obter informações sobre as ações de API disponíveis para definições de tarefa, consulte [Ações de configuração de conta](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/OperationList-query-account.html) na *Referência de API do Amazon Elastic Container Service*.

Use um dos comando a seguir para modificar a configuração de conta padrão para todos os usuários ou funções do na sua conta. Essas alterações se aplicarão a toda a conta da AWS, a menos que o usuário ou o perfil cancele explicitamente essas configurações por conta própria.
+ [put-account-setting-default](https://docs.aws.amazon.com/cli/latest/reference/ecs/put-account-setting-default.html) (AWS CLI)

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

  Você também pode usar esse comando para modificar outras configurações de conta. Para fazer isso, substitua o parâmetro `name` pela configuração de conta correspondente.
+ [Write-ECSAccountSetting](https://docs.aws.amazon.com/powershell/latest/reference/items/Write-ECSAccountSetting.html) (AWS Tools for Windows PowerShell)

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

**Para modificar as configurações da sua conta de usuário (AWS CLI)**

Use um dos comandos a seguir para modificar configurações de conta para o seu usuário do . Se você estiver usando esses comandos como o usuário raiz, as alterações se aplicarão a toda a conta da AWS, a menos que um usuário ou um perfil cancele explicitamente essas configurações por conta própria.
+ [put-account-setting](https://docs.aws.amazon.com/cli/latest/reference/ecs/put-account-setting.html) (AWS CLI)

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

  Você também pode usar esse comando para modificar outras configurações de conta. Para fazer isso, substitua o parâmetro `name` pela configuração de conta correspondente.
+ [Write-ECSAccountSetting](https://docs.aws.amazon.com/powershell/latest/reference/items/Write-ECSAccountSetting.html) (AWS Tools for Windows PowerShell)

  ```
  Write-ECSAccountSetting -Name serviceLongArnFormat -Value enabled -Force
  ```

**Para modificar as configurações de conta para um usuário ou perfil específico (AWS CLI)**

Use um dos comandos a seguir e especifique o ARN de um usuário, perfil ou usuário raiz na solicitação para modificar as configurações de conta para um usuário ou perfil específico.
+ [put-account-setting](https://docs.aws.amazon.com/cli/latest/reference/ecs/put-account-setting.html) (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
  ```

  Você também pode usar esse comando para modificar outras configurações de conta. Para fazer isso, substitua o parâmetro `name` pela configuração de conta correspondente.
+ [Write-ECSAccountSetting](https://docs.aws.amazon.com/powershell/latest/reference/items/Write-ECSAccountSetting.html) (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
  ```