すべてのプロダクト
Search
ドキュメントセンター

Cloud Monitor:Cursor

最終更新日:Dec 24, 2025

エクスポートするモニタリングデータの範囲を定義します。この操作により、Cursor 情報が返されます。BatchExport 操作を初めて呼び出す際には、Cursor 情報を指定する必要があります。

操作説明

前提条件

ハイブリッドクラウド監視がアクティブ化されていること。詳細については、「ハイブリッドクラウド監視のアクティブ化」をご参照ください。

背景情報

この操作を呼び出して Cursor 情報を取得し、次に BatchExport 操作を呼び出してモニタリングデータをエクスポートできます。

説明

このトピックでは、指定されたクラウドサービスの指定されたメトリックのモニタリングデータを定義する方法の例を示します。この例では、クラウドサービスの名前空間が acs_ecs_dashboard に、メトリックが cpu_idle に、開始時刻が 1641627000000 に、終了時刻が 1641645000000 に設定されています。2022年1月8日 15:30:00 から 2022年1月8日 20:30:00 まで、ご利用の Elastic Compute Service (ECS) インスタンス上のアイドル CPU コア数が 60 秒ごとに測定されます。この操作により、Cursor 情報が返されます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

Namespace

string

必須

クラウドサービスの名前空間です。

クラウドサービスの名前空間の詳細については、「付録1:メトリック」をご参照ください。

acs_ecs_dashboard

Metric

string

必須

クラウドサービスをモニターするために使用されるメトリックです。

クラウドサービスのメトリックの詳細については、「付録1:メトリック」をご参照ください。

cpu_idle

Period

integer

必須

メトリック値が測定される時間間隔です。

単位:秒。

説明

通常、時間間隔は 60 秒です。具体的な値については、「付録1:メトリック」の Period パラメーターをご参照ください。

60

StartTime

string

必須

クエリする時間範囲の開始時刻です。

時間は ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で指定します。時間は UTC である必要があります。たとえば、2023-01-01T00:00:00Z は、2023年1月1日 00:00:00 UTC を示します。

説明

CloudMonitor では、モニタリングデータの TTL は時間の粒度によって異なります。Period パラメーターの値に対応する TTL に基づいて、適切な時間間隔を指定してください。

1641627000000

EndTime

string

任意

クエリする時間範囲の終了時刻です。

単位:ミリ秒。

説明
  • この値は、1970年1月1日 00:00:00 UTC から経過したミリ秒数を表す UNIX タイムスタンプです。時間は ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で指定します。時間は UTC である必要があります。たとえば、2023-01-01T00:00:00Z は、2023年1月1日 00:00:00 UTC を示します。

  • 終了時刻を設定しない場合、終了時刻は無限になります。リアルタイムのエクスポートシナリオでは、このパラメーターを空のままにすることができます。

  • CloudMonitor では、モニタリングデータの TTL は時間の粒度によって異なります。Period パラメーターの値に対応する TTL に基づいて、適切な時間間隔を指定してください。

1641645000000

Matchers

array

任意

メトリックのディメンション情報です。

Matcher

任意

メトリックのディメンション情報です。

共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

レスポンスフィールド

フィールド

説明

object

応答のスキーマ

Message

string

返されたメッセージです。

success

Cursor

string

Cursor は、BatchExport 操作でデータエクスポートの入力パラメーターとして使用されます。

v2.5eyJiYXRjaGVzIjoxLCJidWNrZXRCeXRlcyI6IndBPT0iLCJidWNrZXRzIjo0LCJjdXJyZW50QnVja2V0IjotNjQsImN1cnJlbnRUYXJnZXRUaW1lU2xvdCI6MTY3ODc1MjAwMCwiZW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0RW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0U3RhcnRUaW1lIjoxNjc4NzgxODE5MDAwLCJleHByZXNzUmFuZ2UiOmZhbHNlLCJoYXNOZXh0Ijp0cnVlLCJpbmRleCI6MCwibGF0ZXN0TG9nVGltZSI6MCwibWF0Y2hlcnMiOnsiY2hhaW4iOlt7ImxhYmVsIjoidXNlcklkIiwib3BlcmF0b3IiOiJFUVVBTFMiLCJ2YWx1ZSI6IjEyNzA2NzY2Nzk1NDY3MDQifV0sImxvY2tlZCI6dHJ1ZX0sIm1ldHJpYyI6IlNwbGl0cndQcm94eU1heFJlc3BvbnNlU2l6ZSIsIm1ldHJpY1R5cGUiOiJNRVRSSUMiLCJuYW1lc3BhY2UiOiJhY3Nfa3ZzdG9yZV9leCIsIm5leHRQa0FkYXB0ZXIiOnsiZGltIjoiVjowXG5EOmB1c2VySWRgPTEyNzA2NzY2Nzk1NDY3MDQsYGluc3RhbmNlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLGBub2RlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLXByb3h5LTIsXG4iLCJtZXRhIjoiXG5WOjBcbk06YWNzX2t2c3RvcmVfZXgvU3BsaXRyd1Byb3h5TWF4UmVzcG9uc2VTaXplXG5XOjYwXG5COjRcbkk6LTFcblQ6MFxuQzpgQXZlcmFnZWAsYE1heGltdW1gLGBfX2NvdW50X19gLGBfX3RzX19gXG4iLCJyZCI6InN1YkFMU0RwWXY2K0t6aENQQUFBWkErNUFKMEpjbGErRGd2V0hFNWxDSHMvbGtqR2FXYTFJTkVwdFE9PSIsInRhZyI6IiJ9LCJvZmZzZXQiOjAsIm9mZnNldERpZ2l0Ijo0NTU0NTczNDQyMTc4NDIxMjIsInN0YXJ0VGltZSI6MTY3ODc4MTgxOTAwMCwic3RlcCI6LTEsInRhZ01hdGNoZXJzIjp7ImNoYWluIjpbXSwibG9ja2VkIjp0cnVlfSwidGFyZ2V0VGltZVNsb3RzIjpbMTY3ODY2NTYwMCwxNjc4NzUyMDAwXSwidXVpZCI6ImQwMmFhZmY1LWU3ZGQtNDUyYy0***********

Code

integer

HTTP ステータスコードです。

説明

状態コード 200 は、リクエストが成功したことを示します。

200

Success

boolean

リクエストが成功したかどうかを示します。有効な値:

  • true

  • false

true

RequestId

string

リクエスト ID です。

915C2D7A-E6A4-17C3-8E13-4DBDD61E7919

成功レスポンス

JSONJSON

{
  "Message": "success",
  "Cursor": "v2.5eyJiYXRjaGVzIjoxLCJidWNrZXRCeXRlcyI6IndBPT0iLCJidWNrZXRzIjo0LCJjdXJyZW50QnVja2V0IjotNjQsImN1cnJlbnRUYXJnZXRUaW1lU2xvdCI6MTY3ODc1MjAwMCwiZW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0RW5kVGltZSI6MTY3ODc4MjQxOTAwMCwiZXhwb3J0U3RhcnRUaW1lIjoxNjc4NzgxODE5MDAwLCJleHByZXNzUmFuZ2UiOmZhbHNlLCJoYXNOZXh0Ijp0cnVlLCJpbmRleCI6MCwibGF0ZXN0TG9nVGltZSI6MCwibWF0Y2hlcnMiOnsiY2hhaW4iOlt7ImxhYmVsIjoidXNlcklkIiwib3BlcmF0b3IiOiJFUVVBTFMiLCJ2YWx1ZSI6IjEyNzA2NzY2Nzk1NDY3MDQifV0sImxvY2tlZCI6dHJ1ZX0sIm1ldHJpYyI6IlNwbGl0cndQcm94eU1heFJlc3BvbnNlU2l6ZSIsIm1ldHJpY1R5cGUiOiJNRVRSSUMiLCJuYW1lc3BhY2UiOiJhY3Nfa3ZzdG9yZV9leCIsIm5leHRQa0FkYXB0ZXIiOnsiZGltIjoiVjowXG5EOmB1c2VySWRgPTEyNzA2NzY2Nzk1NDY3MDQsYGluc3RhbmNlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLGBub2RlSWRgPXItcmo5ZjlzMTlsc3V1MXd1bnVyLXByb3h5LTIsXG4iLCJtZXRhIjoiXG5WOjBcbk06YWNzX2t2c3RvcmVfZXgvU3BsaXRyd1Byb3h5TWF4UmVzcG9uc2VTaXplXG5XOjYwXG5COjRcbkk6LTFcblQ6MFxuQzpgQXZlcmFnZWAsYE1heGltdW1gLGBfX2NvdW50X19gLGBfX3RzX19gXG4iLCJyZCI6InN1YkFMU0RwWXY2K0t6aENQQUFBWkErNUFKMEpjbGErRGd2V0hFNWxDSHMvbGtqR2FXYTFJTkVwdFE9PSIsInRhZyI6IiJ9LCJvZmZzZXQiOjAsIm9mZnNldERpZ2l0Ijo0NTU0NTczNDQyMTc4NDIxMjIsInN0YXJ0VGltZSI6MTY3ODc4MTgxOTAwMCwic3RlcCI6LTEsInRhZ01hdGNoZXJzIjp7ImNoYWluIjpbXSwibG9ja2VkIjp0cnVlfSwidGFyZ2V0VGltZVNsb3RzIjpbMTY3ODY2NTYwMCwxNjc4NzUyMDAwXSwidXVpZCI6ImQwMmFhZmY1LWU3ZGQtNDUyYy0***********",
  "Code": 200,
  "Success": true,
  "RequestId": "915C2D7A-E6A4-17C3-8E13-4DBDD61E7919"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 %s %s
500 InternalError The request processing has failed due to some unknown error.
500 %s %s
403 %s %s
404 %s %s

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。