CreateAccountSubscription - Amazon QuickSight
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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, consultaRegistrazione aAWSnellaAmazon 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, consultaEsempi di policy IAM per Amazon QuickSightnellaAmazon QuickSight Guida per l’utente di.

Se la tua politica IAM include entrambiSubscribeeCreateAccountSubscriptionazioni, assicurarsi che entrambe le azioni siano impostate suAllow. Se una delle due azioni è impostata suDeny, ilDenyl'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, consultaPassare i ruoli IAM ad Amazon QuickSightnellaAmazon 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, vediImpostazione dell'accesso predefinito alle risorseAWSservizinellaAmazon 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

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

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 valoreAccountNamevalore dopo l'Amazzonia QuickSight l'account è stato creato.

Type: Stringa

Campo obbligatorio: Sì

AuthenticationMethod

Il metodo che desideri che utilizzi per autenticare il tuo Amazon QuickSight conto. Attualmente, i valori validi per questo parametro sonoIAM_AND_QUICKSIGHT,IAM_ONLY, eACTIVE_DIRECTORY.

Se scegliACTIVE_DIRECTORY, fornire unActiveDirectoryNamee unAdminGroupassociato ad Active Directory.

Type: Stringa

Valori validi: IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY

Campo obbligatorio: Sì

Edition

L'edizione di Amazon QuickSight che desideri che il tuo account abbia. Al momento, puoi scegliere traENTERPRISEoENTERPRISE_AND_Q.

Se scegliENTERPRISE_AND_Q, i parametri seguenti sono obbligatori:

  • FirstName

  • LastName

  • EmailAddress

  • ContactNumber

Type: Stringa

Valori validi: STANDARD | ENTERPRISE | ENTERPRISE_AND_Q

Campo obbligatorio: Sì

NotificationEmail

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

Il nome di Active Directory. Il campo è obbligatorio seACTIVE_DIRECTORYè il metodo di autenticazione selezionato del nuovo Amazon QuickSight conto.

Type: Stringa

Campo obbligatorio: No

AdminGroup

Il gruppo di amministratori associato a Active Directory. Il campo è obbligatorio seACTIVE_DIRECTORYè il metodo di autenticazione selezionato del nuovo Amazon QuickSight conto. Per ulteriori informazioni sull'utilizzo di Active Directory in Amazon QuickSight, consultaUtilizzo di Active Directory con Amazon QuickSight Enterprise Editionin Amazon QuickSightGuida per l'utente di .

Type: Gamma di stringhe

Campo obbligatorio: No

AuthorGroup

Il gruppo di autori associato a Active Directory. Per ulteriori informazioni sull'utilizzo di Active Directory in Amazon QuickSight, consultaUtilizzo di Active Directory con Amazon QuickSight Enterprise Editionin Amazon QuickSightGuida per l'utente di .

Type: Gamma di stringhe

Campo obbligatorio: No

ContactNumber

Un numero di telefono di 10 cifre per l'autore dell'Amazon QuickSight account da utilizzare per comunicazioni future. Il campo è obbligatorio seENTERPPRISE_AND_Qè l'edizione selezionata della nuova Amazon QuickSight conto.

Type: Stringa

Campo obbligatorio: No

DirectoryId

ID dell'Active Directory associata al tuo Amazon QuickSight conto.

Type: Stringa

Campo obbligatorio: No

EmailAddress

L'indirizzo e-mail dell'autore di Amazon QuickSight account da utilizzare per comunicazioni future. Il campo è obbligatorio seENTERPPRISE_AND_Qè l'edizione selezionata della nuova Amazon QuickSight conto.

Type: Stringa

Campo obbligatorio: No

FirstName

Il nome dell'autore dell'Amazzonia QuickSight account da utilizzare per comunicazioni future. Il campo è obbligatorio seENTERPPRISE_AND_Qè l'edizione selezionata della nuova Amazon QuickSight conto.

Type: Stringa

Campo obbligatorio: No

LastName

Il cognome dell'autore dell'Amazzonia QuickSight account da utilizzare per comunicazioni future. Il campo è obbligatorio seENTERPPRISE_AND_Qè l'edizione selezionata della nuova Amazon QuickSight conto.

Type: Stringa

Campo obbligatorio: No

ReaderGroup

Il gruppo di lettori associato ad Active Directory. Per ulteriori informazioni sull'utilizzo di Active Directory in Amazon QuickSight, consultaUtilizzo di Active Directory con Amazon QuickSight Enterprise EditionnellaAmazon QuickSightGuida per l’utente di.

Type: Gamma di stringhe

Campo obbligatorio: No

Realm

L'area di autenticazione di Active Directory associata al tuo Amazon QuickSight conto. Il campo è obbligatorio seACTIVE_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

Lo stato HTTP della richiesta.

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

RequestId

LaAWSID di richiesta per questa operazione.

Type: Stringa

SignupResponse

UNSignupResponseoggetto che restituisce informazioni su un Amazon appena creato QuickSight conto.

Tipo: SignupResponse oggetto

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

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: