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à. # CreateAccountSubscription Crea un'Amazon QuickSight account o si iscrive ad Amazon QuickSight Q. LaRegione AWSper l'account deriva da ciò che è configurato nelAWS CLIo SDK. Questa operazione non è supportata nella regione Stati Uniti orientali (Ohio), nella regione Sud America (San Paolo) o nella regione Asia Pacifico (Singapore). Prima di utilizzare questa operazione, assicurarsi di potersi connettere a unAccount AWS. Se non disponi di unAccount AWS, consulta[Registrazione aAWS](https://docs.aws.amazon.com/quicksight/latest/user/setting-up-aws-sign-up.html)nella*Amazon QuickSight Guida per l’utente di*. La persona che si iscrive ad Amazon QuickSight ha bisogno di avere il giustoAWS Identity and Access Management(IAM) autorizzazioni. Per ulteriori informazioni, consulta[Esempi di policy IAM per Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/iam-policy-examples.html)nella*Amazon QuickSight Guida per l’utente di*. Se la tua politica IAM include entrambi`Subscribe`e`CreateAccountSubscription`azioni, assicurarsi che entrambe le azioni siano impostate su`Allow`. Se una delle due azioni è impostata su`Deny`, il`Deny`l'azione prevale e la chiamata API non riesce. Non è possibile passare un ruolo IAM esistente per accedere ad altriAWSservizi che utilizzano questa operazione API. Per passare il tuo ruolo IAM esistente ad Amazon QuickSight, consulta[Passare i ruoli IAM ad Amazon QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/security_iam_service-with-iam.html#security-create-iam-role)nella*Amazon QuickSight Guida per l’utente di*. Non puoi impostare l'accesso alle risorse predefinito per il nuovo account da Amazon QuickSightAPI. Invece, aggiungi l'accesso alle risorse predefinito da Amazon QuickSight Console. Per ulteriori informazioni sull'impostazione dell'accesso predefinito alle risorseAWSservizi, vedi[Impostazione dell'accesso predefinito alle risorseAWSservizi](https://docs.aws.amazon.com/quicksight/latest/user/scoping-policies-defaults.html)nella*Amazon QuickSightGuida per l’utente di*. ## Sintassi della richiesta ``` 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" } ``` ## Parametri della richiesta URI: La richiesta utilizza i seguenti parametri URI. ** [AwsAccountId](#API_CreateAccountSubscription_RequestSyntax) ** LaAccount AWSID dell'account utilizzato per creare il tuo Amazon QuickSight conto. 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. ** [AccountName](#API_CreateAccountSubscription_RequestSyntax) ** Il nome del tuo Amazon QuickSight conto. Questo nome è unico su tuttiAWSe viene visualizzato solo quando gli utenti effettuano l'accesso. Non è possibile modificare questo valore`AccountName`valore dopo l'Amazzonia QuickSight l'account è stato creato. Type: Stringa Campo obbligatorio: Sì ** [AuthenticationMethod](#API_CreateAccountSubscription_RequestSyntax) ** Il metodo che desideri che utilizzi per autenticare il tuo Amazon QuickSight conto. Attualmente, i valori validi per questo parametro sono`IAM_AND_QUICKSIGHT`,`IAM_ONLY`, e`ACTIVE_DIRECTORY`. Se scegli`ACTIVE_DIRECTORY`, fornire un`ActiveDirectoryName`e un`AdminGroup`associato ad Active Directory. Type: Stringa Valori validi: ` IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY` Campo obbligatorio: Sì ** [Edition](#API_CreateAccountSubscription_RequestSyntax) ** L'edizione di Amazon QuickSight che desideri che il tuo account abbia. Al momento, puoi scegliere tra`ENTERPRISE`o`ENTERPRISE_AND_Q`. Se scegli`ENTERPRISE_AND_Q`, i parametri seguenti sono obbligatori: + `FirstName` + `LastName` + `EmailAddress` + `ContactNumber` Type: Stringa Valori validi: ` STANDARD | ENTERPRISE | ENTERPRISE_AND_Q` Campo obbligatorio: Sì ** [NotificationEmail](#API_CreateAccountSubscription_RequestSyntax) ** L'indirizzo e-mail che desideri Amazon QuickSight per inviare notifiche a riguardanti il tuo Amazon QuickSight account o Amazon QuickSight abbonamento. Type: Stringa Campo obbligatorio: Sì ** [ActiveDirectoryName](#API_CreateAccountSubscription_RequestSyntax) ** Il nome di Active Directory. Il campo è obbligatorio se`ACTIVE_DIRECTORY`è il metodo di autenticazione selezionato del nuovo Amazon QuickSight conto. Type: Stringa Campo obbligatorio: No ** [AdminGroup](#API_CreateAccountSubscription_RequestSyntax) ** Il gruppo di amministratori associato a Active Directory. Il campo è obbligatorio se`ACTIVE_DIRECTORY`è il metodo di autenticazione selezionato del nuovo Amazon QuickSight conto. Per ulteriori informazioni sull'utilizzo di Active Directory in Amazon QuickSight, consulta[Utilizzo di Active Directory con Amazon QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)in Amazon QuickSightGuida per l'utente di . Type: Gamma di stringhe Campo obbligatorio: No ** [AuthorGroup](#API_CreateAccountSubscription_RequestSyntax) ** Il gruppo di autori associato a Active Directory. Per ulteriori informazioni sull'utilizzo di Active Directory in Amazon QuickSight, consulta[Utilizzo di Active Directory con Amazon QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)in Amazon QuickSightGuida per l'utente di . Type: Gamma di stringhe Campo obbligatorio: No ** [ContactNumber](#API_CreateAccountSubscription_RequestSyntax) ** Un numero di telefono di 10 cifre per l'autore dell'Amazon QuickSight account da utilizzare per comunicazioni future. Il campo è obbligatorio se`ENTERPPRISE_AND_Q`è l'edizione selezionata della nuova Amazon QuickSight conto. Type: Stringa Campo obbligatorio: No ** [DirectoryId](#API_CreateAccountSubscription_RequestSyntax) ** ID dell'Active Directory associata al tuo Amazon QuickSight conto. Type: Stringa Campo obbligatorio: No ** [EmailAddress](#API_CreateAccountSubscription_RequestSyntax) ** L'indirizzo e-mail dell'autore di Amazon QuickSight account da utilizzare per comunicazioni future. Il campo è obbligatorio se`ENTERPPRISE_AND_Q`è l'edizione selezionata della nuova Amazon QuickSight conto. Type: Stringa Campo obbligatorio: No ** [FirstName](#API_CreateAccountSubscription_RequestSyntax) ** Il nome dell'autore dell'Amazzonia QuickSight account da utilizzare per comunicazioni future. Il campo è obbligatorio se`ENTERPPRISE_AND_Q`è l'edizione selezionata della nuova Amazon QuickSight conto. Type: Stringa Campo obbligatorio: No ** [LastName](#API_CreateAccountSubscription_RequestSyntax) ** Il cognome dell'autore dell'Amazzonia QuickSight account da utilizzare per comunicazioni future. Il campo è obbligatorio se`ENTERPPRISE_AND_Q`è l'edizione selezionata della nuova Amazon QuickSight conto. Type: Stringa Campo obbligatorio: No ** [ReaderGroup](#API_CreateAccountSubscription_RequestSyntax) ** Il gruppo di lettori associato ad Active Directory. Per ulteriori informazioni sull'utilizzo di Active Directory in Amazon QuickSight, consulta[Utilizzo di Active Directory con Amazon QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)nella*Amazon QuickSightGuida per l’utente di*. Type: Gamma di stringhe Campo obbligatorio: No ** [Realm](#API_CreateAccountSubscription_RequestSyntax) ** L'area di autenticazione di Active Directory associata al tuo Amazon QuickSight conto. Il campo è obbligatorio se`ACTIVE_DIRECTORY`è il metodo di autenticazione selezionato del nuovo Amazon QuickSight conto. Type: Stringa Campo obbligatorio: No ## Sintassi della risposta ``` HTTP/1.1 Status Content-type: application/json { "RequestId": "string", "SignupResponse": { "accountName": "string", "directoryType": "string", "IAMUser": boolean, "userLoginName": "string" } } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP. ** [Status](#API_CreateAccountSubscription_ResponseSyntax) ** Lo stato HTTP della richiesta. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [RequestId](#API_CreateAccountSubscription_ResponseSyntax) ** LaAWSID di richiesta per questa operazione. Type: Stringa ** [SignupResponse](#API_CreateAccountSubscription_ResponseSyntax) ** UN`SignupResponse`oggetto che restituisce informazioni su un Amazon appena creato QuickSight conto. Tipo: [SignupResponse](API_SignupResponse.md) oggetto ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md). ** AccessDeniedException ** Non hai l'accesso a questo articolo. 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 ** ConflictException ** L'aggiornamento o l'eliminazione di una risorsa può causare uno stato incoerente. Codice di stato HTTP: 409 ** 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 ** 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 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/CreateAccountSubscription) + [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateAccountSubscription) + [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateAccountSubscription) + [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateAccountSubscription) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateAccountSubscription) + [AWSSDK per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateAccountSubscription) + [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateAccountSubscription) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateAccountSubscription) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateAccountSubscription)