查询边缘集群详情
功能介绍
应用服务器可调用此接口查询边缘集群详情。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v3/{project_id}/clusters/{cluster_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID。获取方法请参见 获取项目ID。 |
| cluster_id | 是 | String | 边缘集群ID |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| cluster_id | String | 集群ID |
| cluster_name | String | 集群名称 |
| description | String | 集群描述 |
| version | String | 边缘集群版本 |
| state | String | 边缘集群状态 |
| os | String | 操作系统 |
| arch | String | 集群架构 |
| license | LicenseInfo object | license信息 |
| resource_id | String | 资源id |
| cluster_type | String | 集群类型 |
| kubernetes_version | String | kubernetes版本 |
| license_status | String | 集群license状态 |
| cluster_addr | String | 集群地址 |
| create_time | String | 创建时间 |
| update_time | String | 最后一次修改时间 |
请求示例
GET https://{endpoint}/v2/{project_id}/clusters/{cluster_id} 响应示例
状态码：200
OK
{
"cluster_id" : "123343534",
"cluster_name" : "test-cluster",
"description" : "this is a test cluster",
"version" : "string",
"state" : "string",
"os" : "string",
"arch" : "string",
"license" : {
"esn" : "54df65s1d65f4as3d131df32",
"expire_time" : "2025-09-26",
"grace_time" : "2025-09-26"
},
"resource_id" : "string",
"cluster_type" : "IoTEdge",
"kubernetes_version" : "v1.27.0",
"create_time" : "string",
"update_time" : "string"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 400 | BAD REQUEST |
| 401 | Unauthorized |
| 403 | FORBIDDEN |
| 500 | Internal Server Error |
错误码
请参见错误码。
