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.
GetRegionOptStatus
Recupera el estado de suscripción de una región en particular.
Sintaxis de la solicitud
POST /getRegionOptStatus HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "string"
}URIParámetros de solicitud
La solicitud no utiliza ningún URI parámetro.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en JSON formato.
- AccountId
-
Especifica el número de ID de cuenta de 12 dígitos del Cuenta de AWS al 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.
AccountIdDebe llamar a la operación en un contexto independiente sin incluir elAccountIdpará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: cadena
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). Esta función devolverá el estado de cualquier región que introduzca en este parámetro.Tipo: cadena
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
Content-type: application/json
{
"RegionName": "string",
"RegionOptStatus": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- RegionName
-
El código de región que se ha transferido.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres.
- RegionOptStatus
-
Uno de los posibles estados que puede sufrir una región (Habilitada, Habilitada, Deshabilitada, Inhabilitada, Enabled_By_Default).
Tipo: cadena
Valores válidos:
ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT
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.
HTTPCódigo de estado: 403
- InternalServerException
-
La operación falló debido a un error interno de AWS. Vuelva a intentar la operación más tarde.
HTTPCódigo de estado: 500
- TooManyRequestsException
-
La operación falló porque se llamaba con demasiada frecuencia y se excedió el límite de aceleración.
HTTPCódigo de estado: 429
- ValidationException
-
La operación falló porque uno de los parámetros de entrada no era válido.
HTTPCódigo de estado: 400
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
