You need to enable JavaScript to run this app.
导航
获取应用版本列表
最近更新时间: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。

  • 若未指定 pagelimit 参数:返回全量数据;
  • 若仅指定 page,未指定 limit:返回全量数据;
  • 若仅指定 limit,未指定 page :返回第 1 页数据;
  • 若指定 pagelimit :返回符合条件的数据。

limit

Int32

10

分页查询时设置的每页行数。

  • 若未指定 pagelimit 参数:返回全量数据;
  • 若仅指定 page,未指定 limit:返回全量数据;
  • 若仅指定 limit,未指定 page :返回第 1 页数据;
  • 若指定 pagelimit :返回符合条件的数据。

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 请求失败。关于错误码的更多信息,参见公共错误码