As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# PutAccountName
<a name="API_PutAccountName"></a>

Atualiza o nome da conta especificada. Para usar essa API, a entidades principais do IAM devem ter a permissão `account:PutAccountName` do IAM. 

## Sintaxe da Solicitação
<a name="API_PutAccountName_RequestSyntax"></a>

```
POST /putAccountName HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "AccountName": "string"
}
```

## Parâmetros da solicitação de URI
<a name="API_PutAccountName_RequestParameters"></a>

A solicitação não usa nenhum parâmetro de URI.

## Corpo da Solicitação
<a name="API_PutAccountName_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [AccountId](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-request-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos da AWS conta que você deseja acessar ou modificar com essa operação.  
Se você não especificar esse parâmetro, o padrão será a AWS conta da identidade usada para chamar a operação.  
Para usar esse parâmetro, o chamador deve ser uma identidade na [conta de gerenciamento da organização](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) ou em uma conta de administrador delegado, e o ID da conta especificada deve ser de uma conta-membro na mesma organização. A organização deve ter [todos os atributos habilitados](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve ter [acesso confiável](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) habilitado para o serviço de gerenciamento de contas e, opcionalmente, uma conta do [administrador delegado](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) atribuída.  
A conta de gerenciamento não pode especificar seu próprio `AccountId`; ela deve chamar a operação em um contexto autônomo sem incluir o parâmetro `AccountId`.
Para chamar essa operação em uma conta que não seja membro de uma organização, não especifique esse parâmetro e chame a operação usando uma identidade pertencente à conta cujos contatos você deseja recuperar ou modificar.  
Tipo: sequência  
Padrão: `\d{12}`   
Obrigatório: não

 ** [AccountName](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-request-AccountName"></a>
O nome da conta.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Padrão: `[ -;=?-~]+`   
Obrigatório: sim

## Sintaxe da resposta
<a name="API_PutAccountName_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de Resposta
<a name="API_PutAccountName_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

## Erros
<a name="API_PutAccountName_Errors"></a>

Para informações sobre os erros comuns retornados pelas ações, consulte [Tipos de erro comuns](CommonErrors.md).

 ** AccessDeniedException **   
Ocorreu uma falha na operação porque a identidade de chamada não tem as permissões mínimas necessárias.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de status HTTP: 403

 ** InternalServerException **   
A operação falhou devido a um erro interno do AWS. Tente executar a operação novamente mais tarde.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de status HTTP: 500

 ** TooManyRequestsException **   
Ocorreu uma falha na operação porque ela foi chamada com muita frequência e excedeu um limite de controle de utilização.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de status HTTP: 429

 ** ValidationException **   
Ocorreu uma falha na operação porque um dos parâmetros de entrada era inválido.    
 ** fieldList **   
O campo em que a entrada inválida foi detectada.  
 ** message **   
A mensagem que informa sobre o que era inválido na solicitação.  
 ** reason **   
O motivo da falha na validação.
Código de status HTTP: 400

## Exemplos
<a name="API_PutAccountName_Examples"></a>

### Exemplo 1
<a name="API_PutAccountName_Example_1"></a>

O exemplo a seguir atualiza o nome da conta cujas credenciais são usadas para chamar a operação. 

#### Exemplo de solicitação
<a name="API_PutAccountName_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountName":"MyAccount"
}
```

#### Resposta da amostra
<a name="API_PutAccountName_Example_1_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

### Exemplo 2
<a name="API_PutAccountName_Example_2"></a>

O exemplo a seguir atualiza o nome da conta de membro especificada em uma organização. Você deve usar as credenciais da conta de gerenciamento da organização ou da conta de administrador delegado do serviço de Gerenciamento de Contas. 

#### Exemplo de solicitação
<a name="API_PutAccountName_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyMemberAccount"
}
```

#### Resposta da amostra
<a name="API_PutAccountName_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

## Consulte também
<a name="API_PutAccountName_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAccountName) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAccountName) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAccountName) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAccountName) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAccountName) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAccountName) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAccountName) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAccountName) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAccountName) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAccountName)