华为云用户手册

响应示例 状态码： 200 OK { "image_infos" : [ { "domain_id" : "4a2a9967e4514c388a4c945efcbab9d6", "image_name" : "cph-private-image", "update_time" : "2024-04-11T06:38:21Z", "create_time" : "2024-04-11T06:38:21Z", "image_size" : 1306150912, "project_id" : "3a63a229aa6e47bab2153b44a7f3f50d", "image_id" : "23030320230421e300221a2000004433", "image_version" : "AOSP 9.0", "image_type" : "private", "status" : 1 } ], "total" : 1, "request_id" : "bff458ad55f24751b0b226119ab4f9fd" }

URI GET /v1/{project_id}/cloud-phone/images 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 image_type 否 String 镜像类型。 public：公共镜像 private：私有镜像 share：共享镜像 status 否 Integer 镜像状态。 0：CREATING 创建中 1：PRODUCTION 生产态，可使用 2：CREATE_FAILED 创建失败 offset 否 Integer 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~100（默认值为100），一般设置为10、20、50。 image_id 否 String 镜像id image_name 否 String 镜像名称 create_since 否 Long 起始时间 create_until 否 Long 截止时间 src_project_id 否 String 共享镜像账号的projectId

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 image_infos Array of ListImagesView objects 镜像详情 total Integer 总条数 request_id String 请求的唯一标识ID。 表5 ListImagesView 参数 参数类型 描述 domain_id String 镜像所属租户 image_name String 镜像名称 update_time String 镜像更新时间 create_time String 镜像创建时间 image_size Long 镜像大小，单位byte project_id String project_id（当image_type为private时，才会返回此字段) image_id String 镜像ID image_version String 镜像AOSP版本 image_type String 镜像类型 公共镜像：public 私有镜像：private 共享镜像：share status Integer 镜像状态。 0：CREATING 创建中 1：PRODUCTION 生产态，可使用 2：CREATE_FAILED 创建失败 src_project_id String 共享镜像账号的projectId（当image_type为share时，才会返回此字段)

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 操作标识。 delete：刪除 tags 是 Array of Tag objects 标签列表。 表4 Tag 参数 是否必选 参数类型 描述 key 是 String 键。 最大长度127个unicode字符。 不能为空，可以包含任意语种字母、数字、空格和_.：=+-@，但首尾不能含有空所有服务均可在标签输入框下拉选择同一标格，不能以_sys_开头。 value 是 String 值列表。 每个值最大长度255个unicode字符。 不能为空，可以包含任意语种字母、、数字、空格和_.：=+-@，但首尾不能含有空格。

请求示例 批量删除标签 Post https://{CPH Endpoint}/v1/{project_id}/{resource_type}/{resource_id}/tags { "action" : "delete", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ] }

URI POST /v1/{project_id}/{resource_type}/{resource_id}/tags/action 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 resource_type 是 String 资源类型。 cph-server，云手机服务器 枚举值： cph-server resource_id 是 String 资源ID。

请求示例 获取云手机连接信息 POST https://{CPHEndpoint}/v1/{project_id}/cloud-phone/phones/batch-connection { "client_type" : "ANDROID", "phone_ids" : [ "1564567b8bab40f34711234cb80d8574", "1234567b8bab40ffb711234cb80d0234", "1234567b8bab40ffb711234cb8654321z" ] }

响应示例 状态码： 200 OK { "request_id" : "70bb40bef50e4a14b116a5a527fd7432", "connect_infos" : [ { "phone_id" : "1564567b8bab40f34711234cb80d8574", "access_info" : { "access_ip" : "213.32.43.22", "intranet_ip" : "192.168.0.25", "access_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d", "access_port" : 14308, "session_id" : "9864567a7bab40f34711234cb8087474", "timestamp" : "122478329742", "ticket" : "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" } } ], "errors" : [ { "phone_id" : "1234567b8bab40ffb711234cb80d0234", "error_code" : "CPS.0018", "error_msg" : "Access info not found." }, { "phone_id" : "1234567b8bab40ffb711234cb8654321", "error_code" : "CPS.0005", "error_msg" : "Phone not found." } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 connect_infos Array of ConnectInfo objects 云手机接入信息列表 errors Array of ConnectErrorInfo objects 错误信息 表5 ConnectInfo 参数 参数类型 描述 phone_id String 云手机的唯一标识。 access_info access_info object 云手机接入信息 表6 access_info 参数 参数类型 描述 access_ip String 云手机实例的访问IP intranet_ip String 云手机实例的内网访问IP access_ipv6 String 云手机服务器IPv6 IP access_port Integer 云手机实例的访问端口 session_id String 本次接入的会话ID timestamp String 时间戳 ticket String 签名令牌 表7 ConnectErrorInfo 参数 参数类型 描述 phone_id String 云手机的唯一标识ID。 error_code String 错误码。 error_msg String 错误说明。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 phone_ids 是 Array of strings phone_id数组，单次请求最大限制10 client_type 是 String 申请接入的客户端类型 ANDROID: 安卓平台SDK WINDOWS: Windows平台SDK H5_MOBILE: H5移动端SDK H5_PC: H5 PC端SDK IOS: iOS平台SDK 枚举值： ANDROID WINDOWS H5_MOBILE H5_PC IOS

响应示例 状态码： 200 OK { "phone_models" : [ { "server_model_name" : "physical.rx1.xlarge", "phone_model_name" : "rx1.cp.c60.d32.e1v1.qemu", "status" : 1, "cpu" : 2, "memory" : 3072, "disk" : 32, "resolution" : "540x960", "render_fps" : 60, "stream_fps" : 60, "extend_spec" : "{\"eip_count\": 1, \"vip_count\":1, \"emulator_type\":0, \"bms_image_id\":\"72460777-7fcb-4cae-8bb5-62d93be86bd7\",\"core_bind_strategy\":\"lxc_qemu_common_hosted_c60\", \"sd_disk\": 1}", "spec_code" : "rx1.cp.c60.d32.e1v1.qemu", "phone_capacity" : 60, "image_label" : "qemu_phone", "product_type" : 0 }, { "server_model_name" : "physical.rx1.xlarge", "phone_model_name" : "rx1.cp.c60.d10.e1v1", "status" : 1, "cpu" : 2, "memory" : 3584, "disk" : 10, "resolution" : "720x1280", "render_fps" : 60, "stream_fps" : 60, "extend_spec" : "{\"eip_count\": 1, \"vip_count\":1, \"emulator_type\":1,\"thinpool_size_g\":70, \"sharepool_size_g\":650,\"max_share_disk_size_g\":50,\"encode_server_spec\": {\"cpu\": 2,\"memory\": 14448,\"disk\": 10,\"image_id\":\"coderserver_v2.5\", \"port_num\":0},\"core_bind_strategy\":\"common_hosted_c60\"}", "spec_code" : "rx1.cp.c60.d10.e1v1", "phone_capacity" : 60, "image_label" : "cloud_phone", "product_type" : 0 } ], "request_id" : "e0dd77cb688743468599487ca2a1c738" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 phone_models Array of PhoneModel objects 云手机的规格信息。 表5 PhoneModel 参数 参数类型 描述 server_model_name String 云手机服务器的规格名称，不超过64个字节。 phone_model_name String 云手机的规格名称，不超过64个字节。 status Integer 规格状态。 1 表示正常使用状态 0 表示已下线状态 已下线的规格不可用来购买云手机服务器 cpu Integer CPU核数。 memory Integer 内存大小，单位：MB。 disk Integer 系统存储大小，单位：GB。 resolution String 分辨率，不超过16个字节。 extend_spec String 扩展描述，不超过512个字节。 spec_code String 规格名称，不超过64个字节。 phone_capacity Integer 当前云手机规格包含的云手机个数。 image_label String 镜像类型，只支持如下类型： qemu_phone cloud_phone cloud_phone_1620 cloud_game cloud_game_1620 product_type Integer 产品类型。 0：云手机 1：云手游 phone_model_version Integer 规格版本： 0：规格1.0 1：规格2.0 dpi Integer 每英寸点数。 fps String 渲染帧率。 volume_mode Integer 手机物理磁盘是否独立。 0：不独立 1：独立

URI GET /v1/{project_id}/cloud-phone/phone-models 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 status 否 Integer 规格状态 0：下线状态 1：正常使用 不传该参数表示查询所有状态的规格。 offset 否 Integer 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~100（默认值为100），一般设置为10、20、50。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 phones Array of Phone objects 云手机信息。 request_id String 请求的唯一标识ID。 count Integer 实例总数。 表5 Phone 参数 参数类型 描述 phone_name String 云手机的名称，不超过65个字符。 server_id String 云手机所在的服务器ID，不超过32个字节。 phone_id String 云手机的唯一标识，不超过32个字节。 phone_model_name String 云手机规格名称，不超过64个字节。 image_id String 云手机镜像ID，不超过32个字节。 image_version String 镜像版本。 vnc_enable String 云手机是否开启VNC服务。 true：开启 false：不开启 status Integer 云手机状态。 0: 创建中 1：创建中 2：运行中 3：重置中 4：重启中 6：冻结 7：正在关机 8：已关机 -5：重置失败 -6：重启失败 -7：手机异常 -8：创建失败 -9：关机失败 type Integer 云手机类型。 0：普通云手机 1：试玩云手机 imei String imei码。 traffic_type String 手机路由类型。 direct：默认路由 routing：路由到编码容器 volume_mode Integer 手机物理磁盘是否独立。 0：不独立 1：独立 availability_zone String 云手机服务器所在的可用区。 metadata metadata object 订单以及产品相关信息。 create_time String 创建时间， 时间格式为UTC。 update_time String 更新时间， 时间格式为UTC。 表6 metadata 参数 参数类型 描述 order_id String 订单ID，不超过64个字节。 product_id String 产品ID，不超过64个字节。

响应示例 状态码： 200 OK { "request_id" : "6a63a18b8bab40ffb71ebd9cb80d0085", "count" : 1, "phones" : [ { "phone_name" : "mobile-0001", "server_id" : "88b8449b896f3a4f0ad57222dd91909", "phone_id" : "1234567b8bab40ffb711234cb80d0234", "phone_model_name" : "AOSP-1U4G15G-001", "image_version" : "AOSP 7.0", "image_id" : "88b8449b896f3a4f0ad57222dd91909", "vnc_enable" : "true", "status" : 2, "type" : 0, "imei" : "869287243397729", "availability_zone" : "cn-southwest-242b", "traffic_type" : "direct", "volume_mode" : 0, "metadata" : { "order_id" : "CS1710111105S8IPB", "product_id" : "00301-25217-0--0" }, "create_time" : "2017-10-10T00:00:00Z", "update_time" : "2018-10-10T00:00:00Z" } ] }

URI GET /v1/{project_id}/cloud-phone/phones 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~200（默认值为200），一般设置为10、20、50。 phone_name 否 String 云手机名称，支持模糊查询。 server_id 否 String 云手机服务器的唯一标识。 status 否 Integer 云手机状态。 1：创建中 2：运行中 3：重置中 4：重启中 6：冻结 7：正在关机 8：已关机 -5：重置失败 -6：重启失败 -7：手机异常 -8：创建失败 -9：关机失败 type 否 Integer 云手机类型。 0：普通云手机

响应示例 状态码： 200 OK { "request_id" : "70bb40bef50e4a14b116a5a527fd7432", "band_widths" : [ { "band_width_id" : "70bb40-bef5-0e4a-14b116-a5a527fd7432", "band_width_name" : "BANDWIDTH_70bb40bef50e4a14b116a5a527fd7432", "band_width_size" : 300, "band_width_share_type" : 1, "create_time" : "2017-10-10T00:00:00Z", "update_time" : "2018-11-12T00:00:00Z" } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 band_widths Array of Bandwidth objects 带宽信息。 表5 Bandwidth 参数 参数类型 描述 band_width_name String 云手机服务器的带宽名称。 band_width_id String 云手机服务器的带宽唯一标识。 band_width_size Integer 云手机服务器的带宽大小。 band_width_charge_mode Integer 云手机服务器带宽的计费方式。 0：bandwidth, 按带宽计费 1：traffic, 按流量计费 band_width_share_type Integer 云手机服务器的带宽类型。 0：per，独享带宽 1：whole，共享带宽 create_time String 带宽创建时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。 update_time String 带宽更新时间， 时间格式为UTC，YYYY-MM-DDTHH:MM:SSZ。

URI GET /v1/{project_id}/cloud-phone/bandwidths 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~100（默认值为100），一般设置为10、20、50。

URI POST /v1/{project_id}/{resource_type}/{resource_id}/tags/action 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 resource_type 是 String 资源类型。 cph-server，云手机服务器 枚举值： cph-server resource_id 是 String 资源ID。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 操作标识。 create：创建 tags 是 Array of Tag objects 标签列表。 表4 Tag 参数 是否必选 参数类型 描述 key 是 String 键。 最大长度127个unicode字符。 不能为空，可以包含任意语种字母、数字、空格和_.：=+-@，但首尾不能含有空所有服务均可在标签输入框下拉选择同一标格，不能以_sys_开头。 value 是 String 值列表。 每个值最大长度255个unicode字符。 不能为空，可以包含任意语种字母、、数字、空格和_.：=+-@，但首尾不能含有空格。

请求示例 批量添加标签 Post https://{CPH Endpoint}/v1/{project_id}/{resource_type}/{resource_id}/tags/action { "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 tags Array of Tag objects 资源标签列表。 表4 Tag 参数 参数类型 描述 key String 键。 最大长度127个unicode字符。 不能为空，可以包含任意语种字母、数字、空格和_.：=+-@，但首尾不能含有空所有服务均可在标签输入框下拉选择同一标格，不能以_sys_开头。 value String 值列表。 每个值最大长度255个unicode字符。 不能为空，可以包含任意语种字母、、数字、空格和_.：=+-@，但首尾不能含有空格。

响应示例 状态码： 200 OK { "encode_servers" : [ { "encode_server_name" : "ENCODE_SERVER_2", "encode_server_id" : "00b00d1b35094f13b360cdfe15a9bfee", "encode_server_ip" : "10.237.0.233", "encode_server_ipv6" : "fd00::aed:e9", "server_id" : "26fef5ef8f484e5fbd3d3974134b8091", "keypair_name" : "keyPair2", "type" : 0, "status" : 1, "access_infos" : [ { "listen_port" : 6902, "intranet_ip" : "172.31.240.115", "access_port" : 6902, "access_ip" : "10.154.119.231", "server_ip" : "172.31.240.115", "server_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d", "public_ip" : "10.154.119.231", "type" : "port1" }, { "listen_port" : 6903, "intranet_ip" : "172.31.240.115", "access_port" : 6903, "access_ip" : "172.31.240.115", "server_ip" : "172.31.240.115", "server_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d", "public_ip" : "", "type" : "port2" }, { "listen_port" : 6900, "intranet_ip" : "172.31.240.115", "access_port" : 6900, "access_ip" : "172.31.240.115", "server_ip" : "172.31.240.115", "server_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d", "public_ip" : "", "type" : "port3" }, { "listen_port" : 6901, "intranet_ip" : "172.31.240.115", "server_ipv6" : "2001:db8:a583:b62:e5ea:4a6b:de7b:f97d", "access_port" : 6901, "access_ip" : "100.68.0.235", "server_ip" : "172.31.240.115", "public_ip" : "100.68.0.235", "type" : "port4" } ] } ], "request_id" : "4faba0b7f7cb4e829b18773718289b99" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 encode_servers Array of EncodeServer objects 编码服务信息。 表5 EncodeServer 参数 参数类型 描述 encode_server_name String 编码服务的名称，不大于64个字节。 encode_server_id String 编码服务的唯一标识ID，不大于32个字节。 encode_server_ip String 编码服务IP地址。 server_id String 云手机服务器ID，不大于32个字节。 keypair_name String 编码服务登录密钥名称。 type Integer 编码服务类型。 0：服务器 1：容器 status Integer 编码服务状态。 1：运行中 2：异常 3：重启中 0、4、5：创建中 access_infos Array of EncodeServerAccessInfo objects 编码服务的访问信息。 encode_server_ipv6 String 编码服务IPv6地址。 表6 EncodeServerAccessInfo 参数 参数类型 描述 listen_port Integer 编码服务监听端口。 access_ip String 编码服务访问的公网IP（过期）。 intranet_ip String 编码服务访问的内网IP（过期）。 public_ip String 编码服务访问的公网IP（新增）。 server_ip String 编码服务访问的内网IP（新增）。 access_port Integer 编码服务公网的访问端口。 type String 编码服务的端口类型，取值如下： adb：云手机的ADB端口 vnc：云手机的VNC端口 cph_app_server：云游戏客户端接入端 cph_h5_server：云游戏H5 web网页接入端口 其他值：用户自定义端口 server_ipv6 String 编码服务访问的内网IPv6 IP（新增）。

URI GET /v1/{project_id}/cloud-phone/encode-servers 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id。 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量为一个大于等于0整数，表示查询该偏移量后面的所有的资源数，默认值为0。 limit 否 Integer 每页返回的资源个数。取值范围：1~100（默认值为100），一般设置为10、20、50。 type 否 Integer 编码服务类型。 0：服务器 1：容器 status 否 Integer 状态列表。 1：运行中 2：异常 3：重启中 4：冻结 5：关机 100、1014、0：创建中 server_id 否 String 云手机服务器的唯一标识。

响应示例 状态码： 200 ok { "resources" : [ { "resource_detail" : null, "resource_id" : "cdfs_cefs_wesas_12_dsad", "resource_name" : "resouece1", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value1" } ] } ], "total_count" : 1000 }

请求示例 查询资源实例数量 Post https://{CPH Endpoint}/v1/{project_id}/{resource_type}/resource_instances/action { "action" : "count", "tags" : [ { "key" : "key1", "values" : [ "value1", "value2" ] }, { "key" : "key2", "values" : [ "value1", "value2" ] } ], "matches" : [ { "key" : "resource_name", "value" : "resource1" } ] } 查询资源实例列表 Post https://{CPH Endpoint}/v1/{project_id}/{resource_type}/resource_instances/action { "offset" : "100", "limit" : "100", "action" : "filter", "tags" : [ { "key" : "key1", "values" : [ "value1", "value2" ] }, { "key" : "key2", "values" : [ "value1", "value2" ] } ], "matches" : [ { "key" : "resource_name", "value" : "resource1" } ] }

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 resources Array of Resource objects 资源列表。 total_count Integer 资源总数。 表7 Resource 参数 参数类型 描述 resource_id String 资源ID。 resource_detail String 资源详情。 resource_name String 资源名称。 tags Array of Tag objects 标签列表。 表8 Tag 参数 参数类型 描述 key String 键。 最大长度127个unicode字符。 不能为空，可以包含任意语种字母、数字、空格和_.：=+-@，但首尾不能含有空所有服务均可在标签输入框下拉选择同一标格，不能以_sys_开头。 value String 值列表。 每个值最大长度255个unicode字符。 不能为空，可以包含任意语种字母、、数字、空格和_.：=+-@，但首尾不能含有空格。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 操作标识（仅限于filter，count）：filter（过滤），count(查询总条数)。 为filter时表示分页查询，为count只需按照条件将总条数返回即可。 枚举值： filter count offset 否 String 索引位置， 从offset指定的下一条数据开始查询。 查询第一页数据时，不需要传入此参数，查询后续页码数据时，将查询前一页数据时响应体中的值带入此参数。action为count时无此参数。action为filter时，默认为0，必须为数字，且不能为负数。 limit 否 String 查询记录数。 action为count时无此参数。 action为filter时，默认为1000。limit最多为1000，不能为负数，最小值为1。 without_any_tag 否 Boolean 不包含任意一个标签，该字段为true时查询所有不带标签的资源。 tags 否 Array of Tags objects 最多包含10个key，每个key最多包含10个value，结构体不能缺失。key不能为空或者空字符串。key不能重复，同一个key中value不能重复，不同key对应的资源之间为与的关系。 matches 否 Array of Match objects 搜索字段。 key为要匹配的字段，当前只支持resource_name。 value为匹配的值，当前为精确匹配。 表4 Tags 参数 是否必选 参数类型 描述 key 是 String 键。 最大长度127个unicode字符。 key不能为空。 values 是 Array of strings 值列表。 最多10个value。 value不允许重复。 每个值最大长度255个unicode字符。 如果values为空则表示any_value。 value之间为或的关系。 表5 Match 参数 是否必选 参数类型 描述 key 是 String 键。 当前key的参数值只能取“resource_name”，此时value的参数值为资源名称。 枚举值： resource_name value 是 String 值。 当前key的参数值只能取“resource_name”，此时value的参数值为资源名称。