CreateAccountCustomization -

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.

CreateAccountCustomization

Crea personalizaciones de Amazon QuickSight en la región de AWS actual. Actualmente, puede agregar un tema predeterminado personalizado utilizando la herramientaCreateAccountCustomizationorUpdateAccountCustomizationOperación de la API Para personalizar aún más QuickSight eliminando activos de muestra y vídeos de QuickSight para todos los usuarios nuevos, consultePersonalización de QuickSighten laGuía del usuario de Amazon QuickSight.

Puede crear personalizaciones para su cuenta de AWS o, si especifica un espacio de nombres, para un espacio de nombres QuickSight en su lugar. Las personalizaciones que se aplican a un espacio de nombres siempre anulan las personalizaciones que se aplican a una cuenta de AWS. Para saber qué personalizaciones se aplican, utilice elDescribeAccountCustomizationOperación de la API

Antes de utilizar laCreateAccountCustomizationpara agregar un tema como el espacio de nombres predeterminado, asegúrese de compartir primero el tema con el espacio de nombres. Si no lo comparte con el espacio de nombres, los usuarios no podrán ver el tema aunque lo conviertan en el tema predeterminado. Para comprobar si el tema está compartido, vea los permisos actuales mediante la herramienta DescribeThemePermissions Operación de la API Para compartir el tema, conceda permisos mediante el UpdateThemePermissions Operación de la API

Sintaxis de la solicitud

POST /accounts/AwsAccountId/customizations?namespace=Namespace HTTP/1.1 Content-type: application/json { "AccountCustomization": { "DefaultTheme": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] }

Parámetros de solicitud URI

La solicitud utiliza los siguientes parámetros URI.

AwsAccountId

El ID de cuenta de la cuenta de AWS para la que desea personalizar QuickSight.

Restricciones de longitud: Longitud fija de 12.

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

: obligatorio Sí

Espacio de nombres

El espacio de nombres QuickSight al que desea añadir personalizaciones.

Restricciones de longitud: La longitud máxima es 64.

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

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

CuentaPersonalización

Las personalizaciones de QuickSight que está agregando a la región de AWS actual. Puede añadirlos a una cuenta de AWS y a un espacio de nombres QuickSight.

Por ejemplo, puede añadir un tema predeterminado estableciendoAccountCustomizational tema de medianoche: "AccountCustomization": { "DefaultTheme": "arn:aws:quicksight::aws:theme/MIDNIGHT" }. O bien, puede agregar un tema personalizado especificando"AccountCustomization": { "DefaultTheme": "arn:aws:quicksight:us-west-2:111122223333:theme/bdb844d0-0fe9-4d9d-b520-0fe602d93639" }.

Tipo: objeto AccountCustomization

: obligatorio Sí

Etiquetas

Una lista de las etiquetas que desea adjuntar a este recurso.

Tipo: Array deTagobjects

Miembros de matrices Número mínimo de 1 elemento. Número máximo de 200 elementos.

: obligatorio No

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 está agregando a la región de AWS actual.

Tipo: objeto AccountCustomization

Arn

El nombre de recurso de Amazon (ARN) para la personalización que ha creado para esta cuenta de AWS.

Tipo: Cadena

AwsAccountId

El ID de cuenta de la cuenta de AWS para la que desea personalizar QuickSight.

Tipo: Cadena

Restricciones de longitud: Longitud fija de 12.

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

Espacio de nombres

El espacio de nombres asociado a la personalización que está creando.

Tipo: Cadena

Restricciones de longitud: 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

ResourceExistsException

El recurso especificado ya existe.

Código de estado HTTP: 409

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: