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.
DescribeAccountPreferences
Devuelve la configuración de preferencias de la cuenta Cuenta de AWS asociada al usuario que realiza la solicitud, en la versión actual Región de AWS.
Sintaxis de la solicitud
GET /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"MaxResults": number,
"NextToken": "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.
- MaxResults
-
(Opcional) Al recuperar las preferencias de la cuenta, si lo desea, puede especificar el parámetro
MaxItemspara limitar el número de objetos devueltos en una respuesta. El valor predeterminado es 100.Tipo: entero
Rango válido: valor mínimo de 1.
Obligatorio: no
- NextToken
-
(Opcional) Puedes usar
NextTokenen una solicitud posterior para buscar la siguiente página de preferencias de la Cuenta de AWS si la carga útil de la respuesta estaba paginada.Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
.+Obligatorio: no
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "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
-
Está presente si hay más registros de los que se devuelven en la respuesta. Se puede utilizar
NextTokenen la solicitud subsiguiente para obtener las descripciones adicionales.Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
.+ - ResourceIdPreference
-
Describe la configuración de preferencias del identificador de recurso Cuenta de AWS asociado al usuario que realiza la solicitud, en el estado actual Región de AWS.
Tipo: objeto ResourceIdPreference
Errores
- InternalServerError
-
Se devuelve si se ha producido un error en el servidor.
- ErrorCode
-
El código de error es una cadena que identifica de forma exclusiva una condición de error. Está diseñado para que los programas que detectan y administran errores por tipo puedan leerlo y comprenderlo.
- Message
-
El mensaje de error contiene una descripción genérica de la condición de error en inglés. Está destinado a un público humano. Los programas simples muestran el mensaje directamente al usuario final si se detecta una condición de error que no sabe cómo controlar o no le interesa hacerlo. Los programas sofisticados con un control de errores más exhaustivo y una internacionalización adecuada tienen más probabilidades de ignorar el mensaje de error.
Código de estado HTTP: 500
Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: