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

# SearchGroups
<a name="API_SearchGroups"></a>

Utilizzo dell'`SearchGroups`operazione di ricerca di gruppi in un Amazon specificato QuickSight namespace utilizzando i filtri forniti.

## Sintassi della richiesta
<a name="API_SearchGroups_RequestSyntax"></a>

```
POST /accounts/AwsAccountId/namespaces/Namespace/groups-search?max-results=MaxResults&next-token=NextToken HTTP/1.1
Content-type: application/json

{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Value": "string"
      }
   ]
}
```

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

La richiesta utilizza i seguenti parametri URI.

 ** [AwsAccountId](#API_SearchGroups_RequestSyntax) **   <a name="QS-SearchGroups-request-AwsAccountId"></a>
L'ID delAWSconto in cui si trova il gruppo. Attualmente, si utilizza l'ID per ilAWSaccount che contiene il tuo Amazon QuickSight conto.  
Vincoli di lunghezza: Lunghezza fissa di 12.  
Modello: `^[0-9]{12}$`   
Campo obbligatorio: Sì

 ** [MaxResults](#API_SearchGroups_RequestSyntax) **   <a name="QS-SearchGroups-request-MaxResults"></a>
Numero massimo di risultati da restituire da questa richiesta.  
Intervallo di Valore minimo di 1. valore massimo pari a 100.

 ** [Namespace](#API_SearchGroups_RequestSyntax) **   <a name="QS-SearchGroups-request-Namespace"></a>
Lo spazio dei nomi in cui si desidera effettuare ricerche.  
Vincoli di lunghezza: La lunghezza massima è 64 caratteri.  
Modello: `^[a-zA-Z0-9._-]*$`   
Campo obbligatorio: Sì

 ** [NextToken](#API_SearchGroups_RequestSyntax) **   <a name="QS-SearchGroups-request-NextToken"></a>
Token di paginazione che è possibile utilizzare in una richiesta.

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [Filters](#API_SearchGroups_RequestSyntax) **   <a name="QS-SearchGroups-request-Filters"></a>
La struttura dei filtri di ricerca che si desidera applicare alla ricerca.  
Type: Matrice di[GroupSearchFilter](API_GroupSearchFilter.md)oggetti  
Membri dell'array: Numero minimo di 1 elemento.  
Campo obbligatorio: Sì

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

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

{
   "GroupList": [ 
      { 
         "Arn": "string",
         "Description": "string",
         "GroupName": "string",
         "PrincipalId": "string"
      }
   ],
   "NextToken": "string",
   "RequestId": "string"
}
```

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

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

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

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

 ** [GroupList](#API_SearchGroups_ResponseSyntax) **   <a name="QS-SearchGroups-response-GroupList"></a>
Elenco di gruppi in uno spazio dei nomi specificati che corrispondono ai filtri impostati nel`SearchGroups`.  
Type: Matrice di[Group](API_Group.md)oggetti

 ** [NextToken](#API_SearchGroups_ResponseSyntax) **   <a name="QS-SearchGroups-response-NextToken"></a>
Token di paginazione che è possibile utilizzare in una richiesta.  
Type: Stringa

 ** [RequestId](#API_SearchGroups_ResponseSyntax) **   <a name="QS-SearchGroups-response-RequestId"></a>
LaAWSID della richiesta per questa operazione.  
Type: Stringa

## Errori
<a name="API_SearchGroups_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 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 `NextToken` non è valido.  
Codice di stato HTTP: 400

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

 ** PreconditionNotMetException **   
Una o più precondizioni non sono soddisfatte.  
Codice di stato HTTP: 400

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

 ** ResourceUnavailableException **   
Questa risorsa al momento non è disponibile.  
Codice di stato HTTP: 503

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

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