华为云用户手册

计费构成分析 可以将公网NAT网关的使用阶段按照计费模式分为两段： 2023/03/18 15:00:00 ~ 2023/03/19 8:00:00期间，以按需计费模式收取NAT网关费用。 2023/03/19 8:00:00 ~ 2023/03/20 8:00:00期间，以按需计费模式收取NAT网关费用。 2023/03/20 8:00:00 ~ 2023/04/20 23:59:59期间，以包年/包月计费模式收取NAT网关费用。 按需计费 在2023/03/18 15:00:00 ~ 2023/03/19 8:00:00期间按照产品规格类型为小型计费，计费时长为1天，费用为：12*1=12元 在2023/03/19 8:00:00 ~ 2023/03/20 8:00:00期间按照产品规格类型为小型计费，计费时长为1天，费用为：12*1=12元 包年/包月计费 在2023/03/20 8:00:00 ~ 2023/04/20 23:59:59期间按照产品规格类型为大型计费，计费时长为1个月，费用为：1147.50*1=1147.50元 由此可见，在3~4月份，该NAT网关服务总共产生的费用为：24+1147.50=1171.50元。

变更配置对计费的影响 当前包年/包月公网NAT网关资源的规格不满足您的业务需要时，您可以在控制台发起变更规格操作，变更时系统将按照如下规则为您计算变更费用： 资源升配：修改规格时，将按照当日使用的最大规格进行计费。您需要按照与原规格的价格差，结合使用周期内的剩余时间，补齐差价。 资源降配：包年/包月的公网NAT网关不支持规格降级。 这里以资源升配且无任何优惠的场景为例，假设您在2023/04/08购买了一个包年/包月公网NAT网关（规格：小型），购买时长为1个月，计划在2023/04/18变更规格为中型。旧配置价格为306元/月，新配置价格为586.5 元/月。计算公式如下： 升配费用=新配置价格*剩余周期-旧配置价格*剩余周期 公式中的剩余周期为每个自然月的剩余天数/对应自然月的最大天数。本示例中，剩余周期=12（4月份剩余天数）/ 30（4月份最大天数）+ 8（5月份剩余天数）/ 31（5月份最大天数）=0.6581，代入公式可得升配费用=586.5*0.6581-306*0.6581=184.60（元） 更多信息请参见变更资源规格费用说明。

计费示例 假设您在2023/03/08 15:50:04购买了一个包年/包月公网NAT网关（产品规格为：小型），购买时长为一个月，并在到期前手动续费1个月，产生的费用如包年/包月NAT网关费用计算示例所示： 表1 包年/包月NAT网关费用计算示例 计费周期 计费公式 费用总和（元） 1个月（2023/03/08 15:50:04 ~ 2023/04/08 23:59:59） 规格单价*购买时长 306*1=306 1个月（2023/04/08 23:59:59 ~ 2023/05/08 23:59:59） 306*1=306 上述价格仅供参考，实际计算请以NAT网关价格详情中的价格为准。

适用场景 包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，如企业官网、在线商城、博客等，包年/包月计费模式能提供较高的成本效益。 长期项目：对于周期较长的项目，如科研项目、大型活动策划等，包年/包月计费模式可以确保在整个项目周期内资源的稳定使用。 业务高峰预测：如果能预测到业务高峰期，如电商促销季、节假日等，可提前购买包年/包月资源以应对高峰期的需求，避免资源紧张。 数据安全要求高：对于对数据安全性要求较高的业务，包年/包月计费模式可确保资源的持续使用，降低因资源欠费而导致的数据安全风险。

计费说明 NAT网关的费用根据您选择的NAT网关类型、规格和使用时长计费。NAT网关提供“包年/包月”和“按需计费”两种计费模式，以满足不同场景下的用户需求。具体内容如下表所示。 表1 NAT网关计费项 计费项 计费项说明 适用的计费模式 计费公式 实例规格 NAT网关的规格指公网NAT网关与私网NAT网关支持的SNAT最大连接数。 包年/包月、按需计费 实例规格单价 * 购买时长 实例规格单价请参见NAT网关价格详情。

计费示例 以包年/包月公网NAT网关计费模式为例，假设您在2023/03/08 15:50:04购买了一个包年/包月公网NAT网关（产品规格为：小型），购买时长为一个月，并在到期前手动续费1个月，产生的费用如包年/包月公网NAT网关费用计算示例所示： 表2 包年/包月公网NAT网关费用计算示例 计费周期 计费公式 费用总和（元） 1个月（2023/03/08 15:50:04 ~ 2023/04/08 23:59:59） 规格单价*购买时长 306*1=306 1个月（2023/04/08 23:59:59 ~ 2023/05/08 23:59:59） 306*1=306

计费周期 公网NAT网关 按需计费公网NAT网关资源按天计费，按天计费模式的计费周期为：从前一天早上8点至第二天早上8点为一天，不满一天的按一天计算。 例如，您在2023/4/18 06:00:00购买了一个按天计费的公网NAT网关，产品规格为小型，截止2023/4/19 9:00:00将其删除。 第一个计费周期为2023/4/18 06:00:00 ~ 2023/4/18 8:00:00，该计费周期内的计费时长为一天 第二个计费周期为2023/4/18 08:00:00 ~ 2023/4/19 8:00:00，该计费周期内的计费时长为一天 第三个计费周期为2023/4/19 08:00:00 ~ 2023/4/20 8:00:00，该计费周期内的计费时长为一天 私网NAT网关 按需计费私网NAT网关资源按秒计费，每一个小时整点结算一次费用（以GMT+8时间为准），结算完毕后进入新的计费周期。计费的起点以实例创建成功的时间点为准，终点以实例删除时间为准。 例如，您在2023/04/18 8:45:30购买了一个按需计费的私网NAT网关，产品规格为小型，然后在2023/04/18 8:55:30将其删除，则计费周期为8:00:00 ~ 9:00:00，在8:45:30 ~ 8:55:30间产生费用，该计费周期内的计费时长为600秒。

计费示例 公网NAT网关 假设您在2023/04/18 6:00:00购买了一个按需计费的公网NAT网关，产品规格为小型，然后在2023/4/19 9:00:00将其删除，则产生的费用如表所示： 表1 按需（天）计费公网NAT网关费用计算示例 计费周期 计费公式 费用总和（元） 1天（2023/04/18 6:00:00 ~ 2023/04/18 8:00:00） 规格单价*购买时长 12*1=12 1天（2023/04/18 8:00:00 ~ 2023/04/19 8:00:00） 12*1=12 1天（2023/4/19 08:00:00 ~ 2023/4/20 8:00:00） 12*1=12 私网NAT网关 您在2023/04/18 8:45:00购买了一个按小时计费的私网NAT网关，产品规格为小型，然后在2023/04/18 9:55:00将其删除。则产生的费用如下表所示： 表2 按需（小时）计费私网NAT网关费用计算示例 计费周期 计费公式 费用总和（元） 1小时（2023/04/18 8:00:00 ~ 2023/04/18 9:00:00） 规格单价*购买时长 0.5/(3600)*900=0.125 1小时（2023/04/18 9:00:00 ~ 2023/04/18 10:00:00） 0.5/(3600)*3300=0.49 上述价格仅供参考，实际计算请以NAT网关价格详情中的价格为准。 产品价格详情中标出了资源的每小时价格，如果资源的计费时长不足1小时，那么计费时长需要按秒计算，此时需要将每小时价格除以3600，得到每秒价格，然后去计算费用，即：每秒价格 = XXX单价 / 3600 。

变更配置对计费的影响 如果您在购买按需计费公网NAT网关后变更了配置，修改规格后，将按照当日使用的最大规格进行计费。 例如，您在2023/04/18 9:00:00购买了一个按需计费的公网NAT网关，产品规格为小型，并在9:30:00升配规格为中型，截止2023/04/18 10:30:00将其删除。计费周期为2023/04/18 8:00:00~2023/04/19 8:00:00，在计费周期内按照产品规格为中型计费。 如果您在购买按需计费私网NAT网关后变更了配置，修改规格后，按照当前计费周期（按小时）内变更前和变更后分别计费，精确到秒。 例如，您在2023/04/18 9:00:00购买了一个按小时计费的私网NAT网关，产品规格为小型，并在9:30:00升配规格为中型，截止2023/04/18 10:30:00将其删除。第一个计费周期为2023/04/18 9:00:00~2023/04/19 10:00:00，在9:00:00 ~ 9:30:00间产生的费用按照产品规格为小型计费，在9:30:00 ~ 10:00:00间产生的费用按照产品规格为中型计费。第二个计费周期为2023/04/18 10:00:00~2023/04/19 11:00:00，在10:00:00 ~ 10:30:00间产生的费用按照产品规格为中型计费。

在续费管理页面开通自动续费 登录管理控制台。 单击“控制台”页面上方“费用与成本”，在下拉菜单中选择“续费管理”。 进入“续费管理”页面。 自定义查询条件。 可在“自动续费项”页签查询已经开通自动续费的资源。 可对“手动续费项”、“到期转按需项”、“到期不续费项”页签的资源开通自动续费。 图2 续费管理 为包年/包月资源开通自动续费。 单个资源开通自动续费：选择需要开通自动续费的NAT网关，单击操作列“开通自动续费”。 图3 单个资源开通自动续费 批量资源开通自动续费：选择需要开通自动续费的NAT网关，单击列表左上角的“开通自动续费”。 图4 多个资源开通自动续费 选择续费时长，并根据需要设置自动续费次数，单击“开通”。 图5 开通自动续费

计费模式概述 NAT网关提供包年/包月、按需计费两种计费模式，以满足不同场景下的用户需求。 包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于设备需求量长期稳定的成熟业务。 按需计费：一种后付费模式，即先使用再付费。按需计费又分为按天计费和按小时计费。按需计费模式允许您根据实际业务需求灵活地调整资源使用，无需提前预置资源，从而降低预置过多或不足的风险。 表1 计费模式 计费模式 包年/包月 按需计费 付费方式 预付费 按照订单的购买周期结算。 后付费 按照NAT网关实际使用时长计费。 计费周期 按订单的购买周期计费。 按天计费和按小时计费（秒级计费，按小时结算。） 适用计费项 网关实例类型和规格类型 网关实例类型和规格类型 变更计费模式 支持变更为按需计费模式。 但包年/包月资费模式到期后，按需的资费模式才会生效。 具体请参见：包年/包月转按需 支持变更为包年/包月计费模式。 具体请参见：按需转包年/包月 变更规格 公网NAT网关只支持升级实例规格，不支持降低实例规格。 支持变更实例规格。 适用场景 适用于可预估资源使用周期的场景，价格比按需计费模式更优惠。对于长期使用者，推荐该方式。 适用于资源需求波动的场景，可以随时开通，随时删除。 私网NAT网关不支持包年/包月计费模式，只支持按需计费模式。 父主题： 计费模式

请求方法：POST 接口URL：生产地址+固定子路径，其中固定子路径为/produceAPI/authSync； 接口示例：生产地址为https://example.isv.com，则接口URL为https://example.isv.com/produceAPI/authSync Headers参数 参数 必选 参数类型 描述 authToken M String(255) 签名信息，请参考auth Token取值说明。 BODY请求参数 参数 必选 参数类型 描述 instanceId M String(64) 说明： 卖家申请应用凭证的时候传空，买家必传。 tenantId M String(64) 租户ID，与租户同步的接口租户ID保持一致，这个ID是买家 appId M String(64) 应用ID，与应用同步的应用ID保持一致的 userList M String 授权用户信息，包含userName:账号名(M)、name:姓名（M）、position:职位(O)、orgCode:部门（M）、role:角色（user-普通用户，admin-管理员）（M）、enable:账号状态（true-启用，false-禁用）（M）、employeeCode:工号（O）、employeeType:人员类型（1：正式 2：实习 3：劳务派遣 4：劳务外包）（O）、mobile：手机号（O）、email：邮箱（O）、workPlace：工作所在地（O）、entryDate：入职时间（yyyy-MM-d）（O） JSON串，例： [{\"userName\":\"zhangsan01\",\"name\":\"张三\",\"position\":\"系统管理员\",\"orgCode\":\"123456789\",\"role\":\"admin\",\"enable\":\"true\",\"employeeCode\":\"\",\"mobile\":\"\",\"email\":\"\",\"extension\":{\"entryDate\":\"2022-11-9\",\"employeeType\":\"4\",\"workPlace\":\"南京\"}},{\"userName\":\"lisi02\",\"name\":\"李四\",\"position\":\"运营经理\",\"orgCode\":\"123456789\",\"role\":\"user\",\"enable\":\"true\",\"extension\":{\"entryDate\":\"2022-11-16\",\"employeeType\":\"4\",\"workPlace\":\"南京\"}}] 商家需要根据角色给用户进行赋权，如果admin赋予管理员角色 最大一次同步用户数是500个 currentSyncTime M String 默认时区东8区，时间戳,时间格式：20220420114117642 flag M Integer(2) 0-删除 1-新增 2-修改 testFlag M Integer(2) 0-生产正式数据 1-调测数据 timeStamp M String 默认时区东8区，时间戳,时间格式：20220420114117642 响应参数 参数 必选 参数类型 描述 resultCode M String(6) 响应码, 具体请参见调用结果码说明。 resultMsg O String(255) 响应信息 示例： POST https://example.isv.com/produceAPI/authSync Connection: keep-alive Content-Type: application/json authToken: "stbNYl*****************Ubt271qDr6WDAVLtLRb” Host: example.isv.com User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) { "instanceId": "huaiweitest123456", "tenantId": "68cbc86ab******92f36422fa0e", "appId": "KSID******34456", "userList": "[{ userName:\"zhangsan01\"，name:\"张三\",position:\"系统管理员\"，orgCode:\"123456789\"，role:\"admin\" enable:\"true\"},{ userName:\"lisi\"，name:\"李四\",position:\"用户\"，orgCode:\"123456789\"，role:\"user\" enable:\"true\"},]", " currentSyncTime": "20220413093539534", "flag": 1, "testFlag": 0, "timeStamp": "20220413093539534", } HTTP/1.1 200 OK Body-Sign: sign_type="HMAC-SHA256", signature= "xxxxxxxxxx" Content-Type: application/json { " resultCode": "000000", " resultMsg": "Success" } HTTP Body签名: Body-Sign: sign_type="HMAC-SHA256", signature= "xxxxxxxxxxxxx" ，详情参考《HTTP Body签名》。

前提条件 购买公网NAT网关必须指定公网NAT网关所在VPC、子网。 由于需要放通到公网NAT网关的流量，即在VPC中需要有指向公网NAT网关的路由，因此在购买公网NAT网关时，会自动在VPC的默认路由表中添加一条0.0.0.0/0的默认路由指向所购买的公网NAT网关。如果在购买公网NAT网关前，VPC默认路由表下已经存在0.0.0.0/0的默认路由，则会导致自动添加该默认路由指向公网NAT网关失败，此时需要在公网NAT网关购买成功后，手动为此网关添加一条不同的路由或在新路由表中创建0.0.0.0/0的默认路由指向该网关。

前提条件 购买公网NAT网关必须指定公网NAT网关所在VPC、子网。 由于需要放通到公网NAT网关的流量，即在VPC中需要有指向公网NAT网关的路由，因此在购买公网NAT网关时，会自动在VPC的默认路由表中添加一条0.0.0.0/0的默认路由指向所购买的公网NAT网关。如果在购买公网NAT网关前，VPC默认路由表下已经存在0.0.0.0/0的默认路由，则会导致自动添加该默认路由指向公网NAT网关失败，此时需要在公网NAT网关购买成功后，手动为此网关添加一条不同的路由或在新路由表中创建0.0.0.0/0的默认路由指向该网关。

前提条件 已购买了公网NAT网关所需的VPC和子网。 由于需要放通到公网NAT网关的流量，即在VPC中需要有指向公网NAT网关的路由，因此在购买公网NAT网关时，会自动在VPC的默认路由表中添加一条0.0.0.0/0的默认路由指向所购买的公网NAT网关。如果在购买公网NAT网关前，VPC默认路由表下已经存在0.0.0.0/0的默认路由，则会导致自动添加该默认路由指向公网NAT网关失败，此时需要在公网NAT网关购买成功后，手动为此网关添加一条不同的路由或在新路由表中创建0.0.0.0/0的默认路由指向该网关。

