最近更新时间:2022.06.14 21:29:04
首次发布时间:2022.06.14 21:29:04
查询指定镜像仓库实例下的一个或多个 OCI 制品仓库。
查询 OCI 制品仓库时,通过 Filter 参数,控制 OCI 制品仓库的筛选条件。
参数名 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListRepositories | 公共参数,本接口值:ListRepositories。 |
Version | String | 是 | 2022-05-12 | 公共参数,本接口值:2022-05-12。 |
Registry | String | 是 | registrya | 指定镜像仓库实例名称。在 镜像仓库控制台 的 实例列表 页面,获取实例名称。 |
Filter | Object<RepositoryFilter> | 否 | 查询 OCI 制品仓库的过滤条件。详细信息,请参见 RepositoryFilter。 | |
PageSize | Integer | 否 | 10 | 单页展示的 OCI 制品仓库数量,默认为 10 个。 |
PageNumber | Integer | 否 | 1 | 开始显示返回结果的页码,从 1 开始,默认为 1。 |
调用该 API 时,除了上述请求参数外,还需传入公共请求参数。公共请求参数说明,请参见 火山引擎公共参数文档。
POST /?Action=ListRepositories &Version=2022-05-12 &<公共参数> Body { "Registry": "registrya", "PageSize": 20, "PageNumber": 3, "Filter": { "Namespaces": ["library"], "Names": ["repositorya"], "AccessLevels": ["Private"] } }
参数名 | 类型 | 示例值 | 描述 |
---|---|---|---|
Registry | String | registrya | 镜像仓库实例 |
TotalCount | Integer | 1 | 镜像实例总数 |
Items | List<Repository> | OCI 制品仓库列表。详细信息,请参见 Repository。 | |
PageSize | Integer | 10 | 单页显示的 OCI 制品仓库信息条数。 |
PageNumber | Integer | 1 | 当前页码。 |
{ "ResponseMetadata": { "RequestId": "540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx", "Action": "ListRepositories", "Version": "2022-05-12", "Service": "cr", "Region": "cn-beijing", }, "Result": { "TotalCount": 1, "Registry": "registrya", "PageSize": 10, "PageNumber": 1, "Items": [ { "Namespace": "library", "Name": "repositorya", "AccessLevel": "Private", "CreateTime": "2020-05-20T13:00:55Z", "UpdateTime": "2020-05-20T13:00:55Z" } ] } }
本接口错误码如下表所示,公共错误码请参见 公共错误码。
HTTP状态码 | 错误码 | 错误信息 | 处理措施 |
---|---|---|---|
400 | OperationDenied.RegistryStatus | The action has been denied due to wrong status %s. | 当前实例状态下不允许执行指定操作,请等待状态转换后重试。 |