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á.
StartPrimaryEmailUpdate
Inicia o processo para atualizar o endereço de e-mail principal para a conta especificada.
Sintaxe da Solicitação
POST /startPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"PrimaryEmail": "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. Para usar esse parâmetro, o chamador deve ser uma identidade na conta de gerenciamento da organização 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 e deve ter acesso confiável habilitado para o serviço de gerenciamento de contas e, opcionalmente, uma conta do administrador delegado 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.
nota
A conta de gerenciamento não pode especificar seu próprio
AccountId.Tipo: string
Padrão:
^\d{12}$Exigido: Sim
- PrimaryEmail
-
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. Comprimento máximo de 64.
Exigido: Sim
Sintaxe da Resposta
HTTP/1.1 200
Content-type: application/json
{
"Status": "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.
- Status
-
O status da solicitação de atualização do e-mail principal.
Tipo: string
Valores Válidos:
PENDING | ACCEPTED
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
- 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.
Código de Status HTTP: 409
- 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
Consulte Também
Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
