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.
UpdateTheme
Actualiza un tema.
Sintaxis de la solicitud
PUT /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
",
"VersionDescription": "string
"
}
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- AwsAccountId
-
El ID de laAWScuenta que contiene el tema que estás actualizando.
Restricciones de longitud Longitud fija de 12.
Patrón:
^[0-9]{12}$
Obligatorio: Sí
- ThemeId
-
El ID del tema.
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, definido por Amazon QuickSight, que hereda un tema personalizado. Todos los temas se heredan inicialmente de un Amazon predeterminado QuickSight tema.
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: No
- Name
-
El nombre del tema.
Type: Cadena
Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Obligatorio: No
- VersionDescription
-
Una descripción de la versión del tema que actualizas cada vez que llamas
UpdateTheme
, crea una versión nueva del tema. Cada versión del tema mantiene una descripción de la versión enVersionDescription
.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 ID 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) de la nueva versión del 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 encontraron 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 Amazon QuickSight tiene actualmente 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: