CreateAccountSubscription - Amazon QuickSight
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

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

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, voirS'inscrire àAWSdans leAmazon QuickSight Guide de l'utilisateur. La personne qui s'inscrit sur Amazon QuickSight doit avoir la bonneAWS Identity and Access Management(IAM). Pour de plus amples informations, veuillez consulterExemples de stratégies IAM pour Amazon QuickSightdans leAmazon QuickSight Guide de l'utilisateur.

Si votre stratégie IAM inclut à la fois laSubscribeetCreateAccountSubscriptionactions, assurez-vous que les deux actions ont la valeurAllow. Si l'une des actions est définie surDeny, leDenyaction 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, voirTransmission des rôles IAM à Amazon QuickSightdans leAmazon 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, voirDéfinition de l'accès aux ressources par défautAWSservicesdans leAmazon QuickSightGuide de l'utilisateur.

Syntaxe de la demande

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

La demande utilise les paramètres URI suivants.

AwsAccountId

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

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

AccountName

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 modifierAccountNamevaleur après Amazon QuickSight le compte est créé.

Type : Chaîne

Obligatoire : Oui

AuthenticationMethod

Méthode que vous souhaitez qu'utilise pour authentifier votre Amazon QuickSight . Actuellement, les valeurs valides pour ce paramètre sontIAM_AND_QUICKSIGHT,IAM_ONLY, etACTIVE_DIRECTORY.

Si vous choisissezACTIVE_DIRECTORY, fournissez unActiveDirectoryNameet unAdminGroupassocié à votre Active Directory.

Type : Chaîne

Valeurs valides : IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY

Obligatoire : Oui

Edition

L'édition d'Amazon QuickSight que vous souhaitez associer à votre compte. Actuellement, vous pouvez choisir parmiENTERPRISEouENTERPRISE_AND_Q.

Si vous choisissezENTERPRISE_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

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

Nom de votre Active Directory. Ce champ est obligatoire siACTIVE_DIRECTORYest la méthode d'authentification sélectionnée par le nouvel Amazon QuickSight .

Type : Chaîne

Obligatoire : Non

AdminGroup

Le groupe d'administrateurs associé à votre Active Directory. Ce champ est obligatoire siACTIVE_DIRECTORYest 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, voirUtilisation d'Active Directory avec Amazon QuickSight Enterprise Editionen Amazon QuickSightGuide de l'utilisateur .

Type : Tableau de chaînes

Obligatoire : Non

AuthorGroup

Le groupe d'auteurs associé à votre Active Directory. Pour plus d'informations sur l'utilisation d'Active Directory dans Amazon QuickSight, voirUtilisation d'Active Directory avec Amazon QuickSight Enterprise Editionen Amazon QuickSightGuide de l'utilisateur .

Type : Tableau de chaînes

Obligatoire : Non

ContactNumber

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 siENTERPPRISE_AND_Qest l'édition sélectionnée du nouvel Amazon QuickSight .

Type : Chaîne

Obligatoire : Non

DirectoryId

L'ID de l'annuaire Active Directory qui est associé à votre Amazon QuickSight .

Type : Chaîne

Obligatoire : Non

EmailAddress

L'adresse e-mail de l'auteur de l'Amazon QuickSight compte à utiliser pour de future communications. Ce champ est obligatoire siENTERPPRISE_AND_Qest l'édition sélectionnée du nouvel Amazon QuickSight .

Type : Chaîne

Obligatoire : Non

FirstName

Le prénom de l'auteur de l'Amazon QuickSight compte à utiliser pour de future communications. Ce champ est obligatoire siENTERPPRISE_AND_Qest l'édition sélectionnée du nouvel Amazon QuickSight .

Type : Chaîne

Obligatoire : Non

LastName

Le nom de famille de l'auteur de l'Amazon QuickSight compte à utiliser pour de future communications. Ce champ est obligatoire siENTERPPRISE_AND_Qest l'édition sélectionnée du nouvel Amazon QuickSight .

Type : Chaîne

Obligatoire : Non

ReaderGroup

Le groupe de lecteurs associé à votre Active Directory. Pour plus d'informations sur l'utilisation d'Active Directory dans Amazon QuickSight, voirUtilisation d'Active Directory avec Amazon QuickSight Enterprise Editiondans leAmazon QuickSightGuide de l'utilisateur.

Type : Tableau de chaînes

Obligatoire : Non

Realm

Le domaine d'Active Directory associé à votre Amazon QuickSight . Ce champ est obligatoire siACTIVE_DIRECTORYest la méthode d'authentification sélectionnée par le nouvel Amazon QuickSight .

Type : Chaîne

Obligatoire : Non

Syntaxe de la réponse

HTTP/1.1 Status
Content-type: application/json

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

Eléments de réponse

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

Status

Le statut HTTP de la requête.

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

RequestId

LeAWSID de demande pour cette opération.

Type : Chaîne

SignupResponse

UNSignupResponseobjet qui renvoie des informations sur un Amazon nouvellement créé QuickSight .

Type : objet SignupResponse

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.

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

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 :