

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.

# CreateAnalysis
<a name="API_CreateAnalysis"></a>

Erstellt eine Analyse in Amazon QuickSight.

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

```
POST /accounts/AwsAccountId/analyses/AnalysisId HTTP/1.1
Content-type: application/json

{
   "Name": "string",
   "Parameters": { 
      "DateTimeParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "DecimalParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "IntegerParameters": [ 
         { 
            "Name": "string",
            "Values": [ number ]
         }
      ],
      "StringParameters": [ 
         { 
            "Name": "string",
            "Values": [ "string" ]
         }
      ]
   },
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "SourceEntity": { 
      "SourceTemplate": { 
         "Arn": "string",
         "DataSetReferences": [ 
            { 
               "DataSetArn": "string",
               "DataSetPlaceholder": "string"
            }
         ]
      }
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThemeArn": "string"
}
```

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

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [AnalysisId](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-AnalysisId"></a>
Die ID der Analyse, die Sie erstellen. Diese ID wird in der URL der Analyse angezeigt.  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.  
Pattern: `[\w\-]+`   
Erforderlich: Ja

 ** [AwsAccountId](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-AwsAccountId"></a>
Die ID derAWSKonto, bei der Sie eine Analyse erstellen.  
Längenbeschränkungen: Feste Länge von 12.  
Pattern: `^[0-9]{12}$`   
Erforderlich: Ja

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [Name](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Name"></a>
Ein beschreibender Name für die Analyse, die Sie erstellen. Dieser Name wird für die Analyse im Amazon angezeigt QuickSight console.   
Type: String  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.  
Erforderlich: Ja

 ** [SourceEntity](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-SourceEntity"></a>
Eine Quellentität, die für die von Ihnen erstellte Analyse verwendet werden soll. Diese Metadatenstruktur enthält Details, die eine Quellvorlage und einen oder mehrere Datensätze beschreiben.  
Typ: [AnalysisSourceEntity](API_AnalysisSourceEntity.md) Objekt  
Erforderlich: Ja

 ** [Parameters](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Parameters"></a>
Die Parameter benennen und überschreiben Werte, die Sie verwenden möchten. Eine Analyse kann einen beliebigen Parametertyp haben, und einige Parameter akzeptieren möglicherweise mehrere Werte.   
Typ: [Parameters](API_Parameters.md) Objekt  
Erforderlich: Nein

 ** [Permissions](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Permissions"></a>
Eine Struktur, die die Prinzipale und Berechtigungen auf Ressourcenebene für eine Analyse beschreibt. Sie können das`Permissions`Struktur zur Erteilung von Berechtigungen durch Bereitstellung einer Liste vonAWS Identity and Access Management(IAM) -Aktionsinformationen für alle nach Amazon-Ressourcennamen (ARN) aufgeführten Prinzipale.   
Um keine Berechtigungen anzugeben, lassen Sie`Permissions`.  
Type: Array von[ResourcePermission](API_ResourcePermission.md)Objekte  
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 64 Elemente.  
Erforderlich: Nein

 ** [Tags](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-Tags"></a>
Enthält eine Zuordnung der Schlüssel-Wert-Paare für die Ressourcen-Tags (n), die der Analyse zugewiesen sind.  
Type: Array von[Tag](API_Tag.md)Objekte  
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 200 Elemente.  
Erforderlich: Nein

 ** [ThemeArn](#API_CreateAnalysis_RequestSyntax) **   <a name="QS-CreateAnalysis-request-ThemeArn"></a>
Der ARN für das Thema, das auf die von Ihnen erstellte Analyse angewendet werden soll. Um das Design im Amazon zu sehen QuickSight -Konsole, stellen Sie sicher, dass Sie Zugriff darauf haben.  
Type: String  
Erforderlich: Nein

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

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

{
   "AnalysisId": "string",
   "Arn": "string",
   "CreationStatus": "string",
   "RequestId": "string"
}
```

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

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

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

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

 ** [AnalysisId](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-AnalysisId"></a>
Die ID der Analyse.  
Type: String  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.  
Pattern: `[\w\-]+` 

 ** [Arn](#API_CreateAnalysis_ResponseSyntax) **   <a name="QS-CreateAnalysis-response-Arn"></a>
Die ARN für die Analyse.  
Type: String

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

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

## Fehler
<a name="API_CreateAnalysis_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

 ** 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 bei einem Amazon durchführen QuickSightAbonnement, bei dem die Edition keine Unterstützung für diesen Vorgang enthält. Amazon 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_CreateAnalysis_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/CreateAnalysis) 
+  [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateAnalysis) 
+  [AWSSDK-für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateAnalysis) 
+  [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateAnalysis) 