华为云用户手册

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 code String 返回码 message String 返回描述 data data object 详情 表6 data 参数 参数类型 描述 pageNum Integer 页数 pageSize Integer 每页展示的数量 total Integer 总数 pages Integer 总页数 record Array of record objects 溯源码信息 表7 record 参数 参数类型 描述 gmtCreate String 创建时间 gmtModified String 修改时间 productName String 商品名称 batchCode String 批次码 isUse String 是否使用，0 未使用，1 已使用 itemCode String 一级溯源码 traceabilityStatus String 溯源状态，0 正常，1 禁用 productTraceUrl String 商品溯源url latestActionsDate String 最近溯源信息变化时间 latestActions String 最近溯源信息 isSupportTrace String 是否支持溯源，0 不支持，1 支持 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：100 error_msg String 错误描述 最小长度：1 最大长度：100

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 code String 返回码 message String 响应消息 data data object 商品详情 表5 data 参数 参数类型 描述 productCode String 商品码 productName String 商品名称 productPhotoUrl String 商品溯源url bannerUrl String 横幅url productOrigin String 商品产地 sweepcodeStatisticsSwitch String 商品溯源扫码统计开关(0：关闭；1 打开) merchant String 商户ID 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：100 error_msg String 错误描述 最小长度：1 最大长度：100

响应示例 状态码： 200 Success { "code" : "200", "message" : "操作成功!", "data" : { "productCode" : "77", "productName" : "7711", "productPhotoUrl" : "https://xxx.xxx.xxx.xxx/petaltrace/6BF050A8AA19BB2F0BFA9F2F0529991C.jpg", "bannerUrl" : "https://xxx.xxx.xxx.xxx/petaltrace/6BF050A8AA19BB2F0BFA9F2F0529991C.jpg", "productOrigin" : "bj", "sweepcodeStatisticsSwitch" : "1", "merchant" : "1759540612045058049" } } 状态码： 500 Error response { "code" : "500", "message" : "系统异常" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token 最小长度：1 最大长度：65535 表3 请求Body参数 参数 是否必选 参数类型 描述 productCode 否 String 产品编码(productCode和productName不能同时为空) 最小长度：1 最大长度：13 productName 否 String 产品名称(productCode和productName不能同时为空) 最小长度：1 最大长度：255 merchant 是 String 商户ID 最小长度：1 最大长度：100

请求示例 { "itemCode" : "fgYRvak0Z6", "linkCode" : "2024021920092096301701", "batchCode" : "366a8e60133c4046b86b582b5640ddba", "merchant" : "1759540612045058049", "logisticsEvent" : "采摘3", "operationWarehouse" : "西安中心仓库", "occurTime" : "2024-03-06T15:30:12+08:00" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token 最小长度：1 最大长度：65535 表3 请求Body参数 参数 是否必选 参数类型 描述 operationWarehouse 否 String 目的仓 最小长度：1 最大长度：255 merchant 是 String 商户ID 最小长度：1 最大长度：100 linkCode 是 String 环节码 最小长度：1 最大长度：100 batchCode 是 String 批次码 最小长度：1 最大长度：100 level3Code 否 String 三级溯源码(level3Code, level2Code itemCode这三个必须有其一，目前只支持一级码) 最小长度：1 最大长度：255 level2Code 否 String 二级溯源码(level3Code, level2Code itemCode这三个必须有其一，目前只支持一级码) 最小长度：1 最大长度：255 logistics 否 logistics object 物流信息 itemCode 否 String 一级溯源码(level3Code, level2Code itemCode这三个必须有其一，目只支持一级码) 最小长度：1 最大长度：255 logisticsEvent 是 String 物流事件，例如：出仓,入仓,到港,清关,门店售出 最小长度：1 最大长度：60 occurTime 否 String ISO8601标准格式（2024-03-06T15:30:12+08:00） 表4 logistics 参数 是否必选 参数类型 描述 logisticsOrderNo 是 String 物流单号 最小长度：1 最大长度：100 logisticsCompany 是 String 物流企业 最小长度：1 最大长度：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 label_quantity Long 溯源码数量 product_quantity Long 商品数量 状态码： 401 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：1 最大长度：512 状态码： 403 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：1 最大长度：512 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：100 error_msg String 错误描述 最小长度：1 最大长度：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code String 状态码 最小长度：1 最大长度：64 data data object 激活套餐包的任务信息 表4 data 参数 参数类型 描述 task_id String 任务ID 最小长度：1 最大长度：64 状态码： 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：1 最大长度：512 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：1 最大长度：512 状态码： 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：100 error_msg String 错误描述 最小长度：1 最大长度：100

响应示例 状态码： 200 success { "count" : 1, "packages" : [ { "id" : "string", "period_type" : 2, "edition" : "string", "period_num" : 1, "subscribe_num" : 1, "status" : "Inactive", "order_id" : " CS 2404180951BTYCQ", "usage" : 100, "amount" : 100, "effective_time" : "2021-08-17T15:14:30.689952+08:00", "expired_time" : "2021-08-17T15:14:30.689952+08:00", "countdown" : 0, "enterprise_project_id" : "0", "resource_spec_code" : "dac.times.public.100amount" } ] } 状态码： 500 Error response { "error_code" : "500", "error_msg" : "系统异常" }

URI GET /v1/{project_id}/trace/packages 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从 IAM 申请到的projectid，一般为32位字符串 最小长度：32 最大长度：32 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 分页，从第几项开始 最小值：0 最大值：65535 limit 否 Integer 每页大小，默认是10,可取值范围为10，20，50,1000 最小值：10 最大值：1000

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Integer 总数 最小值：0 最大值：2147483647 packages Array of PackagesInfo objects 套餐包信息 表5 PackagesInfo 参数 参数类型 描述 id String 唯一标识 最小长度：0 最大长度：255 period_type Integer 包周期类型 edition String 版本，标准版（standard），企业版（enterprise） period_num Integer 周期大小，取值范围1-10 subscribe_num Integer 订购数量 status String 套餐包状态(Unpaid:未支付，Activating：激活中，Inactive：未激活，Expired：已过期，Activated：已激活) 枚举值： Unpaid Activating Inactive Expired Activated order_id String 订单ID 最小长度：1 最大长度：64 usage Integer 溯源码使用量 最小值：0 最大值：2147483647 amount Integer 溯源码总量 最小值：0 最大值：2147483647 effective_time String 生效时间 最小长度：1 最大长度：64 expired_time String 过期时间 最小长度：1 最大长度：64 countdown Integer 保留期倒计时时间，最多保留7天 最小值：0 最大值：7 enterprise_project_id String 企业项目id,默认为“0” 最小长度：1 最大长度：255 resource_spec_code String 规格编码 最小长度：1 最大长度：255 状态码： 401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：1 最大长度：512 状态码： 403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：1 最大长度：512 状态码： 500 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：100 error_msg String 错误描述 最小长度：1 最大长度：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 created_at String 开通时间 is_subscribed Boolean 是否开通 edition String 购买的套餐包版本信息,取值为'standard','enterprise' 枚举值： standard Enterprise 状态码： 401 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：1 最大长度：512 状态码： 403 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：1 最大长度：512 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：100 error_msg String 错误描述 最小长度：1 最大长度：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code String 返回码 message String 返回描述 状态码： 401 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：1 最大长度：512 状态码： 403 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：36 error_msg String 错误描述 最小长度：1 最大长度：512 状态码： 500 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：100 error_msg String 错误描述 最小长度：1 最大长度：100

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 调用 语音合成 API，将文本合称为语音，并调整语音的音色、语速、音高、音量 POST https://{endpoint}/v1/{project_id}/tts Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "text": "欢迎使用语音云服务。", "config": { "audio_format": "wav", "sample_rate": "8000", "property": "chinese_xiaoyan_common", "speed": 10, "pitch": 10, "volume": 60 } } 使用Python3语言调用语音合成API，将文本合称为语音，并调整语音的音色、语速、音高、音量 # -*- coding: utf-8 -*- # 此demo仅供测试使用，强烈建议使用sdk。需提前安装requests，执行pip install requests import requests import json def stts_demo(): url = 'https://{{endpoint}}/v1/{{project_id}}/tts' # endpoint和project_id需替换 token = '用户对应region的token' text = '待识别的文本' header = { 'Content-Type': 'application/json', 'X-Auth-Token': token } body = {'text': text} resp = requests.post(url, data=json.dumps(body), headers=header) print(resp.text) if __name__ == '__main__': stts_demo() 使用Java语言调用语音合成API，将文本合称为语音，并调整语音的音色、语速、音高、音量 import java.io.BufferedReader; import java.io.InputStream; import java.io.InputStreamReader; import java.io.OutputStreamWriter; import java.net.HttpURLConnection; import java.net.URL; /** * 此demo仅供测试使用，强烈建议使用SDK */ public class SttsDemo { public void sttsDemo() { try { // endpoint和projectId需要替换成实际信息。 URL url = new URL("https://{{endpoint}}/v1/{{project_id}}/tts"); String token = "对应region的token"; HttpURLConnection connection = (HttpURLConnection)url.openConnection(); connection.setRequestMethod("POST"); connection.setDoInput(true); connection.setDoOutput(true); connection.addRequestProperty("Content-Type", "application/json"); connection.addRequestProperty("X-Auth-Token", token); OutputStreamWriter osw = new OutputStreamWriter(connection.getOutputStream(), "UTF-8"); String body = "{\"text\": \"123\"}"; osw.append(body); osw.flush(); InputStream is = connection.getInputStream(); BufferedReader br = new BufferedReader(new InputStreamReader(is, "UTF-8")); while (br.ready()) { System.out.println(br.readLine()); } } catch (Exception e) { e.printStackTrace(); } } public static void main(String[] args) { SttsDemo sttsDemo = new SttsDemo(); sttsDemo.sttsDemo(); } }

响应示例 状态码：200 成功响应示例 { "trace_id": "567e8537-a89c-13c3-a882-826321939651", "result":{ "data": "/+MgxAAUeHpMAUkQAANhuRAC..." } } 状态码：400 失败响应示例 { "error_code": "SIS.0032", "error_msg": "'audio_format' is invalid" }

响应参数 状态码： 200 表7 响应Body参数 参数 是否必选 参数类型 描述 trace_id 否 String 服务内部的令牌，可用于在日志中追溯具体流程。 在某些错误情况下可能没有此令牌字符串。 result 否 CustomResult object 调用成功表示合成结果，调用失败时无此字段。 表8 CustomResult 参数 是否必选 参数类型 描述 data 否 String 语音数据，以Base64编码格式返回。 用户如需生成音频，需要将Base64编码解码成byte数组，再保存为音频，音频格式同“audio_format”参数设置的值，默认为wav格式。 语音合成代码示例请参考SDK，SDK已对Base64转音频过程进行封装，可以直接获取音频文件。 状态码： 400 表9 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。响应消息头中X-Subject-Token的值即为Token。 Enterprise-Project-Id 否 String 企业项目ID。SIS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 企业项目创建步骤请参见用户指南。 说明： 账户创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用SIS服务，账单归到企业ID对应的企业项目中。 携带错误的ID，正常使用SIS服务，账单的企业项目会被分类为“default”。 不携带ID，正常使用SIS服务，账单的企业项目会被分类为“default”。 表3 请求Body参数 参数 是否必选 参数类型 描述 text 是 String 待合成的文本，文本长度限制不大于500字符。 config 否 TtsConfig object 语音合成配置信息。 表4 TtsConfig 参数 是否必选 参数类型 描述 audio_format 否 String 语音格式头：wav、mp3、pcm 默认：wav 父节点：config sample_rate 否 String 采样率：16000、8000赫兹 默认：8000 父节点：config property 否 String 语音合成特征字符串，组成形式为{language}_{speaker}_{domain}，即“语种_人员标识_领域”。发音人分为普通发音人和精品发音人，每次调用价格相同，针对精品发音人，每50字计一次调用，不足50字按一次计；普通发音人每100字计一次调用，不足100字按一次计。其中1个汉字、1个英文字母或1个标点均算作1个字符，具体费用请参考价格计算器。 普通发音人：取值范围请参考表 普通发音人property取值范围。 精品发音人：区域仅支持cn-north-4、cn-east-3，暂时不支持音高调节，取值范围请参考表 精品发音人property取值范围。使用精品发音人如果报错SIS.0411，请检查是否符合使用约束。 默认：chinese_xiaoyan_common，中文发音，小燕，温柔女声发音人。 父节点：config speed 否 Integer 语速。 取值范围：-500~500 默认值：0 父节点：config 说明： 当取值为“0”时，表示一个成年人正常的语速，约为250字/分钟。设置该值时，语速和数值没有绝对的映射关系。 pitch 否 Integer 音高。 取值范围： -500~500 默认值：0 父节点：config volume 否 Integer 音量。 取值范围：0~100 默认值：50 父节点：config 表5 普通发音人property取值范围 名称 property取值 类型 使用场景 支持采样率（Hz） 小琪 chinese_xiaoqi_common 标准女声 客服 8k/16k 小雯 chinese_xiaowen_common 柔美女声 客服 8k/16k 小宇 chinese_xiaoyu_common 标准男声 电销 8k/16k 小夏 chinese_xiaoxia_common 热情女声 电销 8k/16k 小燕 chinese_xiaoyan_common 温柔女声 文学 8k/16k 小倩 chinese_xiaoqian_common 成熟女声 文学 8k/16k 小王 chinese_xiaowang_common 童声 童声 8k/16k 小呆 chinese_xiaodai_common 呆萌童声 童声 8k/16k 小婧 chinese_xiaojing_common 俏皮女声 新闻播报 8k/16k 小宋 chinese_xiaosong_common 激昂男声 新闻播报 8k/16k cameal english_cameal_common 英文女声 英文 8k/16k 表6 精品发音人property取值范围 名称 property取值 类型 使用场景 支持采样率（Hz） 华小夏 chinese_huaxiaoxia_common 热情女声 电销 8k/16k 华小唯 chinese_huaxiaowei_common 嗲柔女声 电销 8k/16k 华小颜 chinese_huaxiaoyan_common 严厉女声 电销 8k/16k 华晓阳 chinese_huaxiaoyang_common 朝气男声 电销 8k/16k 华晓刚 chinese_huaxiaogang_common 利落男声 客服 8k/16k 华小雯 chinese_huaxiaowen_common 柔美女声 客服 8k/16k 华小美 chinese_huaxiaomei_common 温柔女声 客服 8k/16k 华小飞 chinese_huaxiaofei_common 朝气男声 客服 8k/16k 华小璐 chinese_huaxiaolu_common 知性女声 新闻播报 8k/16k 华小靓 chinese_huaxiaoliang_common 嘹亮女声 新闻播报 8k/16k 华晓东 chinese_huaxiaodong_common 成熟男声 新闻播报 8k/16k 华小蕊 chinese_huaxiaorui_common 知性女声 中英混合 16k 华小萱 chinese_huaxiaoxuan_common 台湾女声 方言 8k/16k 华小闽 chinese_huaxiaomin_common 闽南女声 方言 8k/16k 华小舒 chinese_huaxiaoshu_common 舒缓女声 文学 8k/16k 华女侠 chinese_huanvxia_literature 武侠女生（只支持http形式调用） 文学 16k 华晓悬 chinese_huaxiaoxuan_literature 悬疑男声（只支持http形式调用） 文学 16k 华小龙 chinese_huaxiaolong_common 朝气男声 中英混合 16k 华小汝 chinese_huaxiaoru_common 柔美女声 中英混合 8k/16k 华小涵 chinese_huaxiaohan_common 知性女声 中英混合 8k/16k 华小宁 chinese_huaxiaoning_common 沉稳男声 中英混合 8k/16k 华小珍 chinese_huaxiaozhen_common 温柔女声 中英混合 8k/16k 华小曼 chinese_huaxiaoman_common 温柔女声 中英混合 16k 华小芳 chinese_huaxiaofang_common 朝气女声 中英混合 16k 华小筠 chinese_huaxiaojun_common 成熟女声 中英混合 16k alvin english_alvin_common 成熟男声 纯英文 8k/16k amy english_amy_common 成熟女声 纯英文 8k/16k

应用场景简介 SIS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。企业可以根据组织架构规划不同的企业项目，并为每个企业项目设置拥有不同权限的用户组和用户，多个企业项目之间相互独立，资源分开结算。 企业账号可申请开通企业项目。账号需要进行企业实名认证。如果企业账号注册成为华为云合作伙伴，将无法进入企业项目管理页面。 开通企业项目后，企业项目内的用户在调用SIS API时，只有在请求Header参数中传入Enterprise-Project-Id（企业项目ID）后，才支持按不同企业项目进行财务统计。传参方式详见API文档。 图1 企业项目管理示意图 父主题： 企业项目管理

热词3.0 热词3.0在热词1.0基础上，增加了自定义权重热词和强制替换热词来提升特定场景关键词召回率，如下图3所示。控制台和后端API均已开放热词3.0的创建接口，但需注意的是，并非所有API均能使热词3.0算法生效，具体约束条件如下。 图3 创建热词表 支持的region： 北京四、上海一 支持的API： 实时语音识别 chinese_16k_general/chinese_8k_general、 一句话识别 chinese_16k_general和录音文件识别chinese_16k_media。 热词3.0能创建成功并不意味着一定生效，仅对以上四个API生效。其余API请按照热词1.0的规则创建热词。 热词3.0使用场景和配置规则如下。 普通热词 用于常见的命名实体识别，如地名、景点、商品名、领域关键词。 配置规则： 最多可以创建100个热词表，每个热词表支持10000个热词。 所有含英文的热词均需大写，如：Eiffel铁塔（正确示例为：EIFFEL铁塔）。 所有数字均用相应的汉字表示，不能使用阿拉伯数字 ，如：12345服务热线（正确示例为：一二三四五服务热线）。 热词内容仅包含英文和中文，不能包含标点符号、特殊字符，如：。，？.*等。 尽量避免配置单音节的英文单词，避免误召回，如：MAY/TEE等。 自定义权重热词 用于提升热词召回率，主要应用于以下场景。 所配置的关键词与常见词发音一样，导致热词不能百分百生效。如雇工 vs 故宫。由于故宫更加常见，所以可能存在即使配置了雇工这个热词，也无法召回的情况。 所配置的关键词含有生僻字，如葳蕤，霜蟾。这些生僻字出现的概率较低，所以在热词搜索过程中，可能不生效。 所配置的关键词较常见，与其他高频词容易混淆（误召回），如述职 vs 数值。 配置规则： 自定义权重热词用/将热词分为两个部分，左边即为普通热词，遵循普通热词的配置规则。 右边为1~10的整数（包含），数值越大热词的偏置力度越强，召回率越高（但误召回的风险越大）。 图4 配置示例 强制替换热词 强制替换作为热词功能的补充，主要解决以下两类问题： 一些极其罕见的词语，如绵绵瓜瓞，龙行龘（dá）龘，即使配置了热词，也无法识别，所以需要将谐音词进行强制替换：绵绵瓜叠=绵绵瓜瓞，龙行达达=龙行龘龘。 自定义格式输出，如特殊符号γ、β、奈雪の茶，数学公式x^2+1=0。 配置规则： 强制替换重热词用=将热词分为两个部分，左边为待替换词，遵循普通热词的配置规则。 等号右边为最终输出词，仅校验长度（不超过32字符）。

创建热词表（1.0版本） 创建热词表有两种方式：控制台创建、调用API创建。本章节主要介绍通过控制台创建的方法。 登录SIS服务控制台。 在左侧导航栏中选择“热词表配置”。并在配置页面单击“创建热词表”。 创建成功后，可对热词表内容进行编辑。支持中英混编，最多可添加10000个热词，热词之间用逗号分隔。 热词表支持英文和中文语言类型。中文语言类型的热词最长支持32字符，英文语言类型的热词最长支持64字符。 前端热词创建过程中，具备热词规则校验能力，会将不符合规则的热词返回给用户。 图1 创建热词表 创建热词时，需注意： 中文语言类型(chinese_mandarin)热词可以包含英文，但英文语言类型(english)热词不能包含中文。 热词表能创建通过，仅代表规则校验通过，但是否生效还需由具体API确定（如创建中文类型热词表，请求英文 语音识别 接口，热词不会生效）。 所有含英文的热词均需大写，如：Eiffel铁塔（正确示例为：EIFFEL铁塔）。 所有数字均用相应的汉字表示，避免使用阿拉伯数字 ，如：12345服务热线（正确示例为：一二三四五服务热线）。 热词内容仅包含英文和中文，避免出现标点符号、特殊字符或空格，如：。，？.*等。 尽量避免配置单音节的英文单词，避免误召回，如：MAY/TEE等。

APIG.0101 在调用 人脸识别 接口时，报错“APIG.0101”，“The API does not exist or has not been published in the environment”。该报错表示调用接口时使用的请求地址或者URL不存在或没有发布。 参考API使用说明获取正确的请求样例，并检查请求样例中需要修改的参数“{endpoint}”、{project_id}，是否按规范进行替换。同时检查url中填写的endpoint区域时否和开通服务区域一致。 参考API使用说明获取正确的请求样例。 # 查询服务状态 https://{endpoint}/v1/{project_id}/subscribe 将请求样例中的“{endpoint}”进行替换。 人脸识别服务 的请求地请参考终端节点终端节点章节进行获取。 例如，如果您的服务部署在华北-北京四区域，则该区域的endpoint为“face.cn-north-4.myhuaweicloud.com”。 将请求样例中的“{project_id}”进行替换。项目ID的获取方法请参见获取项目ID。 URL请参考构造请求构造请求章节。

操作场景 本节内容介绍了调用API时，常见的报错及处理办法。 表1 调用API高频报错处理办法 常见报错 处理办法 FRS.0020子服务未开通 开通该服务，检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致，检查API的URL是否拼写正确。 APIG.0101 检查请求地址或者URL是否填写正确。 账密报错The username or password is wrong 请确认近期华为云账号是否有升级为华为账号。如果进行过升级，建议您创建一个IAM账户，使用该账户 获取Token 。

FRS.0020子服务未开通 在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。该报错表示您的子服务没有开通，或url填写错误。 如未开通服务请登录人脸识别服务控制台人脸识别服务控制台选择“开通服务”。 如已经开通服务，请检查调用接口的请求地址是否正确。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 图1 检查区域信息

账密报错The username or password is wrong 获取Token时出现“The username or password is wrong.”。 请确认近期华为云账号是否有升级为华为账号。当前，如果您通过华为账号入口登录华为云账号，就会指引升级。华为云账号若已升级为华为账号，将不支持获取账号Token。 建议您创建一个IAM账户，使用该账户获取Token。 详细处理步骤请参见如何处理账密报错。

指定分组和资源标签 表15 指定分组和资源标签 参数名称 参数类型 是否必选 默认值 说明 参数规范 举例 resourceTag type = object ({group = stringfeatures = string}) 可选 无 group：指定集群部署的分组。 features：指定集群部署的标签信息。 此处配置的信息要再Runtime页面提前预置好。 resourceTag: group: "common" features: "dev"

修订记录 发布日期 更新说明 2024-03-30 第五次正式发布。 新增 xfs创建文件失败问题说明 2024-03-15 第四次正式发布。 新增 OOM相关参数配置与原因排查 2023-12-30 第三次正式发布。 新增 Huawei Cloud EulerOS、openEuler和EulerOS镜像的主要区别是什么？ HCE OS如何配置与EulerOS相同的日志转储？ 如何打开内核wireguard模块以及安装wireguard-tools？ 2023-09-27 第二次正式发布。 新增 如何安装mlnx驱动？ 如何开启HCE OS操作系统的SELinux功能？ 迁移系统后，如何更改控制台操作系统名称？ 2022-10-20 第一次正式发布。

HCE OS如何配置与EulerOS相同的日志转储？ HCE OS版本中的日志转储配置在hce-logrotate软件包中，对应EulerOS中的euleros-logrotate软件包。 操作方法如下： 2023年6月之前发布的HCE OS 版本，默认未安装hce-logrotate软件包，需执行命令yum install -y hce-logrotate进行手动安装。 2023年6月之后发布的HCE OS版本，已默认安装hce-logrotate软件包，如果有自定义的配置，需要手动同步配置，如果没有则无需其他操作。

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 详情请参见区域和可用区。 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中创建资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型 父主题： 使用前必读

错误码 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 CBH.10020009 请求消息格式非法 请求消息格式非法 请求消息格式非法 400 CBH.10020010 Request message param error. 请求消息体参数错误！ 请核对您的请求参数。 400 CBH.10020011 serverId错误 serverId错误 serverId错误 401 CBH.10020100 The IAM token is invalid. 无法通过IAM校验！ 请核对您的token是否正确。 403 CBH.10020002 Tenant has no authority. 租户无权限！ 该租户无权限，请去IAM确认用户权限。 500 CBH.10020000 Unknown error！ 未知错误！ 未知错误，请联系技术人员处理。 父主题： 附录

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 name String 云堡垒机 实例名称。 status String 堡垒机 实例状态。 POWERING_ON：正在开启 POWERING_OFF：正在关闭 DELETE_WAITE：等待删除 REBOOTING：重启中 RESIZE：变更中 UPGRADING：升级中 FROZEN：冻结 ACTIVE：运行 server_id String 云堡垒机实例ID，使用UUID格式表示。 实例ID获取方式。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_description String 请求参数错误。 状态码： 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_description String 校验TOKEN失败。 状态码： 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_description String 租户无权限操作。 状态码： 404 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_description String 没有找到CBH资源。