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.

# GenerateEmbedUrlForAnonymousUser
<a name="API_GenerateEmbedUrlForAnonymousUser"></a>

Génère une URL d'intégration que vous pouvez utiliser pour intégrer un Amazon QuickSight tableau de bord sur votre site Web, sans avoir à enregistrer d'utilisateurs lecteurs. Avant d'effectuer cette action, assurez-vous d'avoir configuré les tableaux de bord et les autorisations.

Les règles suivantes s'appliquent à l'URL générée :
+ Il contient un jeton au porteur temporaire. Il est valide pendant 5 minutes après avoir été généré. Une fois utilisé pendant cette période, il ne peut pas être réutilisé.
+ La période de validité de l'URL ne doit pas être confondue avec la durée de vie réelle de la session qui peut être personnalisée en utilisant le` [SessionLifetimeInMinutes](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html#QS-GenerateEmbedUrlForAnonymousUser-request-SessionLifetimeInMinutes) `  Paramètre . La session utilisateur qui en résulte est valide pendant 15 minutes (minimum) à 10 heures (maximum). Par défaut, la durée de la session est de 10 heures.
+ Vous êtes facturé uniquement lorsque l'URL est utilisée ou en cas d'interaction avec Amazon QuickSight.

Pour de plus amples informations, veuillez consulter[Analyses intégrées](https://docs.aws.amazon.com/quicksight/latest/user/embedded-analytics.html)dans le*Amazon QuickSight Guide de l'utilisateur*.

Pour plus d'informations sur les étapes de haut niveau relatives à l'intégration et pour une démonstration interactive de la manière dont vous pouvez personnaliser l'intégration, visitez le[Amazon QuickSight Portail des développeurs](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-dev-portal.html).

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

```
POST /accounts/AwsAccountId/embed-url/anonymous-user HTTP/1.1
Content-type: application/json

{
   "AllowedDomains": [ "string" ],
   "AuthorizedResourceArns": [ "string" ],
   "ExperienceConfiguration": { 
      "Dashboard": { 
         "InitialDashboardId": "string"
      }
   },
   "Namespace": "string",
   "SessionLifetimeInMinutes": number,
   "SessionTags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

La demande utilise les paramètres URI suivants.

 ** [AwsAccountId](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-AwsAccountId"></a>
L'ID pourCompte AWSqui contient le tableau de bord que vous intégrez.  
Contraintes de longueur : Longueur fixe de 12.  
Modèle : `^[0-9]{12}$`   
Obligatoire Oui

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

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

 ** [AuthorizedResourceArns](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-AuthorizedResourceArns"></a>
ARN (Amazon Resource Names) QuickSight ressources auxquelles l'utilisateur est autorisé à accéder pendant la durée de vie de la session. Si vous choisissez`Dashboard`intégration de l'expérience, transmettez la liste des ARN du tableau de bord dans le compte que vous souhaitez que l'utilisateur puisse voir. Actuellement, vous pouvez transmettre jusqu'à 25 ARN de tableau de bord par appel d'API.  
Type : Tableau de chaînes  
Obligatoire Oui

 ** [ExperienceConfiguration](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-ExperienceConfiguration"></a>
La configuration de l'expérience que vous intégrez.  
Type : objet [AnonymousUserEmbeddingExperienceConfiguration](API_AnonymousUserEmbeddingExperienceConfiguration.md)  
Obligatoire Oui

 ** [Namespace](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-Namespace"></a>
L'Amazon QuickSight espace de noms auquel l'utilisateur anonyme appartient virtuellement. Si vous n'utilisez pas Amazon QuickSight espace de noms personnalisé, définissez-le sur`default`.  
Type : Chaîne  
Contraintes de longueur : Longueur maximale de 64.  
Modèle : `^[a-zA-Z0-9._-]*$`   
Obligatoire Oui

 ** [AllowedDomains](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-AllowedDomains"></a>
Les domaines que vous souhaitez ajouter à la liste d'autorisation pour accéder à l'URL générée qui est ensuite intégrée. Ce paramètre facultatif remplace les domaines statiques configurés dans la fenêtre Gérer QuickSight menu sur Amazon QuickSight console Au lieu de cela, elle autorise uniquement les domaines que vous incluez dans ce paramètre. Vous pouvez répertorier jusqu'à trois domaines ou sous-domaines dans chaque appel d'API.  
Pour inclure tous les sous-domaines d'un domaine spécifique à la liste d'autorisation, utilisez`*`. Par exemple,`https://*.sapp.amazon.com`inclut tous les sous-domaines sous`https://sapp.amazon.com`.  
Type : Tableau de chaînes  
Obligatoire Non

 ** [SessionLifetimeInMinutes](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-SessionLifetimeInMinutes"></a>
Combien de minutes la session est valide. La durée de vie de la session doit être comprise entre [15 à 600] minutes.  
Type : Long  
Plage valide : : : La valeur minimale est 15. Valeur maximale fixée à 600.  
Obligatoire Non

 ** [SessionTags](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-SessionTags"></a>
Balisage de la ligne. Avant d'utiliser ce paramètre, assurez-vous d'avoir configuré les jeux de données appropriés à l'aide de la`DataSet$RowLevelPermissionTagConfiguration`afin que les balises de session puissent être utilisées pour assurer la sécurité au niveau des lignes.  
Ce ne sont pas les balises utilisées pour leAWSfonction de Balisage des ressources. Pour de plus amples informations, veuillez consulter[Utilisation de la sécurité au niveau des lignes (RLS) avec Balisage](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-dev-rls-tags.html)dans le*Amazon QuickSight Guide de l'utilisateur*.  
Type : Tableau[SessionTag](API_SessionTag.md)objets  
Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 50 éléments.  
Obligatoire Non

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

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

{
   "EmbedUrl": "string",
   "RequestId": "string"
}
```

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

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

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

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

 ** [EmbedUrl](#API_GenerateEmbedUrlForAnonymousUser_ResponseSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-response-EmbedUrl"></a>
URL intégrée pour le tableau de bord.  
Type : Chaîne

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

## Erreurs
<a name="API_GenerateEmbedUrlForAnonymousUser_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.  
Code d'état Code : 401

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

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

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

 ** SessionLifetimeInMinutesInvalidException **   
Le nombre de minutes spécifié pour la durée de vie d'une session n'est pas valide. La durée de vie de la session doit être de 15 à 600 minutes  
Code d'état Code : 400

 ** ThrottlingException **   
L'accès est limité.  
Code d'état Code : 429

 ** UnsupportedPricingPlanException **   
Cette erreur indique que vous appelez une opération d'intégration dans Amazon. QuickSightsans le plan tarifaire requis sur votreAWS. Avant de pouvoir utiliser l'intégration pour les utilisateurs anonymes, un QuickSight l'administrateur doit ajouter la tarification de la capacité à Amazon QuickSight. Vous pouvez effectuer cette opération dans la**Gérer Amazon QuickSight**.   
Une fois la tarification de la capacité ajoutée, vous pouvez utiliser le` [GetDashboardEmbedUrl](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetDashboardEmbedUrl.html) `Opération d'API avec`--identity-type ANONYMOUS`option.  
Code d'état Code : 403

 ** UnsupportedUserEditionException **   
Cette erreur indique que vous appelez une opération portant sur Amazon QuickSightabonnement dont l'édition n'inclut pas la prise en charge de cette opération. Amazon Amazon QuickSight Les éditions actuellement disponibles sont Standard Edition et Enterprise Edition. Toutes les opérations et fonctionnalités ne sont pas disponibles dans chaque édition.  
Code d'état Code : 403

## Voir aussi
<a name="API_GenerateEmbedUrlForAnonymousUser_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/GenerateEmbedUrlForAnonymousUser) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWSKits SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser)