华为云用户手册

  • 固定微站监测 图1 固定监测站点 通过单击导航栏的【大气监测】,选择子菜单【固定监测站点】,进入固定微站监测。 页面左侧信息栏勾选站点类型、网格风场和站点警告。单击【监测指标】和【数据标记】进行选择。 页面底部可以进行管控区域的选择,包括“重点管控区域”、“大运会场馆”、“大运会场馆重点管控区(1KM)”、“大运会场馆重点缓冲区(1KM)”。单击时间轴的【天】和【时】的按钮进行或者时间控件来进行截止时间的选择,或者单击【最新】按钮,选择当前的时间。 页面右侧可以进行【连续模式】和【分段模式】的选择。单击地图缩放控件,进行地图放大或者缩小。单击【站点空气质量排名】展示站点空气质量排名情况,包括“排序方式”、“监测指标”、“序号”、“站点类型”、“站点编号”和“指标数值”。
  • 移动微站监测 图2 实时混合监测 通过单击导航栏的【大气监测】,选择子菜单【实时混合监测】,进入移动微站监测。 页面左侧信息栏勾选固定站点类型、移动站点类型和气象站点。单击【监测指标】和【数据标记】进行选择。 页面底部可以进行管控区域的选择,包括“重点管控区域”、“大运会场馆”、“大运会场馆重点管控区(1KM)”、“大运会场馆重点缓冲区(1KM)”。 页面右侧可以进行【连续模式】和【分段模式】的选择。单击地图缩放控件,进行地图放大或者缩小。
  • TVOC 监测 图3 TVOC 监测 通过单击导航栏的【大气监测】,选择子菜单【TVOC 监测】,进入TVOC 监测。 页面左侧单击【监测指标】和【数据标记】进行选择。 页面底部单击时间轴的【天】和【时】的按钮进行或者时间控件来进行截止时间的选择,或者单击【最新】按钮,选择当前的时间。 页面右侧可以进行【连续模式】和【分段模式】的选择。单击地图缩放控件,进行地图放大或者缩小。单击【站点空气质量排名】展示站点空气质量排名情况,包括“排序方式”、“监测指标”、“序号”、“站点类型”、“站点编号”和“指标数值”。
  • 监测回放 图4 监测回放 通过单击导航栏的【大气监测】,选择子菜单【混合监测回放】,进入监测数据回放。 页面左侧信息栏选择固定站点类型、移动站点类型、气象站点、监测指标、回溯开始起始时间、数据缓存时长、播放速度和车辆选择。 页面底部单击时间轴的【天】和【时】的按钮进行或者时间控件来进行截止时间的选择,或者单击【最新】按钮,选择当前的时间。 页面右侧可以进行【连续模式】和【分段模式】的选择。单击地图缩放控件,进行地图放大或者缩小。
  • 资源和成本规划 表1 资源和成本规划 云资源 规格 数量 每月费用(元) 弹性云服务器ECS-Nginx集群 鲲鹏通用计算增强型 | 4vCPUs | 8GiB | kc1.xlarge.2 | 磁盘200GB 1 7720 弹性云服务器ECS-堡垒机 鲲鹏通用计算增强型 | 4vCPUs | 8GiB | kc1.xlarge.2 | 磁盘200GB 1 3860 弹性云服务器ECS-算法集群 鲲鹏通用计算增强型 | 16vCPUs | 32GiB | kc1.4xlarge.2 | 磁盘500GB 1 91800 弹性云服务器ECS-CCE node 鲲鹏通用计算增强型|kc1.2xlarge.4|8vCPUs|32GB|linux | 磁盘300GB 1 41000 对象存储服务OBS 存储包2TB 1 2304 容器引擎CCE 50 节点 1 12624 云数据库RDS rds.mysql.n1.2xlarge.4.ha | 8 vCPUs | 32 GB (通用型) | 存储1200GB 1 39200 SSL证书 OV | GeoTrust 1 6040.74 MapReduce服务MRS Mapreduce服务集群 鲲鹏通用计算增强型|kc1.4xlarge.4|16vCPUs|64GB|linux | 磁盘600GB * 8节点 1 218240 分布式消息服务RocketMQ版本 rocketmq.4u8g.cluster.small * 1 broker 1 40800 分布式缓存服务Redis(DCS) 8 GB | 副本数:2 1 3841.6 文档数据库服务DDS 8 vCPUs | 16GB | 磁盘700GB * 3节点 1 83636.92 GaussDB(for MySQL) gaussdb.mysql.8xlarge.x86.4 | 32 vCPUs | 128 GB | 存储2600GB 1 240320 分布式消息服务Kafka kafka.4u8g.cluster * 3 broker 1 40800 云防火墙CFW 云防火墙标准版 1 28000 Web应用防火墙WAF 基础套餐|标准版 1 38800 漏洞扫描VSS 专业版 1 4380 威胁检测MTD 初级包 1 99.46 主机安全 专业版 1 176400 弹性负载均衡ELB 按需计费 | 共享型-性能保障模式 1 25228.8 弹性公网IP地址 按需计费 1 21900
  • 产品优势 兼容开放 支持各类开源协议低门槛接入,开放了运营、运维数据查询接口和采集标准,提供全托管、免运维、低成本的云原生监控能力。 开箱即用 无需修改业务代码即可接入使用, 非侵入式数据采集,安全无忧。 丰富的数据源 融合云监控、云日志、应用性能、真实用户体验、后台链接数据等多维度可观测性数据源。 全栈一体化监控 覆盖用户端、服务端及云产品所有监控数据,提供从数据发现、数据展示到数据异常告警的全方位、可视化监控服务,实现从上到下、从前端到后端的全栈一体化监控。 关联分析 应用和资源层层自动关联,通过应用、组件、实例、主机和事务等多视角下钻分析指标、日志、告警数据,直击异常。 精准告警 构建指标告警、事件告警、日志告警的统一告警体系,提供分组、抑制和静默等告警降噪策略,结合告警通知和订阅等功能,帮助用户从容应对海量告警风暴,快速检测和修复业务告警。 统一可视化 支持对多种数据源,在同一个仪表盘中统一监控与分析,并以折线图、数字图等形式多样化、可视化呈现,帮助用户快速监控资源、及时获取数据发展趋势和制定决策。
  • 准备依赖资源 RocketMQ实例所需资源的具体要求和创建指导如表1所示。 表1 RocketMQ实例依赖资源 准备资源 要求 创建指导 VPC和子网 RocketMQ实例可以使用当前账号下已创建的VPC和子网,也可以使用新创建的VPC和子网,还可以使用共享VPC和子网,请根据实际需要进行配置。 共享VPC是基于资源访问管理(Resource Access Manager,简称RAM)服务的机制,VPC的所有者可以将VPC内的子网共享给一个或者多个账号使用。通过共享VPC功能,可以简化网络配置,帮助您统一配置和运维多个账号下的资源,有助于提升资源的管控效率,降低运维成本。有关VPC子网共享的更多信息,请参见共享VPC。 在创建VPC和子网时应注意如下要求: 创建的VPC与使用的RocketMQ实例应在相同的区域。 创建VPC和子网时,配置参数建议使用默认配置。 创建VPC和子网的操作指导请参考创建虚拟私有云和子网,若需要在已有VPC上创建和使用新的子网,请参考为虚拟私有云创建新的子网。 安全组 不同的RocketMQ实例可以重复使用相同的安全组,也可以使用不同的安全组,请根据实际需要进行配置。 使用RocketMQ实例必须添加表2或表3所示安全组规则,其他规则请根据实际需要添加。 说明: 创建安全组后,系统默认添加入方向“允许安全组内的弹性云服务器彼此通信”规则和出方向“放通全部流量”规则,此时使用内网通过同一个VPC访问RocketMQ实例,无需添加表2或表3的规则。 创建安全组的操作指导请参考创建安全组,为安全组添加规则的操作指导请参考添加安全组规则。 弹性IP地址 在创建弹性IP地址时,应注意如下要求: 创建的弹性IP地址与RocketMQ实例在相同的区域。 RocketMQ控制台无法识别开启IPv6转换功能的弹性IP地址。 创建弹性IP地址的操作指导请参考申请弹性公网IP。 表2 安全组规则(RocketMQ实例4.8.0版本) 方向 协议 端口 源地址 说明 入方向 TCP 8100 0.0.0.0/0 通过内网访问元数据节点的端口 入方向 TCP 8200 0.0.0.0/0 公网访问元数据节点的端口 入方向 TCP 10100-10199 0.0.0.0/0 访问业务节点的端口 表3 安全组规则(RocketMQ实例5.x版本) 方向 协议 端口 源地址 说明 入方向 TCP 8100 0.0.0.0/0 使用TCP协议,通过内网访问实例的端口 入方向 TCP 8200 0.0.0.0/0 使用TCP协议,通过公网访问实例的端口 入方向 TCP 10100-10199 0.0.0.0/0 使用TCP协议,访问业务节点的端口 入方向 TCP 8080 0.0.0.0/0 使用gRPC协议,通过内网访问实例的端口 入方向 TCP 8081 0.0.0.0/0 使用gRPC协议,通过公网访问实例的端口
  • DMS for RocketMQ权限 默认情况下,管理员创建的IAM用户没有任何权限,需要将其加入用户组,并给用户组授予策略或角色,才能使得用户组中的用户获得对应的权限,这一过程称为授权。授权后,用户就可以基于被授予的权限对云服务进行操作。 DMS for RocketMQ部署时通过物理区域划分,为项目级服务。授权时,“作用范围”需要选择“区域级项目”,然后在指定区域(如华北-北京1)对应的项目(cn-north-1)中设置相关权限,并且该权限仅对此项目生效;如果在“所有项目”中设置权限,则该权限在所有区域项目中都生效。访问DMS for RocketMQ时,需要先切换至授权区域。 权限根据授权精细程度分为角色和策略。 角色:IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度,提供有限的服务相关角色用于授权。由于华为云各服务之间存在业务依赖关系,因此给用户授予角色时,可能需要一并授予依赖的其他角色,才能正确完成业务。角色并不能满足用户对精细化授权的要求,无法完全达到企业对权限最小化的安全管控要求。 策略:IAM最新提供的一种细粒度授权的能力,可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式,能够满足企业对权限最小化的安全管控要求。例如:针对DMS for RocketMQ服务,管理员能够控制IAM用户仅能对实例进行指定的管理操作。多数细粒度策略以API接口为粒度进行权限拆分,DMS for RocketMQ支持的API授权项请参见细粒度策略支持的授权项。 如表1所示,包括了DMS for RocketMQ的所有系统权限。 表1 DMS for RocketMQ系统权限 系统角色/策略名称 描述 类别 依赖关系 DMS FullAccess 分布式消息服务管理员权限,拥有该权限的用户可以操作所有分布式消息服务的功能。 系统策略 无 DMS UserAccess 分布式消息服务普通用户权限(没有实例创建、修改、删除、扩容)。 系统策略 无 DMS ReadOnlyAccess 分布式消息服务的只读权限,拥有该权限的用户仅能查看分布式消息服务数据。 系统策略 无 DMS VPCAccess 分布式消息服务租户委托时需要授权的VPC操作权限。 系统策略 无 DMS KMSAccess 分布式消息服务租户委托时需要授权的KMS操作权限。 系统策略 无 DMS Administrator 分布式消息服务的管理员权限。 系统角色 依赖Tenant Guest和VPC Administrator。 表2列出了DMS for RocketMQ常用操作与系统策略的授权关系,您可以参照该表选择合适的系统策略。 表2 常用操作与系统策略的关系 操作 DMS FullAccess DMS UserAccess DMS ReadOnlyAccess DMS VPCAccess DMS KMSAccess 创建实例 √ × × × × 修改实例 √ × × × × 删除实例 √ × × × × 变更实例规格 √ × × × × 查询实例信息 √ √ √ × ×
  • 请求示例 “endpoint”即调用API的请求地址,不同服务不同区域的endpoint不同,具体请参见终端节点。 例如,服务部署在“华北-北京四”区域的“endpoint”为“moderation.cn-north-4.myhuaweicloud.com”,请求URL为“https://moderation.cn-north-4.myhuaweicloud.com/v3/{project_id}/moderation/video/jobs/{job_id}”,“project_id”为项目ID,获取方法请参见获取项目ID,“job_id”为创建作业成功时,接口返回的job_id。 GET https://{endpoint}/v3/{project_id}/moderation/video/jobs/{job_id}
  • 响应示例 状态码: 200 成功响应示例 { "request_id" : "xxxx", "job_id" : "xxx", "status" : "succeeded", "request_params" : { "data" : { "url" : "xxxx", "frame_interval" : 5 }, "event_type" : "default", "image_categories" : [ "porn", "terrorism", "image_text" ], "audio_categories" : [ "porn", "ad", "moan", "abuse" ], "callback" : "xxx" }, "create_time" : "2022-07-30T08:57:11.011Z", "update_time" : "2022-07-30T08:57:14.014Z", "result" : { "suggestion" : "block", "image_detail" : [ { "suggestion" : "block", "category" : "porn", "ocr_text" : "123", "time" : 0, "detail" : [ { "confidence" : 0.676015138626099, "category" : "porn", "suggestion" : "block", "label" : "pornography" }, { "confidence" : 0.666015138626099, "category" : "porn", "suggestion" : "review", "label" : "sexy_female" }, { "confidence" : 0.666015138626099, "category" : "xxx", "suggestion" : "block", "label" : "leader" }, { "confidence" : 0.691423773765564, "category" : "xxx", "suggestion" : "block", "face_location" : { "top_left_x" : 12, "top_left_y" : 13, "bottom_right_x" : 200, "bottom_right_y" : 240 }, "label" : "leader" }, { "confidence" : 0.691423773765564, "category" : "porn", "suggestion" : "block", "face_location" : { "top_left_x" : 12, "top_left_y" : 13, "bottom_right_x" : 100, "bottom_right_y" : 2000 }, "label" : "leader" }, { "confidence" : 0.891423773765564, "category" : "image_text", "suggestion" : "block", "label" : "qr_code" }, { "confidence" : 0.891423773765564, "category" : "image_text", "suggestion" : "block", "label" : "qr_code", "qr_content" : "xxxxxxxxx", "qr_location" : { "top_left_x" : 12, "top_left_y" : 13, "bottom_right_x" : 100, "bottom_right_y" : 2000 } }, { "confidence" : 0.891423773765564, "category" : "image_text", "suggestion" : "block", "label" : "porn", "segments" : [ { "segment" : "xxx" }, { "segment" : "xx" } ] } ] } ], "audio_detail" : [ { "suggestion" : "block", "label" : "porn", "audio_text" : "xxxxx", "end_time" : 10, "start_time" : 0, "detail" : [ { "confidence" : 0.999117187582349, "label" : "porn", "suggestion" : "block", "segments" : [ { "segment" : "xxx" } ] }, { "confidence" : 0.885117187582349, "label" : "porn", "suggestion" : "block" } ] } ] } } 状态码: 400 失败响应示例 { "error_code" : "AIS.0030", "error_msg" : "Job not found" }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 request_id String 本次请求的唯⼀标识,⽤于问题排查,建议保存。 job_id String 作业id。 status String 作业状态,可取值有: running: 正在运行 succeeded: 运行成功 failed: 运行失败 request_params request_params object 作业创建参数。 create_time String 作业创建时间。 update_time String 作业更新时间。 result result object 作业审核结果,当作业状态为succeeded时存在。 表4 request_params 参数 参数类型 描述 data data object 创建作业时传的data参数。 event_type String 创建作业时传的event_type参数。 image_categories Array of strings 创建作业时传的image_categories参数。 audio_categories Array of strings 创建作业时传的audio_categories参数。 callback String 创建作业时传的callback参数。 表5 data 参数 参数类型 描述 url String 创建作业时传的url参数。 frame_interval Integer 创建作业时传的frame_interval参数,默认为5秒截取一帧。 表6 result 参数 参数类型 描述 suggestion String 视频审核结果是否通过。 block:包含敏感信息,不通过 review:需要人工复检 pass:不包含敏感信息,通过 image_detail Array of image_detail objects 图像审核详情。 audio_detail Array of audio_detail objects 音频审核详情。 表7 image_detail 参数 参数类型 描述 suggestion String 图像审核结果是否通过。 block:包含敏感信息,不通过 review:需要人工复检 category String 检测结果的一级标签。 支持category列表如下: terrorism: 暴恐 porn: 色情 image_text: 图文审核 ocr_text String 图文审核检测出的文本,只有在category参数配置image_text且检测出文本时展示该字段。 time Float 截帧在视频文件中的时间,单位为秒。 detail Array of detail objects 图像帧审核详情。 表8 detail 参数 参数类型 描述 confidence Float 置信度,可选值在0-1之间,值越大,可信度越高。 category String 检测结果的一级标签。 支持category列表如下: terrorism: 暴恐 porn: 色情 image_text: 图文审核 suggestion String 审核结果是否通过。 block:包含敏感信息,不通过 review:需要人工复检 label String 识别的详细标签。 face_location face_location object 人物位置信息。 qr_location qr_location object 二维码位置信息。 qr_content String 图片中二维码指向的链接,当请求参数categories中包含image_text时存在。 segments Array of segments objects image_text场景下命中的文本片段。 表9 face_location 参数 参数类型 描述 top_left_x Integer 检测出人脸的左上角横坐标。 top_left_y Integer 检测出人脸的左上角纵坐标。 bottom_right_x Integer 检测出人脸的右下角横坐标。 bottom_right_y Integer 检测出人脸的右下角纵坐标。 表10 qr_location 参数 参数类型 描述 top_left_x Integer 检测出的二维码左上角横坐标。 top_left_y Integer 检测出的二维码左上角纵坐标。 bottom_right_x Integer 检测出的二维码右下角横坐标。 bottom_right_y Integer 检测出的二维码右下角纵坐标。 表11 segments 参数 参数类型 描述 segment String 命中的风险片段。 表12 audio_detail 参数 参数类型 描述 suggestion String 音频片段审核结果是否通过。 block:包含敏感信息,不通过 review:需要人工复检 label String 音频片段检测标签,选取detail中置信度最大的标签,可取值如下: terrorism: 暴恐 porn: 色情 ad: 广告 ad_law: 广告法 abuse: 辱骂 ban: 违禁 meaningless: 无意义 moan: 娇喘 audio_text String 音频片段文本内容。 end_time Float 音频片段结束时间。 start_time Float 音频片段开始时间。 detail Array of detail objects 音频片段审核详情。 表13 detail 参数 参数类型 描述 confidence Float 风险置信度。 label String 风险标签。 suggestion String 审核处理建议。 block:包含敏感信息,不通过 review:需要人工复检 segments Array of segments objects 命中的风险片段信息列表,如果命中语义算法模型,则该字段不会存在。 表14 segments 参数 参数类型 描述 segment String 命中的风险片段。 状态码: 400 表15 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 请求示例 “endpoint”即调用API的请求地址,不同服务不同区域的endpoint不同,具体请参见终端节点。 例如,服务部署在“华北-北京四”区域的“endpoint”为“moderation.cn-north-4.myhuaweicloud.com”,请求URL为“https://moderation.cn-north-4.myhuaweicloud.com/v3/{project_id}/moderation/audio/jobs”,“project_id”为项目ID,获取方法请参见获取项目ID。 创建音频内容审核作业,事件类型为默认事件,检测的风险类型为涉黄,广告。 POST https://{endpoint}/v3/{project_id}/moderation/audio/jobs { "data" : { "url" : "https://xxxxx.wav" }, "event_type" : "default", "categories" : [ "porn", "ad" ], "callback" : "http://xxxx" }
  • 响应示例 状态码: 200 成功响应示例 { "job_id" : "01661356800_7c0fe871f80543358917e4faebca4a48", "request_id" : "07490f57ac5e034c077ab25b5f9e1da5" } 状态码: 400 失败响应示例 { "error_code": "AIS.0401", "error_msg": "The input parameter event_type is incorrect." }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 data 是 AudioInputBody object 音频数据输入。 event_type 否 String 事件类型,可选值如下: default:默认事件 audiobook:有声书 education:教育音频 game:游戏语音房 live:秀场直播 ecommerce:电商直播 voiceroom:交友语音房 private:私密语音聊天 categories 否 Array of strings 需要检测的风险类型,列表不能为空。 风险类型如下: porn:涉黄检测 ad:广告检测 moan:娇喘检测 abuse:辱骂检测 callback 否 String 该字段非空时,检测结果会回调通知您的URL。该字段为空时,您需要定时轮询获取检测结果。 说明: 您的callback接口需要支持POST方法; 回调数据格式,请参考查询音频内容审核作业的响应示例; 您的服务端callback接口收到内容安全发送的结果后,如果在响应超时时间3秒内返回的HTTP状态码为200,则表示接收成功。其他HTTP状态码或响应时间大于3秒后返回状态码均视为接收失败,接收失败时,内容安全将重复发送多次检测结果。 biz_type 否 String 用户在控制台界面创建的自定义审核策略名称。 如果请求参数中传了biz_type则优先使用biz_type。 如果用户没传biz_type则event_type和categories必须传。 seed 否 String 用于回调通知时校验请求是由华为云内容安全服务发起,您可以自定义。值为随机字符串,由英文字母、数字、下划线组成,不超过64个字符。 说明: 当seed非空时,headers中将包含X-Auth-Signature字段,字段的值使用HmacSHA256算法生成,待加密字符串由create_time、job_id、request_id、seed按照顺序拼接而成,密钥为seed。 表4 AudioInputBody 参数 是否必选 参数类型 描述 url 是 String 音频url地址。 language 否 String 支持检测的音频语言。可选值为zh:中文。 不传该参数表示默认为zh。
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 request_id String 本次请求的唯⼀标识,⽤于问题排查,建议保存。 最小长度:2 最大长度:64 job_id String 作业唯一标识。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 响应示例 状态码: 200 成功响应示例 { "job_id" : "xxxxxx", "status" : "succeeded", "result" : { "suggestion" : "block", "details" : [ { "start_position" : 1, "end_position" : 10, "suggestion" : "block", "index" : 12, "label" : "porn", "type" : "text", "text" : "xxxxxxxxx", "segments" : [ { "segment" : "xxx" }, { "segment" : "xxx" }, { "segment" : "xxx" } ] } ] }, "request_params" : { "data" : { "url" : "https://xxxxx", "format" : "pdf" }, "event_type" : "default", "image_categories" : [ "politics", "porn", "image_text", "terrorism" ], "text_categories" : [ "default" ], "callback" : "http://xxx" } } 状态码: 400 失败响应示例 { "error_code" : "AIS.0030", "error_msg" : "Job not found" }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 job_id String 作业id。 status String 作业状态,可取值有: running:正在运行 succeeded:运行成功 failed:运行失败 result result object 作业审核结果,当作业状态为succeeded时存在。 request_params request_params object 作业创建参数。 create_time String 作业创建时间。 update_time String 作业更新时间。 request_id String 本次请求的唯⼀标识,⽤于问题排查,建议保存。 表4 result 参数 参数类型 描述 suggestion String 文档审核结果是否通过。 block:包含敏感信息,不通过 review:需要人工复检 pass:不包含敏感信息,通过 details Array of details objects 审核详情。 表5 details 参数 参数类型 描述 suggestion String 当前内容片段的处置建议: block:包含敏感信息,不通过 review:需要人工复检 type String 当前内容片段的类型,可取值有: text:文本 image:图像 video:视频 label String 当前内容片段的风险类型,可取值为: terrorism:暴恐 porn:色情 sexy:性感 abuse:辱骂 ad:广告 qr_code:二维码 watermark:水印 meaningless:无意义 ban:违禁 bad_scene:不良场景 moan:娇喘 index Integer 当前处理的片段索引。 text String 当前内容片段中的文本内容,仅当type为text时存在。 start_position Integer 当前文本内容片段在输入中的起始位置,仅当type为text时存在。 end_position Integer 当前文本内容片段在输入中的结束位置,仅当type为text时存在。 image_url String 网页图片url,仅当type为image且文档格式为webpage时存在。 segments Array of segments objects 命中的风险片段信息列表,仅在有命中敏感词时才返回。 video_image_details Array of DocumentVideoImageDetail objects 网页视频中截帧部分审核详情。 audio_details Array of DocumentAudioDetail objects 网页视频中音频部分审核详情。 表6 segments 参数 参数类型 描述 segment String 命中的敏感词。 表7 DocumentVideoImageDetail 参数 参数类型 描述 time Float 截帧在视频文件中的时间,单位为秒。 suggestion String 截帧审核结果是否通过。 block:包含敏感信息,不通过 review:需要人工复检 ocr_text String 截帧检测出的文本。 label String 识别的详细标签。 segments Array of segments objects 命中的文本风险片段列表。 表8 segments 参数 参数类型 描述 segment String 命中的风险片段。 表9 DocumentAudioDetail 参数 参数类型 描述 start_time Float 音频片段开始时间。 end_time Float 音频片段结束时间。 suggestion String 音频片段审核处理建议。 block:包含敏感信息,不通过 review:需要人工复检 audio_text String 音频片段文本内容。 label String 音频片段标签。 segments Array of segments objects 命中的风险片段信息列表。 表10 segments 参数 参数类型 描述 segment String 命中的风险片段。 表11 request_params 参数 参数类型 描述 data data object 创建作业时传的data参数。 event_type String 创建作业时传的event_type参数。 image_categories Array of strings 创建作业时传的image_categories参数。 text_categories Array of strings 创建作业时传的text_categories参数。 video_image_categories Array of strings 创建作业时传的video_image_categories参数。 audio_categories Array of strings 创建作业时传的audio_categories参数。 callback String 创建作业时传的callback参数。 表12 data 参数 参数类型 描述 url String 创建作业时传的url参数。目前支持:公网HTTP/HTTPS URL。 format String 创建作业时传的format参数。 frame_interval Integer 创建作业时传的frame_interval参数。 状态码: 400 表13 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 响应示例 状态码: 200 查询成功时返回作业状态和结果 { "job_id" : "01655654400_ad96b30f58cc40e8968e53f1f1e80021", "status" : "succeeded", "result" : { "suggestion" : "block", "details" : [ { "start_time" : 0, "suggestion" : "block", "end_time" : 10, "label" : "porn", "audio_text" : "xxxx", "segments" : [ { "segment" : "xxx" }, { "segment" : "xxx" }, { "segment" : "xxx" } ] }, { "start_time" : 30, "suggestion" : "block", "end_time" : 40, "label" : "porn", "audio_text" : "xxx", "segments" : [ { "segment" : "xx" } ] } ], "audio_text" : "xxxxxx" }, "request_params" : { "event_type" : "default", "data" : { "url" : "https://xxxx.wav" }, "callback" : "http://xxx", "categories" : [ "porn", "ad" ] }, "create_time" : "2022-06-20 11:05:29", "update_time" : "2022-06-20 11:07:08", "request_id" : "2419446b1fe14203f64e4018d12db3dd" } 状态码: 400 查询失败时返回错误原因 { "error_code" : "AIS.0030", "error_msg" : "Job not found" }
  • 请求示例 “endpoint”即调用API的请求地址,不同服务不同区域的endpoint不同,具体请参见终端节点。 例如,服务部署在“华北-北京四”区域的“endpoint”为“moderation.cn-north-4.myhuaweicloud.com”,请求URL为“https://moderation.cn-north-4.myhuaweicloud.com/v3/{project_id}/moderation/audio/jobs/{job_id}”,“project_id”为项目ID,获取方法请参见获取项目ID,“job_id”为创建作业成功时,接口返回的job_id。。 GET https://{endpoint}/v3/{project_id}/moderation/audio/jobs/{job_id}
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 job_id String 作业id。 status String 作业状态,可取值有: running: 正在运行 succeeded: 运行成功 failed: 运行失败 result result object 作业审核结果,当作业状态为succeeded时存在。 request_params request_params object 作业创建参数。 create_time String 作业创建时间。 update_time String 作业更新时间。 request_id String 本次请求的唯⼀标识,⽤于问题排查,建议保存。 最小长度:2 最大长度:64 表4 result 参数 参数类型 描述 suggestion String 音频审核结果是否通过。 block:包含敏感信息,不通过 pass:不包含敏感信息,通过 review:需要人工复检 details Array of details objects 审核详情。 audio_text String 音频文本内容。 表5 details 参数 参数类型 描述 start_time Float 音频片段开始时间。 suggestion String 音频片段审核处理建议。 block:包含敏感信息,不通过 review:需要人工复检 end_time Float 音频片段结束时间。 label String 音频片段标签。可选值如下: terrorism: 暴恐 porn: 色情 ban: 违禁 abuse: 辱骂 ad: 广告 ad_law: 广告法 moan: 娇喘 meaningless: ⽆意义 audio_text String 音频片段文本内容。 segments Array of segments objects 命中的风险片段信息列表,如果命中语义算法模型,则该字段不会存在。 表6 segments 参数 参数类型 描述 segment String 命中的风险片段。 表7 request_params 参数 参数类型 描述 event_type String 创建作业时传的event_type参数。 data data object 创建作业时传的data参数。 callback String 创建作业时传的callback参数。 categories Array of strings 创建作业时传的categories参数。 表8 data 参数 参数类型 描述 url String 创建作业时传的url参数。 状态码: 400 表9 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 请求示例 创建视频内容审核作业,事件类型为默认事件,检测的风险类型为涉黄,暴恐,图文违规内容检测。 “endpoint”即调用API的请求地址,不同服务不同区域的endpoint不同,具体请参见终端节点。 例如,服务部署在“华北-北京四”区域的“endpoint”为“moderation.cn-north-4.myhuaweicloud.com”,请求URL为“https://moderation.cn-north-4.myhuaweicloud.com/v3/{project_id}/moderation/video/jobs”,“project_id”为项目ID,获取方法请参见获取项目ID。 POST https://{endpoint}/v3/{project_id}/moderation/video/jobs { "data" : { "url" : "https://xxxx", "frame_interval" : 5 }, "event_type" : "default", "image_categories" : [ "porn","terrorism", "image_text" ], "audio_categories" : [ "porn", "ad", "moan", "abuse" ], "callback" : "http://xxxx" }
  • 响应示例 状态码: 200 成功响应示例 { "job_id" : "01661356800_7c0fe871f80543358917e4faebca4a48", "request_id" : "07490f57ac5e034c077ab25b5f9e1da5" } 状态码: 400 失败响应示例 { "error_code" : "AIS.0401", "error_msg" : "The input parameter event_type is incorrect." }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 data 是 data object 视频数据输入。 biz_type 否 String 用户在控制台界面创建的自定义审核策略名称。 如果请求参数中传了biz_type则优先使用biz_type。 如果用户没传biz_type则event_type,image_categories必须传。 event_type 否 String 事件类型,可选值为 default表示默认事件。 image_categories 否 Array of strings 视频中画面需要检测的风险类型,列表不能为空。 terrorism:暴恐内容的检测 porn:鉴黄内容的检测 image_text:图文违规内容的检测(检测图片中出现的广告、色情、暴恐的文字违规内容以及二维码内容) audio_categories 否 Array of strings 视频中音频需要检测的风险类型,不传或为空时表示不审核音频维度。 porn:涉黄检测 ad: 广告检测 moan: 娇喘检测 abuse: 辱骂检测 callback 否 String 该字段非空时,检测结果会回调通知您的URL。该字段为空时,您需要定时轮询获取检测结果。 说明: 您的callback接口需要支持POST方法; 回调数据格式,请参考查询视频内容审核作业的响应示例; 您的服务端callback接口收到内容安全发送的结果后,如果在响应超时时间3秒内返回的HTTP状态码为200,则表示接收成功。其他HTTP状态码或响应时间大于3秒后返回状态码均视为接收失败,接收失败时,内容安全将重复发送多次检测结果。 seed 否 String 用于回调通知时校验请求是由华为云内容安全服务发起,您可以自定义。值为随机字符串,由英文字母、数字、下划线组成,不超过64个字符。 说明: 当seed非空时,headers中将包含X-Auth-Signature字段,字段的值使用HmacSHA256算法生成,待加密字符串由create_time、job_id、request_id、seed按照顺序拼接而成,密钥为seed。 表4 data 参数 是否必选 参数类型 描述 url 是 String 视频url地址。 frame_interval 否 Integer 截帧频率间隔,单位为秒,取值范围为1~60s。如果不传递默认5s截帧一次 language 否 String 支持的语言,当前只支持zh:中文,默认取值为zh。
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 request_id String 本次请求的唯一标识,用于问题排查,建议保存。 job_id String 作业唯一标识。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 request_id String 本次请求的唯一标识,用于问题排查,建议保存。 job_id String 作业唯一标识。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 data 是 data object 视频流数据输入。 event_type 是 String 事件类型,可选值为default,default表示默认事件。 image_categories 是 Array of strings 视频流中画面需要检测的风险类型,列表不能为空。 可选择的风险类型如下: porn:鉴黄内容的检测 terrorism:暴恐内容的检测 politics:敏感人物内容的检测 image_text:图文违规内容的检测(检测图片中出现的广告、色情、暴恐的文字违规内容以及二维码内容) audio_categories 否 Array of strings 视频流中音频需要检测的风险类型,不传或为空时表示不审核音频维度。 可选择的风险类型如下: porn:涉黄检测 abuse: 辱骂检测 ad: 广告检测 moan: 娇喘检测 callback 是 String 该字段非空时,检测结果会回调通知您的URL。视频流未结束时,检测片段违规时回调客户端,视频流结束时,检测片段违规或正常都将回调客户端。 说明: 您的callback接口需要支持POST方法; 回调数据格式,请参考查询视频内容审核作业的响应示例; 您的服务端callback接口收到内容安全发送的结果后,如果在响应超时时间3秒内返回的HTTP状态码为200,则表示接收成功。其他HTTP状态码或响应时间大于3秒后返回状态码均视为接收失败,接收失败时,内容安全将重复发送多次检测结果。 seed 否 String 用于回调通知时校验请求是由华为云内容安全服务发起,您可以自定义。值为随机字符串,由英文字母、数字、下划线组成,不超过64个字符。 说明: 当seed非空时,headers中将包含X-Auth-Signature字段,字段的值使用HmacSHA256算法生成,待加密字符串由create_time、job_id、request_id、seed按照顺序拼接而成,密钥为seed。 表4 data 参数 是否必选 参数类型 描述 url 是 String 视频流url,支持rtmp、rtmps、hls、http、https等主流协议。 frame_interval 否 Integer 截帧频率间隔,单位为秒,取值范围为1~60s;如果不传递默认5s截帧一次。
  • 请求示例 创建视频流内容审核作业。 POST https://{endpoint}/v3/{project_id}/moderation/video-stream/jobs { "data" : { "url" : "xxx", "frame_interval" : 3 }, "event_type" : "default", "image_categories" : [ "politics", "porn", "image_text", "terrorism" ], "audio_categories" : [ "porn", "ad", "politics", "moan", "abuse" ], "callback" : "xxx" }
  • 响应示例 状态码: 200 成功响应示例 { "job_id" : "01661356800_7c0fe871f80543358917e4faebca4a48", "request_id" : "07490f57ac5e034c077ab25b5f9e1da5" } 状态码: 400 失败响应示例 { "error_code" : "AIS.0401", "error_msg" : "The input parameter event_type is incorrect." }
  • 请求示例 创建音频流内容审核作业请求体 POST https://{endpoint}/v3/{project_id}/moderation/audio-stream/jobs { "data" : { "url" : "https://xxxxx" }, "event_type" : "default", "categories" : [ "porn", "ad" ], "callback" : "http://xxxx" }
  • 响应参数 状态码: 200 表5 响应Body参数 参数 参数类型 描述 request_id String 本次请求的唯一标识,用于问题排查,建议保存。 job_id String 作业唯一标识。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
共100000条