内部 API オペレーション - AMS Advanced ユーザーガイド

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

内部 API オペレーション

API オペレーションをモニタリングすると、次の内部専用オペレーションの呼び出しが表示されることがあります。

  • GetDashboardUrl

  • ListReportsV2

内部 API オペレーション: GetDashboardUrl

このオペレーションは、AMS コンソールによって呼び出されるとシステムログに表示されます。他にユースケースはありません。直接使用することはできません。

対応するレポートの埋め込みダッシュボード URL を返します。このオペレーションは、 によってdashboardName返された を受け入れますListReports

リクエストの構文

HTTP/1.1 200 Content-type: application/json { "dashboardName": "string" }

リクエスト要素

dashboardName: URL がリクエストされている QuickSight ダッシュボードの名前。ダッシュボード名は ListReportsV2 で返されます。

タイプ: 文字列

レスポンスの構文

HTTP/1.1 200 Content-type: application/json { "url": "string" }

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。

url: リクエストされた の QuickSight URL を返しますdashboardName

タイプ: 文字列

エラー

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

BadRequestException:

送信されたリクエストは無効です。たとえば、入力が不完全または正しくない場合などです。詳細については、添付のエラーメッセージを参照してください。

HTTP ステータスコード: 400

NotFoundException:

リクエストされたリソースが見つかりません。リクエスト URI が正しいことを確認します。

HTTP ステータスコード: 404

TooManyRequestsException:

リクエストがスロットリング制限に達しました。指定された期間の後に再試行します。

HTTP ステータスコード: 429

UnauthorizedException:

発信者のアクセス許可が不十分なため、リクエストは拒否されます。

HTTP ステータスコード: 401

内部 API オペレーション: ListReportsV2

この API は、AMS コンソールによって呼び出されるとシステムログに表示されます。他にユースケースはありません。直接使用することはできません。

指定されたアカウントで使用できる運用レポートのリストを返します。

リクエストの構文

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

レスポンスの構文

HTTP/1.1 200 Content-type: application/json { "reportsList": [ { "dashboard": "string", "lastUpdatedTime": "string", } ], "reportsType": "string" }

レスポンス要素

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。

reportsList: 使用可能な運用レポートのリスト。

タイプ: Dashboard オブジェクトの配列

reportsType: レポートが複数のアカウントで集計されるかどうかを示します。

タイプ: 文字列

エラー

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

BadRequestException:

送信されたリクエストは無効です。たとえば、入力が不完全または正しくないとします。詳細については、添付のエラーメッセージを参照してください。

HTTP ステータスコード: 400

NotFoundException:

リクエストされたリソースが見つかりません。リクエスト URI が正しいことを確認します。

HTTP ステータスコード: 404

TooManyRequestsException:

リクエストがスロットリング制限に達しました。指定された期間の後に再試行します。

HTTP ステータスコード: 429

UnauthorizedException:

発信者のアクセス許可が不十分なため、リクエストは拒否されます。

HTTP ステータスコード: 401