云连接 云连接（Cloud Connect）为用户提供一种能够快速构建跨区域VPC之间以及云上多VPC与云下多数据中心之间的高速、优质、稳定的网络能力，帮助用户打造一张具有企业级规模和通信能力的全球云上网络。 通过创建云连接，将用户所需要实现互通的不同区域的网络实例加载到创建的云连接实例中，这里的网络实例可以是用户自己创建的VPC实例或用户创建的用于本地数据中心接入的VGW实例，也可以是其它用户授予权限允许加载的VPC实例，最后通过配置需要互通的网络实例之间的域间带宽，就可以快速的为您提供全球网络互通服务。云连接的实现原理如图1所示。 图1 云连接原理图 VGW： VGW即虚拟网关，是云专线的接入路由器。在云专线服务里，物理专线是用户本地数据中心与云上VPC建立网络连接线路的抽象。虚拟接口是用户本地数据中心访问VPC的入口。VGW将虚拟接口和VPC关联，即可实现本地数据中心访问VPC。 图2 云专线原理图 网络实例： 网络实例包括VPC、虚拟网关（VGW）。 将VPC加载到云连接，可以实现VPC之间的互通。 将虚拟网关加载到云连接，可以实现云下IDC与云上多VPC互通，构建混合云。 带宽包： 跨区域网络实例互通需要购买带宽包，包括以下两种场景： 大区内互通的带宽，用于配置同一个大区内不同区域间，网络实例互通的域间带宽。 大区之间互通的带宽，用于配置两个大区内不同区域间，网络实例互通的域间带宽。 同区域网络实例互通不需要购买带宽包。 域间带宽： 域间带宽指所规划的场景中，一个区域到另一个区域的网络带宽，可以实现两个区域之间的互通。基于一个带宽包配置的多个域间带宽的总和不能超过带宽包的总带宽。 以中国大陆与亚太大区互通为例，详细请参考图3 图3 跨大区互通带宽包和域间带宽

中心网络 中心网络基于华为云骨干网络面向客户提供全球网络管理能力。中心网络可帮助用户在不同地域企业路由器之间、企业路由器与本地数据中心间搭建通信通道，实现同地域或跨地域网络互通。同时，中心网络支持定义灵活的企业路由器互通策略，帮助您打造一张灵活、可靠、智能的企业级全球互联网络。 企业路由器 将两个及以上企业路由器接入中心网络，实现云上跨区域网络互通。 全域互联带宽： 全域互联带宽通过绑定云连接实例，从而控制实例在云内骨干网络的通信速率，包括以下两种场景： 大区带宽：用于连通同一个大区内的云内骨干网络。 跨区带宽：用于连通不同大区内的云内骨干网络。

与其它服务的关系 图1 云连接服务与其他服务的关系示意图 表1 云连接服务与其他服务的关系 相关服务 交互功能 位置 虚拟私有云（Virtual Private Cloud，VPC） 通过VPC服务，创建VPC，不同VPC通过云连接服务实现互通。 创建虚拟私有云及默认子网 企业路由器（Enterprise Router，ER） 通过将两个及以上企业路由器接入中心网络，轻松实现云上跨区域网络互通。 - 云专线（Direct Connect，DC） 通过云专线服务，实现本地数据中心访问多个跨区域VPC。 多数据中心与多区域VPC互通 虚拟专用网络（Virtual Private Network，VPN） 通过VPN服务，可以实现本地数据中心和跨境VPC之间的稳定网络连通。 构建稳定的跨境网络连接 NAT网关（NAT Gateway） 通过NAT网关服务，可以实现本地数据中心服务器访问公网或为公网提供服务。 基于云连接和SNAT实现跨区域内网访问公网服务器加速 云监控（Cloud Eye Service） 通过云监控服务，查看云连接资源的监控数据，还可以获取可视化监控图表。 查看监控指标 统一身份认证服务（Identity and Access Management，IAM） 通过IAM服务，针对您在华为云上创建的云连接资源，向不同用户设置不同的使用权限，可以帮助您安全地控制华为云云连接资源的访问权限。 统一身份认证服务

更多操作 创建版本完成后，您还可以执行如下表2所示的操作。 表2 更多操作 操作 说明 编辑版本 说明： 可编辑未发布的版本，不可编辑已发布的版本。 在“版本管理”页面的版本列表中，单击“操作”列的“编辑”。 在“编辑版本”页面，可编辑版本描述、版本类型、产能、版本开始时间和版本发布时间。 单击“提交”。 删除版本 说明： 可删除未发布的版本，不可删除已发布的版本。 删除版本后其名下全部内容将同步被清空，此操作无法恢复，请谨慎操作。 在“版本管理”页面的版本列表中，单击“操作”列的“删除”。 在“删除版本”对话框，根据界面提示在文本框输入“确定删除”，并勾选“我已知悉，强制删除”。 单击“确定”。

步骤四：企业项目配置 在项目配置区域，单击“新增”。 新增项目配置，具体参数如表3所示。 表3 项目配置参数 名称 说明 部门 选择已录入的部门。 产品 选择已录入的产品。 服务 选择已录入的服务。 华为公有云账号名 选择用户的华为云账号名。 类型 关联项目：关联已有的公有云EPS。 关联且新增项目：在公有云EPS创建一个新项目，同时进行关联。 企业项目名称 关联项目时，选择已有的公有云EPS。 关联且新增时，填写创建的企业项目名称。 单击“确定”。

更多操作 创建和关联流水线完成后，您还可以执行如下表2所示操作。 表2 更多操作 操作 步骤 查看流水线运行历史 在流水线列表中单击流水线名称，进入“流水线运行历史”页面： 选择“流水线详情”页签，查看流水线编排的详情。 选择“执行历史”页面，选择时间段，可查看该时间段的流水线执行详情信息。 执行流水线 在当前服务版本的流水线列表中已关联的流水线所在行的“操作”列，单击“执行”。 在“执行构建”对话框，单击“确定”，流水线开始构建版本的发布软件包。 说明： 在流水线进行中，单击“操作”列“终止”可停止构建。 一个版本可多次重复执行发布构建，但以最后一次的构建结果为准。 解除关联流水线 在流水线列表“操作”列，单击“解除关联”。 单击“确认”，解除此流水线与当前版本的关联。 基线化 基线化用于将发布构建的产物（软件包）复制至开发中心OBS中心。 在流水线列表右上角单击“基线化”。 在“基线化”页面，选择流水线，单击“基线化”。

使用须知 流水线管理是开发中心结合流水线CodeArts Pipeline和编译构建CodeArts Build服务的能力，提供可视化、可编排的CI/CD持续交付软件生产线，帮助企业快速转型，实现DevOps持续交付高效自动化，缩短应用TTM（Time to Market）交付周期，提升研发效率。 流水线服务本质上是一个可视化的自动化任务调度平台，需要配合软件开发生产线中编译构建、代码检查、测试计划、部署等服务的自动化任务使用。根据用户需要的场景，如开发测试环境应用部署、生产环境应用部署等，对这些自动化任务进行自定义编排，一次配置后就可以一键自动化触发调度执行，避免频繁低效的手工操作。 关于流水线的详细介绍文档请参考流水线CodeArts Pipeline和编译构建 CodeArts Build。

步骤四：企业项目配置 在项目配置区域，单击“新增”。 新增项目配置，具体参数如表3所示。 表3 项目配置参数 名称 说明 部门 选择已录入的部门。 产品 选择已录入的产品。 服务 选择已录入的服务。 华为公有云账号名 选择用户的华为云账号名。 类型 关联项目：关联已有的公有云EPS。 关联且新增项目：在公有云EPS创建一个新项目，同时进行关联。 企业项目名称 关联项目时，选择已有的公有云EPS。 关联且新增时，填写创建的企业项目名称。 单击“确定”。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result Array of ImageBatchModerationResultBody objects 调用成功时表示调用结果。 调用失败时无此字段。 表5 ImageBatchModerationResultBody 参数 参数类型 描述 url String 图片的URL路径。 suggestion String 审核结果是否通过。 block：包含敏感信息，不通过 pass：不包含敏感信息，通过 review：需要人工复检 说明： 当同时检测多个场景时，suggestion的值以最可能包含敏感信息的场景为准。即任一场景出现了block则总的suggestion为block，所有场景都pass时suggestion为pass，这两种情况之外则一定有场景需要review，此时suggestion为review。 目前本服务不会保存客户的调用结果（如block的历史信息），因为涉及到客户的数据隐私问题，建议您保留接口调用结果的日志信息。 detail ImageDetectionResultDetail object 针对选定的每个检测场景列出结果列表，terrorism为暴恐检测结果，porn为涉黄检测结果。如果检测场景中的最高置信度也未达到threshold则结果列表为空。 category_suggestions Object 具体每个场景的检测结果。 block：包含敏感信息，不通过 pass：不包含敏感信息，通过 review：需要人工复检 表6 ImageDetectionResultDetail 参数 参数类型 描述 porn Array of ImageDetectionResultSimpleDetail objects 涉黄检测结果。 terrorism Array of ImageDetectionResultSimpleDetail objects 暴恐检测结果。 ad Array of ImageDetectionResultAdDetail objects 广告检测结果。 表7 face_detail 参数 参数类型 描述 h Integer 人脸区域高度。 w Integer 人脸区域宽度。 x Integer 人脸区域左上角到y轴距离。 y Integer 人脸区域左上角到x轴距离。 表8 ImageDetectionResultSimpleDetail 参数 参数类型 描述 confidence Float 置信度，取值范围 0-1。 label String 每个检测结果的标签化说明。 terrorism：label为对应的暴恐元素信息。 暴恐场景当前支持label列表如下： normal：正常（表示您上传的图像不涉及暴恐场景） knife：刀 gun：枪 fire：火灾 bloody ：血腥 terrorist：暴恐组织及标志 fascist：法西斯组织及标志 cult：邪教组织及标志 special_characters ：特殊文字 kidnap：绑架 corpse：尸体 riot：暴乱事件 parade ：游行示威 sensitive_landmarks：敏感地标 military_weapon：军事武器 army：警察部队 crowd：人群聚集 porn：label为对应的涉黄分类（涉黄、性感等）信息。 鉴黄场景当前支持label列表如下： normal：正常（表示您上传的图像内容不涉黄） porn：色情 sexy：性感 ad：label为对应的广告识别结果信息。 广告场景当前支持label列表如下： normal：正常（表示您上传的图像不涉及广告内容） ad：广告 图文审核场景当前支持label列表如下： normal：正常 qr_code：二维码 porn：涉黄 ad：广告 abuse：辱骂 contraband：违禁品 其他自定义黑名单词库名称 表9 ImageDetectionResultAdDetail 参数 参数类型 描述 confidence Float 置信度，取值范围 0-1。 label String ad：label为对应的广告识别结果信息。 广告场景当前支持label列表如下： normal：正常 ad：广告 图文审核场景当前支持label列表如下： normal：正常 qr_code：二维码 porn：涉黄 ad：广告 abuse：辱骂 contraband：违禁品 其他自定义黑名单词库名称 hit_contexts Array of strings 图文审核场景命中的文本列表。 状态码： 400 表10 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 fail_category String 当包含多个场景时，调用失败的场景。

