最近更新时间:2022.06.14 21:29:04
首次发布时间:2022.06.14 21:29:04
查询指定 OCI 制品仓库下的一个或多个 OCI 制品(镜像、Helm Chart)版本。
查询 OCI 制品版本时,通过 Filter 参数,控制 OCI 制品版本的筛选条件。
参数名 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListTags | 公共参数,本接口值:ListTags。 |
Version | String | 是 | 2022-05-12 | 公共参数,本接口值:2022-05-12。 |
Registry | String | 是 | registrya | 指定 OCI 制品仓库所属的镜像仓库实例名称。在 镜像仓库控制台 的 实例列表 页面,获取实例名称。 |
Namespace | String | 是 | library | 指定 OCI 制品仓库所属的命名空间名称。在 镜像仓库控制台 目标实例的 命名空间 页面,获取命名空间名称。 |
Repository | String | 是 | repositorya | 指定 OCI 制品仓库名称。在 镜像仓库控制台 目标实例的 OCI制品仓库 页面,获取 OCI 制品仓库名称。 |
Filter | Object<TagFilter> | 否 | 查询 OCI 制品版本的过滤条件。详细信息,请参见 TagFilter。 | |
PageSize | Integer | 否 | 10 | 单页展示的 OCI 制品版本数量,默认为 10 个。 |
PageNumber | Integer | 否 | 1 | 开始显示返回结果的页码,从 1 开始,默认为 1。 |
调用该 API 时,除了上述请求参数外,还需传入公共请求参数。公共请求参数说明,请参见 火山引擎公共参数文档。
POST /?Action=ListTags &Version=2022-05-12 &<公共参数> Body { "Registry": "registrya", "Namespace": "library", "Repository": "repositorya", "PageSize": 2, "PageNumber": 1, "Filter": { "Names": ["taga"], "Types": ["Image"] } }
参数名 | 类型 | 示例值 | 描述 |
---|---|---|---|
Registry | String | registrya | 指定 OCI 制品仓库所属的镜像仓库实例名称。 |
Namespace | String | library | 指定 OCI 制品仓库所属的命名空间名称。 |
Repository | String | repositorya | 指定 OCI 制品仓库名称。 |
TotalCount | Integer | 1 | 查询到的 OCI 制品版本总数。 |
Items | List<Tag> | OCI 制品版本列表。详细信息,请参见 Tag。 | |
PageSize | Integer | 10 | 单页显示的 OCI 制品版本信息条数。 |
PageNumber | Integer | 1 | 当前页码。 |
{ "ResponseMetadata": { "RequestId": "540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx", "Action": "ListTags", "Version": "2022-05-12", "Service": "cr", "Region": "cn-beijing" }, "Result": { "Registry": "registrya", "Namespace": "library", "Repository": "repositorya", "TotalCount": 1, "PageSize": 10, "PageNumber": 1, "Items": [ { "Digest": "sha256:318693f46bd015fa7e1652cff99728ab91403d0922af1183a8ad15ee********", "Type": "Image", "PushTime": "2021-08-26T06:04:29Z", "Size": 4389, "Name": "0.0.2", "ImageAttributes": [ { "Author": "", "Architecture": "amd64", "Os": "linux", "Digest": "xxxxxx" } ] } ] } }
本接口错误码如下表所示,公共错误码请参见 公共错误码。
HTTP状态码 | 错误码 | 错误信息 | 处理措施 |
---|---|---|---|
400 | OperationDenied.RegistryStatus | The action has been denied due to wrong status %s. | 当前实例状态下不允许执行指定操作,请等待状态转换后重试。 |