获取应用版本列表--边缘计算节点-火山引擎

文档中心

立即注册

导航

边缘计算节点

获取应用版本列表

最近更新时间：2024.06.25 16:32:14首次发布时间：2023.02.22 17:09:42

本接口用于获取应用版本列表。

请求说明

请求方式：GET
请求地址：https://veecc.volcengineapi.com/?Action=ListAppVersions&Version=2022-10-01

请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	ListAppVersions	要执行的操作。取值：ListAppVersions。
app_id	String	是	veecc-4000252292242221****	边缘应用 ID。
status	String	否	Initialize	版本状态，取值范围为： Initialize：未部署 InUse: 使用中多个值时，用英文逗号分隔。例如：status=Initialize,InUse。
page	Int32	否	1	列表的页码，最小为 1。若未指定 page 和 limit 参数：返回全量数据；若仅指定 page，未指定 limit：返回全量数据；若仅指定 limit，未指定 page ：返回第 1 页数据；若指定 page 和 limit ：返回符合条件的数据。
limit	Int32	否	10	分页查询时设置的每页行数。若未指定 page 和 limit 参数：返回全量数据；若仅指定 page，未指定 limit：返回全量数据；若仅指定 limit，未指定 page ：返回第 1 页数据；若指定 page 和 limit ：返回符合条件的数据。
order_by	Int32	是	1	查询出来的版本的按创建时间的排列顺序。取值范围： 1：按照降序排列。 2：按照升序排列。

返回参数

参数	类型	示例值	描述
versions	AppVersionResp	请参见返回示例	应用版本列表。
total_count	Int64	100	应用版本总数。

请求示例

GET https://veecc.volcengineapi.com/?Action=ListAppVersions
&app_id=veecc-3728752022535555****
&page=1
&limit=10
&order_by=1
&<公共请求参数>

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2021102215554401022511001102AB****",
    "Action": "ListAppVersions",
    "Version": "2022-10-01",
    "Service": "veecc",
    "Region": "cn-north-1"
  },
  "Result": {
    "total_count": 2,
    "versions": [
      {
        "application_identity": "veecc-0171040411402432****",
        "version": "1.0.1",
        "status": "Initialize",
        "remark": "",
        "create_time": 1672898890,
        "action": {
          "can_delete": true,
          "can_gray": true,
          "can_deploy": true
        }
      },
      {
        "application_identity": "veecc-0171040411402432****",
        "version": "1.0.0",
        "status": "InUse",
        "remark": "",
        "create_time": 1672813059,
        "action": {
          "can_delete": false,
          "can_gray": false,
          "can_deploy": true
        }
      }
    ]
  }
}

错误码

如果响应正文中包含 Error 字段，则表示 API 请求失败。关于错误码的更多信息，参见公共错误码。