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 de una Amazon existente QuickSight análisis 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 del URI La solicitud utiliza los siguientes parámetros URI. ** [AwsAccountId](#API_UpdateTemplate_RequestSyntax) ** El ID de laAWScuenta que contiene la plantilla que estás actualizando. Restricciones de longitud Longitud fija de 12. Patrón: `^[0-9]{12}$` Obligatorio Sí ** [TemplateId](#API_UpdateTemplate_RequestSyntax) ** El identificador de la plantilla. 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. ** [SourceEntity](#API_UpdateTemplate_RequestSyntax) ** La entidad que utiliza como fuente cuando actualiza la plantilla. En`SourceEntity`, especificas el tipo de objeto que utilizas como fuente:`SourceTemplate`para una plantilla o`SourceAnalysis`para un análisis de. Ambas opciones requieren un nombre de recurso de Amazon (ARN). Para`SourceTemplate`, especifique el ARN de la plantilla de origen. Para`SourceAnalysis`, especifique el ARN del análisis de origen. La`SourceTemplate`El ARN puede contener cualquierAWScuenta y cualquier Amazon QuickSight-admitidoRegión de AWS;. Usar`DataSetReferences`entidad dentro`SourceTemplate`o`SourceAnalysis`para enumerar los conjuntos de datos de reemplazo para los marcadores de posición que aparecen en el original. El esquema de cada conjunto de datos debe coincidir con su marcador de posición. Tipo: objeto [TemplateSourceEntity](API_TemplateSourceEntity.md) Obligatorio Sí ** [Name](#API_UpdateTemplate_RequestSyntax) ** El nombre de la plantilla. Type: Cadena Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres. Obligatorio No ** [VersionDescription](#API_UpdateTemplate_RequestSyntax) ** Una descripción de la versión actual de la plantilla que se está actualizando. Cada vez que llamas`UpdateTemplate`, se crea una nueva versión de la plantilla. Cada versión de la plantilla mantiene una descripción de la versión en el`VersionDescription`. 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", "TemplateId": "string", "VersionArn": "string" } ``` ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve la siguiente respuesta HTTP. ** [Status](#API_UpdateTemplate_ResponseSyntax) ** El estado HTTP de la solicitud. El servicio devuelve los datos siguientes en formato JSON. ** [Arn](#API_UpdateTemplate_ResponseSyntax) ** El nombre de recurso de Amazon (ARN) de la plantilla. Type: Cadena ** [CreationStatus](#API_UpdateTemplate_ResponseSyntax) ** El estado de creación de la plantilla. Type: Cadena Valores válidos:` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` ** [RequestId](#API_UpdateTemplate_ResponseSyntax) ** LaAWSID de la operación. Type: Cadena ** [TemplateId](#API_UpdateTemplate_ResponseSyntax) ** El identificador de la plantilla. Type: Cadena Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres. Patrón: `[\w\-]+` ** [VersionArn](#API_UpdateTemplate_ResponseSyntax) ** El ARN de la plantilla, incluida la información de versión de la primera versión. Type: Cadena ## Errores Para obtener información sobre los errores que son comunes a todas las acciones, consulte[Errores comunes](CommonErrors.md). ** 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 ** 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 una operación en una Amazon QuickSighten la que la edición no incluye soporte para esa operación. Amazon QuickSight actualmente 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: + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/UpdateTemplate) + [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/UpdateTemplate) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/UpdateTemplate) + [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/UpdateTemplate) + [SDK para Java V2 de AWS](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/UpdateTemplate) + [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/UpdateTemplate) + [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/UpdateTemplate) + [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/UpdateTemplate) + [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/UpdateTemplate)