华为云用户手册

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxx" } } } } 获取Token 后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 1 2 3 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ....

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 notifications Array of NotificationList objects 通知列表 表4 NotificationList 参数 参数类型 描述 channel_name String 通道名称 status String 当前状态 updated_time String 更新时间 tc3_need Boolean 是否开启可信 invitor_info InvitorInfo object 邀请方信息 invitee_info InviteeInfo object 被邀请方信息 hide Long 是否删除 invitee_orgs Array of OrganizationV2 objects 被邀请的组织信息 read_status Long 阅读状态值 cross_version_upgrade String 跨版本进行升级 表5 InvitorInfo 参数 参数类型 描述 invitor_id String 邀请方用户id invitor_name String 邀请方用户名 invitor_bcs_id String 邀请方的服务实例id invitor_bcs_name String 邀请方的服务实例名 invitor_consensus String 邀请方的共识 invitor_project_id String 邀请方的projectID invitor_cluster_type String 邀请方的集群类型 invitor_database_type String 邀请方数据库类型 invitor_signature_algorithm String 邀请方的签名算法 invitor_fabric_version String 邀请方的fabric版本 order_fade_enabled Boolean 是否允许共识节点老化 order_fade_cache Long 共识节点的老化阈值 表6 InviteeInfo 参数 参数类型 描述 invitee_id String 被邀请用户id invitee_name Long 被邀请租户名称 invitee_bcs_name String 被邀请的服务实例名称 invitee_bcs_id String 被邀请的服务实例id invitee_project_id String 被邀请的项目id 表7 OrganizationV2 参数 参数类型 描述 name String 组织名称 name_hash String 组织hash node_count Integer 组织节点 status String 状态 status_detail String 状态描述 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 403 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 404 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 500 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512

响应示例 状态码： 400 Bad Request { "error_code" : " BCS .4006014", "error_msg" : "Invalid Parameter quotasType : ecs" } 状态码： 401 Unauthorized { "error_code" : "B CS .4010401", "error_msg" : "Incorrect token or token resolution failed" } 状态码： 403 Forbidden { "error_code" : "BCS.4030403", "error_msg" : "No permissions to request this method" } 状态码： 404 Not Found { "error_code" : "BCS.4040404", "error_msg" : "Not Found:the url is not found" } 状态码： 500 InternalServerError { "error_code" : "BCS.5000500", "error_msg" : "Internal Server Error" }

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误。 400 CBC.30010036 续费的资源非主资源，不允许续费。 400 CBC.30010069 不存在的续费周期。 400 CBC.30050006 订单自动支付失败。 400 CBC.99000092 订购周期校验失败。 400 CBC.99003100 当前操作的资源中，有资源包含在您的待支付的订单，不能进行当前操作。 400 CBC.99003016 资源已过期删除或不存在。 400 CBC.99003144 资源有处理中的订单，不能进行当前操作。 400 CBC.99003154 资源已购买时长加本次续费时长已超过最大值，请重新选择续费时长。 400 CBC.99003634 参与优惠套餐活动的资源需要整体续费，不能和其他资源一起续费。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

功能介绍 客户在伙伴销售平台完成包年/包月资源的续订。 客户的包年/包月资源即将到期时，可进行包年/包月资源的续订。 客户在费用中心执行续订操作请参见这里。 调用接口后，如果某个主资源有对应的从资源，系统会将主资源和从资源一起续订，主资源的从资源信息可以通过调用查询客户包年/包月资源列表接口获取。 注意：如ECS主机挂载新购的云硬盘，但此硬盘不是该ECS主资源的从资源，主从资源信息必须以调用查询客户包年/包月资源列表接口获取的信息为准。 本接口支持自动支付，支付时使用折扣或优惠券的说明，请参见支付使用折扣或优惠券说明。

包周期询价示例（通过价格计算器） 查询包年/包月产品价格接口的请求参数可通过价格计算器获取。 以“弹性云服务器”为例： 区域：华北-北京四 可用区：通用可用区 计费模式：包年包月 CPU架构：X86计算 规格 ：通用计算增强型 C6|2核|4GB 系统盘：通用型SSD 40G 购买时长：1个月 购买个数：1台 进入价格计算器页面，F12打开控制台。根据示例中的参数，在页面完成选择。 在控制台中进入Network选项，找到询价接口“resource”。点击“Payload”，查看接口请求参数。 根据步骤2获取到的请求参数拼接查询包年/包月产品价格接口请求参数。 如上图所示，查询包年/包月产品价格接口组合询价了一个弹性云服务器和一个云硬盘。所以产品信息列表product_infos需要两个结构体，最终结果如下所示： { "project_id": "84c5********fb2420", "product_infos": [ { "id": "1", "cloud_service_type": "hws.service.type.ec2", "resource_type": "hws.resource.type.vm", "resource_spec": "c6.large.2.linux", "region": "cn-north-4", "period_type": 2, "period_num": 1, "subscription_num": 1 }, { "id": "2", "cloud_service_type": "hws.service.type.ebs", "resource_type": "hws.resource.type.volume", "resource_spec": "GPSSD", "region": "cn-north-4", "resource_size": 40, "size_measure_id": 17, "period_type": 2, "period_num": 1, "subscription_num": 1 } ] } 【可选】登录APIExplorer，输入product_infos，询价得到的产品价格与价格计算器结果一致。 父主题： 询价接口指导

环境毒性（Environmental Toxicity） Bioconcentration Factors： 生物浓缩系数（BFC）。生物体内某种化合物的浓度同水中该物质的浓度比值，单位为log10(L/kg)。 IGC50： 48 hour Tetrahymena pyriformis IGC50（50% Inhibition Growth Concentration），导致50% Tetrahymena pyriformis生长抑制，在48小时后的化学物质浓度。单位为−log10[(mg/L)/(1000*MW)]。 LC50FM： 96 hour fathead minnow LC50，导致50% fathead minnow死亡，在96小时后的化学物质浓度。单位为−log10[(mg/L)/(1000*MW)]。 LC50DM： 48 hour Daphnia magna LC50，导致50% Daphnia magna死亡，在48小时后的化学物质浓度。单位为−log10[(mg/L)/(1000*MW)]。

分布（Distribution） PPB： Plasma protein binding，血浆蛋白结合度。结合度的多少会影响药物的渗透情况。 结果解释：结合度小于90%比较合适。 VD： Volume Distribution，体积分布，单位为L/kg。 结果解释：VD值在0.04~20L/kg之间较好。 BBB Penetration： blood–brain barrier Penetration，血脑屏障。作用于中枢神经系统的药物需要穿过血脑屏障 (BBB) 才能达到其分子靶点。相反，对于具有外围靶点的药物，不需要BBB渗透以避免中枢神经系统副作用，单位为cm/s。logBB 大于-1为（BBB+）, logBB小于等于-1为（BBB-），数值在0~1之间。 结果解释：预测值的范围在0~1之间。 Fu： The fraction unbound in plasms，未结合血清蛋白的比例。药物与血清蛋白的结合程度越高，渗透性越差。 结果解释：未结合比例大于等于5%效果较好。

Tox21通路（Tox21 Pathway） NR-AR： Androgen receptor，雄激素受体。在AR依赖性前列腺癌和其他相关雄激素相关疾病中其关键作用，内分泌干扰物与AR的相互作用，会破坏正常的内分泌功能，因此需要了解化学物质对ER信号通路的影响。0为AR无活性，1为AR有活性。数值在0~1之间。 结果解释：预测值的范围在0~1之间。 NR-AR-LBD： 雄激素受体配体结合区。0为AR-LBD无活性，1为AR-LBD有活性。数值在0~1之间。 结果解释：预测值的范围在0~1之间。 NR-AhR： The Aryl hydrocarbon Receptor，芳香烃受体。AhR是一种配体激活性转录因子。当与多环芳烃、卤代芳烃等配体结合后，可调控一系列基因的表达。0为AhR无活性，1为AhR有活性。数值在0~1之间。 结果解释：预测值的范围在0~1之间。 NR-Aromatase： Aromatase，芳香化酶，是雌激素生物合成的关键酶。0为Aromatase无活性，1为Aromatase有活性。数值在0~1之间。 结果解释：预测值的范围在0~1之间。 NR-ER： Estrogen receptor，雌激素受体。在发育和新城代谢中起重要作用，内分泌干扰物与ER的相互作用，会破坏正常的内分泌功能，因此需要了解化学物质对ER信号通路的影响，0为Estrogen receptor无活性，1为Estrogen receptor有活性。数值在0~1之间。 结果解释：预测值的范围在0~1之间。 NR-ER-LBD： 雌激素受体配体结合区。0为ER-LBD无活性，1为ER-LBD有活性。数值在0~1之间。 结果解释：预测值的范围在0~1之间。 NR-PPAR-gamma： peroxisome proliferator-activated receptors PPAR，过氧化物酶体增殖物激活受体。PPAR是一类由配体激活的核转录因子，PPAR超家族有3个亚型:即PPAR-α、 PPAR-δ（又称PPAR-β或NUC-1）和PPAR-γ,分别由不同的基因编码，PPAR-γ受体（格列酮受体）。参与调节糖脂代谢。0为PPAR-gamma无活性，1为PPAR-gamma有活性。数值在0~1之间。 结果解释：预测值的范围在0~1之间。 SR-ARE： antioxidant response element ARE，抗氧化反应元件。ARE与Nrf2结合，启动下游大量的抗氧化酶基因的转录。0为ARE无活性，1为ARE有活性。数值在0~1之间。 结果解释：预测值的范围在0~1之间。 SR-ATAD5： ATPase family AAA domain-containing protein 5，三磷酸腺苷酶家族蛋白5。ATAD5会随着各种类型的DNA损伤而在蛋白质水平上增长。0为ATAD5无活性，1为ATAD5有活性，数值在0~1之间。 结果解释：预测值的范围在0~1之间。 SR-HSE： Heat shock factor，热激蛋白。HSE是一类功能性相关蛋白质，当细胞受到升高温度或其他胁迫时它们的表达就会增长。0为HSE无活性，1为HSE有活性，数值在0~1之间。 结果解释：预测值的范围在0~1之间。 SR-MMP： Mitochondrial membrane potential，线粒体膜电位。线粒体是动植物细胞生成ATP的主要地点，是促进细胞能量转换、参与细胞凋亡的重要细胞器。 线粒体在产生能量时会将电化学势能储存于线粒体内膜，在内膜两侧，若质子及其他离子浓度的不对称分布就会形成线粒体膜电位，即MMP，测量活细胞中的MMP通常用于评估化学物质对线粒体功能的影响。0为MMP无活性，1为MMP有活性，数值在0~1之间。 结果解释：预测值的范围在0~1之间。 SR-p53： p53，一种肿瘤抑制因子，控制细胞周期的启动。在所有恶性肿瘤中，50%以上会出现该基因的突变。0为p53无活性，1为p53有活性，数值在0~1之间。 结果解释：预测值的范围在0~1之间。

毒效团（Toxicophore Rules） Acute Toxicity Rule: 有20个子结构，含有该子结构可能在口服给药期间引起急性毒性。 结果解释：数值代表有多少个子结构匹配此数据库，可以通过DETAIL查看所匹配的子结构特征。 Genotoxic Carcinogenicity Rule： 117个子结构，含有该子结构可能通过遗传毒性引起致癌性或者致突变性。 结果解释：数值代表有多少个子结构匹配此数据库，可以通过DETAIL查看所匹配的子结构特征。 NonGenotoxic Carcinogenicity Rule: 23个子结构，含有该子结构可能通过非遗传毒性引起致癌性或者致突变性。 结果解释：数值代表有多少个子结构匹配此数据库，可以通过DETAIL查看所匹配的子结构特征。 Skin Sensitization Rule： 155个子结构，含有该子结构可能会导致皮肤损伤。 结果解释：数值代表有多少个子结构匹配此数据库，可以通过DETAIL查看所匹配的子结构特征。 Aquatic Toxicity Rule： 99个子结构，含有该子结构可能会对液体（包括水）造成毒性。 结果解释：数值代表有多少个子结构匹配此数据库，可以通过DETAIL查看所匹配的子结构特征。 NonBiodegradable Rule： 19个子结构，含有该子结构可能会不可生物降解。 结果解释：数值代表有多少个子结构匹配此数据库，可以通过DETAIL查看所匹配的子结构特征。 SureChEMBL Rule： 164个子结构，含有该子结构可能会具有不好的药物化学结构。 结果解释：数值代表有多少个子结构匹配此数据库，可以通过DETAIL查看所匹配的子结构特征。 FAF-Drugs4 Rule： 154个子结构，含有该子结构可能会有毒性。 结果解释：数值代表有多少个子结构匹配此数据库，可以通过DETAIL查看所匹配的子结构特征。

吸收（Absorption） Caco-2 Permeability： 人体结肠腺癌细胞系（Caco-2）用来估计药物渗透性。单位为Log cm/s。 结果解释：大于-5.15 log cm/s代表具有较好的渗透性。 MDCK Permeability： MDCK细胞的表观渗透系数Papp用来估计药物进入人体的吸收效率。单位为cm/s。 结果解释：大于20 x 10-6cm/s代表具有较好的渗透性，2~20 x 10-6cm/s具有一般渗透性，小于2 x 10-6cm/s具有较差的渗透性。 Pgp-inhibitor： Pgp-inhibitor，Pgp抑制。0为非Pgp抑制，1为Pgp抑制。 结果解释：预测值的范围在0~1之间。 Pgp-substrate： Pgp-substrate，Pgp基质。0为非Pgp基质，1为Pgp基质。 结果解释：预测值的范围在0~1之间。 HIA： Human intestinal absorption，人体肠道吸收指标。HIA大于30%代表具有较好的吸收性（HIA+），小于30%为（HIA-）。 结果解释：预测值的范围在0~1之间。 F20%： The human oral bioavailability 20%，人体口服生物利用度。大于20%为（F20%+），小于20%为（F20%-）。 结果解释：预测值的范围在0~1之间。 F30%： The human oral bioavailability 30%，人体口服生物利用度。大于30%为（F30%+），小于30%为（F30%-）。 结果解释：预测值的范围在0~1之间。

代谢（Metabolism） Metabolism 药物代谢反应过程可以分为两大类：第一阶段（氧化反应），第二阶段（共轭反应），人类细胞色素P450家族与第一阶段的氧化反应有关，其中1A2、3A4、2C9同工酶尤为重要，大部分集中在肝脏。0为非抑制剂/非基质，1为抑制剂/基质，数值范围在0~1之间。 结果解释：预测值的范围在0~1之间。 CYP1A2 inhibitor 细胞色素P450 1A2亚型抑制剂，0为非抑制剂，1为抑制剂。 结果解释：预测值的范围在0~1之间。 CYP2C9 inhibitor 细胞色素P450 2C9亚型抑制剂，0为非抑制剂，1为抑制剂。 结果解释：预测值的范围在0~1之间. CYP3A4 inhibitor 细胞色素P450 3A4亚型抑制剂，0为非抑制剂，1为抑制剂。 结果解释：预测值的范围在0~1之间。 CYP2C19 inhibitor 细胞色素P450 2C19亚型抑制剂，0为非抑制剂，1为抑制剂。 结果解释：预测值的范围在0~1之间。

修订记录 表1 修订记录 文档版本 发布日期 修改说明 04 2024-04-11 第四次正式发布。 新增： 支持分子搜索。 支持自定义数据库。 修改： 分子优化。 靶点口袋发现。 靶点口袋分子设计。 自由能微扰。 分子属性预测。 合成路径规划。 03 2023-12-30 第三次正式发布。 新增： 支持小分子聚类。 支持卡片视图，同时查看多个小分子。 修改： 导入应用的数量限制。 分子属性上限。 分子对接计费规则。 02 2023-11-02 第二次正式发布。 新增 靶点口袋发现 靶点口袋分子设计 AI模型 修改 分子对接 分子优化 自由能微扰 分子属性预测 01 2023-08-10 第一次正式发布。 父主题： 用户指南（盘古辅助制药）

操作步骤 登录华为云管理控制台，鼠标指向页面右上角的用户名，在下拉列表中单击“我的凭证”。 图1 我的凭证入口 在“我的凭证”页面中选择“访问密钥”页签。单击“新增访问密钥”，按操作指引获取认证账账号的AK/SK，请妥善保管AK/SK信息。 图2 访问密钥 每个用户仅允许新增两个访问密钥。 为保证访问密钥的安全，访问密钥仅在初次生成时自动下载，后续不可再次通过管理控制台页面获取。请在生成后妥善保管。

步骤4：创建应用 在“项目管理”页面“工具”页签中，单击“新建应用”。 填写应用的基本信息。 “名称”填写fastqc，“版本”填写v0.11.5.2。“短描述”、“描述”、“标签”可选填。 图2 填写基本信息 选择镜像。 单击“选择镜像”，在“ 自定义镜像 ”列表中选择fastqc镜像和镜像版本。 依据FastQC命令说明填写镜像启动命令。 镜像启动命令需要引用输入、输出参数中的变量，并以大括号扩起，以$符号进行引用。 fastqc软件输入参数填写为input-file、threads，输出参数为output-dir，则镜像启动命令如下所示。 使用-t命令，指定运行所需的线程数量。-o命令，指定存放输出结果的文件夹。输入文件夹已在填写参数时指定。 fastqc -t ${threads} -o ${output-dir} ${input-file} 选择“X86”CPU架构，CPU需求建议0.2起。GPU类型选择“无”。 按需填写内存大小，单位为GB。FastQC运行中所需内存大小依赖于输入数据大小，建议至少1GB。 图3 CPU、内存、GPU 填写参数。 通过阅读FastQC命令说明，了解命令。 图4 FastQC命令 填写所需的输入参数。 图5 输入参数 填写所需的输出参数。 因镜像启动命令中指定了输出参数，设置输出参数时，需勾选“必传”，并填写“默认值”。例如，输出结果默认存放在fastqc_output文件夹中。 图6 输出参数 单击“立即创建”，完成fastqc应用的创建。 创建完成后的应用，将显示在应用列表中，您可以使用该应用创建分析作业。

步骤2：制作镜像 方法1：直接下载官方的FastQC镜像。 执行如下命令下载FastQC镜像。 docker pull biocontainers/fastqc:v0.11.5 方法2：通过Dockerfile制作FastQC镜像。 执行vi Dockerfile命令，进入Dockerfile文件中，编写文件。 FROM ubuntu:16.04 # FastQC依赖java运行，需安装java环境。安装执行下载、解压缩的软件包 RUN apt-get update && apt-get upgrade -y \ && apt-get install -y default-jre perl wget zip # 下载FastQC，解压缩，设置FastQC可执行权限 RUN wget https://www.bioinformatics.babraham.ac.uk/projects/fastqc/fastqc_v0.11.5.zip \ && unzip fastqc_v0.11.5.zip \ && rm fastqc_v0.11.5.zip \ && chmod +x /FastQC/fastqc # 将FastQC添加到环境变量中 ENV PATH "/FastQC:$PATH 按Esc键，并执行:wq退出Dockerfile。 制作镜像。 docker build -t fastqc:v0.11.5 . 详细的Dockerfile指令请参见Dockerfile参考。

步骤1：搭建Docker环境 搭建Docker环境，您可以任选以下两种方式搭建Docker环境。 使用自己的电脑搭建Docker环境。 使用华为云弹性 云服务器ECS 搭建Docker环境。 本示例中使用华为云弹性服务器ECS，并通过ECS搭建Docker环境。在创建ECS时，可以选择ECS的操作系统。例如，在Linux操作系统下，可以使用如下命令快速安装容器引擎。 curl -fsSL get.docker.com -o get-docker.sh sh get-docker.sh 检查安装结果。 执行docker --version命令，如果显示如下类似信息，表示Docker安装成功。 图1 Docker安装成功

公共响应参数 公共响应参数如表 公共响应参数所示。 表1 公共响应参数 参数名 说明 Content-Length 响应消息体的字节长度，单位为Byte。 Date 系统响应的时间。 Content-type 发送的实体的MIME类型。 Upgrade 发送WebSocket握手请求时，响应消息包含该头域，内容为Websocket。 Connection 发送WebSocket握手请求时，响应消息包含该头域，内容为Upgrade。 Sec-WebSocket-Accept 结合Sec-WebSocket-Key提供基本的防护，比如恶意的连接，或者无意的连接。 父主题： 附录

示例 { "command": "START", "text": "欢迎使用语音云服务。", "config": { "audio_format": "pcm", "sample_rate": "8000", "property": "chinese_xiaoyan_common", "speed": 10, "pitch": 10, "volume": 60 } }

请求消息 表1 参数说明 名称 参数类型 是否必选 说明 command String 是 需设置为START，表示开始识别请求。 text String 是 待合成的文本，chinese_huaxiaomei_common,chinese_huaxiaofei_common,chinese_huaxiaolong_common,chinese_huaxiaorui_common发音人支持长度不大于10000字符的文本，其他发音人支持长度不大于500字符的文本。 config Object 否 配置信息。请参考表2。 表2 config数据结构 名称 参数类型 是否必选 说明 audio_format String 否 语音格式头：pcm、alaw、ulaw、mp3。 默认：pcm sample_rate String 否 采样率：16000、8000赫兹。 默认：8000 property String 否 可参考表3和表4。 默认：chinese_xiaoyan_common 实时 语音合成 和语音合成属于同一种资源，按次计费。实时语音合成普通发音人，每100字计一次。精品发音人每50字计一次。 speed Integer 否 语速。 取值范围：-500~500 默认值：0 pitch Integer 否 音高。 取值范围：-500~500 默认值：0 volume Integer 否 音量。 取值范围：0~100 默认值：50 subtitle String 否 是否生成时间戳信息，不使用则不填写。 取值范围： “word_level”：文本级别时间戳 “phoneme_level”：音素级别时间戳 注：chinese_huaxiaomei_common、chinese_huaxiaofei_common支持该功能，其他property暂不支持 表3 普通发音人property取值范围 名称 property取值 类型 使用场景 支持采样率（Hz） 支持audio_format 小琪 chinese_xiaoqi_common 标准女声 客服 8k/16k pcm、alaw、ulaw 小宇 chinese_xiaoyu_common 标准男声 电销 8k/16k pcm、alaw、ulaw 小燕 chinese_xiaoyan_common 温柔女声 文学 8k/16k pcm、alaw、ulaw 小王 chinese_xiaowang_common 童声 童声 8k/16k pcm、alaw、ulaw 表4 精品发音人property取值范围 名称 property取值 类型 使用场景 支持采样率（Hz） 支持audio_format 华小美 chinese_huaxiaomei_common 温柔女声 客服 8k/16k pcm、mp3 华小飞 chinese_huaxiaofei_common 朝气男声 客服 8k/16k pcm、mp3 华小汝 chinese_huaxiaoru_common 柔美女声 中英混合 8k/16k pcm 华小涵 chinese_huaxiaohan_common 知性女声 中英混合 8k/16k pcm 华小蕊 chinese_huaxiaorui_common 知性女声 中英混合 16k pcm、mp3 华小龙 chinese_huaxiaolong_common 朝气男声 中英混合 16k pcm、mp3 华小珍 chinese_huaxiaozhen_common 温柔女声 中英混合 8k/16k pcm alvin english_alvin_common 成熟男声 纯英文 8k/16k pcm amy english_amy_common 成熟女声 纯英文 8k/16k pcm

接口使用介绍 实时语音识别 接口使用Websocket协议承载，客户端与服务端交流流程如图1所示。 分为三个主要步骤： WebSocket握手。 基于WebSocket协议进行实时 语音识别 。 关闭WebSocket连接。 其中，基于WebSocket协议进行实时语音识别时，需要客户端首先发送转写开始消息，然后持续发送语音数据至服务端，最后发送结束消息，在此期间客户端会持续收到服务端发送的转写结果或事件，客户端根据所收到的响应消息做对应处理。实时语音识别接口的具体细节请参见接口说明章节。 图1 客户端与服务端交流流程

代码示例 import okhttp3.OkHttpClient; import okhttp3.Request; import okhttp3.Response; import okhttp3.WebSocket; import okhttp3.WebSocketListener; import okio.ByteString; /** * 此demo仅供测试使用，强烈建议使用SDK * 使用前需已配置okhttp、okio jar包。jar包可通过下载SDK获取。 */ public class SasrWebsocketDemo { public void sasrWebsocketDemo() { try { // endpoint和projectId需要替换成实际信息。 String url = "wss://{{endpoint}}/v1/{{project_id}}/asr/short-audio"; String token = "对应region的token"; byte[] data = null; // 存放将要发送音频的byte数组 OkHttpClient okHttpClient = new OkHttpClient(); Request request = new Request.Builder().url(url).header("X-Auth-Token", token).build(); WebSocket webSocket = okHttpClient.newWebSocket(request, new MyListener()); webSocket.send("{\"command\": \"START\", \"config\": {\"audio_format\": \"pcm8k16bit\", \"property\": \"chinese_8k_common\"}}"); webSocket.send(ByteString.of(data)); // audio太大注意要分片发送，否则会报错。建议分片大小3200 webSocket.send("{ \"command\": \"END\"}"); Thread.sleep(10000); webSocket.close(1000, null); } catch (Exception e) { e.printStackTrace(); } } class MyListener extends WebSocketListener { @Override public void onOpen(WebSocket webSocket, Response response) { System.out.println("conneected"); } @Override public void onClosed(WebSocket webSocket, int code, String reason) { System.out.println("closed"); } @Override public void onFailure(WebSocket webSocket, Throwable t, Response response) { t.printStackTrace(); } @Override public void onMessage(WebSocket webSocket, String text) { System.out.println(text); } } public static void main(String[] args) { SasrWebsocketDemo sasrWebsocketDemo = new SasrWebsocketDemo(); sasrWebsocketDemo.sasrWebsocketDemo(); } }

结束识别 功能介绍 对于识别中的对话，需要在Websocket上发送“结束识别”的请求来取消或结束识别。 "结束识别"请求使用文本类型的数据帧(text message)发送，命令和参数以json字符串的形式提供。 请求消息 表7 参数说明 参数名 是否必选 参数类型 说明 command 是 String 表示客户端结束识别请求，参数值设置为END。 示例 { "command": "END" } 状态码 状态码请参见状态码。 错误码 错误码请参见错误码。

响应结果 开始识别响应 由于WebSocket是全双工的，因此响应就是从服务器端发送给客户端的消息，但也并不是所有的请求信息都有一条对应的响应。服务器端收到“开始识别”请求时，会给出如下响应消息，以json字符串形式放置在text message中。 表8 响应参数 参数名 参数类型 说明 resp_type String 响应类型。参数值为START，表示开始识别响应。 trace_id String 服务内部的令牌，可用于在日志中追溯具体流程。 示例 { "resp_type": "START", "trace_id": "567e8537-a89c-13c3-a882-826321939651" } 事件响应 服务器端检测到某些事件时，会给出如下响应消息，以json字符串形式放置在text message中。 表9 响应参数 参数名 参数类型 说明 resp_type String 响应类型。参数值为EVENT，表示开始识别响应。 trace_id String 服务内部的令牌，可用于在日志中追溯具体流程。 event String 具体的事件， 一句话识别 中仅会出现"EXCEEDED_AUDIO”，当输入音频超过1min时，会返回该事件。 timestamp Integer 保留字段。将来会用于此事件发生的具体时间，以会话开始作为0点，单位为ms。 示例 { "resp_type": "EVENT", "trace_id": "567e8537-a89c-13c3-a882-826321939651", "event": "EXCEEDED_AUDIO", "timestamp": 1500 } 结果响应 服务端在收到客户端发送的连续音频数据后， 当服务端识别出结果后会实时向客户端按句推送识别结果响应消息， 以json字符串形式放置在text message中。 表10 响应参数 参数名 参数类型 说明 resp_type String 响应类型。参数值为RESULT，表示识别结果响应。 trace_id String 服务内部的令牌，可用于在日志中追溯具体流程。 segments Array of objects 多句结果。 请参考表 segment 数据结构。 表11 segment 数据结构 参数名 参数类型 说明 start_time Integer 一句的起始时间戳，单位为ms。 end_time Integer 一句的结束时间戳，单位为ms。 is_final Boolen true表示是最终结果， false表示为中间临时结果。 result Object 调用成功表示识别结果，调用失败时无此字段。 请参考表 result数据结构。 表12 result数据结构 参数名 参数类型 说明 text String 识别结果。 score Float 识别结果的置信度，取值范围：0~1。此值仅会在最终结果时被赋值，在中间结果时统一置为“0.0”。 说明： 目前置信度作用不是太大，请勿过多依赖此值。 word_info Array of Object 分词输出列表。 表13 word_info 数据结构 参数名 是否必选 参数类型 说明 start_time 否 Integer 起始时间 end_time 否 Integer 结束时间 word 否 String 分词 示例 { "resp_type": "RESULT", "trace_id": "567e8537-a89c-13c3-a882-826321939651", "segments": [ { "start_time": 100, "end_time": 1500, "is_final": false, "result": { "text": "第一句中间结果", "word_info": [ { "start_time": 100, "end_time": 800, "word": "第一" }, { "start_time": 800, "end_time": 1000, "word": "句" }, { "start_time": 1000, "end_time": 1500, "word": "结果" } ], "score": 0.0 }, }, ] } 错误响应 错误响应，包括如下情况： 配置串错误，包括存在不识别的配置串，或者配置串值的范围不合法。 时序不正确，比如连续发送两次“开始识别”指令。 识别过程中发生错误，比如音频解码发生错误。 表14 响应参数 参数名 参数类型 说明 resp_type String 参数值为ERROR，表示错误响应。 trace_id String 服务内部的跟踪令牌，可用于在日志中追溯具体流程。 在某些错误情况下，可能没有此字段。 error_code String 错误码列表。详细错误码解释，请参见错误码。 error_msg String 返回错误信息。 示例 { "resp_type": "ERROR", "trace_id": "567e8537-a89c-13c3-a882-826321939651", "error_code": "SIS.0002", "error_msg": "***" } 结束识别响应 服务器端收到“结束识别”请求时或语音识别过程中发生错误，服务端会向客户端推送如下响应消息，以json字符串形式放置在text message中。 表15 响应参数 参数名 参数类型 说明 resp_type String 参数值为END，表示结束识别响应。 trace_id String 服务内部的令牌，可用于在日志中追溯具体流程。 reason String 结束原因，详情请参见表 结束原因表。 表16 结束原因表 参数名 说明 NORMAL 正常结束。 ERROR 识别过程中发生错误。 示例 { "resp_type": "END", "trace_id": "567e8537-a89c-13c3-a882-826321939651", "reason": "NORMAL", }

wss-URI wss-URI格式 wss /v1/{project_id}/asr/short-audio 参数说明 表1 参数说明 参数名 是否必选 说明 project_id 是 项目编号。获取方法，请参见获取项目ID。 表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”。

开始识别 功能介绍 当wss握手请求收到成功响应后，客户端到服务端的通信协议会升级为Websocket协议。通过Websocket协议，客户端发送开始识别请求，用于配置一句话识别的配置信息。 请求消息 表3 参数说明 参数名 是否必选 参数类型 说明 command 是 String 表示客户端发送开始识别请求，参数值需设置为START。 config 是 Object 配置信息。结构信息请参见表 config数据结构。 表4 config数据结构 参数 是否必选 参数类型 说明 audio_format 是 String 支持语音的格式，请参见表 audio_format取值范围。 property 是 String 所使用的模型特征串。通常是 “语种_采样率_领域”的形式，例如chinese_8k_common。请参见表 property取值范围。 add_punc 否 String 表示是否在识别结果中添加标点，取值为yes 、 no，默认no。 digit_norm 否 String 表示是否将语音中的数字识别为阿拉伯数字，取值为yes 、 no，默认为yes。识别结束后，会将数字识别为阿拉伯数字。 interim_results 否 String 是否输出中间结果，可以为yes或no。默认为no，表示不输出中间结果。 vocabulary_id 否 String 热词表id，不使用热词则不填写。 创建热词表信息请参考创建热词表。 need_word_info 否 String 表示是否在识别结果中输出分词结果信息，取值为“yes”和“no”，默认为“no”。 表5 property取值范围 property取值 说明 chinese_8k_general 支持采样率为8k的中文普通话语音识别，采用新一代端到端识别算法，识别准确率更高。 格式支持pcm8k16bit/alaw8k8bit/ulaw8k8bit，区域支持cn-east-3和cn-north-4（强烈推荐使用）。 chinese_16k_general 支持采样率为16k的中文普通话语音识别，采用新一代端到端识别算法，识别准确率更高。 格式支持pcm16k16bit/alaw16k8bit/ulaw16k8bit，区域支持cn-east-3和cn-north-4（强烈推荐使用）。 chinese_8k_common 支持采样率为8k的中文普通话语音识别。 chinese_16k_common 支持采样率为16k的中文普通话语音识别。 sichuan_16k_common 支持采样率为16k的中文普通话与四川话方言语音识别。区域仅支持cn-north-4。max_seconds参数最短时长为10s，当设置低于10s，默认按照10s处理。 cantonese_16k_common 支持采样率为16k的粤语方言语音识别。区域仅支持cn-north-4。max_seconds参数最短时长为10s，当设置低于10s，默认按照10s处理。 shanghai_16k_common 支持采样率为16k的上海话方言语音识别。区域仅支持cn-north-4。max_seconds参数最短时长为10s，当设置低于10s，默认按照10s处理。 表6 audio_format取值范围 audio_format取值 说明 pcm16k16bit 16k16bit单通道录音数据。 pcm8k16bit 8k16bit单通道录音数据。 ulaw16k8bit 16k8bit ulaw单通道录音数据。 ulaw8k8bit 8k8bit ulaw单通道录音数据。 alaw16k8bit 16k8bit alaw单通道录音数据。 alaw8k8bit 8k8bit alaw单通道录音数据。 目前仅支持裸音频格式，仅支持pcm编码的wav格式，不支其他wav头或者arm格式的编码。 示例 { "command": "START", "config": { "audio_format": "pcm8k16bit", "property": "chinese_8k_common", "add_punc": "yes", "interim_results": "yes", "need_word_info": "yes" } } 状态码 状态码请参见状态码。 错误码 错误码请参见错误码。

功能介绍 一句话识别websocket接口支持识别1min以内的音频，交互过程如图 客户端和服务端交互流程所示，主要分为开始识别、发送音频数据，结束识别、断开连接四个步骤。 websocket接口同http接口一致按次计费，只要建立连接成功，发送音频，服务开始识别，则本次调用计费生效。如果用户发送错误end请求或者持续20s未发送音频而产生了报错，该次调用依然认为生效。如果连接成功后未发送音频直接断开，或者请求字段不正确而产生异常，则认为本次调用无效，不会纳入计费次数。 图1 客户端和服务端交互流程

产品简介 GaussDB (for MySQL)实例支持只读节点。 在对数据库有少量写请求，但有大量读请求的应用场景下，单个实例可能无法抵抗读取压力，甚至对主业务产生影响。为了实现读取能力的弹性扩展，分担数据库压力，您可以在某个区域中创建一个或多个只读节点，利用只读节点满足大量的数据库读取需求，以此增加应用的吞吐量。您需要在应用程序中分别配置主实例和每个只读节点的连接地址，才能实现将写请求发往主节点，而将读请求发往只读节点。

功能限制 “包年/包月”和“按需计费”实例最多可以创建15个只读节点。 Serverless实例可创建0~1个只读节点，如需更多只读节点，可以联系客服最多申请创建7个只读节点。 实例恢复：不支持通过任意时间点创建临时节点，不支持通过备份集覆盖节点。 数据迁移：不支持将数据迁移至只读节点。 数据库管理：不支持创建和删除数据库。 账号管理：只读节点不提供创建账号权限。 只读节点与主节点可能会存在时延，其中全文索引由于其本身的特殊机制，延时较为显著。如果您的业务对时延较为敏感，可将查询发送到主节点。

账户密码等级设置 GaussDB(for MySQL)管理控制台上数据库密码复杂度，请参见购买实例中的数据库配置表格。 GaussDB(for MySQL)对在客户端新创建的数据库用户，设置了密码安全策略： 口令长度8~32个字符。 口令至少包含大写字母、小写字母、数字、特殊字符三种字符的组合，其中允许输入~!@#%^*-_=+?,()&$|.特殊字符。 不能与用户名或倒序的用户名相同。 创建实例时，为用户提供了密码复杂度校验，由于root用户可以修改密码复杂度，安全起见，建议修改后的密码复杂度不低于GaussDB(for MySQL)数据库的初始化设置。