华为云用户手册

请求示例 请求URL示例 POST https://{endpoint}/v2/cvr/applications 请求示例 创建应用，选择上海一和北京四的安装包，使用北京四区域的已有云服务器。 { "application": { "name": "test", "description": "1234", "type": "vr", "session_hold_time": 3, "policy": { "type": "black_list", "devices": [ "111111111" ] }, "package_list": [ { "bucket_name": "cvr1", "package_name": "1.zip", "bucket_region": "cn-north-4" }, { "bucket_name": "cvr2", "package_name": "2.zip", "bucket_region": "cn-east-3" } ], "existed_servers": [ { "server_id": "a4a4ae15-c7eb-40b5-9d0e-7f611404e112" }, { "server_id": "efd3ae15-c7eb-40b5-9d0e-7f611404e111" }, ] }}

响应参数 状态码为200时 表6 响应Body参数 参数 参数类型 描述 application Object 应用信息，详情请参见表7。 表7 application字段数据结构说明 参数 参数类型 描述 id String 应用ID。 应用的唯一标识，格式为UUID。 name String 应用名称。 session_hold_time Integer 会话保持时间，单位分钟（min）。 若该值为-1，表示会话一直保持。 type String 应用类型。 应用类型枚举值： vr：表示VR应用。 3d：表示3D应用。 launch_path String 应用启动路径。 create_time String 应用创建时间。 时间格式例如：2020-05-20T03:30:52Z status String 应用状态。 应用状态枚举值： active：正常 creating：创建中 create_failed：创建失败 updating：修改中 update_failed：修改失败 deleting：删除中 delete_failed：删除失败 adding：添加中（添加云服务器） add_failed：添加失败 repairing：修复中 repair_failed：修复失败 description String 应用描述。 icon_name String 应用的图标名称。 cluster_id String 集群ID 。 应用所属集群的唯一标识，格式为UUID。 policy_type String 设备连接策略规则（黑、白名单）。 black_list：表示黑名单。 white_list：表示白名单。 package_list Array of objects 应用的安装包信息列表，详情请参见表8。 表8 package字段数据结构说明 参数 参数类型 描述 bucket_name String 安装包所在OBS桶名称。 示例：cloudvr package_name String 安装包名称。 示例：cvrapp.zip package_size String 安装包大小。 示例：100MB bucket_region String OBS桶所在区域。 示例：cn-north-4 状态码为400时 表9 响应Body参数 参数 参数类型 描述 error_code String 返回的错误码，如CVR.0001。 error_msg String 错误的英文描述。

响应示例 状态码为200时 { "application": { "id": "fe8e97a0-4350-11eb-8bb9-fa1640a9b002", "name": "test", "type": "vr", "session_hold_time": 3, "launch_path": "", "create_time": "2020-12-21T05:54:31Z", "status": "active", "description": "1234", "icon_name": "image_default.png", "policy_type": "black_list", "cluster_id": "50adbf76-412a-11eb-821b-fa1640a9b002", "package_list": [ { "bucket_name": "cvr1", "package_name": "1.zip", "package_size": "324.83MB", "bucket_region": "cn-north-4" }, { "bucket_name": "cvr2", "package_name": "2.zip", "package_size": "324.83MB", "bucket_region": "cn-east-3" } ] }} 状态码为400时 { "error_code" : "string", "error_msg" : "string" }

请求参数 表2 请求参数 参数 是否必选 参数类型 描述 package_list 是 Array of objects 应用安装包，详情请参见表3。 约束： 需至少选择一个区域的安装包，请先在OBS桶中上传相关安装包，具体操作请参见VR内容上云。 安装包区域需在当前集群区域范围内，同一区域不能选择多个安装包。 launch_path 否 String 应用启动路径（相对路径）。 修改3D应用的应用安装包时，若应用启动路径发生变化，可同时修改应用启动路径。 取值范围： 长度范围1到200个字符。 只允许输入中文字符、英文大小写字母、数字、空格及“_”、“-”、“.“、“/”。 archive_data 否 Boolean 是否保留相关云服务器上该应用旧数据。 true，表示保留相关云服务器上该应用旧数据。 false，表示不保留相关云服务器上该应用旧数据。 默认值：false。 表3 package字段数据结构说明 参数 是否必选 参数类型 描述 bucket_name 是 String 安装包所在OBS桶名称。 示例：cloudvr package_name 是 String 安装包名称。 示例：cvrapp.zip bucket_region 是 String OBS桶所在区域。 示例：cn-north-4

响应示例 状态码为200时 { "application": { "id": "fe8e97a0-4350-11eb-8bb9-fa1640a9b002", "name": "test", "type": "vr", "session_hold_time": 3, "launch_path": "", "create_time": "2020-12-21T05:54:31Z", "status": "active", "description": "1234", "icon_name": "image_default.png", "policy_type": "black_list", "cluster_id": "50adbf76-412a-11eb-821b-fa1640a9b002", "package_list": [ { "bucket_name": "cvr1", "package_name": "1.zip", "package_size": "324.83MB", "bucket_region": "cn-north-4" }, { "bucket_name": "cvr2", "package_name": "2.zip", "package_size": "324.83MB", "bucket_region": "cn-east-3" } ] }} 状态码为400时 { "error_code" : "string", "error_msg" : "string" }

响应参数 状态码为200时 表4 响应Body参数 参数 参数类型 描述 application Object 应用信息，详情请参见表5。 表5 application字段数据结构说明 参数 参数类型 描述 id String 应用ID。 应用的唯一标识，格式为UUID。 name String 应用名称。 session_hold_time Integer 会话保持时间，单位分钟（min）。 若该值为-1，表示会话一直保持。 type String 应用类型。 应用类型枚举值： vr：表示VR应用。 3d：表示3D应用。 launch_path String 应用启动路径。 create_time String 应用创建时间。 时间格式例如：2020-05-20T03:30:52Z status String 应用状态。 应用状态枚举值： active：正常 creating：创建中 create_failed：创建失败 updating：修改中 update_failed：修改失败 deleting：删除中 delete_failed：删除失败 adding：添加中（添加云服务器） add_failed：添加失败 repairing：修复中 repair_failed：修复失败 description String 应用描述。 icon_name String 应用的图标名称。 cluster_id String 集群ID 。 应用所属集群的唯一标识，格式为UUID。 policy_type String 设备连接策略规则（黑、白名单）。 black_list：表示黑名单。 white_list：表示白名单。 package_list Array of objects 应用的安装包信息列表，详情请参见表6。 表6 package字段数据结构说明 参数 参数类型 描述 bucket_name String 安装包所在OBS桶名称。 示例：cloudvr package_name String 安装包名称。 示例：cvrapp.zip package_size String 安装包大小。 示例：100MB bucket_region String OBS桶所在区域。 示例：cn-north-4 状态码为400时 表7 响应Body参数 参数 参数类型 描述 error_code String 返回的错误码，如CVR.0001。 error_msg String 错误的英文描述。

响应示例 状态码为200时 OK { "count":1, "servers": [ { "id": "d7acc58a-d83f-44ac-8f57-588832d525aa", "cluster_id": "50adbf76-412a-11eb-821b-fa1640a9b0aa", "publicip": "255.255.255.255", "region_id": "cn-north-4", "volume_size": "98", "total_volume_size": "99", "link_status": "free", "link_device_id": "", "failure_reason": "", "create_time": "2021-02-02T10:20:43Z", "current_application_id": "", "installed_applications": ["4d00636c-6540-11eb-b54a-fa1640a9b0aa"], "name": "ecs-eeee", "status": "ACTIVE", "flavor_display_name": "32vCPUs | 64GB | g5r.8xlarge.2", "availability_zone_id": "cn-north-4a", "image_name": "Windows-Server-2016-64bit", "charging_mode": 0, "privateip": "192.168.0.0", "bandwidth_size": 50, "applications": ["4d00636c-6540-11eb-b54a-fa1640a9b0aa"], "session_number": 2} ]} 状态码为400时 { "error_code" : "string", "error_msg" : "string" }

请求参数 表1 查询参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页显示的条目数量。 默认为1000，最大值为1000。 offset 否 Integer 偏移量，表示从此偏移量开始查询。 默认为0，最大值为1000。 link_status 否 String 当前设备与云服务器的连接状态。 连接状态枚举值： free： 闲置 lost：失联 error：异常 use： 正常 init：初始化 publicip 否 String 云服务器绑定的公网IP地址，只支持精确匹配。 用于设备与云服务器进行网络数据传输。 name 否 String 根据云服务器名称进行模糊搜索。 privateip 否 String 云服务器绑定的私有IP地址，只支持精确搜索。 application_id 否 String 根据应用ID进行精确搜索。 可查看该应用下的云服务器列表（包括已安装该应用及安装未完成的）。 status 否 String 云服务器的当前状态。 状态枚举值： ACTIVE： 实例正常运行状态。 SHUTOFF：实例被正常停止。 BUILD：创建实例后，在实例状态进入运行中之前的状态。 ERROR： 实例处于异常状态。 region_id 否 String 云服务器所在的区域。 区域枚举值（当前仅支持以下三个区域）： cn-north-4：华北-北京四 cn-east-3：华东-上海一 cn-south-1：华南-广州

响应参数 状态码为200时 表2 响应Body参数 参数 参数类型 描述 count Integer 云服务器数量。 servers Array of objects 云服务器信息列表，详情请参见表3。 表3 server字段数据结构说明 参数 参数类型 描述 availability_zone_id String 云服务器所在可用区。 bandwidth_size Integer 云服务器所绑定带宽的大小。 单位：Mbit/s charging_mode Integer 云服务器的计费模式。 0：表示按需计费。 1：表示包周期计费。 create_time String 云服务器的创建时间。 时间格式例如：2020-05-20T03:30:52Z current_application_id String 云服务器上正在运行应用ID。 failure_reason String 云服务器的故障信息。 privateip String 云服务器所绑定的私有IP。 flavor_display_name String 云服务器的规格显示名称。 格式如下： xvCPUs | yGB | flavor_id x为CPU个数，y为内存大小，flavor_id为规格名。 image_name String 云服务器所安装的镜像名称。 installed_applications Array of strings 已安装的应用ID列表。 link_device_id String 正在连接的设备ID，与云服务器连接设备的唯一标识。 link_status String 设备与云服务器的连接状态。 cluster_id String 集群ID。 name String 云服务器名称。 id String 云服务器ID。 publicip String 云服务器绑定的公网IP。 region_id String 云服务器所在的区域。 status String 云服务器的状态。 total_volume_size Sring 云服务器上安装的云硬盘总量。 单位：GB volume_size String 云服务器上安装的云硬盘剩余量。 单位：GB applications Array of strings 该台云服务器上的所有应用ID列表，包括安装完成的及还未安装完成的应用。 session_number Integer 云服务器的会话路数。 状态码为400时 表4 响应Body参数 参数 参数类型 描述 error_code String 返回的错误码，如CVR.0001。 error_msg String 错误的英文描述。

响应参数 状态码为200时 表2 响应参数 参数 参数类型 描述 count Integer 符合条件的所有渲染任务的数量。 render_tasks Array of objects 渲染任务信息列表，详情请参见表3。 表3 render_task字段数据结构说明 参数 参数类型 描述 task_id String 任务ID。 连接任务的唯一标识，格式为UUID。 application_id String 应用ID。 应用的唯一标识，格式为UUID。 server_id String 云服务器ID。 云服务器的唯一标识，格式为UUID。 session_id String 会话ID，提供音视频流的会话ID。 普通型云服务器该ID为空。 会话型云服务器该ID为会话编号。 device_id String 设备ID，设备的唯一标识。 device_brand String 设备品牌。 device_type String 设备类型。 application_user String 应用使用用户标识。 application_launch_args String 应用启动参数。 protocol_type String 设备与云服务器进行通信时所使用的协议类型。 location Array of strings 区域列表或边缘小站列表。 resolution String GPU云服务器 传给设备的画面分辨率。 gpu_ip_type String 分配给设备使用的GPU云服务器的IP类型。 status String 任务状态。 status的取值范围如下： active：运行中的任务。 finish：已经结束运行的任务。 start_time String 任务开始时间。 时间格式例如：2020-05-20T03:30:52Z finish_time String 任务结束时间。 时间格式例如：2020-05-20T03:30:52Z finish_reason String 任务结束原因。 finish_reason的取值范围如下： cancel：主动停止任务。 normal：任务正常结束。 error：出现故障，任务结束。 server_deleted：云服务器删除，任务结束。 application_start_failed：启动应用失败，任务结束。 device_changed：修改设备，任务结束。 状态码为400时 表4 响应参数 参数 参数类型 描述 error_code String 返回的错误码，如CVR.0001。 error_msg String 错误的英文描述。

响应示例 状态码为200时 { "count": 1, "render_tasks": [ { "task_id": "5a229588-7bea-11eb-bb6d-84a93e805fe6", "application_id": "63b79e6e-7be9-11eb-8817-84a93e805fe6", "server_id": "63231434-7bea-11eb-9409-84a93e805fe6", "session_id": "1", "device_id": "0FBCA6", "status": "active", "start_time": "2021-03-02T12:55:13Z", "finish_time": "", "finish_reason": "" } ]} 状态码为400时 { "error_code" : "string", "error_msg" : "string" }

请求参数 表1 查询参数 参数 是否必选 参数类型 描述 status 否 String 任务状态。 status的取值范围如下： active：运行中的任务。 finish：已经结束运行的任务。 initial：正在初始化的任务。 clean：正在转储中的任务。 application_id 否 String 根据应用ID进行精确搜索。 获取指定应用ID下的渲染任务列表。 server_id 否 String 根据云服务器ID进行精确搜索。 获取指定云服务器上的渲染任务。 device_id 否 String 根据设备ID进行精确搜索。 获取指定设备的渲染任务列表。 limit 否 Integer 每页显示的条目数量。 默认为1000，最大值为1000。 offset 否 Integer 偏移量，表示从此偏移量开始查询。 默认为0，最大值为1000。

API概览 通过使用VR云渲游所提供的接口，您可以完整地使用VR云渲游的所有功能。 VR云渲游终端节点提供的具体API如表1所示。 表1 接口说明 子类型 说明 渲染节点调度 一般由设备调用，用于获取可以连接的GPU云服务器的IP地址等信息。 停止渲染任务 当用户头显处于连接中状态（运行VR或者3D应用）时，调用此接口，会使当前连接断连，即渲染任务停止。 获取渲染任务列表 获取渲染任务列表。 仅支持查询90天内的渲染任务信息。 获取应用列表 获取应用列表，可查看应用基本信息，如应用安装包。 其中，应用的安装包信息受限于集群所选择的区域，因此不会返回当前集群所在区域以外其他区域的安装包信息。 创建应用 创建一个应用，应用会自动安装到选择的云服务器上。 创建应用时，应用安装包区域需在当前集群区域范围内，若为VR应用或非预装的3D应用，需至少选择一个区域的安装包，选择了安装包的区域才能配置该区域的云服务器。预装的3D应用配置云服务器时无安装包区域限制。 一个用户最多创建500个应用。 修改应用安装包 修改指定应用的安装包。修改完成后，该应用安装包区域下的相关云服务器将重新下载安装包进行安装。 已预装的3D应用不支持调用该API修改安装包。 删除应用 删除应用。执行删除操作后，将从云服务器中卸载该应用。 获取指定云服务器上的应用列表 获取指定云服务器上的应用列表，包括需要安装和已经安装的应用。 获取云服务器列表 获取云服务器列表。

错误码 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 CVR.0001 Format of the request body is error. 消息体格式错误 请确认消息体格式是否为json格式 400 CVR.0002 The page limit is error. It can only be [1-1000]. limit格式错误，取值范围为[1-1000] 请确认limit参数在1-1000范围内 400 CVR.0003 The page offset is error. It can only be [0-1000]. offset错误，取值范围为[0-1000] 请确认offset参数在1-1000范围内 400 CVR.0004 Application name is error. It cannot be empty, and can only contain chinese and [a-zA-Z0-9._-]. 应用名称格式错误，不能为空，且只允许输入中文，英文大小写，数字和._- 请更换应用名称 400 CVR.0005 Device ID is error. It can only contain [a-zA-Z0-9_-]. 设备ID格式错误，只允许输入大小写英文，数字和_- 请更换设备ID 400 CVR.0009 Project ID is error. It can only contain [a-f0-9-]. 项目ID格式错误，只允许输入小写英文a-f，数字和- 请确认传入的项目ID是否正确 400 CVR.0010 Application ID is error. It can only contain [a-f0-9-]. 应用ID格式错误，只允许输入小写英文a-f，数字和- 请确认传入的应用ID是否正确 400 CVR.0012 The resource id(cluster id, application id or server id) is not found. 指定资源ID错误，未找到（集群ID，应用ID，云服务器ID） 请确认传入的资源ID是否正确 400 CVR.0013 The application has no idle servers with plugins installed. 指定应用下没有插件已安装完成的闲置云服务器 当前无可用云服务器，请稍后再试 400 CVR.0014 It reaches the connection limit of the master, please upgrade master type or try after a moment. 当前集群连接数已到上限，请稍后再连或者升级集群规格 请稍后再试或者升级集群规格 400 CVR.0016 This device is forbidden in this application. 指定应用的连接策略禁止您的设备连接 请修改应用的连接策略 400 CVR.0024 Task ID is error. It can only contain [a-f0-9-]. 任务ID格式错误，只允许输入小写英文a-f，数字和- 请确认传入的任务ID是否正确 400 CVR.0025 Task ID is error, specified task is not found. 任务ID错误，未找到指定任务 请确认传入的任务ID是否正确 400 CVR.0030 Device brand is error. It can only contain [a-zA-Z0-9 _-]. 设备品牌格式错误，只允许输入英文大小写，数字和空格_- 请确认设备品牌是否正确 400 CVR.0034 Server ID is error. It can only contain [a-f0-9-]. 云服务器ID格式错误，只允许输入小写英文a-f，数字和- 请确认传入的云服务器ID是否正确 403 CVR.0036 Forbidden, project_id is error 鉴权失败，项目ID错误 请确认传入的项目ID是否是API调用区域的 403 CVR.0037 Token is expired. Token过期 请重新 获取Token 403 CVR.0039 Token role is forbidden to perform this action. Token权限不足 请授予Tenant Administrator、Tenant Guest和 IAM ReadOnlyAccess权限后再重新获取Token 500 CVR.0041 Generate linked token failed 连接Token生成失败 内部错误，请稍后重试或联系技术支持 400 CVR.0055 Policy is not formatted correctly. 策略规则格式错误 请确认传入的policy参数是否正确 400 CVR.0056 The policy type of application is error. It can only be white_list or black_list. 策略类型格式错误，只允许输入[white_list,black_list] 请确认传入的policy type是否正确 400 CVR.0058 Only task status in ['initial', 'active', 'error'] can be stopped. 只能停止[initial, active, error]状态的任务 请确认任务状态是否正确 500 CVR.0060 System error, please try again later or contact customer service. 系统错误，请稍后重试或联系客服 请稍后重试或联系技术支持 400 CVR.0091 Application name already exists. 应用名称已存在 请更换应用名称 400 CVR.0093 Server name is error. It can only contain chinese and [a-zA-Z0-9._-]. 云服务器名称格式错误，只允许输入中文，英文大小写，数字和._- 请确认传入的云服务器名称是否正确 400 CVR.0094 IP address is error. IP地址输入错误 请确认传入的IP地址是否是正确格式 400 CVR.0095 Server status must in ['ACTIVE', 'SHUTOFF', 'BUILD', 'ERROR']. 云服务器状态必须是['ACTIVE', 'SHUTOFF', 'BUILD', 'ERROR']之一 请确认传入的云服务器状态是否正确 400 CVR.0100 The format of description is wrong. 描述信息的格式有误 请确认传入的description参数是否正确 400 CVR.0102 The number of applications exceeds the limit. 应用创建数量已超出上限 请联系技术支持 400 CVR.0107 Must select at least one installation package, the regions of packages must in the regions of current cluster, and packages must be formatted correctly. 需至少选择一个安装包，安装包区域需为当前集群区域内，且安装包格式正确 请确认传入的应用安装包信息是否正确 400 CVR.0109 Must select at least one server. 至少要选择一台云服务器 请确认传入参数中已有云服务器字段是否为空 400 CVR.0113 archive_data must in [true, false]. archive_data必须是[true, false]之一 请确认传入的archive_data参数是否正确 400 CVR.0117 link_status must in ['free', 'error', 'use', 'lost', 'init']. link_status必须是['free', 'error', 'use', 'lost', 'init']之一 请确认传入的link_status参数是否正确 400 CVR.0152 Cannot perform the action,the status of application is abnormal. 应用状态异常，不能进行相关应用操作 当前应用处于修改中等中间状态或异常状态，请等待应用状态恢复正常后再进行相关操作或联系技术支持 400 CVR.0160 Application status is wrong，please use the right status to search your applications. 应用状态参数错误，请使用正确的应用状态进行应用搜索 请确认传入的应用状态是否正确 400 CVR.0193 IES id is wrong. 边缘小站ID参数错误 请确认传入的ID是否正确 400 CVR.0194 No idle servers exists under the specified application or the policy configuration of current device. 当前设备的策略配置下或指定应用下无闲置云服务器 请待有闲置云服务器时再重新尝试 400 CVR.0195 Location is not formatted correctly. 调度区域传参错误 请确认传入的调度区域是否正确 400 CVR.0196 No idle servers exists under regions or available zones of location. 指定location中区域或边缘小站下无闲置云服务器 修改location中指定的区域或边缘小站，或购买新的云服务器 400 CVR.0207 Task status is error. It can only be [initial, active, clean, error, finish]. 任务状态错误，只能是initial, active, clean, error, finish 请确认传入的任务状态是否正确 400 CVR.0223 Servers cannot be configured in a region where the installation package is not selected. 未选择安装包的区域不能配置云服务器 请确认云服务器所在区域已经选择安装包 400 CVR.0225 The current user has no cluster, or the cluster status is not running. 当前用户下无集群，或集群状态不为运行中。 请确认当前用户已经创建集群，且集群处于运行中 400 CVR.0226 The content of existed_servers is not formatted correctly. 使用已有云服务器信息格式错误 请确认云服务器信息是否json格式 400 CVE.0227 Cannot delete application, the application has uncompleted Yearly/Monthly order. 该应用有未完成的包周期订单，暂不支持删除应用 若包周期订单待支付，请取消订单后再执行删除应用操作；若包周期订单处理中，请等待订单处理完成后，再执行删除应用操作 400 CVR.0228 The installation package does not exist. 安装包不存在 请确认安装包参数是否为空 400 CVR.0229 Only one application can be installed on a VR server which has multiple sessions. 多路VR应用服务器只允许安装一个VR应用 请选择单路会话的云服务器进行应用安装 400 CVR.0230 The server with type being switched or switched failed does not support the current operation. 正在切换类型或切换类型失败的云服务器不支持当前操作 请等待类型切换结束，或者选择类型正常的云服务器进行相关操作 400 CVR.0233 The type of application is error. It can only be ['vr', '3d']. 应用类型错误，必须是['vr', '3d']之一 请确认传入的应用类型是否正确 400 CVR.0234 Application launch path must be provided for 3D applications. 3D应用必须提供应用启动路径 若需创建3D应用，请输入应用启动路径 400 CVR.0235 Application launch path is not formatted correctly. 应用启动路径格式错误 请确认传入的应用启动路径格式是否正确 400 CVR.0236 Application launch path must be updated with value. 修改应用启动路径，必须设置路径值（不能为空）。 请输入有效的应用启动路径 400 CVR.0258 Device type is error. It can only be [vr] for VR applications, [pc,mobile,ideahub] for 3D applications. 设备类型错误，VR应用只允许输入[vr]，3D应用只允许输入[pc,mobile,ideahub] 请确认传入的设备类型是否正确 400 CVR.0259 Protocol type is error. It can only be [udp,webrtc,websocket]. 协议类型错误，仅支持[udp,webrtc,websocket] 请确认传入的协议类型是否正确 400 CVR.0260 Application user is error. It can only contain [a-zA-Z0-9_]. 应用使用用户格式错误，只允许输入英文大小写，数字和._- 请确认传入的应用使用用户格式是否正确 400 CVR.0261 The current user or the current device has a render task running under the specified application, and the connected server does not have a public IP. Please stop the task and then reconnect. Task id is %(task_id)s. 当前用户或当前设备在指定应用下存在一个渲染任务，请先停止这个任务后重新连接，任务ID为(task_id) 请调用停止渲染任务API停止原有的渲染任务 400 CVR.0262 The current user or the current device has a render task being dumped under the specified application. Please reconnect after the dump is complete. 当前用户或当前设备在指定应用下存在一个转储中的渲染任务，请等待转储完成后重新连接 请等待转储完成后重新连接 400 CVR.0263 The current user or the current device has a render task running under the specified application. Please stop the task and then reconnect. Task id is %s. 当前用户或当前设备在指定应用下存在一个渲染任务，请先停止这个任务后重新连接，任务ID为(task_id) 请停止渲染任务后重新连接 400 CVR.0264 Start application failed. Please reconnect. 启动应用失败，请重新连接 请根据失败原因查看解决方案，解决问题后重新连接 400 CVR.0266 The current user or the current device has a render task running under the specified application in region %s. Task id is %s. 当前用户或当前设备在指定应用下存在一个其它区域的渲染任务，区域为(region)，任务ID为(task_id)。 请停止其它区域的渲染任务后重新连接 400 CVR.0282 Application launch args is not formatted correctly. 应用启动参数格式错误 请确认传入的应用启动参数格式是否正确 400 CVR.0284 Session hold time is not formatted correctly.It can only be an integer in the range of [-1, 1-30]. 会话保持时间格式错误，只允许输入整数,取值范围为[-1,1-30] 请确认传入的会话保持时间格式是否正确 400 CVR.0291 The number of sessions can be changed only when the link status of server is free. 只有连接状态为闲置的云服务器才允许变更会话路数 请确认云服务器的连接状态是否为闲置。 400 CVR.0296 Cannot update the packages of 3D applications which have be preinstalled in the image. 原镜像预装的3d应用暂不支持修改安装包 若需使用非预装的应用，请重新创建应用选择安装包进行安装 400 CVR.0387 Resolution is error. It can only be [480p, 540p, 720p, 1080p, 2k, 4k]. 分辨率错误，取值只能是[480p, 540p, 720p, 1080p, 2k, 4k]。 请确认传入的分辨率参数是否正确 400 CVR.0388 GPU IP type is error. It can only be [public, private]. 云服务器IP类型错误，取值只能是[public, private] 请确认传入的云服务器IP类型参数是否正确 400 CVR.0392 Cannot perform the action, the current server is creating images. 当前云服务器正在创建镜像，不能进行相关操作 请等待镜像创建完成后重试 400 CVR.0408 The number of sessions can be changed only for VR servers with [2,4,8] sessions. 只有会话路数为[2,4,8]的VR应用云服务器，才能修改会话路数 请确认VR应用云服务器当前的会话路数是否为[2,4,8] 400 CVR.0409 The number of sessions can only be [2,4,8] for VR servers. VR应用云服务器的会话路数只允许为[2,4,8] 请确认VR应用云服务器设置的会话路数是否为[2,4,8] 400 CVR.0410 The number of sessions is error. 3D应用云服务器的会话路数错误 请确认3D应用云服务器设置的会话路数是否为[1,2] 父主题： 附录

状态码 正常 返回值 类型 说明 200 OK GET、PUT、POST操作正常返回 204 No Content DELETE操作正常返回 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403 Forbidden 对被请求页面的访问被禁止。 404 Not Found 服务器无法找到被请求的页面。 500 Internal Server Error 请求未完成。服务异常。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway Timeout 网关超时。 父主题： 附录

身份认证与访问控制 统一身份认证 （Identity and Access Management，简称IAM）是华为云提供权限管理的基础服务，可以帮助用户安全地控制云服务和资源的访问权限。 企业路由器支持通过IAM权限策略进行访问控制。IAM权限是作用于云资源的，IAM权限定义了允许和拒绝的访问操作，以此实现云资源权限访问控制。 管理员创建IAM用户后，需要将用户加入到一个用户组中，IAM可以对这个组授予ER所需的权限，组内用户自动继承用户组的所有权限。 IAM的详细介绍，请参见IAM功能介绍。 ER所需的权限，请参见权限管理。 父主题： 安全

响应参数 状态码为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 错误的英文描述。

响应示例 状态码为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" }

如何选择区域？ 选择区域时，您需要考虑以下几个因素： 地理位置 一般情况下，建议就近选择靠近您或者您的目标用户的区域，这样可以减少网络时延，提高访问速度。 在除中国大陆以外的亚太地区有业务的用户，可以选择“中国-香港”、“亚太-曼谷”或“亚太-新加坡”区域。 在非洲地区有业务的用户，可以选择“非洲-约翰内斯堡”区域。 在拉丁美洲地区有业务的用户，可以选择“拉美-圣地亚哥”区域。 “拉美-圣地亚哥”区域位于智利。 资源的价格 不同区域的资源价格可能有差异，请参见华为云服务价格详情。

管理简单 企业路由器可以在接入的所有网络实例之间路由流量，可以简化网络拓扑，降低网络管理难度，提升网络运维效率。可以减少的工作说明如下： 对于VPC互通，不再需要您频繁创建多个VPC对等连接，维护每个VPC路由表。 对于VPC和DC/VPN互通，不用接入多条线路，多个VPC可以共享专线/VPN。 企业路由器支持路由学习，能够自动进行路由信息的更新和同步，当网络拓扑变更时，能够自动收敛，无需手工配置、变更繁琐的路由条目。

什么是区域、可用区？ 区域和可用区用来描述数据中心的位置，您可以在特定的区域、可用区创建资源。 区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。

责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的 云安全 挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。 华为云：负责云服务自身的安全，提供安全的云。华为云的安全责任在于保障其所提供的IaaS、PaaS和SaaS类云服务自身的安全，涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身，也包括运维运营安全，以及更广义的安全合规遵从。 租户：负责云服务内部的安全，安全地使用云。华为云租户的安全责任在于对使用的IaaS、PaaS和SaaS类云服务内部的安全以及对租户定制配置进行安全有效的管理，包括但不限于虚拟网络、 虚拟主机 和访客虚拟机的操作系统，虚拟防火墙、API网关和高级安全服务，各项云服务，租户数据，以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措施，包括云安全战略、责任共担模型、合规与隐私、安全组织与人员、基础设施安全、租户服务与租户安全、工程安全、运维运营安全、生态安全。 图1 华为云安全责任共担模型 父主题： 安全

ER权限 默认情况下，管理员创建的IAM用户没有任何权限，需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 ER部署时通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域（如华北-北京1）对应的项目（cn-north-1）中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问ER时，需要先切换至授权区域。 权限根据授权精细程度分为角色和策略。 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于华为云各服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。 策略：IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式，能够满足企业对权限最小化的安全管控要求。例如：针对ER服务，管理员能够控制IAM用户仅能对企业路由器进行指定的管理操作。多数细粒度策略以API接口为粒度进行权限拆分，权限的最小粒度为API授权项（action），ER支持的API授权项请参见权限及授权项说明。 如表1所示，包括了ER的所有系统权限。 表1 ER系统权限 系统角色/策略名称 描述 类别 依赖关系 ER FullAccess 企业路由器的管理员权限，拥有该权限的用户可以操作并使用所有企业路由器。 系统策略 无 ER ReadOnlyAccess 企业路由器只读权限，拥有该权限的用户仅能查看企业路由器数据。 系统策略 无 表2列出了ER常用操作与系统权限的授权关系，您可以参照该表选择合适的系统权限。 表2 常用操作与系统权限的关系 操作 Tenant Administrator Tenant Guest ER FullAccess ER ReadOnlyAccess 创建企业路由器 √ x √ x 修改企业路由器配置 √ x √ x 查看企业路由器 √ √ √ √ 删除企业路由器 √ x √ x 在企业路由器中添加“虚拟私有云（VPC）”连接 √ x √ x 删除“虚拟私有云（VPC）”连接 √ x √ x 查看连接（所有类型） √ √ √ √ 创建路由表 √ x √ x 修改路由表名称 √ x √ x 查看路由表 √ √ √ √ 删除路由表 √ x √ x 创建关联将连接关联至路由表中 √ x √ x 查看路由表中关联的连接 √ √ √ √ 删除路由表中关联的连接 √ x √ x 在路由表中创建连接的传播 √ x √ x 查看路由表中连接的传播 √ √ √ √ 删除路由表中连接的传播 √ x √ x 创建静态路由 √ x √ x 修改静态路由 √ x √ x 查看路由 √ √ √ √ 删除静态路由 √ x √ x 创建流日志 √ x √ x 查看流日志 √ √ √ √ 关闭流日志 √ x √ x 开启流日志 √ x √ x 删除流日志 √ x √ x 添加资源的标签 √ x √ x 修改资源的标签 √ x √ x 查看资源的标签 √ √ √ √ 删除资源的标签 √ x √ x

审计与日志 云审计 服务（Cloud Trace Service， CTS ），是华为云安全解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。 用户开通云审计服务后，CTS可记录企业路由器的操作事件用于审计。 CTS的详细介绍和开通配置方法，请参见CTS快速入门。 企业路由器支持审计的操作事件请参见支持审计的关键动作。 查看企业路由器的审计日志，请参见查看审计日志。 父主题： 安全

修订记录 发布日期 修订说明 2019-12-11 第二十四次正式发布： 增加dis-kafka-adapter，增加使用Kafka Adapter上传与下载数据。 2019-10-08 第二十三次正式发布： 优化Java和Python SDK。 2019-07-08 第二十次正式发布： 小文件功能下线，删除“创建源数据类型是FILE的通道”。 2019-07-03 第十九次正式发布： Java SDK不兼容原生Kafka客户端，删除“连接Kafka consumer”。 2019-05-14 第十八次正式发布： 支持使用SDK实现数据的加密上传下载，修改初始化DIS客户端。 2019-05-07 第十七次正式发布： 查询通道列表SDK增加分页功能说明，修改查询通道列表。 2019-04-16 第十六次正式发布： 查询通道列表SDK增加响应参数说明，修改查询通道列表。 2019-03-18 第十五次正式发布： 新增如下内容： 添加转储任务~~查询转储详情 初始化DIS客户端 2019-02-23 第十四次正式发布： 修改如下内容： 获取认证信息 2019-01-17 第十三次正式发布： 内容优化。 2019-01-07 第十二次正式发布： 修改如下内容： 下载流式数据 2018-11-28 第十一次正式发布： 修改如下内容： 初始化DIS客户端 创建通道 下载流式数据 2018-11-07 第十次正式发布。 修改如下内容： 如何校验软件包完整性？ 2018-09-25 第九次正式发布。 新增如下内容： 准备环境~~获取数据游标 2018-08-19 第八次正式发布。 修改如下内容： 配置样例工程 2018-07-23 第七次正式发布。 修改文档结构和名称。 2018-07-10 第六次正式发布。 新增了如下内容： 创建APP 删除APP 查询Checkpoint 变更分区数量 2018-06-12 第五次正式发布。 修改了如下内容： 开通DIS服务 DIS服务端错误码 2018-05-11 第四次正式发布。 修改了如下内容： 开通DIS通道 DIS服务端错误码 Uquery更名为 数据湖探索 （ DLI ，Data Lake Insight）。 2018-02-08 第三次正式发布。 新增了如下内容： 创建通道 删除通道 查询通道列表 查询通道详情 获取数据游标 修改了如下内容： 上传流式数据 下载流式数据 2017-11-18 第二次正式发布。 修改了如下内容： 开通DIS通道 2017-10-28 第一次正式发布。

查询转储列表 参见初始化DIS客户端的操作初始化一个DIS客户端实例。 配置参数如下： 1 streamname="XXX" #已存在的通道名 执行list_dump_task_sample.py文件默认调用list_dump_task_test方法，获取响应200查询成功。 响应示例如下： 12 200{'total_number': 1, 'tasks': [{'last_transfer_timestamp': 1538018769241, 'state': 'RUNNING', 'create_time': 1537949648144, 'destination_type': 'OBS', 'task_name': 'task_test1'}]} 父主题： 使用SDK（Python）

Json格式上传流式数据 参见初始化DIS客户端的操作初始化一个DIS客户端实例。 配置参数如下： 1 streamname="dis-test1"| #已存在的通道名 putRecords_sample.py文件中的putRecords_test方法中的records为需要上传的数据内容，数据上传格式如下： 1234 records=[{"data": "abcdefd", "partition_id": “shardId-0000000001”}]#"data"："xxx"为上传的数据值，请自定义；“partition_id”:“shardId-0000000001”为数据写入的分区id值，请自定义。 record1 = {"data": "xxx","partition_id": partition_id} #可写入多条数据，数据格式如record1所示，每写一条数据使用下面的append方法传入records中。 配置好以上参数后，执行putRecords_sample.py文件调用putRecords_test方法，响应结果如下： 12 200{'failed_record_count': 0, 'records': [{'partition_id': 'shardId-0000000001', 'sequence_number': '15'}]} 父主题： 使用SDK（Python）

创建通道 参见初始化DIS客户端的操作初始化一个DIS客户端实例。 根据stream_type选取方法，参照创建通道配置方法中的参数值。 stream_type=“” #无转储通道 配置createstream_sample.py中Dump_switch方法参数值。 stream_type=“FILE” #文件类型通道 配置createstream_sample.py中Dump_switch_FILE方法参数值。 配置好参数后，执行createstream_sample.py文件默认调用createStream_test方法，获取响应201创建成功。 父主题： 使用SDK（Python）

初始化DIS客户端 您可以使用以下方法初始化DIS SDK客户端实例。其中，“endpoint”，“ak”，“sk”，“region”，“projectId”信息请参考获取认证信息。 cli = disclient(endpoint='**your-endpoint**', // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； // 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 ak=os.environ.get("HUAWEICLOUD_SDK_AK"), sk=os.environ.get("HUAWEICLOUD_SDK_SK"), projectid='**your-projectid**', region='**your-region**') 父主题： 使用SDK（Python）

更新转储任务 参考初始化DIS客户端的操作初始化一个DIS客户端实例，实例名称为dic。 使用DIS SDK更新转储任务，需要指定通道名称、转储任务名称，转储周期，转储目标服务等信息。 1 2 3 4 5 6 7 8 9101112131415161718192021 //需配置转储任务的全量参数，不支持更新单个参数UpdateTransferTaskRequest request = new UpdateTransferTaskRequest();// 配置待更新的转储任务所属通道的名称request.setStreamName(streamName);// 配置待更新的转储任务名称OBSDestinationDescriptorRequest descriptor = new OBSDestinationDescriptorRequest();descriptor.setTransferTaskName(taskName);// 转储至 对象存储服务 (简称OBS)：OBS桶名和子文件夹名，通过OBS控制台或客户端创建桶和文件夹descriptor.setObsBucketPath("obs-dis1");descriptor.setFilePrefix("transfertask");// 转储周期，单位sdescriptor.setDeliverTimeInterval(300);// 可选，转储OBS的目标文件格式：默认text，可配置parquet、carbondescriptor.setDestinationFileType(DestinationFileTypeEnum.TEXT.getType());request.setObsDestinationDescriptor(descriptor); 配置“UpdateTransferTaskRequest”对象之后，通过调用updateTransferTask的方法更新转储任务。 1 dic.updateTransferTask(request); 父主题： 使用SDK（Java）