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á.

# Referência da API
<a name="api-reference"></a>

As operações de API no namespace Account Management (`account`) permitem que você modifique seu. Conta da AWS

Cada um Conta da AWS suporta metadados com informações sobre a conta, incluindo informações sobre até três contatos alternativos associados à conta. Eles são adicionais ao endereço de e-mail associado ao [usuário-raiz](root-user.md) da conta. Você pode especificar somente um de cada um dos tipos de contato a seguir associados a uma conta.
+ Contato de faturamento
+ Contato de operações
+ Contato de segurança

Por padrão, as operações de API discutidas neste guia se aplicam diretamente à conta que chama a operação. A [identidade](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html) da conta que está chamando a operação normalmente é um perfil do IAM ou um usuário do IAM e deve ter permissão aplicada por uma política do IAM para chamar a operação da API. Como alternativa, você pode chamar essas operações de API a partir de uma identidade em uma conta de AWS Organizations gerenciamento e especificar o número de ID da conta para qualquer pessoa Conta da AWS que seja membro da organização.

 **Versão da API** 

Esta versão da Referência da API de Contas documenta a versão 2021-02-01 da API de Gerenciamento de Contas.

**nota**  
Como alternativa ao uso direto da API, você pode usar uma delas AWS SDKs, que consiste em bibliotecas e código de amostra para várias linguagens e plataformas de programação (Java, Ruby, .NET, iOS, Android e muito mais). Eles SDKs fornecem uma maneira conveniente de criar acesso programático às AWS Organizations. Por exemplo, SDKs cuidar da assinatura criptográfica de solicitações, do gerenciamento de erros e da repetição automática de solicitações. Para obter mais informações sobre o AWS SDKs, incluindo como baixá-los e instalá-los, consulte [Ferramentas para Amazon Web Services](https://console.aws.amazon.com/).

Recomendamos que você use o AWS SDKs para fazer chamadas programáticas de API para o serviço de gerenciamento de contas. No entanto, você também pode usar a API de consulta do Gerenciamento de Contas para fazer chamadas diretas para o serviço Web de Gerenciamento de Contas. Para saber mais sobre a API de consulta do Gerenciamento de Contas, consulte [Chamar a API por meio de solicitações de consulta HTTP](query-requests.md) no Account Management User Guide. O Organizations oferece suporte a solicitações GET e POST para todas as ações. Ou seja, a API não exige que você use GET para algumas ações e POST para outras. No entanto, as solicitações GET estão sujeitas à limitação do tamanho de um URL. Portanto, para operações que exigem tamanhos maiores, use uma solicitação POST.

**Assinatura de solicitações**

Ao enviar solicitações HTTP para AWS, você deve assinar as solicitações para que AWS possa identificar quem as enviou. Você assina solicitações com sua chave de AWS acesso, que consiste em um ID de chave de acesso e uma chave de acesso secreta. É altamente recomendável não criar uma chave de acesso para o usuário-raiz. Qualquer pessoa que tenha a chave de acesso do usuário-raiz da conta tem acesso irrestrito a todos os recursos da conta. Em vez disso, crie uma chave de acesso para um usuário do IAM que tenha privilégios administrativos. Como outra opção, use o AWS Security Token Service para gerar credenciais de segurança temporárias e use essas credenciais para assinar solicitações.

Para assinar solicitações, recomendamos o uso do Signature Version 4. Se você tiver uma aplicação existente que usa o Signature Version 2, não precisará atualizá-la para usar o Signature Version 4. No entanto, algumas operações agora exigem o Signature Version 4. A documentação das operações que exigem a versão 4 indica esse requisito. Para obter mais informações, consulte [Solicitações de AWS API de assinatura](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) no *Guia do usuário do IAM*.

Quando você usa a Interface de Linha de AWS Comando (AWS CLI) ou uma das AWS SDKs para fazer solicitações AWS, essas ferramentas assinam automaticamente as solicitações para você com a chave de acesso que você especifica ao configurar as ferramentas.

**Suporte e feedback para o Gerenciamento de Contas**

Os seus comentários são bem-vindos. Envie seu feedback para [feedback-awsaccounts@amazon.com](mailto://feedback-awsaccounts@amazon.com) ou publique seu feedback e suas perguntas no [Account Management support forum](https://forums.aws.amazon.com/forum.jspa?forumID=219). Para obter mais informações sobre os fóruns de AWS suporte, consulte [a Ajuda dos fóruns](https://forums.aws.amazon.com/help.jspa).

**Como os exemplos são apresentados**

O JSON retornado pelo Gerenciamento de Contas como resposta às suas solicitações é retornado como uma única string longa sem quebras de linha ou espaços em branco de formatação. Tanto as quebras de linha quanto os espaços em branco são mostrados nos exemplos deste guia para melhorar a leitura. Quando exemplos de parâmetros de entrada também resultam em sequências longas que se estendem para além da tela, inserimos quebras de linha para melhorar a leitura. Você deve sempre enviar a entrada como uma única string de texto JSON.

**Registro de solicitações de API**

O Account Management suporta CloudTrail um serviço que registra chamadas de AWS API para você Conta da AWS e entrega arquivos de log em um bucket do Amazon S3. Usando as informações coletadas por CloudTrail, você pode determinar quais solicitações foram feitas com sucesso ao Gerenciamento de Contas, quem fez a solicitação, quando ela foi feita e assim por diante. Para obter mais informações sobre o gerenciamento de contas e seu suporte para CloudTrail, consulte[Registrando chamadas da API de gerenciamento de AWS contas usando AWS CloudTrail](monitoring-cloudtrail.md). Para saber mais sobre CloudTrail, inclusive como ativá-lo e encontrar seus arquivos de log, consulte o [Guia AWS CloudTrail do usuário](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).

# Ações
<a name="API_Operations"></a>

As ações a seguir são compatíveis:
+  [AcceptPrimaryEmailUpdate](API_AcceptPrimaryEmailUpdate.md) 
+  [DeleteAlternateContact](API_DeleteAlternateContact.md) 
+  [DisableRegion](API_DisableRegion.md) 
+  [EnableRegion](API_EnableRegion.md) 
+  [GetAccountInformation](API_GetAccountInformation.md) 
+  [GetAlternateContact](API_GetAlternateContact.md) 
+  [GetContactInformation](API_GetContactInformation.md) 
+  [GetGovCloudAccountInformation](API_GetGovCloudAccountInformation.md) 
+  [GetPrimaryEmail](API_GetPrimaryEmail.md) 
+  [GetRegionOptStatus](API_GetRegionOptStatus.md) 
+  [ListRegions](API_ListRegions.md) 
+  [PutAccountName](API_PutAccountName.md) 
+  [PutAlternateContact](API_PutAlternateContact.md) 
+  [PutContactInformation](API_PutContactInformation.md) 
+  [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) 

# AcceptPrimaryEmailUpdate
<a name="API_AcceptPrimaryEmailUpdate"></a>

Aceita a solicitação originada de [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) para atualizar o endereço de e-mail principal (também conhecido como endereço de e-mail do usuário-raiz) da conta especificada.

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

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

{
   "AccountId": "string",
   "Otp": "string",
   "PrimaryEmail": "string"
}
```

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

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

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

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

 ** [AccountId](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-request-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos Conta da AWS que você deseja acessar ou modificar com essa 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 do administrador delegado. O ID da conta especificada deve ser uma conta-membro na mesma organização. A organização deve ter [todos os recursos 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/orgs_integrate_services.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.  
Essa operação só pode ser chamada da conta de gerenciamento ou da conta do administrador delegado de uma organização para uma conta-membro.  
A conta de gerenciamento não pode especificar seu próprio `AccountId`.
Tipo: sequência  
Padrão: `\d{12}`   
Obrigatório: Sim

 ** [Otp](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-request-Otp"></a>
O código OTP enviado para o `PrimaryEmail` especificado na chamada de API `StartPrimaryEmailUpdate`.  
Tipo: sequência  
Padrão: `[a-zA-Z0-9]{6}`   
Obrigatório: Sim

 ** [PrimaryEmail](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-request-PrimaryEmail"></a>
O novo endereço de e-mail principal para uso com a conta especificada. Ele deve corresponder ao `PrimaryEmail` da chamada de API `StartPrimaryEmailUpdate`.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 5. O comprimento máximo é 64.  
Obrigatório: sim

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

```
HTTP/1.1 200
Content-type: application/json

{
   "Status": "string"
}
```

## Elementos de resposta
<a name="API_AcceptPrimaryEmailUpdate_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Status](#API_AcceptPrimaryEmailUpdate_ResponseSyntax) **   <a name="accounts-AcceptPrimaryEmailUpdate-response-Status"></a>
Recupera o status da solicitação aceita de atualização do e-mail principal.  
Tipo: string  
Valores válidos: `PENDING | ACCEPTED` 

## Erros
<a name="API_AcceptPrimaryEmailUpdate_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

 ** ConflictException **   
Não foi possível processar a solicitação devido a um conflito no status atual do recurso. Por exemplo, isso acontece se você tenta habilitar uma região que está sendo desabilitada no momento (com status DESABILITANDO) ou se você tenta alterar o e-mail do usuário-raiz de uma conta para um endereço de e-mail que já está em uso.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de Status HTTP: 409

 ** 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

 ** ResourceNotFoundException **   
Ocorreu uma falha na operação porque ela especificou um recurso que não pode ser encontrado.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de status HTTP: 404

 ** 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

## Consulte também
<a name="API_AcceptPrimaryEmailUpdate_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/AcceptPrimaryEmailUpdate) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/AcceptPrimaryEmailUpdate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AcceptPrimaryEmailUpdate) 

# DeleteAlternateContact
<a name="API_DeleteAlternateContact"></a>

Exclui o contato alternativo especificado de um Conta da AWS.

Para obter detalhes completos sobre como usar as operações de contato alternativo, consulte [Update the alternate contacts for your Conta da AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).

**nota**  
Antes de atualizar as informações de contato alternativas de uma Conta da AWS que é gerenciada por AWS Organizations, você deve primeiro habilitar a integração entre AWS Account Management e Organizations. Para obter mais informações, consulte [Enable trusted access for AWS Account Management](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).

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

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

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

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

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

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

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

 ** [AccountId](#API_DeleteAlternateContact_RequestSyntax) **   <a name="accounts-DeleteAlternateContact-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

 ** [AlternateContactType](#API_DeleteAlternateContact_RequestSyntax) **   <a name="accounts-DeleteAlternateContact-request-AlternateContactType"></a>
Especifica quais contatos alternativos devem ser excluídos.   
Tipo: string  
Valores válidos: `BILLING | OPERATIONS | SECURITY`   
Obrigatório: sim

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

```
HTTP/1.1 200
```

## Elementos de Resposta
<a name="API_DeleteAlternateContact_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_DeleteAlternateContact_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

 ** ResourceNotFoundException **   
Ocorreu uma falha na operação porque ela especificou um recurso que não pode ser encontrado.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de status HTTP: 404

 ** 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_DeleteAlternateContact_Examples"></a>

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

O exemplo a seguir exclui o contato alternativo de segurança da conta cujas credenciais são usadas para chamar a operação. 

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact

{
   "AccountName":"MyAccount"
}
```

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

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

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

O exemplo a seguir exclui o contato alternativo para faturamento da conta-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_DeleteAlternateContact_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact

{
   "AccountId":"123456789012",
   "AlternateContactType":"BILLING"
}
```

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

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

## Consulte também
<a name="API_DeleteAlternateContact_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/DeleteAlternateContact) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DeleteAlternateContact) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DeleteAlternateContact) 

# DisableRegion
<a name="API_DisableRegion"></a>

Desabilita (desativa) uma região específica para uma conta.

**nota**  
O ato de desabilitar uma região removerá todo o acesso do IAM a quaisquer recursos que residam nessa região.

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

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

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

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

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

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

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

 ** [AccountId](#API_DisableRegion_RequestSyntax) **   <a name="accounts-DisableRegion-request-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos Conta da AWS que você deseja acessar ou modificar com essa operação. Se você não especificar esse parâmetro, o padrão será a conta da Amazon Web Services 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 do administrador delegado. O ID da conta especificada deve ser uma conta-membro na mesma organização. A organização deve ter [todos os recursos 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/orgs_integrate_services.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 é membro de uma organização, não especifique esse parâmetro. Em vez disso, 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

 ** [RegionName](#API_DisableRegion_RequestSyntax) **   <a name="accounts-DisableRegion-request-RegionName"></a>
Especifica o código de um determinado nome de região (por exemplo, `af-south-1`). Quando você desativa uma região, AWS executa ações para desativar essa região em sua conta, como destruir recursos do IAM na região. Esse processo leva alguns minutos para a maioria das contas, mas poderá levar algumas horas. Você não pode habilitar a região até que o processo de desabilitação esteja concluído.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Obrigatório: sim

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

```
HTTP/1.1 200
```

## Elementos de Resposta
<a name="API_DisableRegion_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_DisableRegion_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

 ** ConflictException **   
Não foi possível processar a solicitação devido a um conflito no status atual do recurso. Por exemplo, isso acontece se você tenta habilitar uma região que está sendo desabilitada no momento (com status DESABILITANDO) ou se você tenta alterar o e-mail do usuário-raiz de uma conta para um endereço de e-mail que já está em uso.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de Status HTTP: 409

 ** 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

## Consulte também
<a name="API_DisableRegion_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/DisableRegion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DisableRegion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DisableRegion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DisableRegion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DisableRegion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DisableRegion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DisableRegion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DisableRegion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DisableRegion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DisableRegion) 

# EnableRegion
<a name="API_EnableRegion"></a>

Habilita (ativa) uma região específica para uma conta.

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

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

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

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

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

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

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

 ** [AccountId](#API_EnableRegion_RequestSyntax) **   <a name="accounts-EnableRegion-request-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos Conta da AWS que você deseja acessar ou modificar com essa operação. Se você não especificar esse parâmetro, o padrão será a conta da Amazon Web Services 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 do administrador delegado. O ID da conta especificada deve ser uma conta-membro na mesma organização. A organização deve ter [todos os recursos 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/orgs_integrate_services.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 é membro de uma organização, não especifique esse parâmetro. Em vez disso, 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

 ** [RegionName](#API_EnableRegion_RequestSyntax) **   <a name="accounts-EnableRegion-request-RegionName"></a>
Especifica o código de um determinado nome de região (por exemplo, `af-south-1`). Quando você habilita uma região, a AWS executa ações para preparar sua conta nesta região, como a distribuição dos seus recursos do IAM para a região. Esse processo leva alguns minutos para a maioria das contas, mas pode levar várias horas. Você não pode usar a região até que esse processo seja concluído. Além disso, você não pode desabilitar a região até que o processo de habilitação esteja concluído.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Obrigatório: sim

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

```
HTTP/1.1 200
```

## Elementos de Resposta
<a name="API_EnableRegion_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_EnableRegion_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

 ** ConflictException **   
Não foi possível processar a solicitação devido a um conflito no status atual do recurso. Por exemplo, isso acontece se você tenta habilitar uma região que está sendo desabilitada no momento (com status DESABILITANDO) ou se você tenta alterar o e-mail do usuário-raiz de uma conta para um endereço de e-mail que já está em uso.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de Status HTTP: 409

 ** 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

## Consulte também
<a name="API_EnableRegion_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/EnableRegion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/EnableRegion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/EnableRegion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/EnableRegion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/EnableRegion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/EnableRegion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/EnableRegion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/EnableRegion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/EnableRegion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/EnableRegion) 

# GetAccountInformation
<a name="API_GetAccountInformation"></a>

Recupera as informações sobre a conta especificada, incluindo nome e ID da conta e data e hora de criação da conta. Para usar essa API, um usuário do IAM ou perfil deve ter a permissão `account:GetAccountInformation` do IAM. 

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

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

{
   "AccountId": "string"
}
```

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

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

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

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

 ** [AccountId](#API_GetAccountInformation_RequestSyntax) **   <a name="accounts-GetAccountInformation-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

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

```
HTTP/1.1 200
Content-type: application/json

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

## Elementos de resposta
<a name="API_GetAccountInformation_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [AccountCreatedDate](#API_GetAccountInformation_ResponseSyntax) **   <a name="accounts-GetAccountInformation-response-AccountCreatedDate"></a>
A data e a hora em que a conta foi criada.  
Tipo: Timestamp

 ** [AccountId](#API_GetAccountInformation_ResponseSyntax) **   <a name="accounts-GetAccountInformation-response-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos Conta da AWS que você deseja acessar ou modificar com essa 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 do administrador delegado. O ID da conta especificada deve ser uma conta-membro na mesma organização. A organização deve ter [todos os recursos 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/orgs_integrate_services.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.  
Essa operação só pode ser chamada da conta de gerenciamento ou da conta do administrador delegado de uma organização para uma conta-membro.  
A conta de gerenciamento não pode especificar seu próprio `AccountId`.
Tipo: sequência  
Padrão: `\d{12}` 

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

## Erros
<a name="API_GetAccountInformation_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_GetAccountInformation_Examples"></a>

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

O exemplo a seguir recupera as informações da conta para a conta cujas credenciais são usadas para chamar a operação. 

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
                    
{}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyAccount",
   "AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```

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

O exemplo a seguir recupera as informações da conta para a 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_GetAccountInformation_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
                    
{
   "AccountId": "123456789012" 
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyMemberAccount",
   "AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```

## Consulte também
<a name="API_GetAccountInformation_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/GetAccountInformation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAccountInformation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAccountInformation) 

# GetAlternateContact
<a name="API_GetAlternateContact"></a>

Recupera o contato alternativo especificado anexado a um Conta da AWS.

Para obter detalhes completos sobre como usar as operações de contato alternativo, consulte [Update the alternate contacts for your Conta da AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).

**nota**  
Antes de atualizar as informações de contato alternativas de uma Conta da AWS que é gerenciada por AWS Organizations, você deve primeiro habilitar a integração entre AWS Account Management e Organizations. Para obter mais informações, consulte [Enable trusted access for AWS Account Management](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).

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

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

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

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

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

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

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

 ** [AccountId](#API_GetAlternateContact_RequestSyntax) **   <a name="accounts-GetAlternateContact-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

 ** [AlternateContactType](#API_GetAlternateContact_RequestSyntax) **   <a name="accounts-GetAlternateContact-request-AlternateContactType"></a>
Especifica qual contato alternativo você deseja recuperar.  
Tipo: string  
Valores válidos: `BILLING | OPERATIONS | SECURITY`   
Obrigatório: sim

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

```
HTTP/1.1 200
Content-type: application/json

{
   "AlternateContact": { 
      "AlternateContactType": "string",
      "EmailAddress": "string",
      "Name": "string",
      "PhoneNumber": "string",
      "Title": "string"
   }
}
```

## Elementos de resposta
<a name="API_GetAlternateContact_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [AlternateContact](#API_GetAlternateContact_ResponseSyntax) **   <a name="accounts-GetAlternateContact-response-AlternateContact"></a>
Uma estrutura que contém os detalhes do contato alternativo especificado.  
Tipo: objeto [AlternateContact](API_AlternateContact.md)

## Erros
<a name="API_GetAlternateContact_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

 ** ResourceNotFoundException **   
Ocorreu uma falha na operação porque ela especificou um recurso que não pode ser encontrado.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de status HTTP: 404

 ** 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_GetAlternateContact_Examples"></a>

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

O exemplo a seguir recupera o contato alternativo de segurança da conta cujas credenciais são usadas para chamar a operação. 

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact

{
   "AlternateContactType":"SECURITY"
}
```

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

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

{
   "AlternateContact":{
      "Name":"Anika",
      "Title":"COO",
      "EmailAddress":"anika@example.com",
      "PhoneNumber":"206-555-0198",
      "AlternateContactType":"Security"
   }
}
```

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

O exemplo a seguir recupera o contato alternativo das operações da conta-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_GetAlternateContact_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact

{
   "AccountId":"123456789012",
   "AlternateContactType":"Operations"
}
```

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

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

{
   "AlternateContact":{
      "Name":"Anika",
      "Title":"COO",
      "EmailAddress":"anika@example.com",
      "PhoneNumber":"206-555-0198",
      "AlternateContactType":"Operations"
   }
}
```

## Consulte também
<a name="API_GetAlternateContact_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/GetAlternateContact) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAlternateContact) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAlternateContact) 

# GetContactInformation
<a name="API_GetContactInformation"></a>

Recupera as informações do contato principal de uma Conta da AWS.

Para obter detalhes completos sobre como usar as operações do contato principal, consulte [Update the primary contact for your Conta da AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html).

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

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

{
   "AccountId": "string"
}
```

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

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

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

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

 ** [AccountId](#API_GetContactInformation_RequestSyntax) **   <a name="accounts-GetContactInformation-request-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos Conta da AWS que você deseja acessar ou modificar com essa operação. Se você não especificar esse parâmetro, o padrão será a conta da Amazon Web Services 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 do administrador delegado. O ID da conta especificada deve ser uma conta-membro na mesma organização. A organização deve ter [todos os recursos 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/orgs_integrate_services.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 é membro de uma organização, não especifique esse parâmetro. Em vez disso, 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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "ContactInformation": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "AddressLine3": "string",
      "City": "string",
      "CompanyName": "string",
      "CountryCode": "string",
      "DistrictOrCounty": "string",
      "FullName": "string",
      "PhoneNumber": "string",
      "PostalCode": "string",
      "StateOrRegion": "string",
      "WebsiteUrl": "string"
   }
}
```

## Elementos de resposta
<a name="API_GetContactInformation_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [ContactInformation](#API_GetContactInformation_ResponseSyntax) **   <a name="accounts-GetContactInformation-response-ContactInformation"></a>
Contém os detalhes das informações do contato principal associadas a uma Conta da AWS.  
Tipo: objeto [ContactInformation](API_ContactInformation.md)

## Erros
<a name="API_GetContactInformation_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

 ** ResourceNotFoundException **   
Ocorreu uma falha na operação porque ela especificou um recurso que não pode ser encontrado.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de status HTTP: 404

 ** 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

## Consulte também
<a name="API_GetContactInformation_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/GetContactInformation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetContactInformation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetContactInformation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetContactInformation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetContactInformation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetContactInformation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetContactInformation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetContactInformation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetContactInformation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetContactInformation) 

# GetGovCloudAccountInformation
<a name="API_GetGovCloudAccountInformation"></a>

Recupera informações sobre a GovCloud conta vinculada à conta padrão especificada (se ela existir), incluindo o ID e o estado da GovCloud conta. Para usar essa API, um usuário do IAM ou perfil deve ter a permissão `account:GetGovCloudAccountInformation` do IAM. 

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

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

{
   "StandardAccountId": "string"
}
```

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

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

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

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

 ** [StandardAccountId](#API_GetGovCloudAccountInformation_RequestSyntax) **   <a name="accounts-GetGovCloudAccountInformation-request-StandardAccountId"></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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountState": "string",
   "GovCloudAccountId": "string"
}
```

## Elementos de resposta
<a name="API_GetGovCloudAccountInformation_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [AccountState](#API_GetGovCloudAccountInformation_ResponseSyntax) **   <a name="accounts-GetGovCloudAccountInformation-response-AccountState"></a>
O estado da GovCloud conta vinculada.  
Tipo: string  
Valores válidos: `PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED` 

 ** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) **   <a name="accounts-GetGovCloudAccountInformation-response-GovCloudAccountId"></a>
O número de identificação da conta de 12 dígitos da conta GovCloud vinculada.  
Tipo: sequência  
Padrão: `\d{12}` 

## Erros
<a name="API_GetGovCloudAccountInformation_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

 ** ResourceNotFoundException **   
Ocorreu uma falha na operação porque ela especificou um recurso que não pode ser encontrado.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de status HTTP: 404

 ** ResourceUnavailableException **   
A operação falhou porque especificou um recurso que não está disponível no momento.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de status HTTP: 424

 ** 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_GetGovCloudAccountInformation_Examples"></a>

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

O exemplo a seguir recupera as informações da GovCloud conta vinculada para a conta cujas credenciais são usadas para chamar a operação. 

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
                    
{}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "GovCloudAccountId": "123456789012",
   "AccountState": "ACTIVE"
}
```

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

O exemplo a seguir recupera as informações da GovCloud conta vinculada para a conta 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_GetGovCloudAccountInformation_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
                    
{
   "StandardAccountId": "111111111111" 
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "GovCloudAccountId": "123456789012",
   "AccountState": "ACTIVE"
}
```

### Exemplo 3
<a name="API_GetGovCloudAccountInformation_Example_3"></a>

O exemplo a seguir tenta recuperar as informações da GovCloud conta vinculada para uma conta padrão que não está vinculada a uma GovCloud conta. 

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
                    
{
   "StandardAccountId": "222222222222" 
}
```

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

```
HTTP/1.1 404
Content-Type: application/json
                    
{
   "message":"GovCloud Account ID not found for Standard Account - 222222222222."
}
```

## Consulte também
<a name="API_GetGovCloudAccountInformation_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/GetGovCloudAccountInformation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetGovCloudAccountInformation) 

# GetPrimaryEmail
<a name="API_GetPrimaryEmail"></a>

Recupera o endereço de e-mail principal da conta especificada.

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

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

{
   "AccountId": "string"
}
```

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

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

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

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

 ** [AccountId](#API_GetPrimaryEmail_RequestSyntax) **   <a name="accounts-GetPrimaryEmail-request-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos Conta da AWS que você deseja acessar ou modificar com essa 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 do administrador delegado. O ID da conta especificada deve ser uma conta-membro na mesma organização. A organização deve ter [todos os recursos 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/orgs_integrate_services.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.  
Essa operação só pode ser chamada da conta de gerenciamento ou da conta do administrador delegado de uma organização para uma conta-membro.  
A conta de gerenciamento não pode especificar seu próprio `AccountId`.
Tipo: sequência  
Padrão: `\d{12}`   
Obrigatório: sim

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

```
HTTP/1.1 200
Content-type: application/json

{
   "PrimaryEmail": "string"
}
```

## Elementos de resposta
<a name="API_GetPrimaryEmail_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [PrimaryEmail](#API_GetPrimaryEmail_ResponseSyntax) **   <a name="accounts-GetPrimaryEmail-response-PrimaryEmail"></a>
Recupera o endereço de e-mail principal associado à conta especificada.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 5. O comprimento máximo é 64.

## Erros
<a name="API_GetPrimaryEmail_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

 ** ResourceNotFoundException **   
Ocorreu uma falha na operação porque ela especificou um recurso que não pode ser encontrado.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de status HTTP: 404

 ** 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

## Consulte também
<a name="API_GetPrimaryEmail_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/GetPrimaryEmail) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetPrimaryEmail) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetPrimaryEmail) 

# GetRegionOptStatus
<a name="API_GetRegionOptStatus"></a>

Recupera o status de ativação de uma região específica.

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

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

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

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

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

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

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

 ** [AccountId](#API_GetRegionOptStatus_RequestSyntax) **   <a name="accounts-GetRegionOptStatus-request-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos Conta da AWS que você deseja acessar ou modificar com essa operação. Se você não especificar esse parâmetro, o padrão será a conta da Amazon Web Services 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 do administrador delegado. O ID da conta especificada deve ser uma conta-membro na mesma organização. A organização deve ter [todos os recursos 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/orgs_integrate_services.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 é membro de uma organização, não especifique esse parâmetro. Em vez disso, 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

 ** [RegionName](#API_GetRegionOptStatus_RequestSyntax) **   <a name="accounts-GetRegionOptStatus-request-RegionName"></a>
Especifica o código de um determinado nome de região (por exemplo, `af-south-1`). Essa função retornará o status de qualquer região que você passar para esse parâmetro.   
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Obrigatório: sim

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

```
HTTP/1.1 200
Content-type: application/json

{
   "RegionName": "string",
   "RegionOptStatus": "string"
}
```

## Elementos de resposta
<a name="API_GetRegionOptStatus_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [RegionName](#API_GetRegionOptStatus_ResponseSyntax) **   <a name="accounts-GetRegionOptStatus-response-RegionName"></a>
O código da região que foi passado.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.

 ** [RegionOptStatus](#API_GetRegionOptStatus_ResponseSyntax) **   <a name="accounts-GetRegionOptStatus-response-RegionOptStatus"></a>
Um dos possíveis status que uma região pode ter (Habilitada, Sendo habilitada, Desabilitada, Sendo desabilitada, Habilitada\$1por\$1Padrão).  
Tipo: string  
Valores válidos: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` 

## Erros
<a name="API_GetRegionOptStatus_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

## Consulte também
<a name="API_GetRegionOptStatus_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/GetRegionOptStatus) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetRegionOptStatus) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetRegionOptStatus) 

# ListRegions
<a name="API_ListRegions"></a>

Lista todas as regiões de uma determinada conta e seus respectivos status de ativação. Opcionalmente, essa lista pode ser filtrada pelo parâmetro `region-opt-status-contains`. 

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

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

{
   "AccountId": "string",
   "MaxResults": number,
   "NextToken": "string",
   "RegionOptStatusContains": [ "string" ]
}
```

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

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

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

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

 ** [AccountId](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos Conta da AWS que você deseja acessar ou modificar com essa operação. Se você não especificar esse parâmetro, o padrão será a conta da Amazon Web Services 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 do administrador delegado. O ID da conta especificada deve ser uma conta-membro na mesma organização. A organização deve ter [todos os recursos 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/orgs_integrate_services.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 é membro de uma organização, não especifique esse parâmetro. Em vez disso, 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

 ** [MaxResults](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-MaxResults"></a>
O número total de itens para retornar na saída do comando. Se o número total de itens disponíveis for maior que o valor especificado, um `NextToken` será fornecido na saída do comando. Para retomar a paginação, forneça o valor `NextToken` no argumento `starting-token` de um comando subsequente. Não use o elemento de `NextToken` resposta diretamente fora da AWS CLI. Para exemplos de uso, consulte [Paginação](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) no Guia do *usuário da interface de linha de AWS comando*.   
Tipo: inteiro  
Faixa válida: valor mínimo de 1. Valor máximo de 50.  
Obrigatório: não

 ** [NextToken](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-NextToken"></a>
Um token para especificar onde iniciar a paginação. Esse é o `NextToken` de uma resposta truncada anteriormente. Para exemplos de uso, consulte [Paginação](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) no Guia do *usuário da interface de linha de AWS comando*.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 1.000.  
Obrigatório: não

 ** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) **   <a name="accounts-ListRegions-request-RegionOptStatusContains"></a>
Uma lista de status de região (Sendo habilitada, Habilitada, Sendo desabilitada, Desabilitada, Habilitada\$1por\$1Padrão) a serem usados para filtrar a lista de regiões de uma determinada conta. Por exemplo, passar um valor ENABLING só retornará uma lista de regiões com o status de região ENABLING.  
Tipo: matriz de strings  
Valores válidos: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`   
Obrigatório: não

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

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Regions": [ 
      { 
         "RegionName": "string",
         "RegionOptStatus": "string"
      }
   ]
}
```

## Elementos de resposta
<a name="API_ListRegions_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [NextToken](#API_ListRegions_ResponseSyntax) **   <a name="accounts-ListRegions-response-NextToken"></a>
Se houver mais dados a serem retornados, eles serão preenchidos. Deve ser passado para o parâmetro de solicitação `next-token` da `list-regions`.  
Tipo: string

 ** [Regions](#API_ListRegions_ResponseSyntax) **   <a name="accounts-ListRegions-response-Regions"></a>
Essa é uma lista de regiões para uma determinada conta ou, se o parâmetro filtrado foi usado, uma lista de regiões que correspondem aos critérios de filtragem definidos no parâmetro `filter`.  
Tipo: matriz de objetos [Region](API_Region.md)

## Erros
<a name="API_ListRegions_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

## Consulte também
<a name="API_ListRegions_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/ListRegions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/ListRegions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ListRegions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/ListRegions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ListRegions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/ListRegions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/ListRegions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/ListRegions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/ListRegions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ListRegions) 

# 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) 

# PutAlternateContact
<a name="API_PutAlternateContact"></a>

Modifica o contato alternativo especificado anexado a um Conta da AWS.

Para obter detalhes completos sobre como usar as operações de contato alternativo, consulte [Update the alternate contacts for your Conta da AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).

**nota**  
Antes de atualizar as informações de contato alternativas de uma Conta da AWS que é gerenciada por AWS Organizations, você deve primeiro habilitar a integração entre AWS Account Management e Organizations. Para obter mais informações, consulte [Enable trusted access for AWS Account Management](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).

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

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

{
   "AccountId": "string",
   "AlternateContactType": "string",
   "EmailAddress": "string",
   "Name": "string",
   "PhoneNumber": "string",
   "Title": "string"
}
```

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

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

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

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

 ** [AccountId](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos que você deseja acessar ou modificar com essa operação. AWS   
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

 ** [AlternateContactType](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-AlternateContactType"></a>
Especifica qual contato alternativo você deseja criar ou atualizar.  
Tipo: string  
Valores válidos: `BILLING | OPERATIONS | SECURITY`   
Obrigatório: Sim

 ** [EmailAddress](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-EmailAddress"></a>
Especifica um endereço de e-mail para o contato alternativo.   
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 254.  
Padrão: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`   
Obrigatório: Sim

 ** [Name](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-Name"></a>
Especifica um nome para o contato alternativo.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Obrigatório: Sim

 ** [PhoneNumber](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-PhoneNumber"></a>
Especifica um número de telefone para o contato alternativo.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 25.  
Padrão: `[\s0-9()+-]+`   
Obrigatório: Sim

 ** [Title](#API_PutAlternateContact_RequestSyntax) **   <a name="accounts-PutAlternateContact-request-Title"></a>
Especifica um título para o contato alternativo.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Obrigatório: sim

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

```
HTTP/1.1 200
```

## Elementos de Resposta
<a name="API_PutAlternateContact_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_PutAlternateContact_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_PutAlternateContact_Examples"></a>

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

O exemplo a seguir define o contato alternativo para faturamento da conta cujas credenciais são usadas para chamar a operação.

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

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact

{
    "AlternateContactType": "Billing",
    "Name": "Carlos Salazar",
    "Title": "CFO",
    "EmailAddress": "carlos@example.com",
    "PhoneNumber": "206-555-0199"
}
```

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

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

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

O exemplo a seguir define ou substitui o contato alternativo para faturamento da conta-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_PutAlternateContact_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact

{
    "AccountId": "123456789012",
    "AlternateContactType": "Billing",
    "Name": "Carlos Salazar",
    "Title": "CFO",
    "EmailAddress": "carlos@example.com",
    "PhoneNumber": "206-555-0199"
}
```

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

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

## Consulte também
<a name="API_PutAlternateContact_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/PutAlternateContact) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAlternateContact) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAlternateContact) 

# PutContactInformation
<a name="API_PutContactInformation"></a>

Atualiza as informações do contato principal de uma Conta da AWS.

Para obter detalhes completos sobre como usar as operações do contato principal, consulte [Update the primary contact for your Conta da AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html).

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

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

{
   "AccountId": "string",
   "ContactInformation": { 
      "AddressLine1": "string",
      "AddressLine2": "string",
      "AddressLine3": "string",
      "City": "string",
      "CompanyName": "string",
      "CountryCode": "string",
      "DistrictOrCounty": "string",
      "FullName": "string",
      "PhoneNumber": "string",
      "PostalCode": "string",
      "StateOrRegion": "string",
      "WebsiteUrl": "string"
   }
}
```

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

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

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

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

 ** [AccountId](#API_PutContactInformation_RequestSyntax) **   <a name="accounts-PutContactInformation-request-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos Conta da AWS que você deseja acessar ou modificar com essa operação. Se você não especificar esse parâmetro, o padrão será a conta da Amazon Web Services 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 do administrador delegado. O ID da conta especificada deve ser 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 é membro de uma organização, não especifique esse parâmetro. Em vez disso, 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

 ** [ContactInformation](#API_PutContactInformation_RequestSyntax) **   <a name="accounts-PutContactInformation-request-ContactInformation"></a>
Contém os detalhes das informações do contato principal associadas a uma Conta da AWS.  
Tipo: objeto [ContactInformation](API_ContactInformation.md)  
Obrigatório: sim

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

```
HTTP/1.1 200
```

## Elementos de Resposta
<a name="API_PutContactInformation_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_PutContactInformation_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

## Consulte também
<a name="API_PutContactInformation_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/PutContactInformation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutContactInformation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutContactInformation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutContactInformation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutContactInformation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutContactInformation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutContactInformation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutContactInformation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutContactInformation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutContactInformation) 

# StartPrimaryEmailUpdate
<a name="API_StartPrimaryEmailUpdate"></a>

Inicia o processo para atualizar o endereço de e-mail principal para a conta especificada.

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

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

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

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

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

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

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

 ** [AccountId](#API_StartPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-request-AccountId"></a>
Especifica o número de identificação da conta de 12 dígitos Conta da AWS que você deseja acessar ou modificar com essa 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 do administrador delegado. O ID da conta especificada deve ser uma conta-membro na mesma organização. A organização deve ter [todos os recursos 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/orgs_integrate_services.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.  
Essa operação só pode ser chamada da conta de gerenciamento ou da conta do administrador delegado de uma organização para uma conta-membro.  
A conta de gerenciamento não pode especificar seu próprio `AccountId`.
Tipo: sequência  
Padrão: `\d{12}`   
Obrigatório: Sim

 ** [PrimaryEmail](#API_StartPrimaryEmailUpdate_RequestSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-request-PrimaryEmail"></a>
O novo endereço de e-mail principal (também conhecido como endereço de e-mail do usuário-raiz) a ser usado na conta especificada.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 5. O comprimento máximo é 64.  
Obrigatório: sim

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

```
HTTP/1.1 200
Content-type: application/json

{
   "Status": "string"
}
```

## Elementos de resposta
<a name="API_StartPrimaryEmailUpdate_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) **   <a name="accounts-StartPrimaryEmailUpdate-response-Status"></a>
O status da solicitação de atualização do e-mail principal.  
Tipo: string  
Valores válidos: `PENDING | ACCEPTED` 

## Erros
<a name="API_StartPrimaryEmailUpdate_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

 ** ConflictException **   
Não foi possível processar a solicitação devido a um conflito no status atual do recurso. Por exemplo, isso acontece se você tenta habilitar uma região que está sendo desabilitada no momento (com status DESABILITANDO) ou se você tenta alterar o e-mail do usuário-raiz de uma conta para um endereço de e-mail que já está em uso.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de Status HTTP: 409

 ** 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

 ** ResourceNotFoundException **   
Ocorreu uma falha na operação porque ela especificou um recurso que não pode ser encontrado.    
 ** errorType **   
O valor preenchido no cabeçalho da resposta `x-amzn-ErrorType` pelo API Gateway.
Código de status HTTP: 404

 ** 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

## Consulte também
<a name="API_StartPrimaryEmailUpdate_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/StartPrimaryEmailUpdate) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/StartPrimaryEmailUpdate) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/StartPrimaryEmailUpdate) 

# Ações relacionadas em outros AWS serviços
<a name="API_Related_Operations"></a>

As operações a seguir estão relacionadas AWS Gerenciamento de contas , mas fazem parte do AWS Organizations namespace:
+ [CreateAccount](API_CreateAccount.md)
+ [CreateGovCloudAccount](API_CreateGovCloudAccount.md)
+ [DescribeAccount](API_DescribeAccount.md)

# CreateAccount
<a name="API_CreateAccount"></a>

A operação da `CreateAccount` API está disponível para uso somente no contexto de uma organização gerenciada pelo AWS Organizations serviço. A operação da API é definida no namespace desse serviço.

Para obter mais informações, consulte [CreateAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateAccount.html) na *Referência de APIs do AWS Organizations *.

# CreateGovCloudAccount
<a name="API_CreateGovCloudAccount"></a>

A operação da `CreateGovCloudAccount` API está disponível para uso somente no contexto de uma organização gerenciada pelo AWS Organizations serviço. A operação da API é definida no namespace desse serviço.

Para obter mais informações, consulte [CreateGovCloudAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateGovCloudAccount.html) na *Referência de APIs do AWS Organizations *.

# DescribeAccount
<a name="API_DescribeAccount"></a>

A operação da `DescribeAccount` API está disponível para uso somente no contexto de uma organização gerenciada pelo AWS Organizations serviço. A operação da API é definida no namespace desse serviço.

Para obter mais informações, consulte [DescribeAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_DescribeAccount.html) na *Referência de APIs do AWS Organizations *.

# Tipos de dados
<a name="API_Types"></a>

Os seguintes tipos de dados são compatíveis:
+  [AlternateContact](API_AlternateContact.md) 
+  [ContactInformation](API_ContactInformation.md) 
+  [Region](API_Region.md) 
+  [ValidationExceptionField](API_ValidationExceptionField.md) 

# AlternateContact
<a name="API_AlternateContact"></a>

Uma estrutura que contém os detalhes de um contato alternativo associado a uma conta da AWS 

## Conteúdo
<a name="API_AlternateContact_Contents"></a>

 ** AlternateContactType **   <a name="accounts-Type-AlternateContact-AlternateContactType"></a>
O tipo de contato alternativo.  
Tipo: string  
Valores válidos: `BILLING | OPERATIONS | SECURITY`   
Obrigatório: não

 ** EmailAddress **   <a name="accounts-Type-AlternateContact-EmailAddress"></a>
O endereço de e-mail associado a esse contato alternativo.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 254.  
Padrão: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`   
Obrigatório: não

 ** Name **   <a name="accounts-Type-AlternateContact-Name"></a>
O nome associado a esse contato alternativo.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64.  
Obrigatório: não

 ** PhoneNumber **   <a name="accounts-Type-AlternateContact-PhoneNumber"></a>
O número de telefone associado a esse contato alternativo.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 25.  
Padrão: `[\s0-9()+-]+`   
Obrigatório: não

 ** Title **   <a name="accounts-Type-AlternateContact-Title"></a>
O título associado a esse contato alternativo.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Obrigatório: Não

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AlternateContact) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AlternateContact) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AlternateContact) 

# ContactInformation
<a name="API_ContactInformation"></a>

Contém os detalhes das informações do contato principal associadas a uma Conta da AWS.

## Conteúdo
<a name="API_ContactInformation_Contents"></a>

 ** AddressLine1 **   <a name="accounts-Type-ContactInformation-AddressLine1"></a>
A primeira linha do endereço do contato principal.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. O comprimento máximo é 60.  
Obrigatório: Sim

 ** City **   <a name="accounts-Type-ContactInformation-City"></a>
A cidade do endereço do contato principal.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Obrigatório: Sim

 ** CountryCode **   <a name="accounts-Type-ContactInformation-CountryCode"></a>
O código ISO-3166 de duas letras do país do endereço do contato principal.  
Tipo: string  
Restrições de comprimento: comprimento fixo de 2.  
Obrigatório: Sim

 ** FullName **   <a name="accounts-Type-ContactInformation-FullName"></a>
O nome completo do endereço do contato principal.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Obrigatório: Sim

 ** PhoneNumber **   <a name="accounts-Type-ContactInformation-PhoneNumber"></a>
O número de telefone das informações do contato principal. O número será validado e, em alguns países, verificado para ativação.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 20.  
Padrão: `[+][\s0-9()-]+`   
Obrigatório: Sim

 ** PostalCode **   <a name="accounts-Type-ContactInformation-PostalCode"></a>
O código postal do endereço do contato principal.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 20.  
Obrigatório: Sim

 ** AddressLine2 **   <a name="accounts-Type-ContactInformation-AddressLine2"></a>
A segunda linha do endereço do contato principal, se houver.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 60.  
Obrigatório: não

 ** AddressLine3 **   <a name="accounts-Type-ContactInformation-AddressLine3"></a>
A terceira linha do endereço do contato principal, se houver.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Comprimento máximo de 60.  
Obrigatório: não

 ** CompanyName **   <a name="accounts-Type-ContactInformation-CompanyName"></a>
O nome da empresa associada às informações do contato principal, se houver.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Obrigatório: não

 ** DistrictOrCounty **   <a name="accounts-Type-ContactInformation-DistrictOrCounty"></a>
O distrito ou condado do endereço do contato principal, se houver.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Obrigatório: não

 ** StateOrRegion **   <a name="accounts-Type-ContactInformation-StateOrRegion"></a>
O estado ou a região do endereço do contato principal. Se o endereço de correspondência estiver nos Estados Unidos (EUA), o valor nesse campo poderá ser um código de estado de dois caracteres (por exemplo, `NJ`) ou o nome completo do estado (por exemplo, `New Jersey`). Esse campo é obrigatório nos seguintes países: `US`, `CA`, `GB`, `DE`, `JP`, `IN` e `BR`.  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Obrigatório: não

 ** WebsiteUrl **   <a name="accounts-Type-ContactInformation-WebsiteUrl"></a>
O URL do site associado às informações do contato principal, se houver.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 256.  
Obrigatório: Não

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ContactInformation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ContactInformation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ContactInformation) 

# Region
<a name="API_Region"></a>

Essa é uma estrutura que expressa a região de uma determinada conta, consistindo em um nome e no status de ativação.

## Conteúdo
<a name="API_Region_Contents"></a>

 ** RegionName **   <a name="accounts-Type-Region-RegionName"></a>
O código de uma determinada região (por exemplo, `us-east-1`).  
Tipo: string  
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 50.  
Obrigatório: não

 ** RegionOptStatus **   <a name="accounts-Type-Region-RegionOptStatus"></a>
Um dos possíveis status que uma região pode ter (Habilitada, Sendo habilitada, Desabilitada, Sendo desabilitada, Habilitada\$1por\$1Padrão).  
Tipo: string  
Valores válidos: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`   
Obrigatório: não

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/Region) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/Region) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/Region) 

# ValidationExceptionField
<a name="API_ValidationExceptionField"></a>

A entrada falhou em atender às restrições especificadas pelo AWS serviço em um campo especificado.

## Conteúdo
<a name="API_ValidationExceptionField_Contents"></a>

 ** message **   <a name="accounts-Type-ValidationExceptionField-message"></a>
Uma mensagem sobre a exceção de validação.  
Tipo: String  
Obrigatório: Sim

 ** name **   <a name="accounts-Type-ValidationExceptionField-name"></a>
O nome do campo em que a entrada inválida foi detectada.  
Tipo: String  
Obrigatório: Sim

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

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ValidationExceptionField) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ValidationExceptionField) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ValidationExceptionField) 

# Parâmetros gerais
<a name="CommonParameters"></a>

A lista a seguir contém os parâmetros que todas as ações usam para assinar solicitações do Signature versão 4 com uma string de consulta. Todos os parâmetros específicos de uma ação são listados no tópico para a ação. Para obter mais informações sobre o Signature versão 4, consulte [Solicitações de AWS API de assinatura](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) no *Guia do usuário do IAM*.

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
O algoritmo de hash que foi usado para criar a assinatura da solicitação.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Valores válidos: `AWS4-HMAC-SHA256`   
Obrigatório: condicional

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
O valor de escopo da credencial, uma string que inclui a sua chave de acesso, a data, a região visada, o serviço que está sendo solicitado e uma sequência de encerramento ("aws4\$1request"). O valor é expresso no seguinte formato: *chave\$1acesso*/*AAAAMMDD*/*região*/*serviço*/aws4\$1request.  
Para obter mais informações, consulte [Criar uma solicitação de AWS API assinada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) no *Guia do usuário do IAM*.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
A data usada para criar a assinatura. O formato deve ser o formato básico ISO 8601 (AAAAMMDD'T'HHMMSS'Z'). Por exemplo, a data e hora a seguir é um X-Amz-Date valor válido:`20120325T120000Z`.  
Condição: X-Amz-Date é opcional para todas as solicitações; ele pode ser usado para substituir a data usada em solicitações de assinatura. Se o cabeçalho da data for especificado no formato básico ISO 8601, não X-Amz-Date é necessário. Quando X-Amz-Date usado, ele sempre substitui o valor do cabeçalho da data. Para obter mais informações, consulte [Elementos de uma assinatura de solicitação de AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) no *Guia do usuário do IAM*.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
O token de segurança temporário obtido por meio de uma chamada para AWS Security Token Service (AWS STS). Para obter uma lista de serviços que oferecem suporte a credenciais de segurança temporárias do AWS STS, consulte [Serviços da AWS que funcionam com o IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) no *Guia do usuário do IAM*.  
Condição: se você estiver usando credenciais de segurança temporárias do AWS STS, deverá incluir o token de segurança.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Especifica a assinatura com codificação hexadecimal que foi calculada com base na string a ser assinada e na chave de assinatura derivada.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Obrigatório: Condicional

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Especifica todos os cabeçalhos HTTP que foram incluídos como parte da solicitação canônica. Para obter mais informações sobre a especificação de cabeçalhos assinados, consulte [Criar uma solicitação de AWS API assinada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) no Guia do *usuário do IAM*.  
Condição: especifique esse parâmetro quando incluir as informações de autenticação em uma string de consulta em vez de no cabeçalho da autorização HTTP.  
Tipo: string  
Obrigatório: Condicional

# Tipos de erro comuns
<a name="CommonErrors"></a>

Esta seção lista os tipos de erro comuns que esse AWS serviço pode retornar. Nem todos os serviços retornam todos os tipos de erro listados aqui. Para saber os erros específicos de uma ação de API para esse serviço, consulte o tópico sobre a ação de API em questão.

 **AccessDeniedException**   <a name="CommonErrors-AccessDeniedException"></a>
Você não tem permissão para realizar esta ação. Verifique se sua política do IAM inclui as permissões necessárias.  
Código de status HTTP: 403

 **ExpiredTokenException**   <a name="CommonErrors-ExpiredTokenException"></a>
O token de segurança incluído na solicitação expirou. Solicite um novo token de segurança e tente novamente.  
Código de status HTTP: 403

 **IncompleteSignature**   <a name="CommonErrors-IncompleteSignature"></a>
A assinatura da solicitação não está em conformidade com os AWS padrões. Verifique se você está usando AWS credenciais válidas e se sua solicitação está formatada corretamente. Se você estiver usando um SDK, verifique se ele está atualizado.  
Código de status HTTP: 403

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
A solicitação não pode ser processada no momento devido a um problema interno do servidor. Tente novamente mais tarde. Se o problema persistir, entre em contato com o AWS Support.  
Código de status HTTP: 500

 **MalformedHttpRequestException**   <a name="CommonErrors-MalformedHttpRequestException"></a>
O corpo da solicitação não pode ser processado. Isso geralmente acontece quando o corpo da solicitação não pode ser descompactado usando o algoritmo de codificação de conteúdo especificado. Verifique se o cabeçalho da codificação do conteúdo corresponde ao formato de compactação usado.  
Código de status HTTP: 400

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
Você não tem permissões para realizar essa ação. Verifique se sua política do IAM inclui as permissões necessárias.  
Código de status HTTP: 401

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
Sua AWS conta precisa de uma assinatura para esse serviço. Verifique se você ativou o serviço em sua conta.  
Código de status HTTP: 403

 **RequestAbortedException**   <a name="CommonErrors-RequestAbortedException"></a>
A solicitação foi cancelada antes que uma resposta pudesse ser retornada. Isso normalmente acontece quando o cliente fecha a conexão.  
Código de status HTTP: 400

 **RequestEntityTooLargeException**   <a name="CommonErrors-RequestEntityTooLargeException"></a>
A entidade de solicitação é muito grande. Reduza o tamanho do corpo da solicitação e tente novamente.  
Código de status HTTP: 413

 **RequestTimeoutException**   <a name="CommonErrors-RequestTimeoutException"></a>
O tempo limite da solicitação atingiu o tempo limite. O servidor não recebeu a solicitação completa dentro do prazo esperado. Tente novamente.  
Código de status HTTP: 408

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
O serviço está temporariamente indisponível. Tente novamente mais tarde.  
Código de status HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
Sua taxa de solicitação é muito alta. As solicitações de repetição AWS SDKs automática que recebem essa exceção. Reduza a frequência de solicitações.  
Código de status HTTP: 400

 **UnknownOperationException**   <a name="CommonErrors-UnknownOperationException"></a>
A ação ou operação não é reconhecida. Verifique se o nome da ação está escrito corretamente e se é compatível com a versão da API que você está usando.  
Código de status HTTP: 404

 **UnrecognizedClientException**   <a name="CommonErrors-UnrecognizedClientException"></a>
O certificado X.509 ou ID da chave de AWS acesso que você forneceu não existe em nossos registros. Verifique se você está usando credenciais válidas e se elas não expiraram.  
Código de status HTTP: 403

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
A entrada não atende ao formato ou às restrições exigidas. Verifique se todos os parâmetros necessários estão incluídos e se os valores são válidos.  
Código de status HTTP: 400

# Chamar a API por meio de solicitações de consulta HTTP
<a name="query-requests"></a>

Esta seção contém informações gerais sobre o uso da API de consulta para gerenciamento de AWS contas. Para obter mais detalhes sobre as operações da API e os erros, consulte o [Referência da API](api-reference.md).

**nota**  
Em vez de fazer chamadas diretas para a API de consulta de gerenciamento de AWS contas, você pode usar um dos AWS SDKs. Eles AWS SDKs consistem em bibliotecas e exemplos de código para várias linguagens e plataformas de programação (Java, Ruby, .NET, iOS, Android e muito mais). Eles SDKs fornecem uma maneira conveniente de criar acesso programático ao gerenciamento de AWS contas e. AWS Por exemplo, SDKs cuidar de tarefas como assinar criptograficamente solicitações, gerenciar erros e repetir solicitações automaticamente. Para obter informações sobre o AWS SDKs, incluindo como baixá-los e instalá-los, consulte [Ferramentas para Amazon Web Services](https://aws.amazon.com/tools).

Com a API de consulta para gerenciamento de AWS contas, você pode chamar ações de serviço. As solicitações da API de consulta são solicitações HTTPS que devem conter um `Action` parâmetro para indicar a operação a ser executada. AWS Suporte `GET` e `POST` solicitações de gerenciamento de contas para todas as operações. Ou seja, a API não exige que você use `GET` para algumas ações e `POST` para outras. No entanto, as solicitações `GET` estão sujeitas à limitação de tamanho de um URL. Embora esse limite dependa do navegador, um limite típico é 2.048 bytes. Portanto, para as solicitações da API de consulta que exigem tamanhos maiores, você deve usar uma solicitação `POST`.

A resposta é um documento XML. Para obter mais detalhes sobre a resposta, consulte as páginas de ação individuais no [Referência da API](api-reference.md).

**Topics**
+ [Endpoints](#endpoints)
+ [HTTPS obrigatório](#IAMHTTPSRequired)
+ [Assinar solicitações da API de gerenciamento de AWS contas](#SigVersion)

## Endpoints
<a name="endpoints"></a>

AWS O gerenciamento de contas tem um único endpoint de API global hospedado no Leste dos EUA (Norte da Virgínia) Região da AWS.

Para obter mais informações sobre AWS endpoints e regiões para todos os serviços, consulte [Regiões e endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html) no. *Referência geral da AWS* 

## HTTPS obrigatório
<a name="IAMHTTPSRequired"></a>

Como a API de consulta pode retornar informações confidenciais, como credenciais de segurança, você deve usar HTTPS para criptografar todas as solicitações de API. 

## Assinar solicitações da API de gerenciamento de AWS contas
<a name="SigVersion"></a>

As solicitações devem ser assinadas usando um ID da chave de acesso e uma chave de acesso secreta. É altamente recomendável que você não use as credenciais da sua conta AWS raiz para o trabalho diário com o Gerenciamento de AWS Contas. Você pode usar as credenciais de um usuário AWS Identity and Access Management (IAM) ou credenciais temporárias, como as usadas com uma função do IAM.

Para assinar suas solicitações de API, você deve usar o AWS Signature versão 4. Para obter informações sobre como usar o Signature versão 4, consulte [Solicitações de AWS API de assinatura](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) no *Guia do usuário do IAM*. 

Para saber mais, consulte:
+ [Credenciais de segurança da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html): fornece informações gerais sobre os tipos de credencial que você pode usar para acessar a AWS.
+ [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) — Oferece sugestões para usar o serviço IAM para ajudar a proteger seus AWS recursos, incluindo aqueles no gerenciamento de AWS contas.
+ [Credenciais de segurança temporárias no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html): descreve como criar e usar credenciais de segurança temporárias.