华为云用户手册

省份名称缩写 表1 省份名称缩写 省份 英文缩写 其他 OT 北京 BJ 天津 TJ 重庆 CQ 上海 SH 广东 GD 海南 HI 广西 GX 云南 YN 山西 SX 河北 HE 内蒙古 NM 宁夏 NX 辽宁 LN 吉林 JL 黑龙江 HL 江苏 JS 浙江 ZJ 江西 JX 山东 SD 福建 FJ 安徽 AH 四川 SC 西藏 XZ 陕西 SN 青海 QH 新疆 XJ 甘肃 GS 贵州 GZ 湖北 HB 湖南 HN 河南 HA 香港 HK 澳门 MO 台湾 TW 父主题： 附录

操作步骤 获取用户Token，用于调用SparkRTC接口时进行认证鉴权。 在“我的凭证”页面获取username、password、domainname，调用如下接口 获取Token 。详细信息请参见构造请求。 POST https://iam.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json{ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //用户名。 "password": "password", //用户登录密码。 "domain": { "name": "domainname" //用户所属的账号名。 } } } }, "scope": { "domain": { "name": "domainname" //用户所属的账号名。 } } }} 如图1所示，红框中的信息为获取用户Token。 图1 获取用户Token 调用创建应用接口创建SparkRTC应用。 选择POST请求方法并输入URI。 https://rtc-api.myhuaweicloud.com/v2/apps 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。 Request Body中传入如下参数： { "app_name" : "rtctest"} 请求响应成功后，返回已创建应用的ID。 {"app_id": "5ff9701f2346968bb306cb43",} 调用创建或更新录制规则接口，创建录制规则。 选择POST请求方法并输入URI。 https://rtc-api.myhuaweicloud.com/v2/apps/{app_id}/record-rules 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。 Request Body中传入如下参数： {"obs_addr": {"bucket": "obsName","location": "cn-north-4","object": "Record/","project_id": "01234567890123456789012345678901"},"record_formats": ["MP4"],"mp4_config": {}} 请求响应成功后，返回已创建的录制规则。 {"app_id": "5ff9701f2346968bb306cb43","rule_id": "5d0ec2c53a2c15625017adb8bbbcd9ab","create_time": "2021-04-21T10:29:33Z","hls_config": {"record_cycle": 0,"record_max_duration_to_merge_file": 0},"mp4_config": {"record_cycle": 7200,"record_max_duration_to_merge_file": 0,"record_prefix": "Record/{publish_domain}/{app}/{record_type}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time}"},"obs_addr": {"bucket": "obsName","location": "cn-north-4","object": "Record/","project_id": "01234567890123456789012345678901"},"record_formats": ["MP4"],"update_time": "2021-04-21T10:29:33Z"} 调用RTC增值（录制）事件回调配置接口，配置录制回调。 选择PUT请求方法并输入URI。 https://rtc-api.myhuaweicloud.com/v2/apps/{app_id}/record-callback 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。 Request Body中传入如下参数： {"url": "http://mydomain.com/callback","auth_key": "8923ab8c2dcef4538923ab8c2dcef453"} 请求响应成功后，返回已创建的回调信息。 {"app_id": "5ff9701f2346968bb306cb43","record_callback": {"auth_key": "8923ab8c2dcef4538923ab8c2dcef453","update_time": "2021-04-07T12:05:18.0718Z","url": "http://mydomain.com/callback","notify_event_subscription": ["RECORD_NEW_FILE_START","RECORD_FILE_COMPLETE","CLOUD_RECORD_OVER"]}} 终端用户通过SparkRTC APP加入某个SparkRTC房间，SparkRTC APP的集成开发请参见客户端SDK。 调用启动单流任务接口，创建录制任务。 选择POST请求方法并输入URI。 https://rtc-api.myhuaweicloud.com/v2/apps/{app_id}/individual-stream-jobs 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。 Request Body中传入如下参数： {"room_id": "room001","user_id": "user001","is_record_audio": true,"video_type": "CAMERASTREAM","resolution": "1280*720","resolution_policy": "DOWNWARD","max_idle_time": 30,"record_param": {"record_rule_id": "5d0ec2c53a2c15625017adb8bbbcd9ab"}} 请求响应成功后，返回录制任务信息。 {"app_id": "5ff9701f2346968bb306cb43","create_time": "2021-04-21T10:51:55Z","is_record_audio": true,"job_id": "607f87cf00d861eeefffa6c88054cdab","job_unique_id": "a77bb33dbdc948d8","max_idle_time": 30,"push_param": {"rtmp_urls": null},"record_files": null,"record_param": {"record_rule_id": "5d0ec2c53a2c15625017adb8bbbcd9ab"},"resolution_policy": "DOWNWARD","resolution": "1280*720","room_id": "room001","start_time": "2021-04-21T10:51:55Z","state": "INIT","stop_time": "0001-01-01T00:00:00Z","stream_name": "s_607f87cf00d861eeefffa6c88054cdab_room001_user001","update_time": "2021-04-21T10:51:55Z","user_id": "user001","video_type": "CAMERASTREAM"} SparkRTC房间结束音视频互动后，您可以在配置的OBS桶中获取录制文件。

修订记录 表1 修订记录 修改时间 修改说明 2023-05-24 第十八次正式发布 本次变更如下： 修改启动合流任务接口的“encode_template”参数枚举类型640x480_30_1000为640x480_30_1500。 2022-09-27 第十七次正式发布 本次变更如下： 修改更新单流任务接口的示例代码，修复错误字段。 2022-09-06 第十六次正式发布 本次变更如下： 新增房间管理接口组。 单流任务管理接口组新增更新单流任务接口。 2022-08-29 第十五次正式发布 本次变更如下： 修改启动合流任务接口和查询合流任务接口的参考示例。 2022-07-05 第十四次正式发布 本次变更如下： 修改查询用户通话指标接口的参考示例。 所有接口中的响应Header参数“X-request-id”修改为“X-Request-Id”。 2022-07-01 第十三次正式发布 本次变更如下： 修改部分接口参考示例。 下线“查询学生和老师同时在线时长”接口。 2022-06-28 第十二次正式发布 本次变更如下： 修改部分接口示例。 优化启动合流任务背景图相关字段的描述。 2022-03-09 第十一次正式发布 本次变更如下： 启动合流任务、查询合流任务和修改合流任务接口“encode_template”参数，增加如下枚举类型： 1920*1080_30_3150 1920*1080_15_2080 1280*720_30_1710 1280*720_15_1130 640*480_30_1000 640*480_15_500 480*360_30_490 480*360_15_320 2022-01-27 第十次正式发布 本次变更如下： 新增RTC.00002001~RTC.00002006错误码。 2021-12-31 第九次正式发布 本次变更如下： 修改API的operationID，完善API调试链接。 2021-12-17 第八次正式发布 本次变更如下： 启动合流任务、查询合流任务和修改合流任务接口“encode_template”参数，增加枚举类型640x480_15_1000。 2021-12-08 第七次正式发布 本次变更如下： 新增查询用户异常体验事件、查询异常事件用户分布接口。 2021-12-07 第六次正式发布 本次变更如下： 查询房间列表、查询用户列表、查询实时规模、查询实时质量数据、查询实时网络、查询历史规模和查询历史质量接口中增加查询时间间隔的描述。 查询用户通话指标接口增加“stream_id”、“time_type”、“limit”、“offset”参数。 下线接收增值（录制）时间回调通知内容接口。 2021-09-22 第五次正式发布 本次变更如下： 下线查询用户异常体验事件、查询用户异常体验事件分布、查询用户详情、查询房间详情、查询服务端实时通话指标和查询流量数据分布接口。 2021-09-07 第四次正式发布 本次变更如下： 应用回调管理中增加接收增值（录制）时间回调通知内容接口。 数据统计分析中增加查询服务端实时通话指标和查询流量数据分布接口。 修改创建或更新录制规则接口的“record_prefix”参数，增加自定义特殊变量的说明。 修改“使用前必读”中的API流控限制。 增加启动合流任务的请求示例。 2021-08-05 第三次正式发布 本次变更如下： 新增数据统计分析接口。 2021-07-23 第二次正式发布 本次变更如下： 下线“开关访问控制”和“查询访问控制参数”接口。 2021-04-20 第一次正式商用发布

响应示例 状态码： 200 修改成功 { "job_id" : "607824b4fa163e19fe301cc817dda855", "stream_name" : "m_607824b4fa163e19fe301cc817dda855_gigu", "app_id" : "123456789abcdefghijklmno", "room_id" : "gigu", "mix_param" : { "room_id" : "gigu", "encode_template" : "1920x1080_30_4620", "max_idle_time" : 0, "layout_template" : "nine_grids_view" }, "record_param" : { "record_rule_id" : "5f5e172b9016ed5b0961a43" }, "create_time" : "2021-04-16T16:22:44Z", "update_time" : "2021-04-16T16:22:44Z", "state" : "INIT", "start_time" : "2021-04-16T16:22:44Z", "stop_time" : "0001-01-01T00:00:00Z"} 状态码： 400 修改失败，语义有误，当前请求无法被服务器理解，或参数有误 { "error_code" : "RTC.00001003", "error_msg" : "InvalidParameterValue"} 状态码： 404 修改失败，应用不存在 { "error_code" : "RTC.00001003", "error_msg" : "InvalidParameterValue"} 状态码： 500 修改失败，服务器错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError"}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 内容类型。 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息。 表3 请求Body参数 参数 是否必选 参数类型 描述 mix_param 是 UpdateMixParam object 合流参数 表4 UpdateMixParam 参数 是否必选 参数类型 描述 layout_template 否 String 视频布局模板编号，仅支持自定义模板之间的更新。 background_image 否 String 画布背景图地址，图片先上传obs。默认使用等比缩放裁剪，保证铺满。格式s3://bucket/object，如：s3://rtc-bucket-cn-north-4/img/testImg.jpg default_user_background_image 否 String 默认用户背景图地址，图片先上传obs，格式s3://bucket/object，如：s3://rtc-bucket-cn-north-4/img/testImg.jpg。默认使用等比缩放裁剪，保证铺满。 screen_background_image 否 String 共享屏幕的背景图地址，图片先上传obs，格式s3://bucket/object，如：s3://rtc-bucket-cn-north-4/img/testImg.jpg。 在一大多小的布局场景下，无论大窗是显示非指定用户（屏幕共享人的桌面）还是指定用户的共享桌面，都通过该字段指定背景图。 max_idle_time 否 Integer 最长空闲频道时间。 取值范围：[5，43200]，默认值为30。 单位：秒。 如果频道内无连麦方的状态持续超过该时间，录制程序会自动退出。退出后，再次调用start请求，会产生新的录制任务。 连麦方指：joiner或者publisher的用户。 layout_panes 否 Array of MixLayoutPane objects 需要混流的视频列表。若不需要视频混流，则可不传递该参数。 user_background_images 否 Array of MixUserBackgroundImage objects 指定用户背景图，优先级大于default_user_background_image 表5 MixLayoutPane 参数 是否必选 参数类型 描述 id 否 Integer 窗口id，从1开始编号 user_id 否 String 加入房间的用户id video_type 否 String 标识视频流的类型，可选摄像头流或者屏幕分享流。 CAMERASTREAM：摄像头视频流 SCREENSTREAM：屏幕分享视频流 默认为CAMERASTREAM。 x 否 Float 坐标x，归一化百分比，画布上该画面左上角的横坐标的相对值，范围是 [0.0,1.0]。从左到右布局，0.0在最左端，1.0在最右端，小数取值范围在float内，自定义布局场景下填写本字段。 y 否 Float 坐标y，归一化百分比，画布上该画面左上角的纵坐标的相对值，范围是 [0.0,1.0]。从上到下布局，0.0在最上端，1.0在最下端，小数取值范围在float内，自定义布局场景下填写本字段。 width 否 Float 窗格宽，归一化百分比，小数取值范围在float内，自定义布局场景下填写本字段。 height 否 Float 窗格高，归一化百分比，小数取值范围在float内，自定义布局场景下填写本字段。 zorder 否 Integer 叠放顺序，0为最底层，1层在0层之上，以此类推，最大支持25层，自定义布局场景下填写本字段。 crop_mode 否 String 裁剪模式，自定义布局场景下填写本字段，支持两种模式： KEEP_RATIO_PADDING ：保持比例留边。 KEEP_RATIO_CROP ：保持比例裁剪。 filling_policy 否 String 填充策略，仅限屏幕共享模板(包括screen_share_right、screen_share_left)场景下填写本字段，支持两种模式： FIXED_USER ：固定用户填充。 SHARED_SCREEN ：共享屏幕填充。 表6 MixUserBackgroundImage 参数 是否必选 参数类型 描述 user_id 是 String 需要设置背景图的用户ID image_uri 是 String 需要设置背景图的地址，图片先上传obs，格式s3://bucket/object，如：s3://rtc-bucket-cn-north-4/img/testImg.jpg

响应参数 状态码： 200 表7 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号，以便任务跟踪。 表8 响应Body参数 参数 参数类型 描述 job_id String 任务编号，可以用于修改、查看和停止合流任务 stream_name String 流名 app_id String 应用id room_id String 房间id mix_param MixParam object 合流参数 record_param RecordParam object 录制参数 create_time String 任务创建的时间，形如“2006-01-02T15:04:05.075Z”，时区为：UTC update_time String 任务中的布局更新的时间，形如“2006-01-02T15:04:05.075Z”，时区为：UTC state String 任务状态。 INIT：任务正在初始化 RUNNING：任务正在运行 STOPPED：任务已停止 stop_reason String 任务结束原因 description String 状态描述，对state字段的一些补充说明，可用于人工查阅。 start_time String 任务开始时间，形如“2006-01-02T15:04:05.075Z”，时区为：UTC stop_time String 任务结束时间，形如“2006-01-02T15:04:05.075Z”，时区为：UTC 表9 MixParam 参数 参数类型 描述 room_id String 房间id encode_template String 输出编码模板名称 1920*1080_30_4620：输出流是1080p，帧率30，码率4.62Mbps 1920*1080_30_3150：输出流是1080p，帧率30，码率3.15Mbps 1920*1080_15_3460：输出流是1080p，帧率15，码率3.46Mbps 1920*1080_15_2080：输出流是1080p，帧率15，码率2.08Mbps 1280*720_30_3420：输出流是720p，帧率30，码率3.42Mbps 1280*720_30_1710：输出流是720p，帧率30，码率1.71Mbps 1280*720_15_2260：输出流是720p，帧率15，码率2.26Mbps 1280*720_15_1130：输出流是720p，帧率15，码率1.13Mbps 640*480_30_1500：输出流是480p，帧率30，码率1.50Mbps 640*480_15_500：输出流是480p，帧率15，码率500Kbps 480*360_30_490：输出流是360p，帧率30，码率490Kbps 480*360_15_320：输出流是360p，帧率15，码率320Kbps max_idle_time Integer 最长空闲频道时间。 取值范围：[5，43200]，默认值为30。 单位：秒。 如果频道内无连麦方的状态持续超过该时间，录制程序会自动退出。退出后，再次调用start请求，会产生新的录制任务。 连麦方指：joiner或者publisher的用户。 layout_template String 视频布局模板编号，不混视频的时候，不需要带。 nine_grids_view：九宫格模板（自适应模板） screen_share_left：主视图在左边的屏幕共享模板（自适应模板） screen_share_right：主视图在右边的屏幕共享模板（自适应模板） custom：自定义布局 default_user_background_image String 默认用户背景图地址，图片先上传obs，格式s3://bucket/object，如：s3://rtc-bucket-cn-north-4/img/testImg.jpg。默认使用等比缩放裁剪，保证铺满。 screen_background_image String 共享屏幕的背景图地址，图片先上传obs，格式s3://bucket/object，如：s3://rtc-bucket-cn-north-4/img/testImg.jpg。 在一大多小的布局场景下，无论大窗是显示非指定用户（屏幕共享人的桌面）还是指定用户的共享桌面，都通过该字段指定背景图。 background_image String 画布背景图地址，使用背景图功能需先上传图片到obs，填写此字段要求格式为s3://bucket/object，其中bucket和object指图片所在的桶和路径，如：s3://rtc-bucket-cn-north-4/img/testImg.jpg。默认使用等比缩放裁剪，保证铺满。 layout_panes Array of MixLayoutPane objects 需要混流的视频列表。若不需要混流视频，则可不传递该参数。 nine_grids_view模板不需要填写本字段。 user_background_images Array of MixUserBackgroundImage objects 指定用户背景图，优先级大于default_user_background_image 表10 MixLayoutPane 参数 参数类型 描述 id Integer 窗口id，从1开始编号 user_id String 加入房间的用户id video_type String 标识视频流的类型，可选摄像头流或者屏幕分享流。 CAMERASTREAM：摄像头视频流 SCREENSTREAM：屏幕分享视频流 默认为CAMERASTREAM。 x Float 坐标x，归一化百分比，画布上该画面左上角的横坐标的相对值，范围是 [0.0,1.0]。从左到右布局，0.0在最左端，1.0在最右端，小数取值范围在float内，自定义布局场景下填写本字段。 y Float 坐标y，归一化百分比，画布上该画面左上角的纵坐标的相对值，范围是 [0.0,1.0]。从上到下布局，0.0在最上端，1.0在最下端，小数取值范围在float内，自定义布局场景下填写本字段。 width Float 窗格宽，归一化百分比，小数取值范围在float内，自定义布局场景下填写本字段。 height Float 窗格高，归一化百分比，小数取值范围在float内，自定义布局场景下填写本字段。 zorder Integer 叠放顺序，0为最底层，1层在0层之上，以此类推，最大支持25层，自定义布局场景下填写本字段。 crop_mode String 裁剪模式，自定义布局场景下填写本字段，支持两种模式： KEEP_RATIO_PADDING ：保持比例留边。 KEEP_RATIO_CROP ：保持比例裁剪。 filling_policy String 填充策略，仅限屏幕共享模板(包括screen_share_right、screen_share_left)场景下填写本字段，支持两种模式： FIXED_USER ：固定用户填充。 SHARED_SCREEN ：共享屏幕填充。 表11 MixUserBackgroundImage 参数 参数类型 描述 user_id String 需要设置背景图的用户ID image_uri String 需要设置背景图的地址，图片先上传obs，格式s3://bucket/object，如：s3://rtc-bucket-cn-north-4/img/testImg.jpg 表12 RecordParam 参数 参数类型 描述 record_rule_id String 录制规则id。 状态码： 400 表13 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号，以便任务跟踪。 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 404 表15 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号，以便任务跟踪。 表16 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表17 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号，以便任务跟踪。 表18 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

