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.
CreateTheme
Actualiza un tema.
Un tema es un conjunto de opciones de configuración para el color y el diseño. Los temas se aplican a análisis y paneles. Para obtener más información, consulteUso de temas en Amazon QuickSighten laAmazon QuickSight Guía del usuario de.
Sintaxis de la solicitud
POST /accounts/AwsAccountId/themes/ThemeId HTTP/1.1
Content-type: application/json
{
"BaseThemeId": "string",
"Configuration": {
"DataColorPalette": {
"Colors": [ "string" ],
"EmptyFillColor": "string",
"MinMaxGradient": [ "string" ]
},
"Sheet": {
"Tile": {
"Border": {
"Show": boolean
}
},
"TileLayout": {
"Gutter": {
"Show": boolean
},
"Margin": {
"Show": boolean
}
}
},
"UIColorPalette": {
"Accent": "string",
"AccentForeground": "string",
"Danger": "string",
"DangerForeground": "string",
"Dimension": "string",
"DimensionForeground": "string",
"Measure": "string",
"MeasureForeground": "string",
"PrimaryBackground": "string",
"PrimaryForeground": "string",
"SecondaryBackground": "string",
"SecondaryForeground": "string",
"Success": "string",
"SuccessForeground": "string",
"Warning": "string",
"WarningForeground": "string"
}
},
"Name": "string",
"Permissions": [
{
"Actions": [ "string" ],
"Principal": "string"
}
],
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"VersionDescription": "string"
}Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- AwsAccountId
-
El ID de laAWSen la que desea almacenar el nuevo tema.
Restricciones de longitud Longitud fija de 12 caracteres.
Patrón:
^[0-9]{12}$Obligatorio: Sí
- ThemeId
-
Un identificador para el tema que quieres crear. El ID del tema es único porRegión de AWSenAWSaccount.
Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón:
[\w\-]+Obligatorio: Sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- BaseThemeId
-
El identificador del tema del que hereda un tema personalizado. Todos los temas se heredan de uno de los temas iniciales definidos por Amazon QuickSight. Para obtener una lista de los temas iniciales, usa
ListThemeso eligeThemes (Temas)desde dentro de un análisis de.Type: Cadena
Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón:
[\w\-]+Obligatorio: Sí
- Configuration
-
La configuración del tema, que contiene las propiedades de visualización del tema.
Tipo: objeto ThemeConfiguration
Obligatorio: Sí
- Name
-
Un nombre para mostrar del tema.
Type: Cadena
Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Obligatorio: Sí
- Permissions
-
Un grupo válido de permisos de recursos para aplicarlos al nuevo tema.
Type: Matriz deResourcePermissionobjects
Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 64 elementos.
Obligatorio: No
- Tags
-
Un mapa de los pares clave-valor de la etiqueta o etiquetas de recurso que desea agregar al recurso.
Type: Matriz deTagobjects
Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 200 elementos.
Obligatorio: No
- VersionDescription
-
Una descripción de la primera versión del tema que está creando. Cada vez
UpdateTheme, se creará una nueva versión. Cada versión del tema tiene una descripción de la versión en elVersionDescription.Type: Cadena
Restricciones de longitud Longitud mínima de 1. La longitud máxima es 512.
Obligatorio: No
Sintaxis de la respuesta
HTTP/1.1 Status
Content-type: application/json
{
"Arn": "string",
"CreationStatus": "string",
"RequestId": "string",
"ThemeId": "string",
"VersionArn": "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.
- Arn
-
El nombre de recurso de Amazon (ARN) del tema.
Type: Cadena
- CreationStatus
-
El estado de creación del tema.
Type: Cadena
Valores válidos:
CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED - RequestId
-
LaAWSID de solicitud de esta operación.
Type: Cadena
- ThemeId
-
El identificador del tema.
Type: Cadena
Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón:
[\w\-]+ - VersionArn
-
El nombre de recurso de Amazon (ARN) para el nuevo tema.
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
- 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
- LimitExceededException
-
Se superó un límite.
Código de estado HTTP: 409
- ResourceExistsException
-
El recurso especificado ya existe.
Código de estado HTTP: 409
- ResourceNotFoundException
-
No se encuentran uno o varios recursos.
Código de estado HTTP: 404
- ThrottlingException
-
El acceso está limitado.
Código de estado HTTP: 429
- UnsupportedUserEditionException
-
Este error indica que está llamando a una operación en Amazon QuickSighten la que la edición no incluye soporte para esa operación. Amazon QuickSight tiene Standard Edition y Enterprise Edition. No todas las operaciones y funciones están disponibles en todas las ediciones.
Código de estado HTTP: 403
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:
