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.
# DescribeTemplate
Describe los metadatos de una plantilla.
## Sintaxis de la solicitud
```
GET /accounts/AwsAccountId/templates/TemplateId?alias-name=AliasName&version-number=VersionNumber HTTP/1.1
```
## Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
** [AliasName](#API_DescribeTemplate_RequestSyntax) **
El alias de la plantilla que desea describir. Si nombra un alias específico, describe la versión a la que apunta el alias. Puede especificar la última versión de la plantilla proporcionando la palabra clave`$LATEST`en la`AliasName`Parámetro. La palabra clave`$PUBLISHED`no se aplica a plantillas.
Restricciones de longitud Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón: `[\w\-]+|(\$LATEST)|(\$PUBLISHED)`
** [AwsAccountId](#API_DescribeTemplate_RequestSyntax) **
El ID de laAWScuenta que contiene la plantilla que estás describiendo.
Restricciones de longitud Longitud fija de 12.
Patrón: `^[0-9]{12}$`
Obligatorio: Sí
** [TemplateId](#API_DescribeTemplate_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í
** [VersionNumber](#API_DescribeTemplate_RequestSyntax) **
(Opcional) El número de la versión que se deben describir. Si una`VersionNumber`no se proporciona el valor de parámetros de. Se describe la última versión de la plantilla.
Rango válido: Valor mínimo de 1.
## Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
## Sintaxis de la respuesta
```
HTTP/1.1 Status
Content-type: application/json
{
"RequestId": "string",
"Template": {
"Arn": "string",
"CreatedTime": number,
"LastUpdatedTime": number,
"Name": "string",
"TemplateId": "string",
"Version": {
"CreatedTime": number,
"DataSetConfigurations": [
{
"ColumnGroupSchemaList": [
{
"ColumnGroupColumnSchemaList": [
{
"Name": "string"
}
],
"Name": "string"
}
],
"DataSetSchema": {
"ColumnSchemaList": [
{
"DataType": "string",
"GeographicRole": "string",
"Name": "string"
}
]
},
"Placeholder": "string"
}
],
"Description": "string",
"Errors": [
{
"Message": "string",
"Type": "string"
}
],
"Sheets": [
{
"Name": "string",
"SheetId": "string"
}
],
"SourceEntityArn": "string",
"Status": "string",
"ThemeArn": "string",
"VersionNumber": number
}
}
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve la siguiente respuesta HTTP.
** [Status](#API_DescribeTemplate_ResponseSyntax) **
El estado HTTP de la solicitud.
El servicio devuelve los datos siguientes en formato JSON.
** [RequestId](#API_DescribeTemplate_ResponseSyntax) **
LaAWSID de solicitud de esta operación.
Type: Cadena
** [Template](#API_DescribeTemplate_ResponseSyntax) **
La estructura de plantilla del objeto que desea describir.
Tipo: objeto [Template](API_Template.md)
## Errores
Para obtener información sobre errores que son comunes a todas las acciones, consulte[Errores comunes](CommonErrors.md).
** 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 sus 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 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 Amazon QuickSight actualmente tiene Standard 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/DescribeTemplate)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/DescribeTemplate)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/DescribeTemplate)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/DescribeTemplate)
+ [SDK para Java V2 de AWS](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/DescribeTemplate)
+ [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/DescribeTemplate)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/DescribeTemplate)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/DescribeTemplate)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/DescribeTemplate)