文档

DescribeContainerGroupEvents - 查询容器组事件列表

更新时间:

批量查询ECI实例的事件信息。

接口说明

调用本接口可以同时查询多个 ECI 实例的事件信息。默认返回每个 ECI 实例最新的 50 条事件信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
eci:DescribeContainerGroupEventsRead
  • containergroup
    acs:eci:{#regionId}:{#accountId}:containergroup/{#containergroupId}
  • eci:tag

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID。

cn-hangzhou
ZoneIdstring

可用区 ID。

cn-hangzhou-k
VSwitchIdstring

交换机 ID。

vsw-uf6h3rbwbm90urjwa****
ResourceGroupIdstring

资源组 ID。

rg-uf66jeqopgqa9hdn****
ContainerGroupIdsstring

ECI 实例 ID 序列。最多 20 个,字符串需按照 JSON 格式传入。

["eci-bp17gw49eu09yiwm****", "eci-bp19aq49du01abcm****", "eci-2zegym1qhbmdfr1s****"]
Tagobject []

ECI 实例绑定的标签。

Valuestring

ECI 实例的标签值。

name
Keystring

ECI 实例的标签键。

test
NextTokenstring

下一个查询开始的 Token,NextToken 为空表示没有下一个。

首次查询时无需设置该参数,后续查询的 Token 从返回结果中获取。

d78f2dd8-5979-42fe-xaee-b16db43be5bc
EventSourcestring

事件源。取值范围:

  • EciService
  • K8sAgent

默认为空,查询所有事件。

K8sAgent
SinceSecondinteger

返回最近几秒内新增的事件,用于轮询增量事件。

60
Limitinteger

限定此次返回资源(ECI 实例)的数量。默认为 200 个。

说明 返回结果可能小于指定的数量,但不会多于指定的数量。
200

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

1340C38D-6189-54D1-86F6-7D5ECF3E0088
TotalCountinteger

返回的事件条数。

10
Dataobject []

事件信息列表。

ContainerGroupIdstring

ECI 实例 ID。

eci-uf6fonnghi50v6nq****
Namestring

ECI 实例名称。

test
Namespacestring

ECI 实例所在命名空间。

redis
uuidstring

ECI 实例的 UUID。

3fc6b309-****-****
Annotationsstring

ECI 实例的注解。

"{\"tenancy.x-k8s.io/namespace\":\"redis\"}"
Eventsobject []

事件列表。

Typestring

事件类型。可能值:

  • Normal
  • Warning
Normal
Countinteger

事件数量。

10
FirstTimestampstring

事件第一次出现的时间。

2021-10-04T09:08:04Z
LastTimestampstring

事件最后一次出现的时间。

2021-10-04T09:08:04Z
Messagestring

事件信息。

Started container
Reasonstring

事件原因。

Started
ReportingComponentstring

上报事件的组件。

test
ReportingInstancestring

上报事件的实例。

test
Sourceobject

来源。

Componentstring

组件。

kubelet
Hoststring

主机类型。

eci
involvedObjectobject

事件关联的资源对象。

Kindstring

资源类型。

Pod
Namestring

资源名称。

test
Namespacestring

资源所在命名空间。

default
Uidstring

资源 ID。

eci-8vb5nkcq3a5cu0p3****
ApiVersionstring

K8s 版本。

v1
Metadataobject

事件元数据。

Namestring

事件名称。

eci-uto-created-eci-for-ubuntu.167e3fb73cc7f9cb
Namespacestring

命名空间。

default

示例

正常返回示例

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"
          }
        }
      ]
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-06-02OpenAPI 返回结构发生变更看变更集
变更项变更内容
出参OpenAPI 返回结构发生变更
2021-09-27OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:ZoneId
  • 本页导读 (1)
文档反馈