ListNamespaces - Amazon QuickSight

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

ListNamespaces

指定したの名前空間を一覧表示しますAWSアカウント. この操作では、削除された名前空間はリストされません。

リクエストの構文

GET /accounts/AwsAccountId/namespaces?max-results=MaxResults&next-token=NextToken HTTP/1.1

URI リクエストパラメータ

リクエストでは、次の URI パラメータを使用します。

AwsAccountId

の IDAWSAmazonを含むアカウント QuickSight リストする名前空間。

長さの制約: 固定長は 12 です。

パターン: ^[0-9]{12}$

必須: はい

MaxResults

返される結果の最大数。

有効範囲: 最小値は 1 です。最大値は 100 です。

NextToken

後続のリクエストで使用できる一意のページ分割トークン。前回のレスポンス本文にページ区切りトークンを受け取りますListNameSpaces返されるデータが他にもある場合は API を呼び出します。データを受け取るには、別のデータを作成しますListNamespaces次のデータページを取得するために、返されたトークンを利用して API を呼び出します。各トークンは24時間有効です。あなたが作ろうとするならListNamespaces有効期限が切れたトークンでAPI呼び出しを行うと、HTTP 400 InvalidNextTokenExceptionというエラーが表示される。

リクエスト本文

リクエストにリクエスト本文がありません。

レスポンスの構文

HTTP/1.1 Status Content-type: application/json { "Namespaces": [ { "Arn": "string", "CapacityRegion": "string", "CreationStatus": "string", "IdentityStore": "string", "Name": "string", "NamespaceError": { "Message": "string", "Type": "string" } } ], "NextToken": "string", "RequestId": "string" }

レスポンス要素

アクションが成功すると、以下の HTTP レスポンスが返されます。

Status

リクエストの HTTP ステータス。

サービスから以下のデータが JSON 形式で返されます。

Namespaces

この名前空間に関する情報はAWSアカウント. レスポンスには、名前空間 ARN、name、AWS リージョン、通知電子メールアドレス、作成ステータス、および ID ストア。

Type: 配列NamespaceInfoV2オブジェクト

NextToken

後続のリクエストで使用できる一意のページ分割トークン。受信NextTokenあなたの応答には、返されるデータがもっとあることを示しています。データを受け取るには、別のデータを作成しますListNamespaces次のデータページを取得するために、返されたトークンを利用して API を呼び出します。各トークンは24時間有効です。あなたが作ろうとするならListNamespaces有効期限が切れたトークンでAPI呼び出しを行うと、HTTP 400 InvalidNextTokenExceptionというエラーが表示される。

Type: 文字列

RequestId

-AWSこのオペレーションのリクエスト ID です。

Type: 文字列

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

AccessDeniedException

このアイテムにはアクセスできません。提供された認証情報を検証できませんでした。リクエストを実行する権限がない可能性があります。アカウントがAmazonの使用を許可されていることを確認してください QuickSight お使いのポリシーに正しいアクセス許可があること、正しいアクセスキーを使っていることを確認してください。

HTTP ステータスコード: 401

InternalFailureException

内部エラーが発生しました。

HTTP ステータスコード: 500

InvalidNextTokenException

NextToken の値は無効です。

HTTP ステータスコード: 400

InvalidParameterValueException

1 つ以上のパラメータに無効な値があります。

HTTP ステータスコード: 400

PreconditionNotMetException

1 つ以上の前提条件が満たされていません。​

HTTP ステータスコード: 400

ResourceNotFoundException

1 つ以上のリソースが見つかりません。

HTTP ステータスコード: 404

ResourceUnavailableException

このリソースは現在使用できません。

HTTP ステータスコード: 503

ThrottlingException

アクセスが調整済みです。

HTTP ステータスコード: 429

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。