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à.
SearchFolders
Esegue la ricerca nelle sottocartelle di una cartella.
Sintassi della richiesta
POST /accounts/AwsAccountId/search/folders HTTP/1.1
Content-type: application/json
{
"Filters": [
{
"Name": "string",
"Operator": "string",
"Value": "string"
}
],
"MaxResults": number,
"NextToken": "string"
}Parametri della richiesta URI:
La richiesta utilizza i seguenti parametri URI.
- AwsAccountId
-
L'ID delAWSaccount contenente la cartella.
Vincoli di lunghezza: Lunghezza fissa di 12.
Modello:
^[0-9]{12}$Campo obbligatorio: Sì
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- Filters
-
I filtri da applicare alla ricerca. Al momento, puoi cercare solo in base alla cartella principale ARN. Ad esempio,
"Filters": [ { "Name": "PARENT_FOLDER_ARN", "Operator": "StringEquals", "Value": "arn:aws:quicksight:us-east-1:1:folder/folderId" } ].Type: MatriceFolderSearchFilteroggetti
Membri della matrice Numero massimo di 100 elementi.
Campo obbligatorio: Sì
- MaxResults
-
Numero massimo di risultati da restituire per ogni richiesta.
Type: Numero intero
Intervallo valido: Valore minimo di 1. valore massimo pari a 100.
Campo obbligatorio: No
- NextToken
-
Token per il successivo set di risultati oppure null se non ci sono altri risultati.
Type: Stringa
Campo obbligatorio: No
Sintassi della risposta
HTTP/1.1 Status
Content-type: application/json
{
"FolderSummaryList": [
{
"Arn": "string",
"CreatedTime": number,
"FolderId": "string",
"FolderType": "string",
"LastUpdatedTime": number,
"Name": "string"
}
],
"NextToken": "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.
- FolderSummaryList
-
Una struttura che contiene tutte le cartelle nellaAWSconto. Questa struttura fornisce informazioni di base sulle cartelle.
Type: MatriceFolderSummaryoggetti
Membri della matrice Numero massimo di 100 elementi.
- NextToken
-
Token per il successivo set di risultati oppure null se non ci sono altri risultati.
Type: Stringa
- RequestId
-
LaAWSID della richiesta per questa operazione.
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 e che siano utilizzate le chiavi di accesso corrette.
Codice di stato HTTP: 401
- InternalFailureException
-
Si è verificato un errore interno.
Codice di stato HTTP: 500
- InvalidNextTokenException
-
Il valore
NextTokennon è valido.Codice di stato HTTP: 400
- InvalidParameterValueException
-
Uno o più parametri hanno un valore non valido.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Uno o più risorse non sono state trovate.
Codice di stato HTTP: 404
- ThrottlingException
-
L'accesso è limitato.
Codice di stato HTTP: 429
- UnsupportedUserEditionException
-
Questo errore indica che si sta chiamando un'operazione su Amazon QuickSightabbonamento in cui l'edizione non include il supporto per tale operazione. Amazon Amazon QuickSight al momento ha Standard Edition ed Enterprise Edition. Non tutte le operazioni e funzionalità sono disponibili in ogni edizione.
Codice di stato HTTP: 403
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