操作步骤 获取用户Token，用于调用SparkRTC接口时进行认证鉴权。 在“我的凭证”页面获取username、password、domainname，调用如下接口获取Token。详细信息请参见构造请求。 POST https://iam.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json{ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //用户名。 "password": "password", //用户登录密码。 "domain": { "name": "domainname" //用户所属的账号名。 } } } }, "scope": { "domain": { "name": "domainname" //用户所属的账号名。 } } }} 如图1所示，红框中的信息为获取用户Token。 图1 获取用户Token 调用创建应用接口创建SparkRTC应用。 选择POST请求方法并输入URI。 https://rtc-api.myhuaweicloud.com/v2/apps 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。 Request Body中传入如下参数： { "app_name" : "rtctest"} 请求响应成功后，返回已创建应用的ID。 {"app_id": "5ff9701f2346968bb306cb43",} 调用创建或更新录制规则接口，创建录制规则。 选择POST请求方法并输入URI。 https://rtc-api.myhuaweicloud.com/v2/apps/{app_id}/record-rules 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。 Request Body中传入如下参数： {"obs_addr": {"bucket": "obsName","location": "cn-north-4","object": "Record/","project_id": "01234567890123456789012345678901"},"record_formats": ["MP4"],"mp4_config": {}} 请求响应成功后，返回已创建的录制规则。 {"app_id": "5ff9701f2346968bb306cb43","rule_id": "5d0ec2c53a2c15625017adb8bbbcd9ab","create_time": "2021-04-21T10:29:33Z","hls_config": {"record_cycle": 0,"record_max_duration_to_merge_file": 0},"mp4_config": {"record_cycle": 7200,"record_max_duration_to_merge_file": 0,"record_prefix": "Record/{publish_domain}/{app}/{record_type}/{record_format}/{stream}_{file_start_time}/{stream}_{file_start_time}"},"obs_addr": {"bucket": "obsName","location": "cn-north-4","object": "Record/","project_id": "01234567890123456789012345678901"},"record_formats": ["MP4"],"update_time": "2021-04-21T10:29:33Z"} 调用RTC增值（录制）事件回调配置接口，配置录制回调。 选择PUT请求方法并输入URI。 https://rtc-api.myhuaweicloud.com/v2/apps/{app_id}/record-callback 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。 Request Body中传入如下参数： {"url": "http://mydomain.com/callback","auth_key": "8923ab8c2dcef4538923ab8c2dcef453"} 请求响应成功后，返回已创建的回调信息。 {"app_id": "5ff9701f2346968bb306cb43","record_callback": {"auth_key": "8923ab8c2dcef4538923ab8c2dcef453","update_time": "2021-04-07T12:05:18.0718Z","url": "http://mydomain.com/callback","notify_event_subscription": ["RECORD_NEW_FILE_START","RECORD_FILE_COMPLETE","CLOUD_RECORD_OVER"]}} 终端用户通过SparkRTC APP加入某个SparkRTC房间，SparkRTC APP的集成开发请参见客户端SDK。 调用启动合流任务接口，创建录制任务。 选择POST请求方法并输入URI。 https://rtc-api.myhuaweicloud.com/v2/apps/{app_id}/mix-stream-jobs 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。 Request Body中传入如下参数： {"mix_param": {"room_id": "room001","encode_template": "1920x1080_30_4620","max_idle_time": 30,"layout_template": "nine_grids_view" //若视频布局为屏幕共享，则填写为screen_share_left或screen_share_right。},"record_param": {"record_rule_id": "5d0ec2c53a2c15625017adb8bbbcd9ab"}} layout_template：视频布局模板编号。 nine_grids_view：九宫格模板（自适应模板）。 每个用户画面平铺在画布上，大小一致。根据用户数量，动态调整每个画面的大小和位置，最多支持25个画面。不同人数的实际布局效果如下图所示： 如果实际视频流的宽高比与视窗的宽高比不一致，则视频画面会裁剪以适配视窗的大小。 如果中途有流退出房间，则该条流的画面会被后进入房间的流顶替。 如果房间内的人数不足，则剩余位置显示背景色。 如果用户只发送音频，仍然会占用画面位置。 支持背景图，如果房间内人数不足，则显示背景图。 screen_share_left、screen_share_right：主视图在左边、右边的屏幕共享模板（自适应模板）。 屏幕分享（或者主讲人摄像头画面）始终占据屏幕左侧或者右侧大画面位置，其他用户依次垂直排列于旁边，最多支持17个画面。不同人数的实际布局效果如下图所示： 大视窗画面，可选择主讲摄像头流或共享屏幕流。 大视窗画面，显示指定的UID用户的视频，如果未指定或者指定用户未进入频道，则大视窗区域显示背景色。 左侧大视窗为了保持内容的完整性采用缩放方式处理，右侧小视窗采用裁剪方式适配视窗的大小。 右侧小视窗画面按照加入房间的时间先后顺序排列。 右侧小视窗有流退出房间，则该条流的画面会被后进入房间的流顶替。 如果房间内的人数不足，则剩余位置显示背景色。 如果用户只发送音频，仍然会占用画面位置。 支持背景图，如果房间内人数不足，则显示背景图。 请求响应成功后，返回合流录制任务信息。 {"app_id": "5ff9701f2346968bb306cb43","create_time": "2021-04-21T11:47:32Z","job_id": "607f9fc100d861eeefff9b300b388dab","job_unique_id": "87b1f2b8da9c44cd","mix_param": {"room_id": "room001","layout_template": "nine_grids_view","encode_template": "1920x1080_30_4620","max_idle_time": 30},"push_param": {"rtmp_urls": null},"record_param": {"record_rule_id": "5d0ec2c53a2c15625017adb8bbbcd9ab"},"room_id": "room001","start_time": "2021-04-21T11:47:32Z","state": "INIT","stop_time": "0001-01-01T00:00:00Z","stream_name": "m_607f9fc100d861eeefff9b300b388dab_room001","update_time": "2021-04-21T11:47:32Z"} SparkRTC房间结束音视频互动后，您可以在配置的OBS桶中获取录制文件。

响应示例 状态码： 400 语义有误，当前请求无法被服务器理解，或参数有误 { "error_code" : "RTC.00001003", "error_msg" : "InvalidParameterValue"} 状态码： 404 找不到对应房间 { "error_code" : "RTC.00001003", "error_msg" : "InvalidParameterValue"} 状态码： 500 请求失败，服务器端错误 { "error_code" : "RTC.00002xxx", "error_msg" : "InternalError"}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 内容类型。 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Authorization 否 String 使用AK/SK方式认证时必选，携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选，请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选，携带项目ID信息。

响应参数 状态码： 202 表3 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号，以便任务跟踪。 状态码： 400 表4 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号，以便任务跟踪。 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 404 表6 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号，以便任务跟踪。 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码： 500 表8 响应Header参数 参数 参数类型 描述 X-request-Id String 此字段携带请求ID号，以便任务跟踪。 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

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

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

x86 V4实例（CPU采用Intel Broadwell架构） x86 V4实例已停止扩容。 通用型 提供均衡的计算、存储以及网络配置，满足资源专享、网络隔离、性能有基本要求的业务场景，如数据库、核心ERP系统、金融系统等。 表1 通用型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.s3.large 2*10 Core Intel Xeon E5-2618L V4 (2.20 GHz) 128 DDR4 RAM (GB) 2*600GB SAS System Disk RAID 1 2 x 2*10GE + SDI卡 physical.s3.xlarge 2*14 Core Intel Xeon E5-2658 V4 (2.30 GHz) 256 DDR4 RAM (GB) 2*600GB SAS System Disk RAID 1 2 x 2*10GE + SDI卡 physical.s3.2xlarge 2*10 Core Intel Xeon E5-2618L V4 (2.20 GHz) 192 DDR4 RAM (GB) 2*600GB SAS System Disk RAID 1 2 x 2*10GE + SDI卡 本地存储型 系统盘和数据盘均使用本地磁盘，针对数据量大，对计算性能、稳定性、实时性等要求很高的业务场景，如大数据、分布式缓存等。 表2 本地存储型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.d1.large 2*10 Core Intel Xeon E5-2618L V4 (2.20 GHz) 128 DDR4 RAM (GB) 2*600GB SAS System Disk RAID 1 + 8*4TB SATA 2 x 2*10GE 内存优化型 提供1TB以上超大内存，适用于内存数据库、SAP HANA和HPC胖节点等场景。 表3 内存优化型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.m2.small 4*24 Core Xeon E7-8890 V4 (2.20 GHz) 1024 DIMM RAM (GB) 2*600GB SAS System Disk RAID 1 + 7*1.8TB SAS HDD RAID 5 + 2*1.6TB NVMe SSD Card 2 x 2*10GE + 16G FC + SDI卡 physical.m2.medium 4*24 Core Xeon E7-8890 V4 (2.20 GHz) 2048 DIMM RAM (GB) 2*600GB SAS System Disk RAID 1 2 x 2*10GE + SDI卡 physical.m2.large 4*24 Core Xeon E7-8890 V4 (2.20 GHz) 3072 DIMM RAM (GB) 2*600GB SAS System Disk RAID 1 + 14*1.8TB SAS HDD + 4*400GB SAS SSD + 2*1600GB NVMe SSD 2 x 2*10GE + SDI卡 physical.m2.xlarge 4*24 Core Xeon E7-8890 V4 (2.20 GHz) 4096 DIMM RAM (GB) 2*600GB SAS System Disk RAID 1 + 14*1.8TB SAS HDD + 4*400GB SAS SSD + 2*1600GB NVMe SSD 2 x 2*10GE + SDI卡 IO优化型 系统盘和数据盘均使用SSD。适用于高性能大数据、数据库等存储IO性能要求高的场景。 表4 IO优化型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.io1.large 2*10 Core E5 2618L V4 (2.20 GHz) 256 DDR4 RAM (GB) 2*800GB SAS SSD System Disk RAID 1 + 4*3.2TB NVMe SSD 2 x 2*10GE GPU加速型 GPU加速型实例包括计算加速型（P系列）和图形加速型（G系列），提供优秀的浮点计算能力，从容应对高实时、高并发的海量计算场景。特别适合于深度学习、科学计算、CAE、3D动画渲染、CAD等应用。 表5 GPU加速型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.p1.large 2*14 Core Intel Xeon E5-2690 V4 (2.60 GHz) 512 DDR4 RAM (GB) 2*600GB SAS HDD System Disk RAID 1+ 6*800GB NVMe SSD Disk NIC：1*100G IB + 2*10GE + SDI卡 GPU：8*Tesla P100 显存：16G physical.p2.large 2*14 Core Intel Xeon E5-2690 V4 (2.60 GHz) 512 DDR4 RAM (GB) 2*600GB SAS HDD + 6*800GB NVMe SSD NIC：1*100G IB + 2*10GE + SDI卡 GPU：8*Tesla V100 显存：16G physical.g1.small 2*14 Core Intel Xeon E5-2690 V4 (2.60 GHz) 256 DDR4 RAM (GB) 2*600GB SAS + 960GB SSD NIC：3 x 2*10GE GPU：1*M60 父主题： 实例

裸金属服务器与物理机、虚拟机的功能对比 裸金属服务器与物理机、虚拟机的对比如表1所示。其中，Y表示支持，N表示不支持，N/A表示不涉及。 无特性损失、无性能损失：裸金属服务器具备物理机的一切特性和优势，您的应用可以直接访问裸金属服务器的处理器和内存，无任何虚拟化开销。 表1 特性对比 功能分类 功能 裸金属服务器 物理机 虚拟机 下发方式 自动化发放 Y N Y 计算 无特性损失 Y Y N 无性能损失 Y Y N 资源无争抢 Y Y N 存储 拥有本地存储 Y Y N 使用云硬盘（系统盘）启动 Y N Y 使用镜像，免操作系统安装 Y N Y 网络 使用虚拟私有云网络 Y N Y 物理机集群和虚拟机集群之间通过VPC通信 Y N Y 管控 远程登录等用户体验和虚拟机一致 Y N Y 支持监控以及关键操作审计 Y N Y

常用概念 云上的物理计算资源，即运行在华为云数据中心的裸金属服务器，请查看实例。 描述裸金属服务器所在的数据中心，请查看区域和可用区。 裸金属服务器由不同的CPU、内存、存储和网络等组成，请查看实例类型。 裸金属服务器运行环境的模板，其中包含了特定的操作系统和一些预装的应用软件，请查看镜像。 裸金属服务器网络类型及各自使用场景，请查看网络。 实例对内和对外的服务地址，即私有IP地址和弹性公网IP地址。

裸金属服务器介绍 裸金属服务（Bare Metal Server，BMS）是一款兼具弹性云服务器和物理机性能的计算类服务，为您和您的企业提供专属的云上物理服务器，为核心数据库、关键应用系统、高性能计算、大数据等业务提供卓越的计算性能以及数据安全。租户可灵活申请，按需使用。 裸金属服务器的开通是自助完成的，您只需要指定具体的服务器类型、镜像、所需要的网络配置等，即可在30min内获得所需的裸金属服务器。服务器供应、运维工作交由华为云，您可以专注于业务创新。

产品架构 通过和其他服务组合，裸金属服务器可以实现计算、存储、网络、镜像安装等功能： 裸金属服务器在不同可用区中部署（可用区之间通过内网连接），部分可用区发生故障后不会影响同一区域内的其他可用区。 可以通过虚拟私有云（Virtual Private Cloud，VPC）建立专属的网络环境，设置子网、安全组，并通过弹性公网IP实现外网链接（需带宽支持）。 通过 镜像服务 ，可以对裸金属服务器安装镜像，也可以通过私有镜像批量创建裸金属服务器，实现快速的业务部署。 通过云硬盘服务实现数据存储，并通过云硬盘备份服务实现数据的备份和恢复。 云监控 是保持裸金属服务器可靠性、可用性和性能的重要部分，通过云监控，用户可以观察裸金属服务器资源。 云备份提供对云硬盘和裸金属服务器的备份保护服务，支持基于快照技术的备份服务，并支持利用备份数据恢复服务器和磁盘的数据。 图1 BMS产品架构

x86 V5实例（CPU采用Intel Skylake架构） x86 V5实例已停止扩容。 通用型 提供均衡的计算、存储以及网络配置，支持挂载可弹性扩展的云硬盘，满足资源专享、网络隔离、性能有基本要求的业务场景，如数据库、核心ERP系统、金融系统等。 表1 通用型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.s4.medium 2*10 Core Intel Xeon Silver 4114 V5 (2.20 GHz) 128 DDR4 RAM (GB) 无 2 x 2*10GE + SDI卡 physical.s4.large 2*10 Core Intel Xeon Silver 4114 V5 (2.20 GHz) 192 DDR4 RAM (GB) 无 2 x 2*10GE + SDI卡 physical.s4.xlarge 2*14 Core Intel Xeon Gold 5120 V5 (2.20 GHz) 192 DDR4 RAM (GB) 无 2 x 2*10GE + SDI卡 physical.s4.2xlarge 2*14 Core Intel Xeon Gold 5120 V5 (2.20 GHz) 384 DDR4 RAM (GB) 无 2 x 2*10GE + SDI卡 physical.s4.3xlarge 2*22 Core Intel Xeon Gold 6161 V5 (2.20 GHz) 384 DDR4 RAM (GB) 无 2 x 2*10GE + SDI卡 本地存储型 系统盘和数据盘均使用本地磁盘，针对数据量大，对计算性能、稳定性、实时性等要求很高的业务场景，如大数据、分布式缓存等。 表2 本地存储型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.d2.tiny 2*10 Core Intel Xeon Silver 4114 V5 (2.20 GHz) 128 DDR4 RAM (GB) 2*600GB SAS System Disk RAID 1 + 12*1.8TB SAS 2 x 2*10GE physical.d2.large 2*12 Core Intel Xeon Gold 5118 V5 (2.30 GHz) 192 DDR4 RAM (GB) 2*600GB SAS System Disk RAID 1 + 12*10TB SATA 2 x 2*10GE physical.d2.xmedium 2*18 Intel Xeon Gold 6151 V5 (3.00 GHz) 384 DDR4 RAM (GB) 2*600GB SAS RAID 1 + 24*1.8TB SAS 2 x 2*10GE IO优化型 系统盘和数据盘均使用SSD。适用于高性能大数据、数据库等存储IO性能要求高的场景。 表3 IO优化型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.io2.xlarge 2*22 Core Intel Xeon Gold 6161 V5 (2.20 GHz) 12*32 DDR4 RAM (GB) 2*800GB SSD RAID 1 + 10 * 800GB SSD 2 x 2*10GE 高性能计算型 主要使用在受计算限制的高性能处理器的应用程序上。它需要更多处理器核数、大量的内存和高吞吐量的存储系统。该规格使用V5 CPU服务器，并结合IB网卡，适用于HPC高性能计算等场景。 表4 高性能计算型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.h2.large 2*18 Core Intel Xeon Gold 6151 V5 (3.00 GHz) 12*16 GB DDR4 1*1.6TB NVMe SSD Disk 1*100G IB + 2*10GE + SDI卡 physical.hc2.xlarge 2*18 Core Intel Xeon Gold 6151 V5 (3.00 GHz) 384 DDR4 RAM (GB) 无 2 x 2*10GE + SDI卡 内存一栏中，12*16 GB表示有12根同样容量的16GB的内存条，384 GB可能是混合的内存条，也可能是一根384GB的内存条。 GPU加速型 提供优秀的浮点计算能力，从容应对高实时、高并发的海量计算场景。特别适合于深度学习、科学计算、CAE、3D动画渲染、CAD等应用。 表5 GPU加速型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.p3.large 2*18 Core Intel Skylake 6151 V5 (3.00 GHz) 512 DDR4 RAM (GB) 2*1.2TB RAID 1 + 6*800GB NVMe SSD NIC：1*100G IB + 2*10GE + SDI卡 GPU：8*Tesla V100 显存：32G 父主题： 实例

实例类型 裸金属服务器按着CPU体系架构，分为x86和鲲鹏实例，物理资源池配备华为自研高性能物理服务器，搭配独家调优算法，为您提供可靠的硬件环境。您可以根据业务需求选购不同配置的裸金属服务器。 x86 V4实例（CPU采用Intel Broadwell架构）（停止扩容） x86 V5实例（CPU采用Intel Skylake架构）（停止扩容） x86 V6实例（CPU采用Intel Cascade Lake架构） 鲲鹏 V1实例（CPU采用Huawei Kunpeng 920架构）

计费项 计费项包括裸金属服务器、云硬盘（可选）、弹性公网IP（可选），详细说明如表1所示。 表1 计费项说明 计费项 计费说明 裸金属服务器 对您选择的裸金属服务器规格计费（包括CPU规格、内存容量、本地磁盘和扩展配置等）。 具体请参考裸金属服务器产品价格详情。 云硬盘（可选） 随裸金属服务器一起创建的云硬盘，计费方式与裸金属服务器相同。单独创建的云硬盘，支持按量付费和包年包月，具体请参考云硬盘产品价格详情。 弹性公网IP（可选） 裸金属服务器支持绑定弹性公网IP，按带宽或流量计费，具体请参考弹性公网IP产品价格详情。

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

x86 V6实例（CPU采用Intel Cascade Lake架构） 通用型 提供均衡的计算、存储以及网络配置，支持挂载可弹性扩展的云硬盘，满足资源专享、网络隔离、性能有基本要求的业务场景，如数据库、企业ERP系统、容器、大数据计算等。 表1 通用型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.c6s.3xlarge 2*26 Core Intel Cascade Lake 6278 V6 (2.60 GHz) 384 DDR4 RAM (GB) 无 SDI 3.0 (40GE) physical.c6sd.3xlarge 2*26 Core Intel Cascade Lake 6278 V6 (2.60 GHz) 384 DDR4 RAM (GB) 4*3.2TB NVMe SSD SDI 3.0 (40GE) 高性能计算型 采用Intel Cascade Lake CPU，满足多核高主频、低时延HPC的业务场景。 表2 高性能计算型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.h6.xlarge 2*22 Core Intel Cascade Lake 6266 V6 (3.00 GHz) 192 DDR4 RAM (GB) 无 100Ge RDMA(Mellanox)+ SDI 3.0 (40GE) GPU加速型 采用Intel Cascade Lake CPU、NVIDIA T4，满足AI推理和图形图像加速业务场景。 表3 GPU加速型规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 physical.pi6.3xlarge.6 2*26 Core Intel Cascade Lake 6278 V6 (2.60 GHz) 448 DDR4 RAM (GB) 2*480GB SATA SSD + 1.6TB NVMe SSD NIC：2*10GE(IN200) + 2*25GE(IN200) GPU：6*NVIDIA T4 父主题： 实例

高速网络 裸金属服务器的内部网络，为同一可用区内的裸金属服务器之间提供高带宽的网络。如果您需要部署高吞吐量或要求低时延的服务，可以创建高速网络。目前，裸金属服务支持的高速网络带宽的最大值为10Gbps。 增强高速网络基于上一代高速网络进行了软硬件的优化升级，为租户提供更强大的网络功能。 相比上一代高速网络，增强高速网络具有如下优势： 带宽提升至10GE及以上。 租户自定义网络平面数量，最多支持4K个子网。

虚拟私有云 虚拟私有云（Virtual Private Cloud，VPC），为裸金属服务器构建隔离的、用户自主配置和管理的虚拟网络环境，提升用户云中资源的安全性，简化用户的网络部署。您可以在VPC中定义安全组、VPN、IP地址段、带宽等网络特性。用户可以通过VPC方便地管理、配置内部网络，进行安全、快捷的网络变更。同时，用户可以自定义安全组内与组间的访问规则，加强裸金属服务器的安全保护。 更多信息，请参见《虚拟私有云产品介绍》。

自定义VLAN网络 未被系统默认使用的以太网卡（10GE，在裸金属服务器规格中定义）可用于自定义VLAN网络，物理上采用QinQ技术实现用户的网络隔离，提供额外的物理平面和网络带宽，用户能够自由划分所需的VLAN子网来分隔流量。自定义VLAN网络的网卡是成对出现的，用户可以通过配置bond实现高可用。自定义VLAN网络当前不支持跨AZ互通。 QinQ：一种基于802.1Q封装的二层隧道协议，它将用户私网VLAN TAG封装在公网VLAN TAG中，报文带着两层TAG穿越服务商的骨干网络，从而为用户提供二层VPN隧道。

IB网络 IB网络因其低延迟、高带宽的网络特性被用于很多高性能计算（High Performance Computing，HPC）项目，IB网络采用了100G Mellanox IB网卡，通过专用IB交换机和控制器软件UFM实现网络通信和管理。IB网络通过Partition Key实现网络隔离，不同租户的IB网络可通过不同的Partition Key来隔离，类似于以太网的vlan。 图2 IB网络隔离方式 UFM（Unified Fabric Manager）是IB网络上IB交换机控制器，基于OpenSM软件，提供北向服务接口。UFM采用主备部署方式。

修订记录 版本日期 变更说明 2022-11-15 第十五次正式发布。 新增： 责任共担 身份认证与访问控制 数据保护技术 审计与日志 监控安全风险 认证证书 2022-11-09 第十四次正式发布。 修改： 云硬盘，补充不支持挂载云硬盘的裸金属服务器规格说明。 2022-9-20 第十三次正式发布。 修改： 裸金属服务器类型与支持的操作系统版本，补充CentOS兼容性列表及相关说明。 2020-09-10 第十二次正式发布。 新增： x86 V6实例（CPU采用Intel Cascade Lake架构） 2020-06-30 第十一次正式发布。 将实例规格重新划分，新增x86 V4实例（CPU采用Intel Broadwell架构）、x86 V5实例（CPU采用Intel Skylake架构）、鲲鹏 V1实例章节。 2020-03-31 第十次正式发布。 新增： 计费说明 2020-01-20 第九次正式发布。 BMS权限管理，IAM控制台改版，修改权限相关描述。 2019-11-30 第八次正式发布。 新增： 包年/包月实例到期前后的影响及使用建议 2019-07-30 第七次正式发布。 大纲调整。 什么是裸金属服务器，补充常用概念、访问方式。 实例生命周期，修改生命周期表流程。 2019-05-30 第六次正式发布。 新增： 裸金属服务器类型与支持的操作系统版本 BMS权限管理 修改： 裸金属服务器与其他服务的关系、支持列表和使用限制，支持标签管理服务。 2019-04-16 第五次正式发布。 什么是裸金属服务器，补充内网带宽信息。 实例家族，补充RAID配置信息和GPU实例的显存信息。 2019-03-18 第四次正式发布。 大纲调整，并新增如下章节： 实例家族 实例生命周期 支持列表和使用限制 2018-09-14 第三次正式发布。 网络，增加IB网络说明。 2018-06-20 第二次正式发布。 云硬盘，增加云硬盘性能相关描述。 将“专属云”更名为“专属计算集群”。 2018-03-30 第一次正式发布。

鲲鹏 V1实例 鲲鹏型裸金属实例搭载鲲鹏920处理器，提供强劲鲲鹏算力和高性能网络，更好满足政府、互联网等各类企业对云上业务高性价比、安全可靠等诉求。 表1 鲲鹏实例规格详情 规格名称/ID CPU 内存 本地磁盘 扩展配置 是否基于擎天架构 physical.ks1.2xlarge 2*64 Core Kunpeng 920-6426 (2.60 GHz) 16*16 GB DDR4 960GB SAS SSD 2*25GE + 2*25GE 否 physical.ks1ne.2xlarge 2*64 Core Kunpeng 920-6426 (2.60 GHz) 16*16 GB DDR4 无 SDI 3.0 (40GE) 是 physical.ks1ne.4xlarge 2*64 Core Kunpeng 920-6426 (2.60 GHz) 16*32 GB DDR4 2*3.2TB NVMe SSD SDI 3.0 (40GE) 是 physical.ks1ne.8xlarge 2*64 Core Kunpeng 920-6426 (2.60 GHz) 32*32 GB DDR4 2*3.2TB NVMe SSD SDI 3.0 (40GE) 是 physical.kh1ne.2xlarge 2*64 Core Kunpeng 920-6426 (2.60 GHz) 16*16 GB DDR4 960GB SAS SSD 1*100G RDMA(Mellanox)+ SDI 3.0 (40GE) 是 父主题： 实例

云硬盘类型 裸金属服务器使用的云硬盘类型有如下几种： 普通IO（上一代产品）：该类型云硬盘的最大IOPS为2200，适用于大容量、读写速率中等、事务性处理较少的应用场景，例如企业的日常办公应用或者小型测试等。 高IO：该类型云硬盘的最大IOPS可达5000，最低读写时延为1ms，适用于主流的高性能、高可靠应用场景，例如企业应用、大型开发测试以及Web服务器日志等。 超高IO：该类型云硬盘的最大IOPS可达33000，最低读写时延为1ms，适用于超高IO，超大带宽的读写密集型应用场景，例如高性能计算应用场景，用来部署分布式文件系统，或者I/O密集型应用场景，用来部署各类NoSQL/关系型数据库。 通用型SSD：该类型云硬盘的最大IOPS可达20000，最低读写时延为1ms，适用于各种主流的高性能、低延迟交互应用场景，例如企业办公、大型开发测试、转码类业务、Web服务器日志以及容器等高性能系统盘。 极速型SSD：该类型云硬盘的最大IOPS可达128000，最低读写时延为亚毫秒级，采用了结合全新低时延拥塞控制算法的RDMA技术，适用于需要超大带宽和超低时延的应用场景。 当前physical.d2.large和physical.io2.xlarge规格为本地存储型（大数据）机型，不支持挂载云硬盘。

云硬盘的磁盘模式 裸金属服务器当前仅支持S CS I（小型计算机系统接口，Small Computer System Interface）磁盘模式的云硬盘。 您可以通过管理控制台创建SCSI类型的云硬盘，该类型的云硬盘支持SCSI指令透传，允许裸金属服务器操作系统直接访问底层存储介质。除了简单的SCSI读写命令，SCSI类型的云硬盘还可以支持更高级的SCSI命令。 裸金属服务器公共镜像的操作系统中已经预安装了使用SCSI类型云硬盘所需的驱动，无需再安装。您也可以参考《裸金属服务器私有镜像制作指南》的“安装SDI卡驱动”章节了解驱动安装的详细操作。