全部產品
Search
文件中心

API Gateway:事件管理

更新時間:Aug 30, 2025

雲原生API Gateway為產生的事件數目據提供了統一的管理、分析、展示和通知能力。針對一些例外狀況事件,您可以根據云原生API Gateway提供的指引自主排查。本文介紹如何通過事件感知雲原生API Gateway所託管資源的事件變更。

事件模型

一個雲原生API Gateway事件主要有以下參數定義。

參數

描述

時間

事件的觸發時間。

產品名稱

cnapigateway

事件名稱

事件的名稱,包含事件Code和事件描述兩部分。

事件等級

雲原生API Gateway事件中心按事件的影響程度將其劃分成了三個等級。

  • 資訊(INFO)系統運行正常,使用者預期行為對業務沒有影響的事件。

  • 警告(WARN)系統運行正常或出現異常可自愈,對業務可能有影響需要使用者關注的事件。

  • 嚴重(CRITICAL)系統運行異常無法自愈,導致業務無法正常工作的事件。

地區

執行個體所在region。

資源

事件關聯的資源ARN。

內容

事件具體內容。

操作

查看事件詳情。

功能入口

  1. 登入雲原生API Gateway控制台

  2. 在左側導覽列,選擇事件

事件查詢

事件中心提供了多維度事件查詢能力,您可以按照多個維度進行事件查詢。例如:

  • 事件等級

  • 事件名稱

  • 關鍵字

  • 事件觸發時間

按事件等級查詢

您可以選擇指定的事件等級進行事件篩選。

image

按事件名稱查詢

您可以選擇指定的事件名稱進行事件篩選。

image

按關鍵字查詢

可以輸入關鍵字進行事件篩選。例如:如果您需要查詢網關執行個體gw-ctbq4qum1hknl20trv40d的關聯事件,可以在搜尋方塊中輸入gw-ctbq4qum1hknl20trv40查詢。

說明

關鍵字請在列表中的資源內容中擷取。

按事件觸發時間查詢

自訂時間範圍,您可以便捷地查詢指定時間段內所觸發的事件。

說明

雲原生API Gateway事件中心可查詢90天內的資料,最多連續查詢3天資料。

查看事件詳情

單擊事件記錄操作列的詳情,您可以查看事件的詳細資料。

image

事件說明

以下情境或者操作會觸發相關事件通知:

雲原生API Gateway彈性擴容(APIG:ElasticScaleOut

執行彈性擴容時,雲原生API Gateway會根據擴容所處的狀態產生此事件,共有三個狀態:

Executing:執行中|Executed:執行成功|Failed:執行失敗

Executing

該狀態代表雲原生API Gateway彈性擴容進行中。

JSON格式:

{
    "Status": "Executing",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:1321*******4629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01",
        "message": "彈性擴容開始",
        "operator": "SYSTEM",
        "publishRecordId": 6264487,
        "replicas": 3
    },
    "Product": "cnapigateway",
    "Time": 1756400523000,
    "Level": "INFO",
    "RegionId": "cn-hangzhou",
    "Id": "f41bb19f-c0ae-4938-b182-13b3cead0322",
    "GroupId": "0",
    "Name": "APIG:ElasticScaleOut:Executing"
}

Executed

該狀態代表雲原生API Gateway彈性擴容執行成功。

JSON格式:

{
    "Status": "Executed",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:1321****094629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01",
        "message": "彈性擴容成功",
        "operator": "SYSTEM",
        "publishRecordId": 6264487,
        "replicas": 3
    },
    "Product": "cnapigateway",
    "Time": 1756400539000,
    "Level": "INFO",
    "RegionId": "cn-hangzhou",
    "Id": "3f70b85e-ed52-4d20-b97e-6bcc35588114",
    "GroupId": "0",
    "Name": "APIG:ElasticScaleOut:Executed"
}

Failed

該狀態代表雲原生API Gateway彈性擴容執行失敗。

JSON格式:

{
    "Status": "Failed",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:13219*****94629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01",
        "message": "彈性擴容失敗",
        "operator": "SYSTEM",
        "publishRecordId": 6264487,
        "replicas": 3
    },
    "Product": "cnapigateway",
    "Time": 1756400539000,
    "Level": "WARN",
    "RegionId": "cn-hangzhou",
    "Id": "3f70b85e-ed52-4d20-b97e-6bcc35588114",
    "GroupId": "0",
    "Name": "APIG:ElasticScaleOut:Failed"
}

content(內容)欄位解釋:

欄位

說明

樣本值

gatewayName

網關名稱

gw-test-01

replicas

網關執行個體節點數

3

message

訊息

彈性擴容成功

gatewayId

網關 ID

gw-d2o34q6m1hkgipd1hph0

operator

事件的執行者

SYSTEM

publishRecordId

發布記錄ID

6264487

雲原生API Gateway彈性縮容(APIG:ElasticScaleIn

執行彈性縮容時,雲原生API Gateway會根據縮容所處的狀態產生此事件,共有三個狀態:

Executing:執行中|Executed:執行成功|Failed:執行失敗

Executing

該狀態代表雲原生API Gateway彈性縮容執行中。

JSON格式:

{
    "Status": "Executing",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:132******94629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01",
        "message": "彈性縮容開始",
        "operator": "SYSTEM",
        "publishRecordId": 6266557,
        "replicas": 2
    },
    "Product": "cnapigateway",
    "Time": 1756414922000,
    "Level": "INFO",
    "RegionId": "cn-hangzhou",
    "Id": "7bb39402-08ff-4f1f-b3d1-2d259ee4711d",
    "GroupId": "0",
    "Name": "APIG:ElasticScaleIn:Executing"
}

Executed

該狀態代表雲原生API Gateway彈性縮容成功。

JSON格式:

{
    "Status": "Executed",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:132******94629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01",
        "message": "彈性縮容成功",
        "operator": "SYSTEM",
        "publishRecordId": 6266557,
        "replicas": 2
    },
    "Product": "cnapigateway",
    "Time": 1756414922000,
    "Level": "INFO",
    "RegionId": "cn-hangzhou",
    "Id": "7bb39402-08ff-4f1f-b3d1-2d259ee4711d",
    "GroupId": "0",
    "Name": "APIG:ElasticScaleIn:Executed"
}

Failed

該狀態代表雲原生API Gateway彈性縮容失敗。

JSON格式:

{
    "Status": "Failed",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:132******94629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01",
        "message": "彈性縮容失敗",
        "operator": "SYSTEM",
        "publishRecordId": 6266557,
        "replicas": 2
    },
    "Product": "cnapigateway",
    "Time": 1756414922000,
    "Level": "WARN",
    "RegionId": "cn-hangzhou",
    "Id": "7bb39402-08ff-4f1f-b3d1-2d259ee4711d",
    "GroupId": "0",
    "Name": "APIG:ElasticScaleIn:Failed"
}

content(內容)欄位解釋:

欄位

說明

樣本值

gatewayName

網關名稱

gw-test-01

replicas

網關執行個體節點數

3

message

訊息

彈性縮容成功

gatewayId

網關 ID

gw-d2o34q6m1hkgipd1hph0

operator

事件的執行者

SYSTEM

publishRecordId

發布記錄ID

6264487

雲原生API Gateway彈性開啟(APIG:ElasticOpen

開啟自動擴容時,雲原生API Gateway會根據開啟結果產生此事件,共有兩個狀態:

Executed:成功|Failed:失敗

Executed

該狀態代表雲原生API Gateway彈性開啟成功。

JSON格式:

{
    "Status": "Executed",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:13219******4629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "message": "Create Elastic Strategy:Success",
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01",
        "newElasticStrategy": {
            "elasticEnabled": true,
            "elasticType": "CronHPA",
            "timePolicyList": [
                {
                    "units": 3,
                    "startTime": "01:02",
                    "endTime": "05:02"
                }
            ],
            "maxUnits": null,
            "loadWarningThreshold": null,
            "enableScaleTimePolicyList": [
                {
                    "startTime": "",
                    "endTime": ""
                }
            ],
            "disableScaleTimePolicyList": null
        }
    },
    "Product": "cnapigateway",
    "Time": 1756378065000,
    "Level": "INFO",
    "RegionId": "cn-hangzhou",
    "Id": "589abc6e-97de-4d3d-b580-7fe53cda6feb",
    "GroupId": "0",
    "Name": "APIG:ElasticOpen:Executed"
}

Failed

該狀態代表雲原生API Gateway彈性開啟失敗。

JSON格式:

{
    "Status": "Failed",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:13219******4629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "message": "Create Elastic Strategy:Failed",
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01"
    },
    "Product": "cnapigateway",
    "Time": 1756378065000,
    "Level": "WARN",
    "RegionId": "cn-hangzhou",
    "Id": "589abc6e-97de-4d3d-b580-7fe53cda6feb",
    "GroupId": "0",
    "Name": "APIG:ElasticOpen:Failed"
}

content(內容)欄位解釋:

欄位

說明

樣本值

message

日誌資訊

Create Elastic Strategy:Success

gatewayId

網關ID

gw-d2o34q6m1hkgipd1hph0

gatewayName

網關名稱

gw-test-01

newElasticStrategy

新版策略

elasticEnabled

彈性開啟

true

elasticType

擴縮容方式

CronHPA

units

目標總節點

3

startTime

策略執行開始時間

01:02

endTime

策略執行結束時間

05:02

maxUnits

允許最大節點數

4

loadWarningThreshold

擴縮容水位設定

true

disableScaleTimePolicyList

允許縮容的時間段

null

雲原生API Gateway彈性關閉(APIG:ElasticClose

關閉自動擴容時,雲原生API Gateway會根據關閉結果產生此事件,共有兩個狀態:

Executed:成功|Failed:失敗

Executed

該狀態代表雲原生API Gateway彈性關閉成功。

JSON格式:

{
    "Status": "Executed",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:132*******629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "message": "Delete Elastic Strategy:Success",
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01",
        "oldElasticStrategy": {
            "elasticEnabled": true,
            "elasticType": "CronHPA",
            "timePolicyList": [
                {
                    "units": 3,
                    "startTime": "05:04",
                    "endTime": "08:04"
                }
            ],
            "maxUnits": null,
            "loadWarningThreshold": null,
            "enableScaleTimePolicyList": [
                {
                    "startTime": "",
                    "endTime": ""
                }
            ],
            "disableScaleTimePolicyList": null
        }
    },
    "Product": "cnapigateway",
    "Time": 1756430305000,
    "Level": "INFO",
    "RegionId": "cn-hangzhou",
    "Id": "6305f83d-3735-4c5c-aa41-ec1353af7d60",
    "GroupId": "0",
    "Name": "APIG:ElasticClose:Executed"
}

Failed

該狀態代表雲原生API Gateway彈性關閉失敗。

JSON格式:

{
    "Status": "Failed",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:13219******4629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "message": "Delete Elastic Strategy:Failed",
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01"
    },
    "Product": "cnapigateway",
    "Time": 1756378065000,
    "Level": "WARN",
    "RegionId": "cn-hangzhou",
    "Id": "589abc6e-97de-4d3d-b580-7fe53cda6feb",
    "GroupId": "0",
    "Name": "APIG:ElasticClose:Failed"
}

content(內容)欄位解釋:

欄位

說明

樣本值

message

日誌資訊

Delete Elastic Strategy:Success

gatewayId

網關ID

gw-d2o34q6m1hkgipd1hph0

gatewayName

網關名稱

gw-test-01

oldElasticStrategy

舊策略

elasticEnabled

彈性開啟

true

elasticType

擴縮容方式

CronHPA

units

目標總節點

3

startTime

策略執行開始時間

05:04

endTime

策略執行結束時間

08:04

maxUnits

允許最大節點數

4

loadWarningThreshold

擴縮容水位設定

true

disableScaleTimePolicyList

允許縮容的時間段

null

雲原生API Gateway彈性策略更新)(APIG:ElasticStrategyUpdate

自動擴容處於開啟狀態時,雲原生API Gateway會更新自動擴容策略,並根據更新結果產生此事件,共有兩個狀態:

Executed:成功|Failed:失敗

Executed

該狀態代表雲原生API Gateway彈性策略更新成功。

JSON格式:

{
    "Status": "Executed",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:1321*****4629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "message": "Update Elastic Strategy:Success",
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01",
        "oldElasticStrategy": {
            "elasticEnabled": true,
            "elasticType": "CronHPA",
            "timePolicyList": [
                {
                    "units": 3,
                    "startTime": "01:02",
                    "endTime": "05:02"
                }
            ],
            "maxUnits": null,
            "loadWarningThreshold": null,
            "enableScaleTimePolicyList": [
                {
                    "startTime": "",
                    "endTime": ""
                }
            ],
            "disableScaleTimePolicyList": null
        },
        "newElasticStrategy": {
            "elasticEnabled": true,
            "elasticType": "CronHPA",
            "timePolicyList": [
                {
                    "units": 3,
                    "startTime": "05:04",
                    "endTime": "08:04"
                }
            ],
            "maxUnits": null,
            "loadWarningThreshold": null,
            "enableScaleTimePolicyList": [
                {
                    "startTime": "",
                    "endTime": ""
                }
            ],
            "disableScaleTimePolicyList": null
        }
    },
    "Product": "cnapigateway",
    "Time": 1756430007000,
    "Level": "INFO",
    "RegionId": "cn-hangzhou",
    "Id": "ee78f750-1f3a-45d7-8c4f-cc17d6ae5f75",
    "GroupId": "0",
    "Name": "APIG:ElasticStrategyUpdate:Executed"
}

Failed

該狀態代表雲原生API Gateway彈性策略更新失敗。

JSON格式:

{
    "Status": "Failed",
    "InstanceName": "gw-test-01",
    "ResourceId": "acs:apig:cn-hangzhou:13219******4629:gateway/gw-d2o34q6m1hkgipd1hph0",
    "Content": {
        "message": "Update Elastic Strategy:Failed",
        "gatewayId": "gw-d2o34q6m1hkgipd1hph0",
        "gatewayName": "gw-test-01"
    },
    "Product": "cnapigateway",
    "Time": 1756378065000,
    "Level": "WARN",
    "RegionId": "cn-hangzhou",
    "Id": "589abc6e-97de-4d3d-b580-7fe53cda6feb",
    "GroupId": "0",
    "Name": "APIG:ElasticStrategyUpdate:Failed"
}

content(內容)欄位解釋:

欄位

說明

樣本值

message

日誌資訊

Update Elastic Strategy:Success

gatewayId

網關ID

gw-d2o34q6m1hkgipd1hph0

gatewayName

網關名稱

gw-test-01

oldElasticStrategy

舊策略

newElasticStrategy

新策略

elasticEnabled

彈性開啟

true

elasticType

擴縮容方式

CronHPA

units

目標總節點

3

startTime

策略執行開始時間

05:04

endTime

策略執行結束時間

08:04

maxUnits

允許最大節點數

4

loadWarningThreshold

擴縮容水位設定

true

disableScaleTimePolicyList

允許縮容的時間段

null

關於雲原生API Gateway支援的所有事件和為各事件提供處理建議,請參見下表:

事件Code

事件名稱

事件等級

CloudMonitor事件名稱

事件說明和影響

APIG:ElasticScaleOut

雲原生API Gateway彈性擴容

警告

APIG:ElasticScaleOut:Failed:雲原生API Gateway彈性擴容執行失敗

執行彈性擴容時,雲原生API Gateway會根據擴容所處的狀態產生此事件。

資訊

APIG:ElasticScaleOut:Executing:雲原生API Gateway彈性擴容執行中

資訊

APIG:ElasticScaleOut:Executed:雲原生API Gateway彈性擴容執行成功

APIG:ElasticScaleIn

雲原生API Gateway彈性縮容

警告

APIG:ElasticScaleIn:Failed:雲原生API Gateway彈性縮容執行失敗

執行彈性縮容時,雲原生API Gateway會根據縮容所處的狀態產生此事件。

資訊

APIG:ElasticScaleIn:Executing:雲原生API Gateway彈性縮容執行中

資訊

APIG:ElasticScaleIn:Executed:雲原生API Gateway彈性縮容執行成功

APIG:ElasticOpen

雲原生API Gateway彈性開啟

警告

APIG:ElasticOpen:Failed:雲原生API Gateway彈性開啟失敗

開啟自動擴容時,雲原生API Gateway會根據開啟結果產生此事件。

資訊

APIG:ElasticOpen:Executed:雲原生API Gateway彈性開啟成功

APIG:ElasticClose

雲原生API Gateway彈性關閉

警告

APIG:ElasticClose:Failed:雲原生API Gateway彈性關閉失敗

關閉自動擴容時,雲原生API Gateway會根據關閉結果產生此事件。

資訊

APIG:ElasticClose:Executed:雲原生API Gateway彈性關閉成功

APIG:ElasticStrategyUpdate

雲原生API Gateway彈性策略更新

警告

APIG:ElasticStrategyUpdate:Failed:雲原生API Gateway彈性策略更新失敗

自動擴容處於開啟狀態時,雲原生API Gateway會更新自動擴容策略,並根據更新結果產生此事件。

資訊

APIG:ElasticStrategyUpdate:Executed:雲原生API Gateway彈性策略更新成功