华为云用户手册

URI GET /v1.0/{project_id}/asset/info 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 asset_id 否 Array 媒资id，最多同时查询10个媒资。 status 否 Array 媒资状态。 取值如下： UNCREATED：未创建（媒资ID不存在 ） DELETED：已删除 CANCELLED：上传取消 SERVER_ERROR：上传失败（点播服务端故障） UPLOAD_FAILED：上传失败（向OBS上传失败） CREATING：创建中 PUBLISHED：已发布 TRANSCODING：待发布（转码中） TRANSCODE_FAILED：待发布（转码失败） TRANSCODE_SUCCEED：待发布（转码成功） CREATED：待发布（未转码） transcodeStatus 否 Array 转码状态 取值如下： TRANSCODING：转码中 TRANSCODE_FAILED：转码失败 TRANSCODE_SUCCEED：转码成功 UN_TRANSCODE：未转码 WAITING_TRANSCODE：等待转码 assetStatus 否 Array 媒资状态。 取值如下： PUBLISHED：已发布 CREATED：未发布 start_time 否 String 起始时间，查询指定“asset_id”时，该参数无效。 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。 end_time 否 String 结束时间，查询指定“asset_id”时，该参数无效。 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。 category_id 否 Integer 分类ID。 tags 否 String 媒资标签。 单个标签不超过16个字节，最多不超过16个标签。 多个用逗号分隔，UTF8编码。 query_string 否 String 在媒资标题、描述中模糊查询的字符串。 page 否 Integer 分页编号，查询指定“asset_id”时，该参数无效。 默认值：0。 size 否 Integer 每页记录数，查询指定“asset_id”时，该参数无效。 取值范围：[1,100]。 默认值：10。

响应示例 状态码： 200 处理成功返回。 { "asset_info_array" : [ { "asset_id" : "652c1e4085afeb22fdc256c6757d751b", "status" : "PUBLISHED", "description" : "Asset meta is published", "is_multi_transcode" : false, "base_info" : { "title" : "okFLV.flv", "video_name" : "okFLV.flv", "description" : null, "category_id" : -1, "category_name" : "其他", "create_time" : "20190704144303", "last_modified" : "20190704144303", "video_type" : "FLV", "tags" : null, "meta_data" : { "pack_type" : null, "codec" : "H.264", "duration" : 244, "video_size" : 13682041, "width" : 512, "hight" : 288, "height" : 288, "bit_rate" : 448, "frame_rate" : 30, "quality" : null }, "video_url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/45c2493abe68de3dac7e98b0dadcf8ce.flv", "sign_url" : "", "cover_info_array" : [ { "cover_url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/cover/Cover0.jpg" } ], "subtitle_info" : [ ], "source_path" : { "bucket" : "obs-host", "location" : "cn-north-4", "object" : "1/okFLV.flv" }, "output_path" : { "bucket" : "obs-host", "location" : "cn-north-4", "object" : "output/652c1e4085afeb22fdc256c6757d751b/" } }, "play_info_array" : [ { "play_type" : "hls", "url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/play_video/index.m3u8", "encrypted" : 0, "meta_data" : { "pack_type" : null, "codec" : "H.264", "duration" : 0, "video_size" : 0, "width" : 0, "hight" : 0, "height" : 0, "bit_rate" : 0, "frame_rate" : 0, "quality" : null } }, { "play_type" : "hls", "url" : "https://651.cdn-vod.huaweicloud.com/asset/652c1e4085afeb22fdc256c6757d751b/play_video/b5d498082bbcff7a2055041d803ae2f9_1.m3u8", "encrypted" : 0, "meta_data" : { "pack_type" : null, "codec" : "H.264", "duration" : 205, "video_size" : 14669824, "width" : 512, "hight" : 288, "height" : 288, "bit_rate" : 534, "frame_rate" : 0, "quality" : null } } ] } ], "is_truncated" : 0, "total" : 1 } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

请求示例 单媒资ID查询 GET /v1.0/{project_id}/asset/info?asset_id=652c1e4085afeb22fdc256c6757d751b 多媒资ID查询 GET /v1.0/{project_id}/asset/info?asset_id=652c1e4085afeb22fdc256c6757d751b&asset_id=xxxxxx&asset_id=xxxxxx 按时间段查询 GET /v1.0/{project_id}/asset/info?start_time=20170725181000&end_time=20170726181000&page=0&size=20 查询（当前租户下）所有媒资：最近创建的10个，page为默认值0，size为默认值10 GET /v1.0/{project_id}/asset/info 查询（当前租户下）所有媒资：最近创建的第21个到第40个 GET /v1.0/{project_id}/asset/info?page=1&size=20 按分类查询 GET /v1.0/{project_id}/asset/info?category_id=100

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

响应参数 状态码： 202 表4 响应Body参数 参数 参数类型 描述 preheating_results Array of PreheatingResult objects 预热任务数组 表5 PreheatingResult 参数 参数类型 描述 url String 媒资URL。 status String 预热任务状态。 取值如下： processing：处理中 succeed：预热完成 failed：预热失败 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

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

响应示例 状态码： 202 处理成功返回。 { "preheating_results" : [ { "url" : "https://example.com/asset/9db42f5e08c15edecd99a98da241994a/313bfd52a75f95ff48e8bf02eca2ab20.flv", "status" : "processing" }, { "url" : "https://example.com/asset/9e455adb02295aa123809e8dc7ca51c1/68b1241af3bf58bcde9914626e07f5af.mp4", "status" : "succeed" }, { "url" : "https://example.com/asset/9e455adb02295aa123809e8dc7ca51c1/play_video/68b1241af3bf58bcde9914626e07f5af_H.264_480X270_HEAACV1_300.mp4", "status" : "failed" } ] } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 start_time String 统计起始时间。 interval Integer 统计间隔。 sample_data Array of VodSampleData objects 采样数据数组。从start_time开始，每个间隔对应一个采样数据（其中转码时长单位：min，存储单位：GB）。 表5 VodSampleData 参数 参数类型 描述 storage Float 存储空间。 单位：GB。 transcode Long 转码时长。 单位：秒。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 200 处理成功返回。 { "start_time" : "20190528000000", "interval" : 3600, "sample_data" : [ { "storage" : 0, "transcode" : 0 } ] } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

URI GET /v1.0/{project_id}/asset/vod-statistics 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 start_time 否 String 起始时间，格式为yyyymmddhhmmss。 end_time 否 String 结束时间，格式为yyyymmddhhmmss。 “start_time”、“end_time”均不存在时，“start_time”取当天零点，“end_time”取当前时间。 “start_time”不存在、“end_time”存在，请求非法。 “start_time”存在、“end_time”不存在，“end_time”取当前时间。 只能查询最近三个月内的数据，且时间跨度不能超过31天。 起始时间和结束时间会自动规整，起始时间规整为指定时间所在的整点时刻，结束时间规整为指定时间所在时间的下一小时整点时刻。 interval 否 Integer 查询粒度间隔。 取值如下： 时间跨度1天：1小时、4小时、8小时，分别对应3600秒、14400秒和28800秒。 时间跨度2~7天：1小时、4小时、8小时、1天，分别对应3600秒、14400秒、28800秒和86400秒。 时间跨度8~31天：4小时、8小时、1天，分别对应14400秒、28800秒和86400秒。 单位：秒。 若不设置，默认取对应时间跨度的最小间隔。

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 媒资总数 说明： 暂只能统计2万个媒资，若您需要查询具体的媒资总数，请提交工单申请。 assets Array of AssetSummary objects 媒资列表 表5 AssetSummary 参数 参数类型 描述 asset_id String VOD分配的媒资ID，仅支持查询，不支持修改。 title String 媒资标题。长度不超过128个字节，UTF-8编码。 description String 媒资描述。长度不超过1024个字节。 duration Integer 媒资时长。 单位：秒。 size Long 媒资大小。 单位：字节。 original_url String 原始播放url。 category String 媒资分类名称。 covers Array of CoverInfo objects 封面信息。 create_time String 媒资创建时间。 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间。 asset_status String 媒资状态。 取值如下： CREATING：上传中。 FAILED：上传失败。 CREATED：上传成功。 PUBLISHED：已发布。 DELETED：已删除。 transcode_status String 转码状态。 取值如下： UN_TRANSCODE：未转码。 WAITING_TRANSCODE：待转码 TRANSCODING：转码中。 TRANSCODE_SUCCEED：转码成功。 TRANSCODE_FAILED：转码失败。 thumbnail_status String 截图状态。 取值如下： UN_THUMBNAIL：未截图。 THUMBNAILING：截图中。 THUMBNAIL_SUCCEED：截图成功。 THUMBNAIL_FAILED：截图失败。 review_status String 内容审核状态 取值如下： UN_REVIEW：未审核。 REVIEWING：审核中。 REVIEW_SUSPICIOUS：审核可疑，需要人工复审。 REVIEW_PASSED：审核通过。 REVIEW_FAILED：审核失败。 REVIEW_BLOCKED：已屏蔽。 exec_desc String 媒资的任务执行描述汇总。 示例： asset_exec_desc: upload success，媒资任务执行描述信息。 transcode_exec_desc: transcode success，转码任务执行描述信息。 thumbnail_exec_desc: thumbnail failed，截图任务执行描述信息。 review_exec_desc: review pass，审核任务执行描述信息。 media_type String 音视频文件的格式。 取值如下： 视频文件格式：MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG 音频文件格式：MP3、OGG、WAV、WMA、APE、FLAC、AAC、AC3、MMF、AMR、M4A、M4R、WV、MP2 表6 CoverInfo 参数 参数类型 描述 cover_url String 封面文件的下载地址。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

响应示例 状态码： 200 处理成功返回。 { "total" : 1, "assets" : [ { "asset_id" : "67d1470893419bfcb9663103dd8a66ac", "title" : "video.mp4", "duration" : 60, "size" : 12881945, "category" : "其他", "covers" : [ { "cover_url" : "https://355.cdn-vod.huaweicloud.com/asset/67d1470893419bfcb9663103dd8a66ac/cover/Cover0.jpg" } ], "create_time" : "20190625020756", "asset_status" : "PUBLISHED", "transcode_status" : "TRANSCODE_SUCCEED", "thumbnail_status" : "UN_THUMBNAIL", "review_status" : "UN_REVIEW", "exec_desc" : "asset_exec_desc:Asset meta is\npublished;transcode_exec_desc:Transcode success;", "media_type" : "MP4" } ] } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

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

URI GET /v1.0/{project_id}/asset/list 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，获取方法请参考获取项目ID 表2 Query参数 参数 是否必选 参数类型 描述 asset_id 否 Array 媒资ID，最多同时查询10个。 status 否 Array 媒资状态，同时查询多个状态的媒资。 取值如下： CREATING：上传中 FAILED：上传失败 CREATED：上传成功 PUBLISHED：已发布 TRANSCODING：转码中 TRANSCODE_SUCCEED：转码成功 TRANSCODE_FAILED：转码失败 THUMBNAILING：截图中 THUMBNAIL_SUCCEED：截图成功 THUMBNAIL_FAILED：截图失败 UN_REVIEW：未审核 REVIEWING：审核中 REVIEW_SUSPICIOUS ：审核不过，待人工复审 REVIEW_PASSED：审核通过 REVIEW_FAILED：审核任务失败 REVIEW_BLOCKED：已屏蔽 start_time 否 String 起始时间。 格式为yyyymmddhhm mss。必须是与时区无关的UTC时间。 end_time 否 String 结束时间。 格式为yyyymmddhhm mss。必须是与时区无关的UTC时间。 category_id 否 Integer 分类ID。 tags 否 String 媒资标签。 单个标签不超过16个字节， 最多不超过16 个标签。 多个用英文逗号分隔，UTF8编码。 query_string 否 String 在媒资标题、 描述、分类名称中模糊查询的字符串。 media_type 否 Array 音视频文件的格式，支持多格式查询，最多不超过20个。 取值如下： 视频文件格式：MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG 音频文件格式：MP3、OGG、WAV、WMA、APE、FLAC、AAC、AC3、MMF、AMR、M4A、M4R、WV、MP2 page 否 Integer 分页编号。 默认值：0。 size 否 Integer 每页记录数。 取值范围：[1,100]。 默认值：10。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 记录总数 summary_results Array of AssetDailySummaryResult objects 日志文件列表 表5 AssetDailySummaryResult 参数 参数类型 描述 date String 播放日期，格式为：yyyyMMdd000000。 link String 日播放统计数据文件的下载地址，有效期为12个小时。 文件内容格式：[域名]\t[媒资ID]\t[日期]\t[播放流量]\t[播放次数] 播放次数统计说明： HLS文件：访问M3U8文件时会统计播放次数，访问TS文件时不会统计播放次数。 其它文件：如MP4文件，当播放请求带有range且range的start参数不等于0时，不统计播放次数。其它情况下，会统计播放次数。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

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

响应示例 状态码： 200 处理成功返回。 { "total" : 1, "summary_results" : [ { "date" : "20231201000000", "link" : "http://cdn-log-user-bj4.obs.cn-north-4.myhuaweicloud.com:80/asset-play-summary/05a8aee14d8026a92fcdc018fe235c2c/20231201-asset-play-summary.gz?AccessKeyId=QXBNBGA2GW9EP2XXOYUN&Expires=1701786544&Signature=fJjkLLU1IBeTwANC0U0wUZuzd%2F8%3D" } ] } 状态码： 400 处理失败返回。 { "error_code" : "VOD.10053", "error_msg" : "The request parameter is illegal, illegal field: {xx}." }

URI GET /v1/{project_id}/asset/daily-summary 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID 表2 Query参数 参数 是否必选 参数类型 描述 start_time 是 String 查询开始时间。仅支持查询一年内的数据，且一次查询的日期跨度不能超过90天。 如果查询指定开始日期的数据，格式为：yyyyMMdd000000。 end_time 是 String 查询结束时间。仅支持查询一年内的数据，且一次查询的日期跨度不能超过90天。 如果查询指定结束日期的数据，格式为：yyyyMMdd000000。 offset 否 Integer 偏移量，表示查询该偏移量后面的记录。 limit 否 Integer 查询返回记录的数量限制。

getScreenShareSources virtual IHRTCScreenShareSourceList* getScreenShareSources(HRTCScreenShareIconType type) 【功能说明】 获取屏幕可共享对象列表。 【请求参数】 type：屏幕捕获图像类型，具体请参见HRTCScreenShareIconType。 【返回参数】 共享屏幕窗口对象列表，具体请参见共享屏幕资源管理。

客户端错误码 本章节介绍了Web SDK的客户端错误码RtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因或建议处理方式 RTC_ERR_CODE_SUCCESS 0 success 成功。 RTC_ERR_CODE_RTC_SDK_ERROR 90000001 sdk internal error SDK内部错误，联系华为工程师。 RTC_ERR_CODE_WAIT_RSP_TIMEOUT 90000004 message response timeout 消息响应超时，联系华为工程师。 RTC_ERR_CODE_INVALID_PARAMETER 90000005 invalid parameter 参数传递错误，请参照API文档排查。 RTC_ERR_CODE_INVALID_OPERATION 90100001 illegal operation 非法操作，用户状态不正确。 RTC_ERR_CODE_NOT_SUPPORT_MEDIA_DEVICES 90100002 not support enumerate devices 浏览器不支持enumerateDevices方法。 RTC_ERR_CODE_NO_AVAILABLE_DEVICES 90100003 no available devices 没有找到可用设备，请排查设备是否就绪。 RTC_ERR_CODE_NO_AVAILABLE_VIDEO_INPUT_DEVICES 90100004 no available video input devices 没有找到可用摄像头设备，请排查视频采集设备是否就绪。 RTC_ERR_CODE_NO_AVAILABLE_AUDIO_INPUT_DEVICES 90100005 no available audio input devices 没有找到音频输入设备，请排查音频采集设备是否就绪。 RTC_ERR_CODE_NO_AVAILABLE_AUDIO_OUTPUT_DEVICES 90100006 no available audio output devices 没有找到音频输出设备。 RTC_ERR_CODE_STATUS_ERROR 90100007 room status error 房间状态不正确，检查是否入会成功。 RTC_ERR_CODE_WEBSOCKET_NOT_CONNECTED 90100008 websocket connection state is not "CONNECTED" websocket 链接未成功，检查链接情况。 RTC_ERR_CODE_WAIT_CONFIG_FAIL 90100009 wait server config fail 获取下发配置失败，请联系华为工程师。 RTC_ERR_CODE_PUBLISH_RESPONSE_FAIL 90100010 publish response fail 发布流响应失败，请联系华为工程师。 RTC_ERR_CODE_REGION_NOT_COVERED 90100011 current region is not covered, service unavailable 没有找到服务端地址，请联系华为工程师。 RTC_ERR_CODE_WEBSOCKET_CONNECT_TIMEOUT 90100012 websocket connect timeout websocket建链超时，请联系华为工程师。 RTC_ERR_CODE_WEBSOCKET_RECONNECT_TIMEOUT 90100013 websocket reconnect timeout websocket重连超时，请联系华为工程师。 RTC_ERR_CODE_WEBSOCKET_NOT_OPEN 90100014 websocket is not open websocket链接未打开，请联系华为工程师。 RTC_ERR_CODE_WEBSOCKET_INTERRUPTED 90100015 websocket connection state is idle, interrupt operation websocket链接被强制关闭，一般为离会或者重连。 RTC_ERR_CODE_WEBSOCKET_CONNECT_ERROR 90100016 websocket connect error websocket监听onerror，服务端主动断链。 RTC_ERR_CODE_CAPTURE_PERMISSION_DENIED 90100017 capture failed, permission denied 采集失败，音视频设备采集权限未被授权。建议提示用户授权摄像头/麦克风访问权限。 RTC_ERR_CODE_CAPTURE_OVER_CONSTRAINED 90100018 capture failed, Constraint parameter invalid 采集失败，音视频采集设备不支持设置的采集约束。 RTC_ERR_CODE_CAPTURE_DEVICE_NOT_FOUND 90100019 capture failed, requested device not found 采集失败，设备未找到。建议在通话开始前引导用户检查通话所需的摄像头或麦克风等设备是够就绪。 RTC_ERR_CODE_CAPTURE_DEVICE_NOT_READABLE 90100020 capture failed, maybe device is occupied by other application 采集失败，设备被占用，请检查使用状态。建议提示用户“暂时无法访问摄像头/麦克风，请确保当前没有其他应用请求访问摄像头/麦克风，并重试”。 RTC_ERR_CODE_PLAY_NOT_ALLOW 90100021 the user didn't interact with the document first, please trigger by gesture 不允许播放。 RTC_ERR_CODE_ROLE_NO_PERMISSION 90100022 the user role have no permission to operate 用户角色没有权限，请检查用户角色。 RTC_ERR_CODE_ANSWER_SDP_INVALID 90100023 the answer sdp is invalid SDP协商错误，请联系华为工程师。 RTC_ERR_CODE_MEDIA_UPSTREAM_UNSUPPORTED 90100024 the upstream media is not supported 浏览器不支持媒体采集。 RTC_ERR_CODE_MEDIA_NETWORK_ERROR 90100026 media connection establish failed, please switch network or try again later 媒体建链失败，请切换网络重试。 RTC_ERR_CODE_CLIENT_RELAY_ROOM_OVER_MAXNUM 90100027 relay room number over maxium number 跨房数量超过最大值。 RTC_ERR_CODE_CLIENT_RELAY_JOINER_OVER_MAXNUM 90100028 joiner already exist in relay rooms 跨房内主播人数超过最大值。 RTC_ERR_CODE_ROOM_STREAM_STATUS_PAUSED 90100029 room stream status paused 房间音视频暂停。 RTC_ERR_CODE_SIGNATURE_EXPIRED 90100030 signature expired 签名过期。 RTC_ERR_CODE_SIGNATURE_INVALID 90100031 signature invalid 签名非法。 RTC_ERR_CODE_RTC_ACS 90100100 server internal exception 服务端内部错误，请联系华为工程师。 RTC_ERR_CODE_RTC_CONTROL_ERROR 90100200 server internal exception 服务端内部错误，请联系华为工程师。 RTC_ERR_CODE_SFU_ERROR 90100300 server internal exception 服务端内部错误，请联系华为工程师。 父主题： 接口参考

步骤二：纳管VPC 在“VPC纳管”页面，单击“纳管”。 配置VPC纳管参数，配置参数如表2所示，配置完成后，单击“确定”。 纳管后该VPC会显示在VPC列表中。 表2 VPC纳管参数说明 参数名称 参数说明 HWS 账号 选择需要纳管的VPC所属的华为云账号。 HWS 区域 选择需要纳管的VPC所在的区域。 VPC名称 选择需要纳管的VPC。 终端节点子网 选择为需要纳管的VPC创建终端节点的子网。 说明： 如果该VPC下存在多个子网，其他子网需要与该子网保持网络互通。

修订记录 发布日期 修改记录 2024-04-15 第十一次正式发布。 优化： 跨云跨VPC线上线下统一运维最佳实践补充加密协议说明。 2023-05-11 第十次正式发布。 优化变更前必读章节描述，添加堡垒机支持变更的规格。 2022-10-31 第九次正式发布。 云堡垒机等保最佳实践 跨云跨VPC线上线下统一运维最佳实践 如何使用堡垒机对安全事故进行事后追溯 2021-11-03 第八次正式发布。 资料优化。 2021-07-15 第七次正式发布。 原基础版更名为标准版，增强版更名为专业版。 2021-07-05 第六次正式发布。 本次更新说明如下： 修改了变更版本规格，入口修改。 2021-01-25 第五次正式发布。 本次更新说明如下： 修改了扩容前必读，新增1000资产规格。 2020-08-07 第四次正式发布。 本次更新说明如下： 修改了扩容前必读，新增500资产规格。 2020-06-05 第三次正式发布。 本次更新说明如下： 修改了扩容云堡垒机规格，按照变更规格前中后提供操作和说明指导。 2020-03-27 第二次正式发布。 本次更新说明如下： 新增了数据库运维高危操作的复核审批。 2019-07-02 第一次正式发布。 本次更新说明如下： 新增了升级云堡垒机规格。

设置代理服务器 在需要对跨网络域的服务器进行管理运维前，需要在对端网络域中配置一台网络代理服务器。将该代理服务器与业务服务器通过内网进行互通，再将代理服务器到云堡垒机网络进行互通，即可完成云堡垒机到业务服务器之间跨域的网络互联。 该部分操作是达成堡垒机跨域纳管主机资源的前提。 为代理服务器启用网络代理服务 登录代理服务器，进行代理服务器（3proxy）设置。 步骤二至步骤四中的命令，均已CentOS7为例。如需CentOS8代码示例，请参见CentOS8配置代理示例。 上传3proxy压缩包并解压后，进入对应目录执行以下命令： bash install.sh 输入如下命令，添加3proxy用户 /etc/3proxy/add3proxyuser.sh myuser mypassword 重启代理服务3proxy systemctl restart 3proxy socks5代理协议（端口：1080）没有加密功能，若通过代理服务器运维使用了非加密的协议类型，请务必在安全组设置中禁止非必要的IP访问。 如果需要加密传输或数据安全的考量，在选择出入方向规则时建议选择有加密的协议类型：SSH、RDP、SFTP、SCP、Rlogin。 为代理服务器配置安全组规则 进行代理服务器入方向规则配置，允许堡垒机访问代理服务器，协议端口及源地址填写规则请见图2。 图2 入方向规则配置 在“协议端口”中填写socks5代理服务器默认的“1080”端口。 在“源地址”中填写堡垒机的IP地址。 进行代理服务器出方向规则配置，允许代理服务器访问待纳管的业务服务器，源地址填写规则请见图3。 图3 出方向规则配置

CentOS8配置代理示例 执行如下命令，安装3proxy软件包 yum install -y epel-release yum install -y 3proxy 执行如下命令，进行极简配置 nscache 65536 timeouts 1 5 30 60 180 1800 15 60 #设置用户名：在users指令后输入您需要设置的用户名，本章节以test为例 密码：在CL指令后输入您需要设置的用户名，本章节以test为例。 users test:CL:test daemon log /var/log/3proxy/3proxy.log logformat "- +_L%t.%. %N.%p %E %U %C:%c %R:%r %O %I %h %T" archiver gz /bin/gzip %F rotate 30 external 0.0.0.0 internal 0.0.0.0 auth strong allow test maxconn 20 socks flush 启动服务 systemctl start 3proxy

背景信息 病毒文件是指终端上的病毒文件，包括木马病毒、灰色软件等，会破坏用户文件、影响系统运行。 租户需要对“未处置”病毒威胁事件进行处置，处置方法包括“快速处置”和“标记状态”。 快速处置：使用系统推荐的快速处置方式，租户需核实确认并进行处置下发。处置过程中病毒文件事件显示为“处置中”，处置成功则返回状态“处置成功”，处置失败则返回状态“处置失败”。 标记状态：租户可手动对病毒文件事件进行标记，标记后处置状态分别显示为“忽略”、“已人工处置”。

代维方式介绍 MSP（Managed Service Provider，管理服务供应商），一般是指为普通租户提供网络部署、管理、安全检测、安全防御以及运维等一系列工作的机构。MSP通常具备较为专业的业务管理和维护能力。 当普通租户购买华为乾坤后，发现本身不具备完备的网络建设、业务管理、安全运维能力时，可以委托专业的MSP管理，以降低企业人力和资金的投入。租户委托MSP后，MSP可以对委托业务进行日常状态管理、定期巡检，发现并处理业务运行中存在的异常和问题，同时给出风险评估和事件处置方法。 一个租户帐号可与多个MSP帐号建立委托关系，一个MSP帐号可代维多个租户帐号下的服务。 MSP支持以下两种代维方式： 以租户维度进行代维：MSP直接以租户身份进入租户页面进行操作。 以服务维度进行代维：MSP对单服务下所有代维租户进行管理和操作。 边界防护与响应服务的代维既支持按租户维度代维，也支持按服务维度代维。 父主题： MSP代维指导

连接业务线缆（USG67xxF） 图2以USG6710F为例，USG67xxF可参照该图连线。USG67xxF只支持光接口，请使用光纤连接光接口。 图2 USG6710F连接业务线缆 表2 接口使用说明 接口丝印 接口编号 说明 0 100GE0/0/0 业务下行口，为三层口，连接局域网交换机，此处以100GE0/0/0为例。 1 100GE0/0/1 业务上行口，为三层口，连接互联网，此处以100GE0/0/1为例。 MGMT MEth0/0/0 设备管理网口，连接管理PC，用于登录设备的配置界面进行业务配置。默认IP地址为192.168.0.1。

连接业务线缆（USG65xxF、USG66xxF、USG6000F-Exx） 图1以USG6615F为例，USG65xxF、USG66xxF、USG6000F-Exx可参照该图连线。 图1 USG6615F连接业务线缆 表1 接口使用说明 接口丝印 接口编号 说明 6 GE0/0/6 业务下行口，为三层口，连接局域网交换机，此处以GE0/0/6为例。 7 GE0/0/7 业务上行口，为三层口，连接互联网，此处以GE0/0/7为例。 MGMT MEth0/0/0 设备管理网口，连接管理PC，用于登录设备的配置界面进行业务配置。默认IP地址为192.168.0.1。 说明： USG6510F-D、USG6510F-DK、USG6510F-DL、USG6530F-D、USG6530F-DL、USG6307F-D、USG6311F-D、USG6331F-D使用GE0/0/0作为设备管理网口。

背景信息 域名黑名单是一种阻断措施，华为乾坤将域名黑名单下发给设备后，内部资产将不能访问黑名单中的恶意域名。 一般情况下，华为乾坤对威胁事件进行智能分析后，自动下发域名黑名单。此外，用户还可以根据实际的网络环境或业务需要，从设备维度（针对某设备）手动下发域名黑名单，作为上述域名黑名单下发的补充手段，以提高安全防护的灵活性。 USG6000F-C天关、USG6000F防火墙、USG12000防火墙从V600R023C10支持下发域名黑名单功能。 高等级租户享有对自身及下级租户的域名黑名单的创建、修改、删除权限。