CreateFolder - Amazon QuickSight
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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

Crea una cartella condivisa vuota.

Sintassi della richiesta

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:

La richiesta utilizza i seguenti parametri URI.

AwsAccountId

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

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

La richiesta accetta i seguenti dati in formato JSON.

FolderType

Il tipo di cartella. Per impostazione predefinita, folderType è SHARED.

Type: Stringa

Valori validi: SHARED

Campo obbligatorio: No

Name

Il nome della cartella.

Type: Stringa

Limitazioni relative alla lunghezza: Lunghezza minima pari a 1. Lunghezza massima di 200.

Campo obbligatorio: No

ParentFolderArn

L'Amazon Resource Name (ARN) per la cartella principale.

ParentFolderArnpuò essere null. Un vuotoparentFolderArncrea una cartella a livello di root.

Type: Stringa

Campo obbligatorio: No

Permissions

Struttura che descrive i principali e le autorizzazioni a livello di risorsa di una cartella.

Per non specificare alcuna autorizzazione, ometterePermissions.

Type: Matrice diResourcePermissionoggetti

Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 64 elementi.

Campo obbligatorio: No

Tags

Etichette per la cartella.

Type: Matrice diTagoggetti

Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 200 elementi.

Campo obbligatorio: No

Sintassi della risposta

HTTP/1.1 Status
Content-type: application/json

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

Elementi di risposta

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

Status

Lo stato HTTP della richiesta.

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

Arn

L'Amazon Resource Name (ARN) per la cartella appena creata.

Type: Stringa

FolderId

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

L'ID della richiesta per la cartella appena creata.

Type: Stringa

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

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

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: