翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # GetSessionEmbedUrl Amazon Amazonを埋め込むために使用できるセッションURLと認証コードを生成します QuickSight ウェブサーバーコードでコンソール。を使用する`GetSessionEmbedUrl`ユーザーがデータソース、データセット、分析、およびダッシュボードを作成できる作成ポータルを提供する場所。埋め込まれた Amazon にアクセスするユーザー QuickSight コンソールは、作成者または管理者セキュリティコホートに属している必要があります。これらの機能の一部へのアクセスを制限する場合は、カスタムアクセス許可プロファイルを追加します。` [UpdateUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateUser.html) `API オペレーション。を使用する` [RegisterUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RegisterUser.html) `カスタムアクセス許可プロファイルをアタッチした新規ユーザーを追加する API オペレーション。詳細については、次のセクションを参照してください。*アマゾン QuickSight ユーザーガイド*: + [埋め込み分析](https://docs.aws.amazon.com/quicksight/latest/user/embedded-analytics.html) + [Amazon へのアクセスをカスタマイズする QuickSight コンソール](https://docs.aws.amazon.com/quicksight/latest/user/customizing-permissions-to-the-quicksight-console.html) ## リクエストの構文 ``` GET /accounts/AwsAccountId/session-embed-url?entry-point=EntryPoint&session-lifetime=SessionLifetimeInMinutes&user-arn=UserArn HTTP/1.1 ``` ## URI リクエストパラメータ リクエストでは、次の URI パラメータを使用します。 ** [AwsAccountId](#API_GetSessionEmbedUrl_RequestSyntax) ** の IDAWS アカウントAmazon に関連付けられている QuickSight サブスクリプション。 長さの制約: 固定長は 12 です。 パターン: `^[0-9]{12}$` 必須: はい ** [EntryPoint](#API_GetSessionEmbedUrl_RequestSyntax) ** 埋め込みセッションにアクセスするために使用する URL。エントリポイント URL は、次のパスに制限されます。 + `/start` + `/start/analyses` + `/start/dashboards` + `/start/favorites` + `/dashboards/DashboardId `-ここで、とします`DashboardId`は Amazon からの実際の ID キーです QuickSight ダッシュボードのコンソール URL + `/analyses/AnalysisId `-ここで、とします`AnalysisId`は Amazon からの実際の ID キーです QuickSight 分析のコンソール URL 長さの制約: 最小長は 1 です｡ 最大長は 1,000 です。 ** [SessionLifetimeInMinutes](#API_GetSessionEmbedUrl_RequestSyntax) ** セッションが有効な時間 (分) セッションの有効期間は 15 〜 600 分です。 有効範囲: 最小値は 15 です。最大値は 600 です。 ** [UserArn](#API_GetSessionEmbedUrl_RequestSyntax) ** ザ・アマゾン QuickSight ユーザーの Amazon リソースネーム (ARN)`QUICKSIGHT`ID のタイプ。これはどのタイプのAmazonにも使用できます QuickSight アカウントのユーザー (読者、著者、管理者)。これらの認証は、次のいずれかとして認証されている必要があります。 1. Active Directory (AD) ユーザーまたはグループメンバー 1. 招待された非フェデレーションユーザー 1. AWS Identity and Access ManagementSAML、OpenID Connect、または IAM フェデレーションを使用したフェデレーションを使用したフェデレーションを使用したフェデレーションを通じて認証された (IAM) ユーザーおよび IAM ロールベースセッション 3 番目のグループのユーザー、IAM ユーザー、および IAM ロールベースのセッションでは、このパラメーターを省略します。 ## リクエスト本文 リクエストにリクエスト本文がありません。 ## レスポンスの構文 ``` HTTP/1.1 Status Content-type: application/json { "EmbedUrl": "string", "RequestId": "string" } ``` ## レスポンス要素 アクションが成功すると、以下の HTTP レスポンスが返されます。 ** [Status](#API_GetSessionEmbedUrl_ResponseSyntax) ** リクエストの HTTP ステータス。 サービスから以下のデータが JSON 形式で返されます。 ** [EmbedUrl](#API_GetSessionEmbedUrl_ResponseSyntax) ** Amazonを埋め込むためにサーバーサイドのウェブページに入れることができる使い捨てのURL QuickSight セッション。この URL は 5 分間有効です。API オペレーションは、URL に`auth_code`10 時間有効なユーザーセッションへの 1 回 (および 1 回だけ) のサインオンを可能にする値。 Type: 文字列 ** [RequestId](#API_GetSessionEmbedUrl_ResponseSyntax) ** -AWSこの処理のリクエスト ID。 Type: 文字列 ## エラー すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアイテムにはアクセスできません。提供された認証情報を検証できませんでした。リクエストを実行する権限がない可能性があります。アカウントがAmazonの使用を許可されていることを確認してください QuickSight ポリシーに正しいアクセス許可があること、正しいアクセスキーを使っていることを確認してください。 HTTP ステータスコード: 401 ** InternalFailureException ** 内部エラーが発生しました。 HTTP ステータスコード: 500 ** InvalidParameterValueException ** 1 つ以上のパラメータに無効な値があります。 HTTP ステータスコード: 400 ** QuickSightUserNotFoundException ** 指定された名前のユーザーが見つかりません。このエラーは、提供されたユーザー名に基づいてユーザーを見つける必要があるオペレーションで発生する可能性があります。`DeleteUser`,`DescribeUser`など。 HTTP ステータスコード: 404 ** ResourceExistsException ** 指定されたリソースは既に存在します。 HTTP ステータスコード: 409 ** ResourceNotFoundException ** 1 つ以上のリソースが見つかりません。 HTTP ステータスコード: 404 ** SessionLifetimeInMinutesInvalidException ** セッションの存続期間に指定された分数が無効です。セッションの有効期間は 15 〜 600 分です。 HTTP ステータスコード: 400 ** ThrottlingException ** アクセスが調整済みです。 HTTP ステータスコード: 429 ** UnsupportedUserEditionException ** このエラーは Amazon でオペレーションを呼び出していることを示します。 QuickSightエディションにその操作のサポートが含まれていないサブスクリプション。アマゾンアマゾン QuickSight には現在、Standard と Enterprise Edition すべてのオペレーションと機能がすべてのエディションで利用できるわけではありません。​ HTTP ステータスコード: 403 ## 以下の資料も参照してください。 言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/GetSessionEmbedUrl) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/GetSessionEmbedUrl) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/GetSessionEmbedUrl) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/GetSessionEmbedUrl) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/GetSessionEmbedUrl) + [AWS向け SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/GetSessionEmbedUrl) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/GetSessionEmbedUrl) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/GetSessionEmbedUrl) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/GetSessionEmbedUrl)