响应示例 状态码： 200 成功响应示例 { "result": [ { "url": "https://bucketname.obs.myhwclouds.com/ObjectName1", "suggestion": "block", "category_suggestions": { "terrorism": "pass", "porn": "block" }, "detail": { "terrorism": [ { "confidence": 0, "label": "xxx" }, { "confidence": 1, "label": "normal" } ], "porn": [ { "confidence": 0, "label": "normal" }, { "confidence": 1, "label": "xxx" } ] } } ] } 状态码： 400 失败响应示例 { "error_code" : "AIS.0005", "error_msg" : "The service does not exist." }

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的endpoint不同，具体请参见终端节点。 例如，服务部署在“华北-北京四”区域的“endpoint”为“moderation.cn-north-4.myhuaweicloud.com”，请求URL为“https://moderation.cn-north-4.myhuaweicloud.com/v3/{project_id}/moderation/image/batch”，“project_id”为项目ID，获取方法请参见获取项目ID。 识别用户上传的图像内容是否有敏感内容，检测场景为涉黄，暴恐。 POST https://{endpoint}/v2/{project_id}/moderation/image/batch { "urls" : [ "https://bucketname.obs.myhwclouds.com/ObjectName1", "https://bucketname.obs.myhwclouds.com/ObjectName2" ], "categories" : [ "terrorism", "porn" ], "threshold" : "" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 urls 是 Array of strings 图片的URL路径，目前支持： 公网HTTP/HTTPS URL 华为云OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详请参见配置OBS访问权限。 说明： 图片的URL路径列表最多支持10个URL地址。接口响应时间依赖图片的下载时间，如果图片下载时间过长，会返回接口调用失败。请保证被审核图片所在的存储服务稳定可靠，建议您使用华为云OBS存储。 categories 否 Array of strings 检测场景。 terrorism：暴恐元素的检测。 porn：涉黄内容元素的检测。 ad：广告图文的检测。 all：包含terrorism和porn场景的检测。 可通过配置上述场景，来完对应场景元素的检测。 为空或无此参数表示terrorism检测，但不包含porn场景。 说明： 每个检测场景的检测次数会分类统计。 ad_categories 否 Array of strings 图文审核检测场景。当categories包含ad时，该参数生效。 当前支持的场景有系统场景和用户自定义场景： 系统场景为： qr_code：二维码 porn：涉黄 ad：广告 abuse：辱骂 contraband：违禁品 用户自定义场景为：自定义黑名单词库。 说明： 自定义词库的创建和使用请参见配置自定义词库 V2。 threshold 否 Double 结果过滤门限，只有置信度不低于此门限的结果才会呈现在detail的列表中，取值范围 0-1，当未设置此值时各个检测场景会使用各自的默认值。 terrorism检测场景的默认值为0。 ad检测场景的默认值为0。 无特殊需求直接不传此参数或像示例中一样值设为空字符串即可。 说明： 如果检测场景中的最高置信度也未达到threshold，则结果列表为空；反之如果设置的threshold过小，则会使结果列表中内容过多。 threshold参数不支持porn场景筛选。 threshold参数不会对响应中的suggestion产生影响。 moderation_rule 否 String 图像审核规则名称，默认使用default规则。 说明： 审核规则的创建和使用请参见配置审核规则。 show_ocr_text 否 Boolean 是否返回ocr识别结果，默认值为false。

Django日志 日志样例： [08/Jan/2018 20:59:07 ] settings INFO Welcome to Hue 3.9.0 正则表达式为： ^\[(.*)\] (\w*) (\w*) (.*).* 解析结果如下： 表4 Django日志解析结果 列号 样值 1 08/Jan/2018 20:59:07 2 settings 3 INFO 4 Welcome to Hue 3.9.0

Apache server日志 日志样例： [Mon Jan 08 20:43:51.854334 2018] [mpm_event:notice] [pid 36465:tid 140557517657856] AH00489: Apache/2.4.12 (Unix) OpenSSL/1.0.1t configured -- resuming normal operations 正则表达式为： ^\[(.*)\] \[(.*)\] \[(.*)\] (.*).* 解析结果如下： 表5 Apache server日志解析结果 列号 样值 1 Mon Jan 08 20:43:51.854334 2018 2 mpm_event:notice 3 pid 36465:tid 140557517657856 4 AH00489: Apache/2.4.12 (Unix) OpenSSL/1.0.1t configured -- resuming normal operations

Tomcat日志 日志样例： 11-Jan-2018 09:00:06.907 INFO [main] org.apache.catalina.startup.VersionLoggerListener.log OS Name: Linux 正则表达式为： ^(\d.*\d) (\w*) \[(.*)\] ([\w\.]*) (\w.*).* 解析结果如下： 表3 Tomcat日志解析结果 列号 样值 1 11-Jan-2018 09:00:06.907 2 INFO 3 main 4 org.apache.catalina.startup.VersionLoggerListener.log 5 OS Name:Linux