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.
StartPrimaryEmailUpdate
Inicia el proceso de actualización de la dirección de correo electrónico principal de la cuenta especificada.
Sintaxis de la solicitud
POST /startPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string
",
"PrimaryEmail": "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í
- PrimaryEmail
-
La nueva dirección de correo electrónico principal (también conocida como dirección de correo electrónico del usuario raíz) que se utilizará en la cuenta especificada.
Tipo: cadena
Restricciones de longitud: longitud mínima de 5. La longitud máxima es de 64.
Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"Status": "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.
- Status
-
El estado de la solicitud de actualización del correo electrónico principal.
Tipo: cadena
Valores válidos:
PENDING | ACCEPTED
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
- ConflictException
-
No se pudo procesar la solicitud debido a un conflicto en el estado actual del recurso. Por ejemplo, esto ocurre si intentas habilitar una región que está actualmente deshabilitada (en estado DESHABILITADO) o si intentas cambiar el correo electrónico del usuario raíz de una cuenta por una dirección de correo electrónico que ya esté en uso.
Código de estado HTTP: 409
- 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
-
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 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: