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

文档中心

立即注册

导航

ListAssets

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

获取制品包版本文件。

请求说明

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

请求参数

参数名	类型	是否必选	示例值	描述
Action	String	是	ListAssets	接口名称。当前 API 的名称为`ListAssets`。
Version	String	是	2025-01-01	接口版本。当前 API 的版本为`2025-01-01`。
Registry	String	是	artifact-demo	制品仓库实例名称。可以调用 ListArtifactRegistries 接口，获取制品仓库实例名称。
Package	String	是	pakcage-demo	制品包名称。
Version	String	是	version1	制品版本号。说明如果制品不存在版本，例如 Generic 类型的制品，此时需要填写为 ""。
Filter	Object AssetFilter	否	-	查询制品包文件的过滤条件。
PageSize	Integer	否	10	单页展示的制品数量，整数形式：默认值为 10。取值范围为 1～100。
PageNumber	Integer	否	1	当前页数，整数形式：默认值为 1。取值范围为 1～2147483647。

请求示例

POST https://open.volcengineapi.com/?Action=ListAssets&Version=2025-01-01
Content-Type: application/json
{
    "Registry": "artifact-demo",
    "Package": "pakcage-demo",
    "Version": "version1",
    "Filter": {
    	  "Names": ["file1", "file2"]
    }
}

返回参数

参数名	类型	示例	描述
TotalCount	Integer	1	查询获得的制品包文件数量。
Registry	String	artifacts-demo	制品仓库实例名称。
Items	Array of Asset	-	制品包版本文件列表。
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": "ListAssets",
        "Version": "2025-01-01",
        "Service": "artifacts",
        "Region": "cn-north-1"
    },
    "Result": {
        "TotalCount": 1,
        "Registry": "artifacts-demo",
        "Items": [
        	{
        		"Package": "package-demo",
        		"Version": "version1",
        		"Name": "asset-demo",
        		"DownloadUrl": "https://artifacts-cn-beijing.volces.com/repository/artifacts-demo/completion.zsh",
        		"ContentType": "application/octet-stream",
        		"Size": 1000,
        		"CheckSum": {
        			"Md5": "8bfac2b431791d62169f7f***",
        			"Sha1": "c6e99a58ee3e174e84b1d7***",
        			"Sha256": "1bcac0dc92b40f425640eb***",
        			"Sha512": "bccf524d67761fd2d69f4b8***"
        		},
        		"CreateTime": "2025-01-01T00:00:00Z",
        		"UpdateTime": "2025-01-01T00:00:00Z"
        	}
        ]
    }
}