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

# CreateGroup
<a name="API_CreateGroup"></a>

Utilizzo dell'`CreateGroup`operazione per creare un gruppo in Amazon QuickSight. Puoi creare fino a 10.000 gruppi in uno spazio dei nomi. Se desideri creare più di 10.000 gruppi in uno spazio dei nomi, contatta AWS Support.

La risorsa delle autorizzazioni è`arn:aws:quicksight:<your-region>:<relevant-aws-account-id>:group/default/<group-name> `.

La risposta è un oggetto gruppo.

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

```
POST /accounts/AwsAccountId/namespaces/Namespace/groups HTTP/1.1
Content-type: application/json

{
   "Description": "string",
   "GroupName": "string"
}
```

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

La richiesta utilizza i seguenti parametri URI.

 ** [AwsAccountId](#API_CreateGroup_RequestSyntax) **   <a name="QS-CreateGroup-request-AwsAccountId"></a>
L'ID deiAWSconto 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ì

 ** [Namespace](#API_CreateGroup_RequestSyntax) **   <a name="QS-CreateGroup-request-Namespace"></a>
Lo spazio dei nomi di cui vuoi far parte il gruppo.  
Vincoli di lunghezza: La lunghezza massima è 64 caratteri.  
Modello: `^[a-zA-Z0-9._-]*$`   
Campo obbligatorio: Sì

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [GroupName](#API_CreateGroup_RequestSyntax) **   <a name="QS-CreateGroup-request-GroupName"></a>
Un nome per il gruppo che intendi creare.  
Type: Stringa  
Vincoli di lunghezza: Lunghezza minima pari a 1.  
Modello: `[\u0020-\u00FF]+`   
Campo obbligatorio: Sì

 ** [Description](#API_CreateGroup_RequestSyntax) **   <a name="QS-CreateGroup-request-Description"></a>
Una descrizione del gruppo che intendi creare.  
Type: Stringa  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 512 caratteri.  
Campo obbligatorio: No

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

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

{
   "Group": { 
      "Arn": "string",
      "Description": "string",
      "GroupName": "string",
      "PrincipalId": "string"
   },
   "RequestId": "string"
}
```

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

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

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

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

 ** [Group](#API_CreateGroup_ResponseSyntax) **   <a name="QS-CreateGroup-response-Group"></a>
Il nome del gruppo.  
Tipo: [Group](API_Group.md) oggetto

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

## Errori
<a name="API_CreateGroup_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

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

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

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

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

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