調(diào)用DescribeContainerGroupEvents批量查詢ECI實例的事件信息。
接口說明
調(diào)用本接口可以同時查詢多個 ECI 實例的事件信息。默認返回每個 ECI 實例最新的 50 條事件信息。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
eci:DescribeContainerGroupEvents | get | *containergroup acs:eci:{#regionId}:{#accountId}:containergroup/{#containergroupId} |
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 地域 ID。 | cn-hangzhou |
ZoneId | string | 否 | 可用區(qū) ID。 | cn-hangzhou-k |
VSwitchId | string | 否 | 交換機 ID。 | vsw-uf6h3rbwbm90urjwa**** |
ResourceGroupId | string | 否 | 資源組 ID。 | rg-uf66jeqopgqa9hdn**** |
ContainerGroupIds | string | 否 | ECI 實例 ID 序列。最多 20 個,字符串需按照 JSON 格式傳入。 | ["eci-bp17gw49eu09yiwm****", "eci-bp19aq49du01abcm****", "eci-2zegym1qhbmdfr1s****"] |
Tag | array<object> | 否 | ECI 實例綁定的標簽。 | |
object | 否 | ECI 實例綁定的標簽。 | ||
Value | string | 否 | ECI 實例的標簽值。 | name |
Key | string | 否 | ECI 實例的標簽鍵。 | test |
NextToken | string | 否 | 下一個查詢開始的 Token,NextToken 為空表示沒有下一個。 首次查詢時無需設(shè)置該參數(shù),后續(xù)查詢的 Token 從返回結(jié)果中獲取。 | d78f2dd8-5979-42fe-xaee-b16db43be5bc |
EventSource | string | 否 | 事件源。取值范圍:
默認為空,查詢所有事件。 | K8sAgent |
SinceSecond | integer | 否 | 返回最近幾秒內(nèi)新增的事件,用于輪詢增量事件。 | 60 |
Limit | integer | 否 | 限定此次返回資源(ECI 實例)的數(shù)量。默認為 200 個。 說明
返回結(jié)果可能小于指定的數(shù)量,但不會多于指定的數(shù)量。
| 200 |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "1340C38D-6189-54D1-86F6-7D5ECF3E0088",
"TotalCount": 10,
"Data": [
{
"ContainerGroupId": "eci-uf6fonnghi50v6nq****",
"Name": "test",
"Namespace": "redis",
"uuid": "3fc6b309-****-****",
"Annotations": "\"{\\\"tenancy.x-k8s.io/namespace\\\":\\\"redis\\\"}\"",
"Events": [
{
"Type": "Normal",
"Count": 10,
"FirstTimestamp": "2021-10-04T09:08:04Z",
"LastTimestamp": "2021-10-04T09:08:04Z",
"Message": "Started container",
"Reason": "Started",
"ReportingComponent": "test",
"ReportingInstance": "test",
"Source": {
"Component": "kubelet",
"Host": "eci"
},
"involvedObject": {
"Kind": "Pod",
"Name": "test",
"Namespace": "default",
"Uid": "eci-8vb5nkcq3a5cu0p3****",
"ApiVersion": "v1"
},
"Metadata": {
"Name": "eci-uto-created-eci-for-ubuntu.167e3fb73cc7f9cb",
"Namespace": "default"
}
}
]
}
]
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidParameter.MismatchInstanceType | The instanceId mismatch instance type. | 實例類型錯誤 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-09-04 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2023-06-02 | OpenAPI 返回結(jié)構(gòu)發(fā)生變更 | 查看變更詳情 |
2021-09-27 | OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |