集群接口

 

DescribeAppVersions

更新时间 2023-09-06

获取一个或多个应用版本的信息。

可根据应用版本 ID,状态,应用 ID,标签等作为过滤条件,来获取应用信息。

请求参数

参数 类型 描述 是否必选
app_ids.n String 应用 ID,可以是一个或多个。app_idsversion_ids 两者必须至少有一个。 No
version_ids.n String 应用版本 ID,可以是一个或多个。app_idsversion_ids 两者必须至少有一个。 No
name String 应用的名称。 No
sort_key String 结果排序的列。 No
owner String 按照用户账户过滤,只返回指定账户的资源。 No
verbose Integer 是否返回冗长的信息。若为 1,则返回集群相关其它资源信息。 No
offset Integer 数据偏移量。默认为 0。 No
limit Integer 返回数据长度。默认为 20,最大 100。 No
reverse Integer 是否逆序。1 为逆序,0 为正序。 No

响应消息

参数 类型 描述
action String 响应动作。
total_count Integer 应用版本的总数量。
version_set Array 应用的版本集合。
ret_code Integer 执行成功与否。
  • 取值 0 表示成功,其他值则为错误代码。
  • 响应项

    参数 类型 描述
    status String 状态,activesuspended
    description String 应用版本描述。
    resource_kit String 应用的配置文件 ID。
    version_id String 应用版本的 ID。
    app_id String 应用 ID。
    create_time TimeStamp 应用版本的创建时间。
    visibility String 应用版本的可见范围,public 即为所有人可见;private为仅自己可见。
    name String 版本的名称。
    console_id String 版本的 console ID。

    示例

    请求示例

    https://api.qingcloud.com/iaas/?action=DescribeAppVersions
    &app_ids.1=app-tg3lbp0a
    &limit=20
    &COMMON_PARAMS
    

    响应示例

    {
      "action":"DescribeAppVersionsResponse",
      "total_count":1,
      "version_set":[
        {
          "status":"active",
          "description":"\u6b64\u7248\u672c\u63d0\u4f9b\u7684\u662f\u539f\u751f Apache ZooKeeper 3.4.9 \u53d1\u884c\u7248\uff0c\u540c\u65f6\u63d0\u4f9b ZooKeeper REST \u670d\u52a1",
          "resource_kit":"ca-nx8rerlv",
          "version_id":"appv-70gegwmp",
          "app_id":"app-tg3lbp0a",
          "create_time":"2017-04-21T02:34:24Z",
          "visibility":"public",
          "status_time":"2017-04-21T02:34:24Z",
          "console_id":"qingcloud",
          "name":"v1.0 - ZooKeeper 3.4.9"
        }
      ],
      "ret_code":0
    }
    
    这篇文档解决了您的问题吗?
    0
    0