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

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

Crea una cartella condivisa vuota.

## Sintassi della richiesta
<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"
      }
   ]
}
```

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

La richiesta utilizza i seguenti parametri URI.

 ** [AwsAccountId](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-AwsAccountId"></a>
L'ID perAWSaccount in cui si desidera creare la cartella.  
Limitazioni relative alla lunghezza: Lunghezza fissa: 12.  
Modello: `^[0-9]{12}$`   
Campo obbligatorio: Sì

 ** [FolderId](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-FolderId"></a>
L'ID della cartella.  
Limitazioni relative alla lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.  
Modello: `[\w\-]+`   
Campo obbligatorio: Sì

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [FolderType](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-FolderType"></a>
Il tipo di cartella. Per impostazione predefinita, `folderType` è `SHARED`.  
Type: Stringa  
Valori validi: ` SHARED`   
Campo obbligatorio: No

 ** [Name](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-Name"></a>
Il nome della cartella.  
Type: Stringa  
Limitazioni relative alla lunghezza: Lunghezza minima pari a 1. Lunghezza massima di 200.  
Campo obbligatorio: No

 ** [ParentFolderArn](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-ParentFolderArn"></a>
L'Amazon Resource Name (ARN) per la cartella principale.  
 `ParentFolderArn`può essere null. Un vuoto`parentFolderArn`crea una cartella a livello di root.  
Type: Stringa  
Campo obbligatorio: No

 ** [Permissions](#API_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-Permissions"></a>
Struttura che descrive i principali e le autorizzazioni a livello di risorsa di una cartella.  
Per non specificare alcuna autorizzazione, omettere`Permissions`.  
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_CreateFolder_RequestSyntax) **   <a name="QS-CreateFolder-request-Tags"></a>
Etichette per la cartella.  
Type: Matrice di[Tag](API_Tag.md)oggetti  
Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 200 elementi.  
Campo obbligatorio: No

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

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

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

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

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

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

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

 ** [Arn](#API_CreateFolder_ResponseSyntax) **   <a name="QS-CreateFolder-response-Arn"></a>
L'Amazon Resource Name (ARN) per la cartella appena creata.  
Type: Stringa

 ** [FolderId](#API_CreateFolder_ResponseSyntax) **   <a name="QS-CreateFolder-response-FolderId"></a>
L'ID della cartella per la cartella appena creata.  
Type: Stringa  
Limitazioni relative alla lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.  
Modello: `[\w\-]+` 

 ** [RequestId](#API_CreateFolder_ResponseSyntax) **   <a name="QS-CreateFolder-response-RequestId"></a>
L'ID della richiesta per la cartella appena creata.  
Type: Stringa

## Errori
<a name="API_CreateFolder_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.  
Codice stato HTTP: 401

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

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

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

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

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

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

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

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

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