

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# UpdateTemplate
<a name="API_UpdateTemplate"></a>

Aktualisiert eine Vorlage aus einem vorhandenen Amazon QuickSight Analyse oder eine andere Vorlage.

## Anforderungssyntax
<a name="API_UpdateTemplate_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_UpdateTemplate_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [AwsAccountId](#API_UpdateTemplate_RequestSyntax) **   <a name="QS-UpdateTemplate-request-AwsAccountId"></a>
Die ID derAWSKonto, das die Vorlage enthält, die Sie aktualisieren.  
Längenbeschränkungen: Feste Länge von 12.  
Pattern: `^[0-9]{12}$`   
Erforderlich: Ja

 ** [TemplateId](#API_UpdateTemplate_RequestSyntax) **   <a name="QS-UpdateTemplate-request-TemplateId"></a>
Die ID für die Vorlage.  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.  
Pattern: `[\w\-]+`   
Erforderlich: Ja

## Anforderungstext
<a name="API_UpdateTemplate_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [SourceEntity](#API_UpdateTemplate_RequestSyntax) **   <a name="QS-UpdateTemplate-request-SourceEntity"></a>
Die Entität, die Sie beim Aktualisieren der Vorlage als Quelle verwenden. In :`SourceEntity`geben Sie den Objekttyp an, den Sie als Quelle verwenden:`SourceTemplate`für eine Vorlage oder`SourceAnalysis`für eine -Analyse. Beide erfordern einen Amazon-Ressourcenname (ARN). Für`SourceTemplate`geben Sie den ARN der Quellvorlage an. Für`SourceAnalysis`geben Sie den ARN der Quellanalyse an. Die`SourceTemplate`ARN kann beliebige enthaltenAWSKonto und irgendein Amazon QuickSight-unterstütztAWS-Region;.   
Verwenden der`DataSetReferences`Entität innerhalb`SourceTemplate`oder`SourceAnalysis`, um die Ersatz-Datensätze für die im Original aufgeführten Platzhalter aufzulisten. Das Schema in jedem Datensatz muss mit seinem Platzhalter übereinstimmen.   
Typ: [TemplateSourceEntity](API_TemplateSourceEntity.md) Objekt  
Erforderlich: Ja

 ** [Name](#API_UpdateTemplate_RequestSyntax) **   <a name="QS-UpdateTemplate-request-Name"></a>
Name der Vorlage.  
Type: String  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.  
Erforderlich: Nein

 ** [VersionDescription](#API_UpdateTemplate_RequestSyntax) **   <a name="QS-UpdateTemplate-request-VersionDescription"></a>
Eine Beschreibung der aktuellen Vorlagenversion, die aktualisiert wird. Jedes Mal, wenn Sie anrufen`UpdateTemplate`erstellen Sie eine neue Version der Vorlage. Jede Version der Vorlage enthält eine Beschreibung der Version in der`VersionDescription`field.  
Type: String  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge von 512.  
Erforderlich: Nein

## Antwortsyntax
<a name="API_UpdateTemplate_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_UpdateTemplate_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Dienst die folgende HTTP-Antwort zurück.

 ** [Status](#API_UpdateTemplate_ResponseSyntax) **   <a name="QS-UpdateTemplate-response-Status"></a>
Der HTTP-Status der Anforderung.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [Arn](#API_UpdateTemplate_ResponseSyntax) **   <a name="QS-UpdateTemplate-response-Arn"></a>
Der Amazon-Ressourcenname (ARN) für die Vorlage.  
Type: String

 ** [CreationStatus](#API_UpdateTemplate_ResponseSyntax) **   <a name="QS-UpdateTemplate-response-CreationStatus"></a>
Der Erstellungsstatus der Vorlage.  
Type: String  
Zulässige Werte:` CREATION_IN_PROGRESS | CREATION_SUCCESSFUL | CREATION_FAILED | UPDATE_IN_PROGRESS | UPDATE_SUCCESSFUL | UPDATE_FAILED | DELETED` 

 ** [RequestId](#API_UpdateTemplate_ResponseSyntax) **   <a name="QS-UpdateTemplate-response-RequestId"></a>
DieAWSAnforderungs-ID für diese Operation.  
Type: String

 ** [TemplateId](#API_UpdateTemplate_ResponseSyntax) **   <a name="QS-UpdateTemplate-response-TemplateId"></a>
Die ID für die Vorlage.  
Type: String  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.  
Pattern: `[\w\-]+` 

 ** [VersionArn](#API_UpdateTemplate_ResponseSyntax) **   <a name="QS-UpdateTemplate-response-VersionArn"></a>
Der ARN für die Vorlage, einschließlich der Versionsinformationen der ersten Version.  
Type: String

## Fehler
<a name="API_UpdateTemplate_Errors"></a>

Hinweise zu den Fehlern, die bei allen Aktionen auftreten, finden Sie unter[Häufige Fehler](CommonErrors.md).

 ** ConflictException **   
Das Aktualisieren oder Löschen einer Ressource kann zu einem inkonsistenten Zustand führen.  
HTTP-Statuscode: 409

 ** InternalFailureException **   
Es ist ein interner Fehler aufgetreten.  
HTTP-Statuscode: 500

 ** InvalidParameterValueException **   
Ein oder mehrere Parameter haben einen Wert, der nicht gültig ist.  
HTTP-Statuscode: 400

 ** LimitExceededException **   
Ein Limit wurde überschritten.  
HTTP-Statuscode: 409

 ** ResourceExistsException **   
Die angegebene Ressource ist bereits vorhanden.   
HTTP-Statuscode: 409

 ** ResourceNotFoundException **   
Mindestens eine Ressource kann nicht gefunden werden.  
HTTP-Statuscode: 404

 ** ThrottlingException **   
Der Zugriff wird gedrosselt  
HTTP-Statuscode: 429

 ** UnsupportedUserEditionException **   
Dieser Fehler zeigt an, dass Sie eine Operation mit einem Amazon durchführen QuickSightAbonnement, bei dem die Edition keine Unterstützung für diesen Vorgang enthält. Amazon QuickSight verfügt derzeit über eine Standard Edition und eine Enterprise Edition. Nicht jede Operation und Funktion ist in jeder Version verfügbar ist.  
HTTP-Statuscode: 403

## Weitere Informationen finden Sie unter:
<a name="API_UpdateTemplate_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
+  [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/UpdateTemplate) 
+  [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/UpdateTemplate) 
+  [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/UpdateTemplate) 
+  [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/UpdateTemplate) 
+  [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/UpdateTemplate) 
+  [AWSSDK-Updates JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/UpdateTemplate) 
+  [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/UpdateTemplate) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/UpdateTemplate) 
+  [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/UpdateTemplate) 