ListPackages--制品仓库-火山引擎

文档中心

立即注册

导航

ListPackages

最近更新时间：2025.01.23 14:19:43首次发布时间：2025.01.23 14:19:43

查询制品包详情。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com/?Action=ListPackages&Version=2025-01-01

请求参数

参数名	类型	是否必选	示例值	描述
Action	String	是	ListPackages	接口名称。当前 API 的名称为`ListPackages`。
Version	String	是	2025-01-01	接口版本。当前 API 的版本为`2025-01-01`。
Registry	String	是	artifact-demo	制品仓库实例名称。可以调用 ListArtifactRegistries 接口，获取制品仓库实例名称。
Filter	Object PackageFilter	否	-	查询制品的过滤条件。
PageSize	Integer	否	10	单页展示的制品数量，整数形式：默认值为 10。取值范围为 1～100。
PageNumber	Integer	否	1	当前页数，整数形式：默认值为 1。取值范围为 1～2147483647。

请求示例

POST https://open.volcengineapi.com/?Action=ListPackages&Version=2025-01-01
Content-Type: application/json
{
    "Registry": "artifact-demo",
    "Package": "pakcage-demo",
    "Version": "version1",
    "Filter": {
    	"Names": ["tt1", "jt*tt", "*test", "li*"]
    }
}

返回参数

参数名	类型	示例	描述
TotalCount	Integer	1	查询获得的制品包数量。
Registry	String	artifact-demo	制品仓库实例名称。
Items	Array of Package	-	制品包列表。
PageSize	Integer	10	单页展示的制品数量，整数形式，默认为 10 个，取值范围为 1～100。
PageNumber	Integer	1	开始显示返回结果的页码，整数形式，从 1 开始，默认为 1。取值范围为 1～2147483647。

返回示例

HTTP/1.1: 200 OK
Content-Type: application/json
{
    "ResponseMetadata": {
        "RequestId": "20250101110420****100232280022D31",
        "Action": "ListPackages",
        "Version": "2025-01-01",
        "Service": "artifacts",
        "Region": "cn-north-1"
    },
    "Result": {
    	"TotalCount": 1,
    	"Registry": "artifact-demo",
    	"Items": [
    		{
    			"Name": "package-demo",
    			"LatestVersion": "version1",
    			"VersionCount": 1,
    			"CreateTime": "2025-01-01T00:00:00Z",
    			"UpdateTime": "2025-01-01T00:00:00Z"
    		}
    	]
    }
}