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 de atualização do endereço de e-mail principal da conta especificada.
Sintaxe da Solicitação
POST /startPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"PrimaryEmail": "string"
}URIParâmetros de solicitação
A solicitação não usa nenhum URI parâmetro.
Corpo da Solicitação
A solicitação aceita os seguintes dados no JSON formato.
- AccountId
-
Especifica o número de identificação da conta de 12 dígitos do 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 uma conta de administrador delegado. O ID da conta especificado deve ser uma conta membro na mesma organização. A organização deve ter todos os recursos habilitados e a organização deve ter acesso confiável habilitado para o serviço de gerenciamento de contas e, opcionalmente, uma conta de administrador delegado atribuída.
Essa operação só pode ser chamada da conta de gerenciamento ou da conta de administrador delegado de uma organização para uma conta de membro.
nota
A conta de gerenciamento não pode especificar sua própria conta
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: comprimento 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 de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
- Status
-
O status da solicitação principal de atualização por e-mail.
Tipo: string
Valores Válidos:
PENDING | ACCEPTED
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- AccessDeniedException
-
A operação falhou porque a identidade de chamada não tem as permissões mínimas necessárias.
HTTPCódigo de status: 403
- ConflictException
-
A solicitação não pôde ser processada devido a um conflito no status atual do recurso. Por exemplo, isso acontece se você tentar habilitar uma região que está sendo desativada no momento (em um status deDISABLING) ou se você tentar alterar o e-mail do usuário raiz de uma conta para um endereço de e-mail que já está em uso.
HTTPCódigo de status: 409
- InternalServerException
-
A operação falhou devido a um erro interno do AWS. Tente sua operação novamente mais tarde.
HTTPCódigo de status: 500
- ResourceNotFoundException
-
A operação falhou porque especificou um recurso que não pode ser encontrado.
HTTPCódigo de status: 404
- TooManyRequestsException
-
A operação falhou porque foi chamada com muita frequência e excedeu o limite do acelerador.
HTTPCódigo de status: 429
- ValidationException
-
A operação falhou porque um dos parâmetros de entrada era inválido.
HTTPCódigo de status: 400
Consulte também
Para obter mais informações sobre como usar isso API em um dos idiomas específicos AWS SDKs, veja o seguinte:
