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.
DisableRegion
Inhabilita (excluye) una región determinada de una cuenta.
nota
Al deshabilitar una región, se eliminará todo acceso de IAM a cualquier recurso que resida en esa región.
Sintaxis de la solicitud
POST /disableRegion HTTP/1.1
Content-type: application/json
{
"AccountId": "string
",
"RegionName": "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. Si no especificas este parámetro, el valor predeterminado será la cuenta de Amazon Web Services de la identidad utilizada para llamar a la 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 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.
nota
La cuenta de administración no puede especificar la suya propia.
AccountId
Debe llamar a la operación en un contexto independiente sin incluir elAccountId
parámetro.Para llamar a esta operación en una cuenta que no es miembro de una organización, no especifique este parámetro. En su lugar, llama a la operación con una identidad que pertenezca a la cuenta cuyos contactos deseas recuperar o modificar.
Tipo: String
Patrón:
^\d{12}$
Obligatorio: no
- RegionName
-
Especifica el código de región de un nombre de región determinado (por ejemplo,
af-south-1
). Cuando inhabilitas una región, AWS realiza acciones para desactivarla en tu cuenta, como destruir los recursos de IAM de la región. Este proceso tarda unos minutos para la mayoría de las cuentas, pero puede tardar varias horas. No podrá activar la región hasta que el proceso de desactivación haya finalizado por completo.Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres.
Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
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
- TooManyRequestsException
-
La operación falló porque se realizó con demasiada frecuencia y superó el límite de aceleración.
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: