GetPrimaryEmail
Recupera la dirección de correo electrónico principal para la cuenta especificada.
Sintaxis de la solicitud
POST /getPrimaryEmail HTTP/1.1
Content-type: application/json
{
"AccountId": "string"
}Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- AccountId
-
Especifica el número de ID de 12 dígitos de la Cuenta de AWS a la que desea acceder o la que desea modificar con esta operación. Para usar este parámetro, la persona que llama debe ser una identidad de la cuenta de administración de la organización o una cuenta de administrador delegado. El ID de cuenta especificado debe ser una cuenta de miembro en la misma organización. La organización debe tener todas las características habilitadas, así como el acceso de confianza habilitado para el servicio de Account Management y, de manera opcional, debe tener asignada una cuenta de administrador delegado.
Esta operación solo se puede realizar desde la cuenta de administración o desde la cuenta de administrador delegado de una organización para una cuenta de miembro.
nota
La cuenta de administración no puede especificar su propio
AccountId.Tipo: cadena
Patrón:
^\d{12}$Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"PrimaryEmail": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- PrimaryEmail
-
Recupera la dirección de correo electrónico principal asociada a la cuenta especificada.
Tipo: cadena
Restricciones de longitud: longitud mínima de 5 caracteres. La longitud máxima es de 64.
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AccessDeniedException
-
Se produjo un error en la operación porque la identidad que realiza la llamada no tiene los permisos mínimos necesarios.
Código de estado HTTP: 403
- InternalServerException
-
Se produjo un error en la operación debido a un error interno de AWS. Intente operar otra vez más tarde.
Código de estado HTTP: 500
- ResourceNotFoundException
-
Se produjo un error en la operación porque especificó un recurso que no se encuentra.
Código de estado HTTP: 404
- TooManyRequestsException
-
Se produjo un error en la operación porque se realizó la llamada con demasiada frecuencia y superó la limitación.
Código de estado HTTP: 429
- ValidationException
-
Se produjo un error en la operación porque uno de los parámetros de entrada no era válido.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
