通过DescribeContainerGroupEvents批量查询ECI实例的事件信息。
接口说明
调用本接口可以同时查询多个ECI实例的事件信息。默认返回每个ECI实例最新的50条事件信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeContainerGroupEvents |
系统规定参数。取值:DescribeContainerGroupEvents。 |
RegionId | String | 是 | cn-hangzhou |
地域ID。 |
ZoneId | String | 否 | cn-hangzhou-k |
可用区ID。 |
VSwitchId | String | 否 | vsw-uf6h3rbwbm90urjwa**** |
交换机ID。 |
ResourceGroupId | String | 否 | rg-uf66jeqopgqa9hdn**** |
资源组ID。 |
ContainerGroupIds | String | 否 | ["eci-bp17gw49eu09yiwm****", "eci-bp19aq49du01abcm****", "eci-2zegym1qhbmdfr1s****"] |
ECI实例ID序列。最多20个,字符串需按照JSON格式传入。 |
Tag.N.Value | String | 否 | name |
ECI实例的标签值。 |
Tag.N.Key | String | 否 | test |
ECI实例的标签键。 |
NextToken | String | 否 | d78f2dd8-5979-42fe-xaee-b16db43be5bc |
下一个查询开始的Token,NextToken为空表示没有下一个。 首次查询时无需设置该参数,后续查询的Token从返回结果中获取。 |
EventSource | String | 否 | K8sAgent |
事件源。取值范围:
默认为空,查询所有事件。 |
SinceSecond | Integer | 否 | 60 |
返回最近几秒内新增的事件,用于轮询增量事件。 |
Limit | Integer | 否 | 200 |
限定此次返回资源(ECI实例)的数量。默认为200个。 说明 返回结果可能小于指定的数量,但不会多于指定的数量。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 1340C38D-6189-54D1-86F6-7D5ECF3E0088 |
请求ID。 |
TotalCount | Integer | 10 |
返回的事件条数。 |
Data | Array of data |
事件信息列表。 |
|
ContainerGroupId | String | eci-uf6fonnghi50v6nq**** |
ECI实例ID。 |
Events | Array of events |
事件列表。 |
|
Type | String | Normal |
事件类型。可能值:
|
Count | Integer | 10 |
事件数量。 |
FirstTimestamp | String | 2021-10-04T09:08:04Z |
事件第一次出现的时间。 |
LastTimestamp | String | 2021-10-04T09:08:04Z |
事件最后一次出现的时间。 |
Message | String | Started container |
事件信息。 |
Reason | String | Started |
事件原因。 |
ReportingComponent | String | test |
上报事件的组件。 |
ReportingInstance | String | test |
上报事件的实例。 |
Source | Object |
来源。 |
|
Component | String | kubelet |
组件。 |
Host | String | eci |
主机类型。 |
involvedObject | Object |
事件关联的资源对象。 |
|
Kind | String | Pod |
资源类型。 |
Name | String | test |
资源名称。 |
Namespace | String | default |
资源所在命名空间。 |
Uid | String | eci-8vb5nkcq3a5cu0p3**** |
资源ID。 |
ApiVersion | String | v1 |
K8s版本。 |
Metadata | Object |
事件元数据。 |
|
Name | String | eci-uto-created-eci-for-ubuntu.167e3fb73cc7f9cb |
事件名称。 |
Namespace | String | default |
命名空间。 |
示例
请求示例
https://eci.aliyuncs.com/?Action=DescribeContainerGroupEvents
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-k
&VSwitchId=vsw-uf6h3rbwbm90urjwa****
&ResourceGroupId=rg-uf66jeqopgqa9hdn****
&ContainerGroupIds=["eci-bp17gw49eu09yiwm****", "eci-bp19aq49du01abcm****", "eci-2zegym1qhbmdfr1s****"]
&Tag=[{"Value":"name","Key":"test"}]
&NextToken=d78f2dd8-5979-42fe-xaee-b16db43be5bc
&EventSource=K8sAgent
&SinceSecond=60
&Limit=200
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeContainerGroupEventsResponse>
<RequestId>1340C38D-6189-54D1-86F6-7D5ECF3E0088</RequestId>
<TotalCount>10</TotalCount>
<Data>
<ContainerGroupId>eci-uf6fonnghi50v6nq****</ContainerGroupId>
<Events>
<Type>Normal</Type>
<Count>10</Count>
<FirstTimestamp>2021-10-04T09:08:04Z</FirstTimestamp>
<LastTimestamp>2021-10-04T09:08:04Z</LastTimestamp>
<Message>Started container</Message>
<Reason>Started</Reason>
<ReportingComponent>test</ReportingComponent>
<ReportingInstance>test</ReportingInstance>
<Source>
<Component>kubelet</Component>
<Host>eci</Host>
</Source>
<involvedObject>
<Kind>Pod</Kind>
<Name>test</Name>
<Namespace>default</Namespace>
<Uid>eci-8vb5nkcq3a5cu0p3****</Uid>
<ApiVersion>v1</ApiVersion>
</involvedObject>
<Metadata>
<Name>eci-uto-created-eci-for-ubuntu.167e3fb73cc7f9cb</Name>
<Namespace>default</Namespace>
</Metadata>
</Events>
</Data>
</DescribeContainerGroupEventsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "1340C38D-6189-54D1-86F6-7D5ECF3E0088",
"TotalCount" : 10,
"Data" : [ {
"ContainerGroupId" : "eci-uf6fonnghi50v6nq****",
"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"
}
} ]
} ]
}
错误码
访问错误中心查看更多错误码。