Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
GetPrimaryEmail
Recupera la dirección de correo electrónico principal de 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 cuenta de 12 dígitos al Cuenta de AWS que desea acceder o modificar con esta operación. Para utilizar 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 de la misma organización. La organización debe tener todas las funciones habilitadas y debe tener habilitado el acceso de confianza para el servicio de administración de cuentas y, si lo desea, 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 la suya propia.
AccountId
Tipo: String
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. 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 requeridos.
Código de estado HTTP: 403
- InternalServerException
-
La operación falló debido a un error interno de AWS. Vuelva a intentar la operación más tarde.
Código de estado HTTP: 500
- ResourceNotFoundException
-
La operación falló 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 llamaba con demasiada frecuencia y se había superado el límite establecido.
Código de estado HTTP: 429
- ValidationException
-
La operación falló 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 uno de los AWS SDK específicos del idioma, consulta lo siguiente: