すべてのプロダクト
Search

このプロダクト

    EventBridge:EventCenterQueryEvents

    ドキュメントセンター

    EventBridge:EventCenterQueryEvents

    最終更新日:Apr 23, 2026

    イベントセンターからイベントをクエリします。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    eventbridge:EventCenterQueryEvents

    get

    *EventBus

    acs:eventbridge:{#regionId}:{#accountId}:eventbus/{#eventbus}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    BusName

    string

    任意

    イベントバスの名前です。

    default
    NextToken

    string

    任意

    次のページの結果を取得するためのトークンです。

    100
    MaxResults

    integer

    任意

    返す結果の最大数です。有効な値：0～10,000。デフォルト値は 100 です。

    100
    Body

    object

    必須

    リクエストボディです。

    SchemaId

    string

    必須

    スキーマ ID です。

    ecs:GeneralSchema
    QueryType

    string

    必須

    クエリタイプです。有効な値：

    • timeseries：時系列データをクエリします。

    • table：テーブルデータをクエリします。

    • timeseries_and_table：時系列データとテーブルデータの両方をクエリします。

    timeseries_and_table
    Parameters

    object

    必須

    クエリパラメーターです。

    Breakdowns

    array

    任意

    データセットを分割するためのディメンションとして使用する列名の配列です。

    string

    任意

    分割のディメンションとして使用する列の名前です。

    source
    Calculations

    array<object>

    任意

    指定された列で実行する計算です。

    object

    任意

    Op

    string

    任意

    演算子です。

    COUNT_DISTINCT
    Column

    string

    任意

    列名です。

    source
    Filters

    array<object>

    任意

    フィルター条件のリストです。

    array<object>

    任意

    Column

    string

    任意

    列名です。

    source
    Op

    string

    任意

    演算子です。

    =
    Values

    array

    任意

    演算子で使用する値です。

    string

    任意

    値が文字列の場合は、一重引用符 (') で囲みます。

    'acs.ecs'
    NestedFilterCombination

    string

    任意

    ネストされたフィルターを結合するための論理演算子です。

    AND
    NestedFilters

    array<object>

    任意

    ネストされたフィルターのリストです。

    object

    任意

    Column

    string

    任意

    列名です。

    Op

    string

    任意

    演算子です。

    Values

    array

    任意

    演算子で使用する値のリストです。

    string

    任意

    FilterCombination

    string

    任意

    フィルター条件を結合するための論理演算子です。

    AND
    Granularity

    integer

    任意

    時系列データをクエリするための時間の粒度 (秒単位) です。最小値は 1 です。これは推奨値であり、実際の粒度は応答で返されます。

    30
    Orders

    array<object>

    任意

    クエリ結果のソート順です。このパラメーターは、QueryType が table に設定されている場合にのみ適用されます。

    object

    任意

    Op

    string

    任意

    演算子です。

    AVG
    Column

    string

    任意

    列名です。

    source
    Desc

    boolean

    任意

    結果を降順でソートするかどうかを指定します。

    true
    Offset

    integer

    任意

    クエリの開始位置です。カウントは 0 から始まります。

    0
    Limit

    integer

    任意

    クエリするイベントの最大数です。有効な値：1～10,000。

    100
    TimeRange

    integer

    任意

    時間範囲です。単位：ミリ秒。最小値は 1,000 です。

    1000000
    StartTime

    integer

    任意

    イベントクエリの開始タイムスタンプです。単位：ミリ秒。

    1687860901814
    EndTime

    integer

    任意

    イベントクエリの終了タイムスタンプです。単位：ミリ秒。

    1687861201814

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答スキーマです。

    Message

    string

    エラーメッセージです。

    Specified parameter Limit is not valid.
    RequestId

    string

    リクエスト ID です。

    5DAF96FB-A4B6-548C-B999-XXXXXXXX
    Data

    object

    返されたデータです。

    NextToken

    string

    次のページの結果を取得するために使用されるトークンです。このパラメーターが空の場合、すべての結果が返されたことを示します。

    100
    MaxResults

    integer

    返すエントリの最大数です。

    100
    TotalCount

    integer

    フィルター条件を満たすエントリの総数です。このパラメーターはオプションであり、デフォルトでは返されません。

    76
    TimeSeries

    array<object>

    time series クエリタイプのクエリ結果です。

    array<object>

    RowData

    object

    キーと値のペアとして表されるクエリ結果のエントリです。

    { "id":"xxx", "source":"acs.ecs" }
    Time

    string

    タイムスタンプです。

    1683561600000
    Table

    array<object>

    table クエリタイプのクエリ結果です。

    array<object>

    RowData

    object

    キーと値のペアとして表されるクエリ結果のエントリです。

    { "id":"xxx", "source":"acs.ecs" }
    Code

    string

    API 呼び出しのステータスです。Success または POP エラーコードが返されます。

    Success
    Success

    boolean

    呼び出しが成功したかどうかを示します。true は成功を示し、false は失敗を示します。

    true

    例

    成功レスポンス

    JSONJSON

    {
  "Message": "Specified parameter Limit is not valid.",
  "RequestId": "5DAF96FB-A4B6-548C-B999-XXXXXXXX",
  "Data": {
    "NextToken": "100",
    "MaxResults": 100,
    "TotalCount": 76,
    "TimeSeries": [
      {
        "RowData": {
          "id": "xxx",
          "source": "acs.ecs"
        },
        "Time": "1683561600000"
      }
    ],
    "Table": [
      {
        "RowData": {
          "id": "xxx",
          "source": "acs.ecs"
        }
      }
    ]
  },
  "Code": "Success",
  "Success": true
}

    エラーコード

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

    変更履歴

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