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.

# CreateFolder
<a name="API_CreateFolder"></a>

Erstellt einen leeren Freigabeordner.

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

```
POST /accounts/AwsAccountId/folders/FolderId HTTP/1.1
Content-type: application/json

{
   "FolderType": "string",
   "Name": "string",
   "ParentFolderArn": "string",
   "Permissions": [ 
      { 
         "Actions": [ "string" ],
         "Principal": "string"
      }
   ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [AwsAccountId](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-AwsAccountId"></a>
Die -ID derAWSKonto, in der Sie den Ordner erstellen möchten.  
Längenbeschränkungen: Feste Länge von 12.  
Pattern: `^[0-9]{12}$`   
Erforderlich: Ja

 ** [FolderId](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-FolderId"></a>
Die ID des Ordners.  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.  
Pattern: `[\w\-]+`   
Erforderlich: Ja

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [FolderType](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-FolderType"></a>
Der Typ des Ordners. Der Standardwert für `folderType` ist `SHARED`.  
Type: String  
Zulässige Werte:` SHARED`   
Erforderlich: Nein

 ** [Name](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-Name"></a>
Der Name des Verzeichnisses.  
Type: String  
Längenbeschränkungen: Mindestlänge 1. Höchstlänge = 200 Zeichen.  
Erforderlich: Nein

 ** [ParentFolderArn](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-ParentFolderArn"></a>
Der Amazon-Ressourcenname (ARN) für den übergeordneten Ordner.  
 `ParentFolderArn`kann Null sein. Ein leeres`parentFolderArn`erstellt einen Ordner auf Stammebene.  
Type: String  
Erforderlich: Nein

 ** [Permissions](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-Permissions"></a>
Eine Struktur, die die Prinzipale und die Berechtigungen auf Ressourcenebene eines Ordners beschreibt.  
Um keine Berechtigungen anzugeben, lassen Sie`Permissions`.  
Type: Array[ResourcePermission](API_ResourcePermission.md)Objekte  
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 64 Elemente.  
Erforderlich: Nein

 ** [Tags](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-Tags"></a>
Tags für den Ordner.  
Type: Array[Tag](API_Tag.md)Objekte  
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 50 Elemente.  
Erforderlich: Nein

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

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

{
   "Arn": "string",
   "FolderId": "string",
   "RequestId": "string"
}
```

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

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

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

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

 ** [Arn](#API_CreateFolder_ResponseSyntax) **   <a name="QS-CreateFolder-response-Arn"></a>
Der Amazon-Ressourcenname (ARN) für den neu erstellten Ordner.  
Type: String

 ** [FolderId](#API_CreateFolder_ResponseSyntax) **   <a name="QS-CreateFolder-response-FolderId"></a>
Die Ordner-ID für den neu erstellten Ordner.  
Type: String  
Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.  
Pattern: `[\w\-]+` 

 ** [RequestId](#API_CreateFolder_ResponseSyntax) **   <a name="QS-CreateFolder-response-RequestId"></a>
Die Anforderungs-ID für den neu erstellten Ordner.  
Type: String

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

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

 ** AccessDeniedException **   
Sie haben keinen Zugriff auf diese Komponente. Die bereitgestellten Anmeldeinformationen konnten nicht überprüft werden. Sie sind möglicherweise nicht berechtigt, die Anforderung auszuführen. Stellen Sie sicher, dass Ihr Konto für die Nutzung von Amazon autorisiert ist QuickSight -Statuscode, dass Ihre Richtlinien die korrekten Berechtigungen besitzen und dass Sie die richtigen Zugriffsschlüssel verwenden.  
HTTP Status Code: 401

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

 ** InternalFailureException **   
Es ist ein interner Fehler aufgetreten.  
HTTP Status Code: 500

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

 ** LimitExceededException **   
Ein Limit wurde überschritten.  
HTTP Status Code: 409

 ** ResourceExistsException **   
Die angegebene Ressource ist bereits vorhanden.   
HTTP Status Code: 409

 ** ResourceNotFoundException **   
Mindestens eine Ressource kann nicht gefunden werden.  
HTTP Status Code: 404

 ** ThrottlingException **   
Der Zugriff wird gedrosselt  
HTTP Status Code: 429

 ** UnsupportedUserEditionException **   
Dabei zeigt an, dass Sie eine Operation bei 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 Status Code: 403

## Weitere Informationen finden Sie unter:
<a name="API_CreateFolder_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/CreateFolder) 
+  [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateFolder) 
+  [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateFolder) 
+  [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateFolder) 
+  [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateFolder) 
+  [AWSSDK-für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateFolder) 
+  [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateFolder) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateFolder) 
+  [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateFolder)