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à.

# CreateTemplate
<a name="API_CreateTemplate"></a>

Crea un modello da un'Amazon esistente QuickSight analisi o modello. È possibile utilizzare il modello risultante per creare un dashboard.

UN*modello*è un'entità in Amazon QuickSight che incapsula i metadati necessari per creare un'analisi e che è possibile utilizzare per creare il dashboard. Un modello aggiunge un livello di astrazione utilizzando i segnaposto per sostituire il set di dati associato all'analisi. È possibile utilizzare i modelli per creare dashboard sostituendo i segnaposto del set di dati con set di dati che seguono lo stesso schema utilizzato per creare l'analisi e il modello di origine.

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

```
POST /accounts/AwsAccountId/templates/TemplateId HTTP/1.1
Content-type: application/json

{
   "Name": "string",
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "SourceEntity": { 
      "SourceAnalysis": { 
         "Arn": "string",
         "DataSetReferences": [ 
            { 
               "DataSetArn": "string",
               "DataSetPlaceholder": "string"
            }
         ]
      },
      "SourceTemplate": { 
         "Arn": "string"
      }
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "VersionDescription": "string"
}
```

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

La richiesta utilizza i seguenti parametri URI.

 ** [AwsAccountId](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-AwsAccountId"></a>
L'ID delAWSconto in cui si trova il gruppo. Si utilizza l'ID perAWSaccount che contiene il tuo Amazon QuickSight conto.  
Vincoli di lunghezza: Lunghezza fissa di 12.  
Modello: `^[0-9]{12}$`   
Campo obbligatorio: Sì

 ** [TemplateId](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-TemplateId"></a>
Un ID per il modello da creare. Questo modello è unico perRegione AWS; in ciascunaAWSconto.  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.  
Modello: `[\w\-]+`   
Campo obbligatorio: Sì

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [SourceEntity](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-SourceEntity"></a>
L'entità che si utilizza come origine quando si crea il modello. Nello stato`SourceEntity`, si specifica il tipo di oggetto che si sta utilizzando come origine:`SourceTemplate`per un modello o`SourceAnalysis`per un'analisi in. Entrambi richiedono l'Amazon Resource Name (ARN). Per`SourceTemplate`, specificare l'ARN del modello di origine. Per`SourceAnalysis`, specificare l'ARN dell'analisi dell'origine. La`SourceTemplate`L'ARN può contenere qualsiasiAWSaccount e qualsiasi Amazon QuickSight-supportatoRegione AWS.   
Utilizzo dell'`DataSetReferences`entità all'interno`SourceTemplate`o`SourceAnalysis`per elencare i set di dati sostitutivi per i segnaposto elencati nell'originale. Lo schema in ogni set di dati deve corrispondere al relativo segnaposto.   
Tipo: [TemplateSourceEntity](API_TemplateSourceEntity.md) oggetto  
Campo obbligatorio: Sì

 ** [Name](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-Name"></a>
Il nome visualizzato per il modello.  
Type: Stringa  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.  
Campo obbligatorio: No

 ** [Permissions](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-Permissions"></a>
Un elenco di autorizzazioni per le risorse da impostare sul modello.   
Type: Matrice di[ResourcePermission](API_ResourcePermission.md)oggetti  
Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 64 elementi.  
Campo obbligatorio: No

 ** [Tags](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-Tags"></a>
Contiene una mappa delle coppie chiave-valore per il tag o i tag di risorsa assegnati alla risorsa.  
Type: Matrice di[Tag](API_Tag.md)oggetti  
Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 200 elementi.  
Campo obbligatorio: No

 ** [VersionDescription](#API_CreateTemplate_RequestSyntax) **   <a name="QS-CreateTemplate-request-VersionDescription"></a>
Una descrizione della versione del modello corrente in fase di creazione. Questa operazione API crea la prima versione del modello. Ogni volta`UpdateTemplate`si chiama, viene creata una nuova versione. Ogni versione del modello conserva una descrizione della versione nella`VersionDescription`.  
Type: Stringa  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 512 caratteri.  
Campo obbligatorio: No

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

```
HTTP/1.1 Status
Content-type: application/json

{
   "Arn": "string",
   "CreationStatus": "string",
   "RequestId": "string",
   "TemplateId": "string",
   "VersionArn": "string"
}
```

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

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

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

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

 ** [Arn](#API_CreateTemplate_ResponseSyntax) **   <a name="QS-CreateTemplate-response-Arn"></a>
L'ARN per il modello.  
Type: Stringa

 ** [CreationStatus](#API_CreateTemplate_ResponseSyntax) **   <a name="QS-CreateTemplate-response-CreationStatus"></a>
Lo stato di creazione del modello.  
Type: Stringa  
Valori validi: ` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` 

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

 ** [TemplateId](#API_CreateTemplate_ResponseSyntax) **   <a name="QS-CreateTemplate-response-TemplateId"></a>
L'ID del modello.  
Type: Stringa  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.  
Modello: `[\w\-]+` 

 ** [VersionArn](#API_CreateTemplate_ResponseSyntax) **   <a name="QS-CreateTemplate-response-VersionArn"></a>
L'ARN per il modello, comprese le informazioni sulla versione della prima versione.  
Type: Stringa

## Errori
<a name="API_CreateTemplate_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

 ** LimitExceededException **   
È stato superato un limite.  
Codice di stato HTTP: 409

 ** 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 attualmente 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_CreateTemplate_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/CreateTemplate) 
+  [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateTemplate) 
+  [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateTemplate) 
+  [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateTemplate) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateTemplate) 
+  [AWSSDK per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateTemplate) 
+  [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateTemplate)