ListRegions - AWS Administración de cuentas
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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.

ListRegions

Muestra todas las regiones de una cuenta determinada y sus respectivos estados de suscripción. Opcionalmente, esta lista se puede filtrar por el region-opt-status-contains parámetro.

Sintaxis de la solicitud

POST /listRegions HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "MaxResults": number,
   "NextToken": "string",
   "RegionOptStatusContains": [ "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 el AccountId 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

MaxResults

El número total de elementos que se van a devolver en el resultado del comando. Si el número total de elementos disponibles es superior al valor especificado, NextToken se proporciona a en el resultado del comando. Para reanudar la paginación, proporcione el valor de NextToken en el argumento starting-token de un comando posterior. No utilice el elemento de NextToken respuesta directamente fuera de la AWS CLI. Para ver ejemplos de uso, consulte Paginación en la Guía del usuario de la interfaz de línea de AWS comandos.

Tipo: entero

Rango válido: valor mínimo de 1. Valor máximo de 50.

Obligatorio: no

NextToken

Un token que se utiliza para especificar dónde empezar a paginar. Se trata NextToken de una respuesta previamente truncada. Para ver ejemplos de uso, consulte Paginación en la Guía del usuario de la interfaz de línea de AWS comandos.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1000 caracteres.

Obligatorio: no

RegionOptStatusContains

Una lista de los estados de las regiones (habilitada, habilitada, deshabilitada, habilitada, habilitada por defecto) que se puede usar para filtrar la lista de regiones de una cuenta determinada. Por ejemplo, si se introduce un valor de ENABILING, solo se mostrará una lista de regiones con el estado de ENABILING como región ENABILING.

Tipo: matriz de cadenas

Valores válidos: ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT

Obligatorio: no

Sintaxis de la respuesta

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Regions": [ 
      { 
         "RegionName": "string",
         "RegionOptStatus": "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.

NextToken

Si hay más datos que devolver, se rellenarán. Debe pasarse al parámetro de next-token solicitud delist-regions.

Tipo: cadena

Regions

Esta es una lista de regiones para una cuenta determinada o, si se utilizó el parámetro filtrado, una lista de regiones que coinciden con los criterios de filtro establecidos en el filter parámetro.

Tipo: matriz de objetos Region

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

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

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 uno de los AWS SDK específicos del idioma, consulta lo siguiente: