帮你快速理解、总结文档立即下载
文档中心>云安全中心>API 文档>容器资产管理相关接口>查询集群容器详情

查询集群容器详情

最近更新时间：2026-08-20 01:44:02
我的收藏

本页目录：

1. 接口描述

接口请求域名： csip.tencentcloudapi.com 。

查询集群容器详情。通过容器ID获取容器基本信息、镜像信息、挂载信息、网络信息以及关联节点信息。

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：DescribeClusterContainerDetail。
Version 是 String 公共参数，本接口取值：2022-11-21。
Region 否 String 公共参数，此参数为可选参数。
ContainerId 是 String

容器ID


示例值：1ea61132**a320a93772*2fd66091e4d
MemberId.N 否 Array of String

集团账号的成员id


示例值：["mem-tencent-****2f66e429"]

3. 输出参数

参数名称 类型 描述
AppID Integer

主账号AppID


示例值：260083796
ContainerId String

容器ID


示例值：1ea611**efa320a937724ebaca98fb413c6082fd66091e4d
Cmd String

容器启动CMD


示例值：/home/yunjing-agent -d -token -vip
CreateTime Timestamp ISO8601

容器创建时间


示例值：2026-07-29T11:43:52+08:00
RunStatus String

运行状态


示例值：RUNNING
IsolateStatus String

隔离状态


示例值：NORMAL
ImageName String

镜像名称


示例值：ccr.ccs.tencentyun.com/yunjing_agent/agent:dev-latest
ImageId String

镜像ID


示例值：sha256:94cc7bb42e2b7e536778b404262db678f09a4167773cc62ec4834a55dd625645
ImageSize String

镜像大小


示例值：36.28MB
ImageCreateTime String

镜像创建时间


示例值：2026-07-22T20:03:36+08:00
NodeName String

节点名称


示例值：cls-pde9e0s0_np-7i5wo9qa-cwvq7
NodeInternalIP String

节点内网IP


示例值：172.16.0.224
NodeRunStatus String

节点运行状态


示例值：Running
Mounts Array of ContainerMountItem

挂载信息列表
NetworkName String

网络名称


示例值：bridge
NetworkMode String

网络模式


示例值：bridge
NetworkId String

网络ID


示例值：net-abc123
EndpointId String

端点ID


示例值：ep-abc123
Gateway String

网关地址


示例值：172.17.0.1
IPv4 String

IPv4地址


示例值：172.17.0.2
IPv6 String

IPv6地址


示例值：2001:0db8:85a3:0000:0000:8a2e:0370:7334
MAC String

MAC地址


示例值：02:42:ac:11:00:02
ContainerName String

容器名称


示例值：yunjing-agent
NodeInstanceId String

节点实例ID


示例值：eks-3pwtyur9
NodeType String

容器关联节点的节点类型


示例值：WORKER
NodeUniqueID String

容器关联节点的节点唯一ID


示例值：ef616f81***e824b4502
ClusterCaMD5 String

容器关联集群的集群ca证书md5值，集群的唯一标识


示例值：814fe16****f9129471e26ae
EnableLinkImage Boolean

容器镜像能否关联到镜像仓库中的记录


示例值：true
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 1

输入示例

POST / HTTP/1.1
Host: csip.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeClusterContainerDetail
<公共请求参数>

{
    "ContainerId": "1ea61132******************a320a93772*****************2fd66091e4d",
    "MemberId": [
        "mem-tencent-********2f66e429"
    ]
}

输出示例

{
    "Response": {
        "AppID": 260083796,
        "ClusterCaMD5": "814fe16************f9129471e26ae",
        "Cmd": "",
        "ContainerId": "1ea611******************efa320a937724ebaca98fb413c6082fd66091e4d",
        "ContainerName": "yunjing-agent",
        "CreateTime": "2026-07-29T11:43:52+08:00",
        "ImageCreateTime": "2026-07-22T20:03:36+08:00",
        "ImageId": "sha256:94cc7bb42e2b7e536778b404262db678f09a4167773cc62ec4834a55dd625645",
        "ImageName": "ccr.ccs.tencentyun.com/yunjing_agent/agent:dev-latest",
        "ImageSize": "36.28MB",
        "IsolateStatus": "NORMAL",
        "Mounts": [],
        "NodeInstanceId": "eks-3pwtyur9",
        "NodeInternalIP": "172.16.0.224",
        "NodeName": "cls-pde9e0s0_np-7i5wo9qa-cwvq7",
        "NodeRunStatus": "Running",
        "NodeType": "WORKER",
        "NodeUniqueID": "ef616f81***************e824b4502",
        "RunStatus": "RUNNING",
        "RequestId": "680bbd5f-8f84-4b47-81fa-f6778b86dccc"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

命令行工具

6. 错误码

该接口暂无业务逻辑相关的错误码，其他错误码详见 公共错误码。

中国站