

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Amazon Amazon を使用する QuickSight API
<a name="qs-using-the-quicksight-api"></a>

以下では、Amazon の使用を開始する方法について説明します。 QuickSight API。

**Topics**
+ [API リクエストを行う](qs-api-making-api-requests.md)
+ [Amazon の Amazon リソースネーム (ARN) QuickSight](qs-arns.md)
+ [Amazon Amazon のアクセス許可 QuickSight リソース](qs-api-permissions.md)
+ [アマゾン QuickSight API エラー](qs-api-errors.md)

# API リクエストを行う
<a name="qs-api-making-api-requests"></a>

Amazon Amazon API を提供しています QuickSight、Amazon にアクセスできる Amazon SDK QuickSight お好みのプログラミング言語から。Amazon Amazon Amazon を使用する QuickSightの場合、Amazon SDK を使用することで、デプロイの一部の側面を管理できます。

Amazon に対して行われた呼び出しをモニタリングするには QuickSight あなたのアカウントの API、使えるAWS CloudTrail。CloudTrail が発信した通話を監視できますAWS マネジメントコンソール、コマンドラインツール、その他のサービス。詳細については、[AWS CloudTrail ユーザーガイド](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)を参照してください。

**Topics**
+ [前提知識](#qs-api-required-knowledge)
+ [Amazon で使用可能な API オペレーション QuickSight](#qs-api-using-libraries)

## 前提知識
<a name="qs-api-required-knowledge"></a>

Amazon Amazon にアクセスする予定の場合 QuickSight API を使用すると、以下のトピックについて理解しておく必要があります。
+ FSx for ONTAP ファイルシステムの ONTAP 設定プロパティ。
+ ウェブサービス
+ HTTP リクエスト
+ 次のような 1 つ以上のプログラミング言語 JavaScript、C\$1、Java、C\$1、C\$1、C\$1

訪問推奨事項AWS [リソースセンターのご利用開始にあたって](https://aws.amazon.com//getting-started/tools-sdks/)Amazon SDK とツールキットが提供する内容を確認してください。

任意のターミナルとテキストエディタを使用することもできますが、統合された開発環境 (IDE) により、視覚的な UI エクスペリエンスの利点を得ることができます。IDE の一覧は*AWSリソースセンターのご利用開始にあたって*の[IDE と IDE のツールキット](https://aws.amazon.com//getting-started/tools-sdks/#IDE_and_IDE_Toolkits)セクションに追加します。このサイトは、提供していますAWS任意の IDE をダウンロードできるツールキット。一部の IDE は、プログラミング言語の詳細を理解するために役立つチュートリアルも提供しています。

## Amazon で使用可能な API オペレーション QuickSight
<a name="qs-api-using-libraries"></a>

アマゾン QuickSight API オペレーションは以下を提供します。
+ ユーザーとグループの管理
+ データ管理 (データソース、データセット、テンプレート、SPICE インジェスト)
+ ダッシュボードと分析管理
+ テンプレートの管理
+ 経営へのアクセス権
+ カスタマイズ管理

AWSでは、HTTPS を介してリクエストを送信する代わりに、言語固有の API オペレーションを使用してアプリケーションを構築することを好むソフトウェアデベロッパー向けに、ライブラリ、サンプルコード、チュートリアル、その他のリソースを提供するものです。これらのライブラリには、リクエストの暗号化署名、リクエストの再試行、エラーレスポンスの処理などのタスクを自動化する基本的な機能が用意されています。これらのライブラリを使用すると、簡単に作業を開始できます。

Amazon SDK をダウンロードする方法の詳細については、「」を参照してください。[Amazon SDK とツール](https://aws.amazon.com/tools/)。次のリンクは、利用可能な言語固有の API ドキュメントの例です。

**AWS Command Line Interface**
+ [AWS CLI QuickSight コマンドリファレンス](https://docs.aws.amazon.com//cli/latest/reference/quicksight/index.html)
+ [AWS CLI ユーザーガイド](https://docs.aws.amazon.com//cli/latest/userguide/)
+ [AWS CLI コマンドリファレンス](https://docs.aws.amazon.com//cli/latest/reference/)

**AWS SDK for .NET**
+ [Amazon.Quicksight](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSight.html)
+ [Amazon.Quicksight.Model](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSightModel.html)

**AWS SDK for C\$1\$1**
+ [おれ::QuickSight::QuickSightClient クラスリファレンス](https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_quick_sight_1_1_quick_sight_client.html)

**AWS SDK for Go**
+ [QuickSight](https://docs.aws.amazon.com/sdk-for-go/api/service/quicksight/)

**AWS SDK for Java**
+ [QuickSightClient](https://docs.aws.amazon.com/sdk-for-java/latest/reference//software/amazon/awssdk/services/quicksight/package-frame.html)
+ [QuickSightModel](https://docs.aws.amazon.com/sdk-for-java/latest/reference//software/amazon/awssdk/services/quicksight/model/package-frame.html)

**AWS SDK for JavaScript**
+ [QuickSight](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/QuickSight.html)

**AWS SDK for PHP**
+ [QuickSightClient](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.QuickSight.QuickSightClient.html)

**AWS SDK for Python (Boto3)**
+ [QuickSight](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/quicksight.html)

**AWS SDK for Ruby**
+ [おれ::QuickSight](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/QuickSight.html)

# Amazon の Amazon リソースネーム (ARN) QuickSight
<a name="qs-arns"></a>

Amazon リソースネーム (ARN) は、AWS リソースを一意に識別します。ARN は、すべてのリソースを明確に識別します。AWSたとえば、IAMPolicies、Amazon Relational Database Service (Amazon RDS) タグ、API 呼び出しなどです。Amazon ARN を検索するには QuickSightリソースに追加するには、`Describe`関連するリソースに対する操作。

このセクションでは ARN の仕組みについて説明します。ここに記載されている資料は、Amazon向けに特別に用意された例です。 QuickSight。

**Topics**
+ [ARN 形式](qs-arn-format.md)
+ [アマゾン QuickSight リソース ARN](qs-resource-arns.md)

# ARN 形式
<a name="qs-arn-format"></a>

ARN はコロンで区切られ、*セグメント*、コロン (:) で区切られた部分です (`:`). ARN のセグメントで使用される特定のコンポーネントと値は、AWSARN の対象となるサービス。ARN がどのように構築されるかを以下に示します。

```
arn:partition:service:region:account-id:resource-id
arn:partition:service:region:account-id:resource-type/resource-id
arn:partition:service:region:account-id:resource-type:resource-id
```

これらの ARN には次のセグメントが含まれます。

***`partition`***— リソースが置かれているパーティションです。スタンダード用AWS リージョンでは、パーティションは*aws*。他のパーティションにリソースがある場合、パーティションは*aws-partitionname*。例えば、中国 (北京) リージョンにあるリソースのパーティションは、`aws-cn` です。

***`service`***— を識別するサービス名前空間AWSの製品。例:`quicksight`Amazonを識別します QuickSight,`s3`Amazon S3 を識別します。`iam`IAM、識別されます。

***`region`***—AWS リージョンリソースが置かれていること。一部のリソースの ARN にはAWS リージョン、S3 の場合のように、この要素は省略されます。アマゾン QuickSight ARN にはAWS リージョン。

***`account-id`***— の ID です。AWS アカウントリソースが置かれているです。ARN または API オペレーションでアカウント番号を使用する場合は、ハイフンを省略します (123456789012 など)。一部のリソースの ARN はアカウント番号を必要としないので、この要素は省略されます。アマゾン QuickSight ARN にはAWS アカウント番号。ただし、アカウント番号とAWS リージョン以下に示すように、S3 バケット ARN からは省略されます。

```
arn:aws:s3:::bucket_name
arn:aws:s3:::bucket_name/key_name
```

***`resource`*または*`resource-type`***— ARN のこの部分のコンテンツは、サービスによって異なります。リソース識別子は、リソースの名前または ID（たとえば、`user/Bob`または`instance/i-1234567890abcdef0`) またはリソースパスです。たとえば、一部のリソース識別子には親リソース (`sub-resource-type/parent-resource/sub-resource`) またはバージョン (*resource-type*:*resource-name*:*修飾子*).

一部のリソース ARN には、パス、変数、またはワイルドカードを含めることができます。

ワイルドカード文字 (`*`そして`?`）は、任意の ARN セグメント内にあります。アスタリスク (`*`) は 0 個以上の文字の任意の組み合わせを表し、疑問符 (`?`) は任意の 1 文字を表します。各セグメントで複数の \$1 または ? の文字を使用することができますが、ワイルドカードはセグメントをまたぐことができません。アクセス権限に ARN を使用している場合は、`*`可能な場合はワイルドカードを使用して、必要な要素のみにアクセスを制限します。パス、ワイルドカード、および変数の使用例をいくつか以下に示します。

次の例では、S3 ARN を使用します。これは、IAMPolicy で S3 にアクセス許可を付与するときに使用できます。この S3 ARN は、パスとファイルが指定されていることを示します。

**注記**  
用語*キー名*後にあるパスとファイルの外観を記述するために使用されます`bucketname/`。バケットにはコンピュータのファイルシステムで使用されているようなフォルダ構造が実際には含まれていないため、これらはキー名と呼ばれます。代わりにスラッシュ (`/`）は、バケットの構成をより直感的にするのに役立つ区切り文字です。この場合、バケット名は`examplebucket`、キー名は`developers/design_info.doc`。

```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q4.json
```

バケット内のすべてのオブジェクトを識別するには、次のようにワイルドカードを使用して、すべてのキー名 (またはパスとファイル) が ARN に含まれることを示します。

```
arn:aws:s3:::examplebucket/*
```

キー名の一部とワイルドカードを使用して、特定のパターンで始まるすべてのオブジェクトを識別できます。この場合は、次に示すように、フォルダ名にワイルドカードを加えたものに似ています。ただし、この ARN には`my-data`。

```
arn:aws:s3:::examplebucket/my-data/*
```

ワイルドカードを追加することで、名前の一部を指定できます。これはで始まるすべてのオブジェクトを識別します`my-data/sales-export*`。

```
arn:aws:s3:::examplebucket/my-data/sales-export*
```

この場合、このワイルドカードを使用して指定すると、次のような名前のオブジェクトが含まれます。
+ `my-data/sales-export-1.xlsx`
+ `my-data/sales-export-new.txt`
+ `my-data/sales-export-2019/file1.txt`

次に示すように、両方のタイプ (アスタリスクと疑問符) のワイルドカードを組み合わせて、または個別に使用できます。

```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q?.*

arn:aws:s3:::examplebucket/my-data/sales-export-20??-q?.*
```

または、ARN の将来を見据えたい場合は、下の 2 桁にワイルドカードを使用するだけでなく、年全体をワイルドカードに置き換えることができます。

```
arn:aws:s3:::examplebucket/my-data/sales-export-????-q?.*
arn:aws:s3:::examplebucket/my-data/sales-export-*-q?.*
```

S3 ARN の詳細については、「」を参照してください。[ポリシーでのリソースの指定](https://docs.aws.amazon.com//AmazonS3/latest/dev/s3-arn-format.html)そして[オブジェクトキーとメタデータ](https://docs.aws.amazon.com//AmazonS3/latest/dev/UsingMetadata.html)の*Amazon Storage Service ユーザーガイド。*

# アマゾン QuickSight リソース ARN
<a name="qs-resource-arns"></a>

以下のリソースタイプは Amazon によって定義されています QuickSight: ユーザー、グループ、およびダッシュボード。これらはAmazonで使用されています QuickSight API 呼び出しと IAMPermission ステートメントの要素として使用されます。を見つけますup-to-date Amazon Amazon の情報 QuickSight (サービスプレフィックス:quicksight) IAMPermission ポリシーで使用できるように、リソース、アクション、条件コンテキストキーについては、「」を参照してください。[Amazon のアクション、リソース、および条件キー QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)の*IAM ユーザーガイド。*


| リソースタイプ | ARN 形式 | 条件キー | 
| --- | --- | --- | 
| user | arn: PartitionResourceId\$1 | 該当なし | 
| グループ | arn: PartitionResourceId\$1 | 該当なし | 
| ダッシュボード | arn: PartitionResourceId\$1 | 該当なし | 

リソース ARN は、リソースを説明するセグメントから構成されます。たとえば、分析用のリソース ARN は次のセグメントで構成されます。

```
arn:<partition>:quicksight:<aws-region>:<aws-account-id>:<resource-type>/<resource-id>
```

セグメントは次のように定義されます。
+ *`partition`*— 例:`aws`または`aws-cn`。
+ *`aws-region`*—AWS リージョンリソースが含まれています。
+ *`aws-account-id`*—AWS アカウントリソースが含まれています。ハイフンは含まれません。
+ *`resource-type`*— リソースのタイプ。この例では、です。`analyses`。ダッシュボードの場合、`dashboard`。
+ *`resource-id`*— 特定のリソースの一意の識別子。

-AWS リージョン、リソースタイプ、およびリソース ID は、Amazon の使用時にリソースの URL で識別されます QuickSight console. たとえば、ARN が必要な分析の URL であるとします。

```
https://us-east-2.quicksight.aws.amazon.com/sn/analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```

AWS リージョン は、`us-east-2` です。resource-type は、です。`analysis`。この URL のリソース ID は`4036e682-7de6-4c05-8a76-be51b9ec9b29`。アカウント番号が`111122223333`の場合、この分析の ARN は次のようになります。

```
arn:aws:quicksight:us-east-2:111122223333:analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```

を取得するにはAWS アカウント番号については、システム管理者に連絡してください。

# Amazon Amazon のアクセス許可 QuickSight リソース
<a name="qs-api-permissions"></a>

必要なアクセス許可が不明な場合は、呼び出しを試みることができます。クライアントにより、不足しているアクセス許可が何であるかが分かります。リソースフィールドのアスタリスク (`*`) は、明示的なリソースの指定ではなく、アクセス許可ポリシーに使用できます。ただし、各アクセス許可はできるだけ制限することをお勧めします。Amazon を使用してポリシーでリソースを指定したり除外することで、ユーザーアクセスを制限できます。 QuickSight ARN。Amazon ARN を検索するには QuickSight リソースに、`Describe`関連するリソースに対する操作。

Amazonに電話する前に QuickSight API オペレーション`quicksight:operation-name`IamIdentity にアタッチされたポリシー内のアクセス許可。例えば、`list-users` を呼び出すには、アクセス許可 `quicksight:ListUsers` が必要です。すべてのオペレーションに同じパターンが適用されます。呼び出しアクセス許可を持たない呼び出しを行おうとすると、どのアクセス許可が不足しているかを発生したエラーで確認できます。各アクセス許可はできるだけ制限することをお勧めします。

一部のシナリオでは、IAM で条件を追加して、API へのアクセスをさらに制限することができます。たとえば、`User1` を `Group1` に追加すると、メインリソースは `Group1` になります。特定のグループへのアクセスを許可または拒否できます。​ または、Amazon を編集することもできます。 QuickSight iamKey`quicksight:UserName`をクリックして、特定のユーザーがそのグループに追加されるのを許可または禁止する条件を追加します。

詳細については、次を参照してください。
+ [アクション、リソース、および条件キー](https://docs.aws.amazon.com//IAM/latest/UserGuide/list_amazonquicksight.html)
+ [IAMJSON ポリシー要素](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_elements.html)



最も多く見るには up-to-date アマゾンのリスト QuickSight アクション、「」を参照してください[Amazon で定義されるアクション QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html#amazonquicksight-actions-as-permissions)の*IAM ユーザーガイド*。

## ベストプラクティス
<a name="qs-api-permissions-best-practices"></a>

アマゾン QuickSight では、分析、ダッシュボード、テンプレート、テーマを最大 100 のプリンシパルと共有できます。ある*主要な*の値は次のいずれかを指定できます。
+ Amazon の Amazon リソースネーム (ARN) QuickSight データソースまたはデータセットに関連付けられたユーザーまたはグループ。(こちらは一般的です)。
+ Amazon ARN QuickSight 分析、ダッシュボード、テンプレート、またはテーマに関連付けられたユーザー、グループ、または名前空間。(こちらは一般的です)。
+ の ARNAWSアカウントのルート: これは IAM ARN ではなく QuickSight ARN。このオプションは、リソース (テンプレート) を間で共有する場合のみ使用します。AWS口座。(こちらはそれほど一般的ではありません)。

これらのリソースを他のプリンシパルと共有する場合は、グループレベルまたは名前空間レベルでリソースパーミッションを割り当てることを検討してください。たとえば、ユーザーをグループに追加し、リソースをグループと共有する場合、グループ内の全員に共有されている場合でも、そのグループは 1 つのプリンシパルとしてカウントされます。

# アマゾン QuickSight API エラー
<a name="qs-api-errors"></a>

アマゾン QuickSight には、2 種類のエラーコードがあります。
+ **クライアントエラー**— これらのエラーは通常、クライアントが行ったことが原因で発生します。リクエストで誤ったパラメータや無効なパラメータを指定したり、アクションやリソースを使用するアクセス許可を持たないユーザーにアクションやリソースを使用するなど。​これらのエラーには 400 番台の HTTP レスポンスコードが伴います。
+ **サーバーエラー**— これらのエラーは通常、AWSサーバー側の問題。​これらのエラーには 500 番台の HTTP レスポンスコードが伴います。

**Topics**
+ [共通のクライアントエラー](#qs-api-errors-client)
+ [クライアントエラー](#qs-api-errors-table-client)
+ [サーバーエラー](#qs-api-errors-table-server)

## 共通のクライアントエラー
<a name="qs-api-errors-client"></a>

以下に、すべてのアクションが返す共通のクライアントエラーを列挙します。


| エラーコード | 説明 | 
| --- | --- | 
| AuthFailure | 提供された認証情報を検証できませんでした。リクエストを実行する権限がない可能性があります。アカウントがAmazonの使用を許可されていることを確認する QuickSight クレジットカード情報が正しいこと、正しいアクセスキーを使用しているということです。 | 
| Blocked | お客様のアカウントは現在ブロックされています。ご質問がありましたら、aws-verification@amazon.com までお問い合わせください。 | 
| DryRunOperation | ユーザーに必要なアクセス許可があるため、リクエストは成功したはずですが、DryRun パラメータが使用されました。 | 
| IdempotentParameterMismatch | リクエストは、前の、しかし同一ではないリクエストと同じクライアントトークンを使用します。リクエストが同一でない限り、異なるリクエストでクライアントトークンを再利用しないでください。 | 
| IncompleteSignature | リクエストの署名が AWS 基準に適合しません。 | 
| InvalidAction | 要求されたアクション、またはオペレーションは無効です。アクションが正しく入力されていることを確認します。 | 
| InvalidCharacter | 指定された文字が無効です。 | 
| InvalidClientTokenId | 指定された x.509 証明書、または AWS アクセスキー ID が見つかりません。 | 
| InvalidPaginationToken | 指定されたページ区切りトークンが無効か、または期限切れです。 | 
| InvalidParameter | リクエストで指定されたパラメータが無効であるか、サポートされていないか、または使用できません。返されたメッセージはエラー値の説明を提供します。​  | 
| InvalidParameterCombination | 誤ったパラメータの組み合わせ、または欠落しているパラメータを示します。​  | 
| InvalidParameterValue | リクエストで指定された値が無効であるか、サポートされていないか、または使用できません。​ 必ずフル ID を使用してリソースを指定してください。返されたメッセージはエラー値の説明を提供します。​ | 
| InvalidQueryParameter | AWS クエリ文字列が正しい形式でないため、AWS 基準に順守していません。 | 
| MalformedQueryString | クエリ文字列に構文エラーがあります。 | 
| MissingAction | リクエストに、アクションまたは必須パラメータが含まれていません。 | 
| MissingAuthenticationToken | リクエストには、有効な (登録された) AWS アクセスキー ID、または X.509 証明書のどちらか一方が含まれている必要があります。 | 
| MissingParameter | リクエストに、アクションまたは必須パラメータが含まれていません。リクエストに必要なすべてのパラメータを指定していることを確認してください。たとえば、リソース ID です。 | 
| OptInRequired | 要求された製品を使用する権限がありません。使用しようとしているサービスに加入していることを確認してください。​ 初めての方AWSでは、クレジットカード情報の確認中にアカウントがアクティブになるまでに時間がかかることがあります。 | 
| PendingVerification | アカウントの検証を保留中です。確認プロセスが完了するまでは、このアカウントでリクエストを実行できない可能性があります。ご不明な点がある場合は、[AWS サポート](https://console.aws.amazon.com/support/home#/) までお問い合わせください。 | 
| RequestExpired | リクエストの日付スタンプまたはリクエストの有効期限 (署名付き URL の場合など) の 15 分以上またはリクエストの有効期限 (署名付き URL の場合など) の 15 分以上です。または、リクエストの日付スタンプが15分以上future です。一時的なセキュリティ認証情報を使用している場合、このエラーは認証情報の有効期限が切れている場合にも発生する可能性があります。​ 詳細については、IAM ユーザーガイドの「[IAM の一時的なセキュリティ認証情報](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html)」を参照してください。 | 
| UnauthorizedOperation | この操作を実行する権限がありません。IAM ポリシーを確認し、正しいアクセスキーを使用していることを確認します。 | 
| UnknownParameter | 不明または認識されていないパラメータが指定されました このエラーの原因となる可能性があるリクエストには、スペルミスのパラメータ、または指定された API バージョンではサポートされていないパラメータの指定が含まれます。 | 
| UnsupportedInstanceAttribute | 指定された属性は変更できません。 | 
| <a name="UnsupportedOperation"></a> UnsupportedOperation  | 指定されたリクエストにはサポートされていないオペレーションが含まれています。​ 返されたメッセージには、サポートされていないオペレーションの詳細が記載されています。 | 
| UnsupportedProtocol | 使用したプロトコルはサポートされていません。 | 
| ValidationError | 入力が、AWS サービスで指定された制約を満たしていません。 | 

## クライアントエラー
<a name="qs-api-errors-table-client"></a>

以下に、Amazon 専用のクライアントエラーのリストを示します。 QuickSight API オペレーション 


| エラーコード | 説明 | 
| --- | --- | 
| AccessDeniedException | このファイルへのアクセス権限がありません。提供された認証情報を検証できませんでした。リクエストを実行する権限がない可能性があります。アカウントがAmazonの使用を許可されていることを確認する QuickSight ポリシーに正しいアクセス許可があること、正しいアクセスキーを使用しているということです。 | 
| DomainNotWhiteListedException | 指定されたドメインは許可リストにありません。​ 埋め込みダッシュボードのすべてのドメインは、Amazon によって承認済みリストに追加される必要があります QuickSight admin。 | 
| IdentityTypeNotSupportedException | 指定されたアイデンティティタイプはサポートされていません。サポートされているアイデンティティタイプには次のものが含まれます。iamとQuickight。 | 
| InvalidNextTokenException | NextToken の値は無効です。 | 
| InvalidParameterValueException | 1 つ以上のパラメータに有効な値がありません。 | 
| PreconditionNotMetException | 1 つ以上の前提条件が満たされていません。​ | 
| QuickSightUserNotFoundException | ユーザーが見つかりません。これは、提供されたユーザー名に基づいてユーザーを見つける必要があるオペレーションで発生する可能性があります。たとえば、 DeleteUser,DescribeUser、、、、、と指定します。 | 
| ResourceExistsException | 指定されたリソースは存在しません  | 
| ResourceNotFoundException | 1 つ以上のリソースが見つかりませんでした。 | 
| SessionLifetimeInMinutesInvalidException | セッションの存続期間に指定された分数が無効です。​ セッションの有効期間は 15 〜 600 分です。 | 
| ThrottlingException | アクセスが調整済みです。 | 
| UnsupportedUserEditionException | Amazon でオペレーションを呼び出していることを示します QuickSightサブスクリプションにそのオペレーションのサポートが含まれていないエディションには、そのオペレーションのサポートが含まれていません。アマゾン QuickSight には現在、Standard Edition と Enterprise すべてのオペレーションと機能がすべてのエディションで利用できるわけではありません。​ | 

### クライアントエラーの一般的な原因
<a name="qs-api-errors-common-causes"></a>

リクエストの実行中にエラーが発生する可能性がある理由はいくつかあります。​ これらのガイドラインに従うことで、いくつかのエラーを防止または簡単に解決できます。​
+ **[] を指定します。AWS アカウントID と名前空間**— 関連するAWS アカウントリクエストごとにIDを提供する必要があります。名前空間を `default` に設定する必要があります。
+ **最終的な一貫性を可能にする**— 前のリクエストがまだシステムを介して伝搬されていないために、いくつかのエラーが発生します。
+ **要求レート間のスリープ間隔を使用する**— アマゾン QuickSight サービスのパフォーマンスを維持するために、API リクエストは抑制されています。リクエストが抑制されている場合は、エラーが発生します。​
+ **リソースの完全な ID を使用する**— リソースを指定するときは、ユーザー指定の名前や説明ではなく、必ずフル ID を使用してください。
+ **サービスを確認する**— 使用しようとしているすべてのサービスにサインアップしていることを確認してください。サインアップしているサービスについては、**My Account**の セクション[AWSホームページ](https://aws.amazon.com/)。
+ **アクセス許可をチェックする**— リクエストを実行するために必要なアクセス許可があることを確認してください。
+ **VPC をチェックする**— セキュリティグループなど、一部のリソースは仮想プライベートクラウド (VPC) 間で共有できません。
+ **認証情報を確認する**— リクエストを行う際にアクセスキーを指定し、認証情報を正しく入力していることを確認します。また、複数のアカウントがある場合は、特定のアカウントに正しい認証情報を使用していることを確認します。提供された認証情報が正しくない場合は、次のエラーが発生する可能性があります。`Client.AuthFailure`。

## サーバーエラー
<a name="qs-api-errors-table-server"></a>

以下に、サーバーから返される可能性があるエラーのリストを示します。


| エラーコード | 説明 | 
| --- | --- | 
| BatchClientRequestTokensNotDistinctException –  | バッチクライアントリクエストトークンが一意ではありません。 | 
| EmptyBatchRequestException | バッチリクエストが空です。 | 
| InternalFailureException | 内部エラーが発生しました。 | 
| InternalServiceError | サービスから内部エラーが発生しました。 | 
| InvalidBatchClientRequestTokenException | -AWSこのクライアントバッチリクエストのリクエストトークンは無効です。 | 
| InvalidParameterException | 1 つ以上のパラメータに無効な値があります。 | 
| LimitExceededException | 制限を超過しています。 | 
| ResourceUnavailableException | このリソースは現在使用できません。 | 
| TooManyEntriesInBatchRequestException | このバッチリクエストの項目が多すぎます。 | 