GetAlternateContact - AWS Account Management
Sintaxe da SolicitaçãoParâmetros da solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosExemplosConsulte também

GetAlternateContact

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

Para obter detalhes completos sobre como usar as operações de contato alternativo, consulte Access or updating the alternate contacts.

nota

Antes de atualizar as informações de contato alternativas de uma Conta da AWS que é gerenciada pelo AWS Organizations, você deve primeiro habilitar a integração entre o Gerenciamento de Contas da AWS e o Organizations. Para obter mais informações, consulte Enabling trusted access for AWS Account Management.

Sintaxe da Solicitação

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

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

Parâmetros da solicitação de URI

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

Corpo da Solicitação

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

AccountId

Especifica o número do ID de 12 dígitos da 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 AWS 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 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 recursos habilitados e deve ter acesso confiável habilitado para o serviço de gerenciamento de contas e, opcionalmente, uma conta do administrador delegado atribuída.

nota

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: string

Padrão: ^\d{12}$

Obrigatório: Não

AlternateContactType

Especifica qual contato alternativo você deseja recuperar.

Tipo: string

Valores Válidos: BILLING | OPERATIONS | SECURITY

Exigido: Sim

Sintaxe da Resposta

HTTP/1.1 200
Content-type: application/json

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

Elementos de Resposta

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

Uma estrutura que contém os detalhes do contato alternativo especificado.

Tipo: objeto AlternateContact

Erros

Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.

AccessDeniedException

Ocorreu uma falha na operação porque a identidade de chamada não tem as permissões mínimas necessárias.

Código de Status HTTP: 403

InternalServerException

Ocorreu uma falha na operação devido a um erro interno da AWS. Tente executar a operação novamente mais tarde.

Código de Status HTTP: 500

ResourceNotFoundException

Ocorreu uma falha na operação porque ela especificou um recurso que não pode ser encontrado.

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.

Código de Status HTTP: 429

ValidationException

Ocorreu uma falha na operação porque um dos parâmetros de entrada era inválido.

Código de Status HTTP: 400

Exemplos

Exemplo 1

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

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

{ "AlternateContactType": "SECURITY" }

Resposta da amostra

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

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

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

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

Resposta da amostra

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

Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte: