Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# CreateAccountSubscription
<a name="API_CreateAccountSubscription"></a>

Crée une Amazon QuickSight compte, ou s'abonne à Amazon QuickSight Q.

LeRégion AWSpour le compte est dérivé de ce qui est configuré dans leAWS CLIou SDK. Cette opération n'est pas prise en charge dans la région USA Est (Ohio), Amérique du Sud (Sao Paulo) ou Asie-Pacifique (Singapour). 

Avant d'utiliser cette opération, assurez-vous que vous pouvez vous connecter à unCompte AWS. Si vous n'avez pas deCompte AWS, voir[S'inscrire àAWS](https://docs.aws.amazon.com/quicksight/latest/user/setting-up-aws-sign-up.html)dans le*Amazon QuickSight Guide de l'utilisateur*. La personne qui s'inscrit sur Amazon QuickSight doit avoir la bonneGestion des identités et des accès AWS(IAM). Pour de plus amples informations, veuillez consulter[Exemples de stratégies IAM pour Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/iam-policy-examples.html)dans le*Amazon QuickSight Guide de l'utilisateur*.

Si votre stratégie IAM inclut à la fois la`Subscribe`et`CreateAccountSubscription`actions, assurez-vous que les deux actions ont la valeur`Allow`. Si l'une des actions est définie sur`Deny`, le`Deny`action prévaut et votre appel d'API échoue.

Vous ne pouvez pas transmettre un rôle IAM existant pour accéder à d'autresAWSservices utilisant cette opération d'API. Pour transmettre votre rôle IAM existant à Amazon QuickSight, voir[Transmission des rôles IAM à Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/security_iam_service-with-iam.html#security-create-iam-role)dans le*Amazon QuickSight Guide de l'utilisateur*.

Vous ne pouvez pas définir l'accès aux ressources par défaut sur le nouveau compte Amazon QuickSightAPI. Au lieu de cela, ajoutez l'accès aux ressources par défaut depuis Amazon QuickSight console Pour plus d'informations sur la configuration de l'accès aux ressources par défautAWSservices, voir[Définition de l'accès aux ressources par défautAWSservices](https://docs.aws.amazon.com/quicksight/latest/user/scoping-policies-defaults.html)dans le*Amazon QuickSightGuide de l'utilisateur*.

## Syntaxe de la demande
<a name="API_CreateAccountSubscription_RequestSyntax"></a>

```
POST /account/AwsAccountId HTTP/1.1
Content-type: application/json

{
   "AccountName": "string",
   "ActiveDirectoryName": "string",
   "AdminGroup": [ "string" ],
   "AuthenticationMethod": "string",
   "AuthorGroup": [ "string" ],
   "ContactNumber": "string",
   "DirectoryId": "string",
   "Edition": "string",
   "EmailAddress": "string",
   "FirstName": "string",
   "LastName": "string",
   "NotificationEmail": "string",
   "ReaderGroup": [ "string" ],
   "Realm": "string"
}
```

## Paramètres de demande URI
<a name="API_CreateAccountSubscription_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [AwsAccountId](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AwsAccountId"></a>
LeCompte AWSID du compte que vous utilisez pour créer votre Amazon QuickSight .  
Contraintes de longueur : Longueur fixe de 12.  
Modèle : `^[0-9]{12}$`   
Obligatoire : Oui

## Corps de la demande
<a name="API_CreateAccountSubscription_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [AccountName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AccountName"></a>
Nom de votre Amazon QuickSight . Ce nom est unique parmi tousAWS, et il n'apparaît que lorsque les utilisateurs se connectent. Vous ne pouvez pas modifier`AccountName`valeur après Amazon QuickSight le compte est créé.  
Type : Chaîne  
Obligatoire : Oui

 ** [AuthenticationMethod](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AuthenticationMethod"></a>
Méthode que vous souhaitez qu'utilise pour authentifier votre Amazon QuickSight . Actuellement, les valeurs valides pour ce paramètre sont`IAM_AND_QUICKSIGHT`,`IAM_ONLY`, et`ACTIVE_DIRECTORY`.  
Si vous choisissez`ACTIVE_DIRECTORY`, fournissez un`ActiveDirectoryName`et un`AdminGroup`associé à votre Active Directory.  
Type : Chaîne  
Valeurs valides :` IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY`   
Obligatoire : Oui

 ** [Edition](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-Edition"></a>
L'édition d'Amazon QuickSight que vous souhaitez associer à votre compte. Actuellement, vous pouvez choisir parmi`ENTERPRISE`ou`ENTERPRISE_AND_Q`.  
Si vous choisissez`ENTERPRISE_AND_Q`, les paramètres suivants sont obligatoires :  
+  `FirstName` 
+  `LastName` 
+  `EmailAddress` 
+  `ContactNumber` 
Type : Chaîne  
Valeurs valides :` STANDARD | ENTERPRISE | ENTERPRISE_AND_Q`   
Obligatoire : Oui

 ** [NotificationEmail](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-NotificationEmail"></a>
L'adresse e-mail que vous souhaitez Amazon QuickSight pour envoyer des notifications concernant votre Amazon QuickSight compte ou Amazon QuickSight abonnement.  
Type : Chaîne  
Obligatoire : Oui

 ** [ActiveDirectoryName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ActiveDirectoryName"></a>
Nom de votre Active Directory. Ce champ est obligatoire si`ACTIVE_DIRECTORY`est la méthode d'authentification sélectionnée par le nouvel Amazon QuickSight .  
Type : Chaîne  
Obligatoire : Non

 ** [AdminGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AdminGroup"></a>
Le groupe d'administrateurs associé à votre Active Directory. Ce champ est obligatoire si`ACTIVE_DIRECTORY`est la méthode d'authentification sélectionnée par le nouvel Amazon QuickSight . Pour plus d'informations sur l'utilisation d'Active Directory dans Amazon QuickSight, voir[Utilisation d'Active Directory avec Amazon QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)en Amazon QuickSightGuide de l'utilisateur .  
Type : Tableau de chaînes  
Obligatoire : Non

 ** [AuthorGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AuthorGroup"></a>
Le groupe d'auteurs associé à votre Active Directory. Pour plus d'informations sur l'utilisation d'Active Directory dans Amazon QuickSight, voir[Utilisation d'Active Directory avec Amazon QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)en Amazon QuickSightGuide de l'utilisateur .  
Type : Tableau de chaînes  
Obligatoire : Non

 ** [ContactNumber](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ContactNumber"></a>
Numéro de téléphone à 10 chiffres pour l'auteur de l'Amazon QuickSight compte à utiliser pour de future communications. Ce champ est obligatoire si`ENTERPPRISE_AND_Q`est l'édition sélectionnée du nouvel Amazon QuickSight .  
Type : Chaîne  
Obligatoire : Non

 ** [DirectoryId](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-DirectoryId"></a>
L'ID de l'annuaire Active Directory qui est associé à votre Amazon QuickSight .  
Type : Chaîne  
Obligatoire : Non

 ** [EmailAddress](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-EmailAddress"></a>
L'adresse e-mail de l'auteur de l'Amazon QuickSight compte à utiliser pour de future communications. Ce champ est obligatoire si`ENTERPPRISE_AND_Q`est l'édition sélectionnée du nouvel Amazon QuickSight .  
Type : Chaîne  
Obligatoire : Non

 ** [FirstName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-FirstName"></a>
Le prénom de l'auteur de l'Amazon QuickSight compte à utiliser pour de future communications. Ce champ est obligatoire si`ENTERPPRISE_AND_Q`est l'édition sélectionnée du nouvel Amazon QuickSight .  
Type : Chaîne  
Obligatoire : Non

 ** [LastName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-LastName"></a>
Le nom de famille de l'auteur de l'Amazon QuickSight compte à utiliser pour de future communications. Ce champ est obligatoire si`ENTERPPRISE_AND_Q`est l'édition sélectionnée du nouvel Amazon QuickSight .  
Type : Chaîne  
Obligatoire : Non

 ** [ReaderGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ReaderGroup"></a>
Le groupe de lecteurs associé à votre Active Directory. Pour plus d'informations sur l'utilisation d'Active Directory dans Amazon QuickSight, voir[Utilisation d'Active Directory avec Amazon QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)dans le*Amazon QuickSightGuide de l'utilisateur*.  
Type : Tableau de chaînes  
Obligatoire : Non

 ** [Realm](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-Realm"></a>
Le domaine d'Active Directory associé à votre Amazon QuickSight . Ce champ est obligatoire si`ACTIVE_DIRECTORY`est la méthode d'authentification sélectionnée par le nouvel Amazon QuickSight .  
Type : Chaîne  
Obligatoire : Non

## Syntaxe de la réponse
<a name="API_CreateAccountSubscription_ResponseSyntax"></a>

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

{
   "RequestId": "string",
   "SignupResponse": { 
      "accountName": "string",
      "directoryType": "string",
      "IAMUser": boolean,
      "userLoginName": "string"
   }
}
```

## Eléments de réponse
<a name="API_CreateAccountSubscription_ResponseElements"></a>

Si l'action aboutit, le service renvoie la réponse HTTP suivante.

 ** [Status](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-Status"></a>
Le statut HTTP de la requête.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [RequestId](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-RequestId"></a>
LeAWSID de demande pour cette opération.  
Type : Chaîne

 ** [SignupResponse](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-SignupResponse"></a>
UN`SignupResponse`objet qui renvoie des informations sur un Amazon nouvellement créé QuickSight .  
Type : objet [SignupResponse](API_SignupResponse.md)

## Erreurs
<a name="API_CreateAccountSubscription_Errors"></a>

Pour plus d'informations sur les erreurs communes à toutes les actions, consultez[Erreurs courantes](CommonErrors.md).

 ** AccessDeniedException **   
Vous n'avez pas accès à cet élément. Les informations d'identification fournies n'ont pas pu être validées. Il est possible que vous ne soyez pas autorisé à effectuer la demande. Assurez-vous que votre compte est autorisé à utiliser Amazon QuickSight , que vos stratégies ont les autorisations appropriées et que vous utilisez les bonnes clés d'accès.  
HTTP : 401

 ** ConflictException **   
La mise à jour ou la suppression d'une ressource peut entraîner un état incohérent.  
HTTP : 409

 ** InternalFailureException **   
Une défaillance interne s'est produite.  
HTTP : 500

 ** InvalidParameterValueException **   
La valeur d'un ou de plusieurs paramètres n'est pas valide.  
HTTP : 400

 ** PreconditionNotMetException **   
Une ou plusieurs conditions préalables ne sont pas remplies.  
HTTP : 400

 ** ResourceExistsException **   
La ressource spécifiée existe déjà.   
HTTP : 409

 ** ResourceNotFoundException **   
Une ou plusieurs ressources n'ont pas pu être trouvées.  
HTTP : 404

 ** ResourceUnavailableException **   
Cette ressource n'est pas disponible actuellement.  
HTTP : 503

 ** ThrottlingException **   
L'accès est limité.  
HTTP : 429

## Voir aussi
<a name="API_CreateAccountSubscription_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateAccountSubscription) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWSKits SDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateAccountSubscription)