DescribeAccountCustomization -

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.

DescribeAccountCustomization

Describe las personalizaciones asociadas a la cuenta de AWS proporcionada y el espacio de nombres de Amazon QuickSight en una región de AWS. La consola de QuickSight evalúa las personalizaciones que se deben aplicar ejecutando esta operación de API con elResolvedMarca incluida.

Para determinar qué personalizaciones se muestran al ejecutar este comando, puede ayudar a visualizar la relación de las entidades involucradas.

  • AWS Account: la cuenta de AWS existe en la parte superior de la jerarquía. Tiene el potencial de utilizar todas las regiones de AWS y los servicios de AWS. Cuando se suscribe a QuickSight, elige una región de AWS para utilizarla como región de origen. Ahí es donde se encuentra su capacidad SPICE gratuita. Es posible que se utilice QuickSight en cualquier región de AWS compatible.

  • AWS Region- En cada región de AWS en la que inicia sesión en QuickSight al menos una vez, QuickSight actúa como una instancia independiente del mismo servicio. Si tiene un directorio de usuario, reside en us-east-1, que es el EE. UU. Este (Norte de Virginia). En términos generales, estos usuarios tienen acceso a QuickSight en cualquier región de AWS, a menos que estén restringidos a un espacio de nombres.

    Para ejecutar el comando en una región de AWS diferente, cambie la configuración de la región. Si utiliza la CLI de AWS, puede usar una de las siguientes opciones:

  • Namespace- Un espacio de nombres QuickSight es una partición que contiene usuarios y activos (orígenes de datos, conjuntos de datos, paneles, etc.). Para acceder a los activos que se encuentran en un espacio de nombres específico, los usuarios y los grupos también deben formar parte del mismo espacio de nombres. Las personas que comparten un espacio de nombres están completamente aisladas de los usuarios y activos de otros espacios de nombres, incluso si están en la misma cuenta de AWS y región de AWS.

  • Applied customizations- Dentro de una región de AWS, se puede aplicar un conjunto de personalizaciones de QuickSight a una cuenta de AWS o a un espacio de nombres. La configuración que aplica a un espacio de nombres anula la configuración que aplica a una cuenta de AWS. Todas las configuraciones están aisladas en una sola región de AWS. Para aplicarlos en otras regiones de AWS, ejecute elCreateAccountCustomizationEn cada región de AWS en la que desea aplicar las mismas personalizaciones.

Sintaxis de la solicitud

GET /accounts/AwsAccountId/customizations?namespace=Namespace&resolved=Resolved HTTP/1.1

Parámetros de solicitud URI

La solicitud utiliza los siguientes parámetros URI.

AwsAccountId

El ID de la cuenta de AWS para la que desea describir las personalizaciones de QuickSight.

Restricciones de Longitud fija de 12.

Patrón: ^[0-9]{12}$

: obligatorio Sí

Espacio de nombres

Espacio de nombres QuickSight para el que desea describir las personalizaciones de QuickSight.

Restricciones de La longitud máxima es 64.

Patrón: ^[a-zA-Z0-9._-]*$

Resolved (Resuelto)

LaResolvedfunciona con los demás parámetros para determinar qué vista de las personalizaciones de QuickSight se devuelve. Puede agregar esta marca al comando para utilizar la misma vista que utiliza QuickSight para identificar las personalizaciones que se aplicarán a la consola. Omita este indicador o configúrelo enno-resolved, para revelar las personalizaciones que están configuradas en diferentes niveles.

Cuerpo de la solicitud

La solicitud no tiene un cuerpo de la solicitud.

Sintaxis de la respuesta

HTTP/1.1 Status Content-type: application/json { "AccountCustomization": { "DefaultTheme": "string" }, "Arn": "string", "AwsAccountId": "string", "Namespace": "string", "RequestId": "string" }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve la respuesta siguiente HTTP.

Estado

El estado HTTP de la solicitud.

El servicio devuelve los datos siguientes en formato JSON.

CuentaPersonalización

Las personalizaciones de QuickSight que existen en la región de AWS actual.

Tipo: objeto AccountCustomization

Arn

El nombre de recurso de Amazon (ARN) de la personalización asociada a esta cuenta de AWS.

Tipo: Cadena

AwsAccountId

El ID de la cuenta de AWS que está describiendo.

Tipo: Cadena

Restricciones de Longitud fija de 12.

Patrón: ^[0-9]{12}$

Espacio de nombres

El espacio de nombres QuickSight que está describiendo.

Tipo: Cadena

Restricciones de La longitud máxima es 64.

Patrón: ^[a-zA-Z0-9._-]*$

RequestId

ID de solicitud de AWS de esta operación.

Tipo: Cadena

Errors

Para obtener información sobre los errores que son comunes a todas las acciones, consulteErrores comunes.

AccessDeniedException

No tiene permiso de acceso. La credenciales proporcionadas no se pudieron validar. Es posible que no tenga autorización para realizar la solicitud. Asegúrese de que su cuenta tiene permiso para utilizar el servicio de Amazon QuickSight, que las políticas tienen los permisos correctos y que está utilizando las claves de acceso correctas.

Código de estado HTTP: 401

InternalFailureException

Se produjo un error interno.

Código de estado HTTP: 500

InvalidParameterValueException

Uno o más parámetros tienen un valor que no es válido.

Código de estado HTTP: 400

ResourceNotFoundException

No se encontraron uno o varios recursos.

Código de estado HTTP: 404

ResourceUnavailableException

Este recurso no está disponible en este momento.

Código de estado HTTP: 503

ThrottlingException

El acceso está limitado.

Código de estado HTTP: 429

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: