接口功能介绍
查询镜像版本(Tag)列表
接口约束
无
URI
GET /v1/listRepoTag
路径参数
无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
instanceId | 是 | Long | 实例ID | 1638470585571688449 | |
repositoryId | 是 | Long | 镜像仓库ID | 1695041896390332417 | |
tagName | 否 | String | 镜像版本(Tag) | mytag | |
pageSize | 否 | Integer | 每页大小 | 10 | |
pageNum | 否 | Integer | 页码 | 1 | |
orderBy | 否 | String | 排序字段(name:镜像版本名称, pushTime:推送时间) | createdTime | |
order | 否 | String | 排序方式(desc:降序排序, asc:升序排序) | desc |
请求参数
请求头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 | 镜像版本(Tag)列表 | records |
表 records
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
name | String | 镜像名称 | v0.16.0 | |
digest | String | 镜像摘要 | sha256:86acd01eece9da3e4f1eedbd7ddb58a304740aa9426632e5de5c1d07dd7b749a | |
architecture | String | 制品架构 | amd64 | |
author | String | 镜像作者 | The Prometheus Authors <prometheus-developers@googlegroups.com> | |
created | String | 镜像创建时间 | 2019-11-11T16:39:34.106623916Z | |
os | String | 操作系统 | linux | |
size | String | 镜像大小 | 9.19MB | |
pull_time | String | 最近一次拉取镜像时间 | 2023-08-25T11:54:11.924Z | |
push_time | String | 最近一次推送镜像时间 | 2023-08-25T11:54:11.924Z |
枚举参数
无
请求示例
请求url
GET https://[endpoint].ctapi.ctyun.cn/v1/listRepoTag?instanceId=1638470585571688449&repositoryId=1695041896390332417&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":[
{
"architecture":"amd64",
"author":"The Prometheus Authors <prometheus-developers@googlegroups.com>",
"created":"2019-11-11T16:39:34.106623916Z",
"digest":"sha256:86acd01eece9da3e4f1eedbd7ddb58a304740aa9426632e5de5c1d07dd7b749a",
"name":"v0.16.0",
"os":"linux",
"push_time":"2023-08-25T11:54:11.924Z",
"size":"9.19MB"
}
],
"searchCount":true,
"size":10,
"total":1
}
}
状态码
请参考 状态码
错误码
请参考 错误码