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à.
GenerateEmbedUrlForRegisteredUser
Genera un URL di incorporamento che puoi utilizzare per incorporare un Amazon QuickSight esperienza nel tuo sito Web. Questa azione può essere utilizzata per qualsiasi tipo di utente registrato in Amazon QuickSight conto. Prima di usare questa azione, assicurati di aver configurato Amazon pertinente QuickSight risorse e autorizzazioni.
All'URL generato si applicano le seguenti regole:
-
Contiene un gettone al portatore temporaneo. È valido per 5 minuti dopo la generazione. Una volta riscattato entro questo periodo, non può essere riutilizzato di nuovo.
-
Il periodo di validità dell'URL non deve essere confuso con la durata effettiva della sessione che può essere personalizzata utilizzando
SessionLifetimeInMinutesParametro .La sessione utente risultante è valida da 15 minuti (minimo) a 10 ore (massimo). La durata predefinita della sessione è di 10 ore.
-
Ti viene addebitato solo quando viene utilizzato l'URL o c'è interazione con Amazon QuickSight.
Per ulteriori informazioni, consultaAnalisi incorporatenellaAmazon QuickSight Guida per l’utente di.
Per ulteriori informazioni sui passaggi di alto livello per l'incorporamento e per una demo interattiva dei modi in cui è possibile personalizzare l'incorporamento, visitare ilAmazon QuickSight Portale per sviluppatori.
Sintassi della richiesta
POST /accounts/AwsAccountId/embed-url/registered-user HTTP/1.1
Content-type: application/json
{
"AllowedDomains": [ "string" ],
"ExperienceConfiguration": {
"Dashboard": {
"InitialDashboardId": "string"
},
"QSearchBar": {
"InitialTopicId": "string"
},
"QuickSightConsole": {
"InitialPath": "string"
}
},
"SessionLifetimeInMinutes": number,
"UserArn": "string"
}Parametri della richiesta URI:
La richiesta utilizza i seguenti parametri URI.
- AwsAccountId
-
L'ID delAccount AWSche contiene la dashboard che stai incorporando.
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.
- ExperienceConfiguration
-
L'esperienza che stai incorporando. Per gli utenti registrati, puoi incorporare Amazon QuickSight dashboard o l'intero Amazon QuickSight Console.
Tipo: RegisteredUserEmbeddingExperienceConfiguration oggetto
Campo obbligatorio: Sì
- UserArn
-
Amazon Resource Name (ARN) dell'utente registrato.
Type: Stringa
Campo obbligatorio: Sì
- AllowedDomains
-
I domini che si desidera aggiungere all'elenco consentiti per l'accesso all'URL generato che viene quindi incorporato. Questo parametro facoltativo sostituisce i domini statici configurati in Gestisci QuickSight menu in Amazzonia QuickSight Console. Al contrario, consente solo i domini inclusi in questo parametro. Puoi elencare fino a tre domini o sottodomini in ogni chiamata API.
Per includere tutti i sottodomini di un dominio specifico nell'elenco consentiti, utilizzare
*. Ad esempio,https://*.sapp.amazon.cominclude tutti i sottodominihttps://sapp.amazon.com.Type: Gamma di stringhe
Campo obbligatorio: No
- SessionLifetimeInMinutes
-
Quanti minuti è valida la sessione. La durata di una sessione deve essere compresa nell'intervallo di [15-600] minuti.
Type: Lungo
Campo valido valido valido valido Valore minimo di 15. valore massimo pari a 600.
Campo obbligatorio: No
Sintassi della risposta
HTTP/1.1 Status
Content-type: application/json
{
"EmbedUrl": "string",
"RequestId": "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.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- 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
- QuickSightUserNotFoundException
-
L'utente con il nome fornito non è stato trovato. Questo errore può accadere in qualsiasi operazione che richiede la ricerca di un utente in base a un nome utente fornito, ad esempio
DeleteUser,DescribeUsere così via.Codice di stato HTTP: 404
- ResourceNotFoundException
-
Uno o più risorse non sono state trovate.
Codice di stato HTTP: 404
- SessionLifetimeInMinutesInvalidException
-
Il numero di minuti specificato per la durata di una sessione non è valido. La durata di una sessione deve essere di 15-600 minuti.
Codice di stato HTTP: 400
- ThrottlingException
-
L'accesso è limitato.
Codice di stato HTTP: 429
- UnsupportedPricingPlanException
-
Questo errore indica che stai chiamando un'operazione di incorporamento in Amazon QuickSightsenza il piano tariffario richiestoAWSconto. Prima di poter utilizzare l'incorporamento per utenti anonimi, QuickSight l'amministratore deve aggiungere il prezzo della capacità ad Amazon QuickSight. Tale operazione può essere eseguita suGestire Amazon QuickSight(Certificato creato).
Dopo aver aggiunto il prezzo della capacità, è possibile utilizzare il
GetDashboardEmbedUrlOperazione API con il--identity-type ANONYMOUSopzione.Codice di stato HTTP: 403
- UnsupportedUserEditionException
-
Questo errore indica che si sta chiamando un'operazione su Amazon. QuickSightabbonamento in cui l'edizione non include il supporto per tale operazione. Amazon Amazon QuickSight attualmente ha Standard Edition ed Enterprise Edition. Non tutte le operazioni e funzionalità sono disponibili in ogni edizione.
Codice di stato HTTP: 403
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
