Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# DescribeTemplate
<a name="API_DescribeTemplate"></a>

Descrive i metadati di un modello.

## Sintassi della richiesta
<a name="API_DescribeTemplate_RequestSyntax"></a>

```
GET /accounts/AwsAccountId/templates/TemplateId?alias-name=AliasName&version-number=VersionNumber HTTP/1.1
```

## Parametri della richiesta URI:
<a name="API_DescribeTemplate_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [AliasName](#API_DescribeTemplate_RequestSyntax) **   <a name="QS-DescribeTemplate-request-AliasName"></a>
L'alias del modello da descrivere. Se si nomina un alias specifico, viene descritta la versione a cui punta l'alias. Puoi specificare la versione più recente del modello fornendo la parola chiave`$LATEST`nella`AliasName`Parametro . La parola chiave`$PUBLISHED`non si applica ai modelli.  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.  
Modello: `[\w\-]+|(\$LATEST)|(\$PUBLISHED)` 

 ** [AwsAccountId](#API_DescribeTemplate_RequestSyntax) **   <a name="QS-DescribeTemplate-request-AwsAccountId"></a>
L'ID delAWSaccount che contiene il modello che stai descrivendo.  
Vincoli di lunghezza: Lunghezza fissa di 12.  
Modello: `^[0-9]{12}$`   
Campo obbligatorio: Sì

 ** [TemplateId](#API_DescribeTemplate_RequestSyntax) **   <a name="QS-DescribeTemplate-request-TemplateId"></a>
L'ID del modello.  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.  
Modello: `[\w\-]+`   
Campo obbligatorio: Sì

 ** [VersionNumber](#API_DescribeTemplate_RequestSyntax) **   <a name="QS-DescribeTemplate-request-VersionNumber"></a>
(Facoltativo) Numero della versione da descrivere. Se un`VersionNumber`il valore del parametro non viene fornito, viene descritta la versione più recente del modello.  
Intervallo valido: Valore minimo di 1.

## Corpo della richiesta
<a name="API_DescribeTemplate_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeTemplate_ResponseSyntax"></a>

```
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
      }
   }
}
```

## Elementi di risposta
<a name="API_DescribeTemplate_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP.

 ** [Status](#API_DescribeTemplate_ResponseSyntax) **   <a name="QS-DescribeTemplate-response-Status"></a>
Lo stato HTTP della richiesta.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [RequestId](#API_DescribeTemplate_ResponseSyntax) **   <a name="QS-DescribeTemplate-response-RequestId"></a>
LaAWSID richiesta per questa operazione.  
Type: Stringa

 ** [Template](#API_DescribeTemplate_ResponseSyntax) **   <a name="QS-DescribeTemplate-response-Template"></a>
La struttura del modello per l'oggetto che si intende descrivere.  
Tipo: [Template](API_Template.md) oggetto

## Errori
<a name="API_DescribeTemplate_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Non hai l'accesso. Le credenziali fornite non possono essere convalidate. È possibile che non sei autorizzato a effettuare la richiesta. Assicurati che il tuo account sia autorizzato a utilizzare Amazon QuickSight , che le policy abbiano le autorizzazioni corrette e che siano utilizzate le chiavi di accesso corrette.  
Codice di stato HTTP: 401

 ** ConflictException **   
L'aggiornamento o l'eliminazione di una risorsa può causare uno stato incoerente.  
Codice di stato HTTP: 409

 ** InternalFailureException **   
Si è verificato un errore interno.  
Codice di stato HTTP: 500

 ** InvalidParameterValueException **   
Uno o più parametri hanno un valore non valido.  
Codice di stato HTTP: 400

 ** ResourceExistsException **   
La risorsa specificata esiste già.   
Codice di stato HTTP: 409

 ** ResourceNotFoundException **   
Uno o più risorse non sono state trovate.  
Codice di stato HTTP: 404

 ** ThrottlingException **   
L'accesso è limitato.  
Codice di stato HTTP: 429

 ** UnsupportedUserEditionException **   
Questo errore indica che si sta chiamando un'operazione su Amazon QuickSightabbonamento in cui l'edizione non include il supporto per tale operazione. Amazon Amazon QuickSight al momento ha Standard Edition ed Enterprise Edition. Non tutte le operazioni e funzionalità sono disponibili in ogni edizione.  
Codice di stato HTTP: 403

## Vedi anche
<a name="API_DescribeTemplate_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/DescribeTemplate) 
+  [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/DescribeTemplate) 
+  [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/DescribeTemplate) 
+  [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/DescribeTemplate) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/DescribeTemplate) 
+  [AWSSDK per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/DescribeTemplate) 
+  [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/DescribeTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/DescribeTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/DescribeTemplate)