UpdateTemplate -

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.

UpdateTemplate

Actualiza una plantilla a partir de un análisis existente de Amazon QuickSight u otra plantilla.

Sintaxis de la solicitud

PUT /accounts/AwsAccountId/templates/TemplateId HTTP/1.1 Content-type: application/json { "Name": "string", "SourceEntity": { "SourceAnalysis": { "Arn": "string", "DataSetReferences": [ { "DataSetArn": "string", "DataSetPlaceholder": "string" } ] }, "SourceTemplate": { "Arn": "string" } }, "VersionDescription": "string" }

Parámetros de solicitud URI

La solicitud utiliza los siguientes parámetros URI.

AwsAccountId

El ID de la cuenta de AWS que contiene la plantilla que está actualizando.

Restricciones: Longitud fija de 12.

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

: obligatorio Sí

TemplateId

El identificador de la plantilla.

Restricciones: 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.

SourceEntity

Entidad que está utilizando como origen al actualizar la plantilla. EnSourceEntity, especifica el tipo de objeto que está utilizando como fuente:SourceTemplatepara una plantilla oSourceAnalysispara un análisis de. Ambos requieren un nombre de recurso de Amazon (ARN). ParaSourceTemplate, especifique el ARN de la plantilla de origen. ParaSourceAnalysis, especifique el ARN del análisis de origen. LaSourceTemplateARN puede contener cualquier cuenta de AWS y cualquier región de AWS compatible con QuickSight.

UsarDataSetReferencesentidad dentro deSourceTemplateorSourceAnalysispara enumerar los datasets de reemplazo de los marcadores de posición enumerados en el original. El esquema de cada dataset debe coincidir con su marcador de posición.

Tipo: objeto TemplateSourceEntity

: obligatorio Sí

Nombre

El nombre de la plantilla.

Tipo: Cadena

Restricciones: Longitud mínima de 1. La longitud máxima es de 2048 caracteres.

: obligatorio No

VersionDescription

Una descripción de la versión de plantilla actual que se está actualizando. Cada vez que llamaUpdateTemplate, cree una nueva versión de la plantilla. Cada versión de la plantilla mantiene una descripción de la versión en elVersionDescriptionfield.

Tipo: Cadena

Restricciones: 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", "TemplateId": "string", "VersionArn": "string" }

Elementos de respuesta

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

Estado

El estado HTTP de la solicitud.

El servicio devuelve los datos siguientes en formato JSON.

Arn

El nombre de recurso de Amazon (ARN) para la plantilla.

Tipo: Cadena

Estado de creación

El estado de creación de la plantilla.

Tipo: Cadena

Valores válidos: CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED

RequestId

ID de solicitud de AWS de esta operación.

Tipo: Cadena

TemplateId

El identificador de la plantilla.

Tipo: Cadena

Restricciones: Longitud mínima de 1. La longitud máxima es de 2048 caracteres.

Patrón: [\w\-]+

VersionArn

El ARN de la plantilla, incluida la información de la versión de la primera versión.

Tipo: Cadena

Errors

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

ConflictExcepción

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

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 una suscripción de Amazon QuickSight en la que la edición no admite esa operación. Las ediciones actuales de Amazon QuickSight son 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: