接口功能介绍
查询Chart版本列表
接口约束
仅限企业版实例使用
URI
GET /v1/listChartTag
路径参数
无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
instanceId | 是 | Long | 实例ID | 1638470585571688449 | |
repositoryId | 是 | Long | chart仓库ID | 1695042677004832769 | |
tagName | 否 | String | Chart版本(Tag) | mytag | |
pageNum | 否 | Integer | 页码 | 1 | |
pageSize | 否 | Integer | 每页大小 | 10 | |
order | 否 | String | 排序方式(desc:降序排序, asc:升序排序) | desc | |
orderBy | 否 | String | 排序字段(name:镜像版本名称, pushTime:推送时间) | createdTime |
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
Content-Type | 是 | String | 类型 | application/json | |
regionId | 是 | String | 资源池编码 | bb9fdb42056f11eda1610242ac110002 |
请求体body参数
无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 响应码 | 0 | |
message | String | 返回信息 | ||
returnObj | Object | 返回结果 | returnObj | |
error | String | 错误信息 |
表 returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
total | Integer | 总条数 | 5 | |
size | Integer | 每页条数 | 10 | |
current | Integer | 当前页码 | 1 | |
pages | Integer | 总页数 | 1 | |
records | Object | Chart版本(Tag)列表 | records |
表 records
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
name | String | Chart名称 | 0.1.0 | |
digest | String | Chart摘要 | sha256:688f091f0ac18668a4b5f7f771f761b57a1fd8aea44408d8d184e6aa69275f5b | |
size | String | Chart大小 | 4.59KB | |
pull_time | String | 最近一次拉取Chart时间 | 2023-09-05T07:51:02.678Z | |
push_time | String | 最近一次推送Chart时间 | 2023-09-05T07:51:02.678Z | |
description | String | Chart说明 | A Helm chart for Kubernetes |
枚举参数
无
请求示例
请求url
GET https://[endpoint].ctapi.ctyun.cn/v1/listChartTag?instanceId=1638470585571688449&repositoryId=1695042677004832769&tagName=mytag&pageNum=1&pageSize=10
请求头header
{
"Content-Type":"application/json"
}
请求体body
无
响应示例
{
"statusCode":0,
"message":"",
"returnObj":{
"current":1,
"hitCount":false,
"optimizeCountSql":true,
"orders":[
],
"pages":1,
"records":[
{
"description":"A Helm chart for Kubernetes",
"digest":"sha256: 688f091f0ac18668a4b5f7f771f761b57a1fd8aea44408d8d184e6aa69275f5b",
"name":"0.1.0",
"push_time":"2023-09-05T07: 51: 02.678Z",
"size":"4.59KB"
}
],
"searchCount":true,
"size":10,
"total":1
}
}
状态码
请参考 状态码
错误码
请参考 错误码