文档首页/ VR云渲游平台 CVR/ API参考/ API/ 云服务器管理/ 获取指定云服务器上的应用列表
更新时间:2021-11-25 GMT+08:00
分享

获取指定云服务器上的应用列表

功能介绍

获取指定云服务器上的应用列表,包括需要安装和已经安装的应用。

URI

GET /v2/cvr/servers/{server_id}/applications

该接口需要使用global终端节点调用。

表1 路径参数

参数

是否必选

参数类型

描述

server_id

String

云服务器ID。

请求参数

不涉及

响应参数

  • 状态码为200时
    表2 响应Body参数

    参数

    参数类型

    描述

    applications

    Array of objects

    应用列表信息,详情请参见表3

    表3 application字段数据结构说明

    参数

    参数类型

    描述

    id

    String

    应用ID。

    应用的唯一标识,格式为UUID。

    name

    String

    应用名称。

    status

    String

    云服务器上应用的安装状态。

    安装状态枚举值:

    • waitinstall:等待安装
    • installing:安装中
    • failure:安装失败
    • launch:运行中
    • unlaunch:未运行

    create_time

    String

    应用创建时间。

    时间格式例如:2020-05-20T03:30:52Z

    package_size

    String

    在云服务器上应用的安装包大小。

    install_progress

    String

    在云服务器上应用的安装任务进度。

    如:0.86

    说明:总进度为1。

  • 状态码为400时
    表4 响应Body参数

    参数

    参数类型

    描述

    error_code

    String

    返回的错误码,如CVR.0001。

    error_msg

    String

    错误的英文描述。

请求示例

  • 请求示例
    获取id为d7acc58a-d83f-44ac-8f57-588832d525aa的云服务器上的应用列表。
    GET https://{endpoint}/v2/cvr/servers/d7acc58a-d83f-44ac-8f57-588832d525aa/applications

响应示例

  • 状态码为200时
    OK
    { 
        "applications":[
            {
                "id": "4d00636c-6540-11eb-b54a-fa1640a9b002",
                "name": "testcxcx",
                "status": "unlaunch", 
                "create_time": "2021-02-02T10:20:42Z", 
                "package_size": "99.27MB", 
                "install_progress": "0.56" 
            }
    }
  • 状态码为400时
    { 
      "error_code" : "string", 
      "error_msg" : "string" 
    }

状态码

请参见状态码

错误码

请参见错误码

相关文档