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 Amazon QuickSight personalizaciones para el actualRegión de AWS. Actualmente, puede añadir un tema predeterminado personalizado mediante laCreateAccountCustomizationoUpdateAccountCustomizationOperación de la API. Para personalizar más Amazon QuickSight eliminando Amazon QuickSightmateriales y vídeos de muestra para todos los usuarios nuevos, consultePersonalización de Amazon QuickSighten laAmazon QuickSight Guía del usuario de .
Puede crear personalizaciones para suAWScuenta o, si especifica un espacio de nombres, para un QuickSight espacio de nombres en su lugar. Las personalizaciones que se aplican a un espacio de nombres siempre anulan las personalizaciones que se aplican a unAWSaccount. Para saber qué personalizaciones se aplican, utilice laDescribeAccountCustomizationOperación de la API.
Antes de usar elCreateAccountCustomizationOperación de la API para agregar un tema como espacio de nombres predeterminado, asegúrese de compartir primero el tema con el espacio de nombres. Si no lo compartes con el espacio de nombres, el tema no estará visible para los usuarios, aunque lo conviertas en el tema predeterminado. Para comprobar si el tema es compartido, consulta los permisos actuales mediante la
DescribeThemePermissions
Operación de la API. Para compartir el tema, conceda permisos mediante la
UpdateThemePermissions
Operación de la API.
Sintaxis de la solicitud
POST /accounts/AwsAccountId/customizations?namespace=Namespace HTTP/1.1
Content-type: application/json
{
"AccountCustomization": {
"DefaultEmailCustomizationTemplate": "string",
"DefaultTheme": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- AwsAccountId
-
El ID deAWScuenta que desea personalizar Amazon QuickSight para.
Restricciones de longitud Longitud fija de 12 caracteres.
Patrón:
^[0-9]{12}$Obligatorio: Sí
- Namespace
-
El Amazon QuickSight espacio de nombres 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.
- AccountCustomization
-
El Amazon QuickSight personalizaciones que va a añadir en la versión actualRegión de AWS. Puede añadir estos elementos a unaAWScuenta y un QuickSight espacio de nombres.
Por ejemplo, puedes añadir un tema predeterminado configurando
AccountCustomizational tema de medianoche:"AccountCustomization": { "DefaultTheme": "arn:aws:quicksight::aws:theme/MIDNIGHT" }. O bien, puede añadir un tema personalizado especificando"AccountCustomization": { "DefaultTheme": "arn:aws:quicksight:us-west-2:111122223333:theme/bdb844d0-0fe9-4d9d-b520-0fe602d93639" }.Tipo: objeto AccountCustomization
Obligatorio: Sí
- Tags
-
Una lista de las etiquetas que desea adjuntar a este recurso.
Type: Matriz deTagobjects
Miembros de la matriz: 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": {
"DefaultEmailCustomizationTemplate": "string",
"DefaultTheme": "string"
},
"Arn": "string",
"AwsAccountId": "string",
"Namespace": "string",
"RequestId": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve la siguiente respuesta HTTP.
- Status
-
El estado HTTP de la solicitud.
El servicio devuelve los datos siguientes en formato JSON.
- AccountCustomization
-
El Amazon QuickSight personalizaciones que va a añadir en la versión actualRegión de AWS.
Tipo: objeto AccountCustomization
- Arn
-
El nombre de recurso de Amazon (ARN) de la personalización de que se ha creado para esteAWSaccount.
Type: Cadena
- AwsAccountId
-
El ID deAWScuenta que desea personalizar Amazon QuickSight para.
Type: Cadena
Restricciones de longitud Longitud fija de 12 caracteres.
Patrón:
^[0-9]{12}$ - Namespace
-
El espacio de nombres asociado a la personalización que está creando.
Type: Cadena
Restricciones de longitud La longitud máxima es 64.
Patrón:
^[a-zA-Z0-9._-]*$ - RequestId
-
LaAWSID de solicitud de esta operación.
Type: Cadena
Errores
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 esté autorizada para usar 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
- ConflictException
-
La actualización o eliminación de un recurso puede provocar un estado incoherente.
Código de estado HTTP: 409
- 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:
