华为云用户手册

自然语言处理服务支持哪几种语言？ 自然语言处理服务各个API接口支持的语言如表1所示。 表1 NLP支持语言 接口类型 接口 支持语言 自然语言处理基础接口 分词 中文（zh）、英文（en） 多粒度分词 中文（zh）、英文（en） 依存句法分析 中文（zh） 命名实体识别（基础版） 中文（zh）、英文（en）、西班牙文（es） 命名实体识别（领域版） 中文（zh） 文本相似度（基础版） 中文（zh）、英文（en） 文本相似度（高级版） 中文（zh） 句向量 中文（zh） 实体链接 中文（zh） 关键词抽取 中文（zh） 事件抽取 中文（zh） 成分句法分析 中文（zh） 语言生成接口 文本摘要（基础版） 中文（zh）、英文（en） 文本摘要（领域版） 中文（zh） 诗歌生成 中文（zh） 语言理解接口 情感分析（基础版） 中文（zh）、英文（en） 情感分析（领域版） 中文（zh） 文本分类 中文（zh） 属性级情感分析 中文（zh） 属性级情感分析（高级版） 中文（zh） 实体级情感分析 中文（zh） 意图理解 中文（zh） 文档分类 中文（zh） 机器翻译 接口 文本翻译 翻译支持的原语言和目标语言请见表2 语种识别 支持识别的文本语种请见表3 文档翻译任务创建 文档翻译当前仅支持中英互译 文档翻译状态查询 文档当前仅支持中英互译 表2 文本翻译支持的语言列表 语种名称 语言代码 阿拉伯语（即将下线） ar 德语（即将下线） de 俄语（即将下线） ru 法语（即将下线） fr 韩语（即将下线） ko 葡萄牙语（即将下线） pt 日语（即将下线） ja 泰语（即将下线） th 土耳其语（即将下线） tr 西班牙语（即将下线） es 英语 en 越南语（即将下线） vi 中文（简体） zh 自动检测输入语种并翻译成目标语种，您需要指定目标语种（即将下线）。 auto 表3 语种识别支持的语言列表 语种名称 语言代码 阿拉伯语 ar 爱沙尼亚语 et 保加利亚语 bg 冰岛语 is 波兰语 pl 波斯尼亚语 bs 波斯语 fa 丹麦语 da 德语 de 俄语 ru 法语 fr 芬兰语 fi 高棉语 km 韩语 ko 加泰罗尼亚语 ca 捷克语 cs 克罗地亚语 hr 拉脱维亚语 lv 立陶宛语 lt 罗马尼亚语 ro 马耳他语 mt 马来西亚语 ms 北马其顿语 mk 孟加拉语 bn 缅甸语 my 南非荷兰语 af 挪威语 no 葡萄牙语 pt 日语 ja 瑞典语 sv 塞尔维亚语 sr 斯洛伐克语 sk 斯洛文尼亚语 sl 斯瓦希里语 sw 泰语 th 土耳其语 tr 威尔士语 cy 乌尔都语 ur 乌克兰语 uk 西班牙语 es 希伯来语 he 希腊语 el 匈牙利语 hu 意大利语 it 印地语 hi 印尼语 id 英语 en 越南语 vi 中文 zh 无法识别语种 unk

问题描述 用户在调用语义理解api时，为什么报“The API does not exist or has not been published in the environment“错误？ 接口调用地址url: https://nlp-ext.cn-north-4.myhuaweicloud.com/0ade47a66b8025572f42c0157eb7c94b/nlg/summarization

新服务构建 应用场景 应用场景复杂，缺乏软件架构设计能力，以及微服务开发能力。 开发能力不足，缺乏编码规范和安全编码意识。 对云上数据库、中间件和存储等服务不了解，缺乏云上服务对接能力。 价值 根据用户的诉求，快速帮助用户生成满足DDD领域驱动设计的框架代码，并且内置稳定的安全防护能力和编码规范、API规范、数据规范，极大提升了用户开发效率和开发代码质量。 优势 生成满足DDD领域驱动设计的框架代码，开发人员更加专注于业务问题的解决，提高代码质量和开发效率，并且更好地支持不断演化的业务需求。 内置稳定的安全防护能力和编码规范、API规范、数据规范，极大提升了开发代码质量。 内置云服务对接能力，快速对接多种云服务。

平台预置云服务中间件接入、服务治理、通用基础能力提供 提供框架级内置组件，可结合建模业务使用和单独使用。 中间件&高可用增强 内置中间件增强能力，如容灾切换、消息高可靠等，兼容开源解决方案。 云服务接入 内置云服务对接能力，零码完成云服务的对接，助力服务低成本达成云原生、应用现代化等目标。 服务治理能力 开源服务治理能力基础上增强依赖降级、可观测等易用性强能力，大幅提升企业应用可治理能力。 应用通用基础能力 提供标准通用基础能力，包括标准三方件及依赖管理可快速解决版本漏洞、安全特性及日志跟踪等能力。

计费构成分析 可以将RocketMQ实例的使用阶段按照计费模式分为两段：在2023/03/18 15:30:00 ~ 2023/03/20 10:30:00期间为按需计费，2023/03/20 10:30:00 ~ 2023/04/20 23:59:59期间为包年/包月计费。 按需计费 在2023/03/18 15:30:00 ~ 2023/03/20 9:00:00期间按照rocketmq.4u8g.cluster*1规格计费，计费时长为41.5小时，费用计算如下： 在2023/03/20 9:00:00 ~ 2023/03/20 10:30:00期间按照rocketmq.8u16g.cluster*1规格计费，计费时长为1.5小时，费用计算如下： 包年/包月计费 在2023/03/20 10:30:00 ~ 2023/04/20 23:59:59期间为包年/包月计费，计费时长为1个月，费用计算如下： 由此可见，在3~4月份，该RocketMQ实例总共产生的费用为：587.23 + 40.73 + 12255 =12882.96 元。

计费场景 某用户于2023/03/18 15:30:00在“华北-北京四”区域购买了一个按需计费4.8.0版本的RocketMQ实例，规格配置如下： 规格：rocketmq.4u8g.cluster*1 总存储空间：高I/O，300GB 用了一段时间后，用户发现RocketMQ实例当前规格无法满足业务需要，于2023/03/20 9:00:00升配为rocketmq.8u16g.cluster*1。因为该RocketMQ实例打算长期使用下去，于2023/03/20 10:30:00将RocketMQ实例转为包年/包月计费，购买时长为1个月。那么在3~4月份，该RocketMQ实例总共产生多少费用呢？

成本优化 成本控制 企业可以在成本中心的“预算管理”页面创建精细粒度的预算来管理成本和使用量，在实际或预测超过预算阈值时，自动发送通知给指定消息接收人。企业还可以创建预算报告，定期将指定预算进展通知给指定消息接收人。 例如企业需要创建一个RocketMQ实例的按需成本预算，每月预算金额为2000元，当预测金额高于预算金额的80%时发送预算告警。那么，创建的预算如下： 图4 预算基本信息 图5 设置成本范围 图6 设置提醒 详细介绍请参见使用预测和预算来跟踪成本和使用量。 资源优化 您可以通过 云监控服务 监控资源的使用情况，识别空闲资源，寻找节约成本的机会。也可以根据成本分析阶段的分析结果识别成本偏高的资源，然后采取针对性的优化措施。 监控资源利用率，评估当前配置是否过高。例如：CPU、内存、云硬盘等资源的利用率。 监控闲置的资源，避免浪费。例如：未挂载的云硬盘、未绑定的EIP等。 计费模式优化 不同类型的业务对资源使用周期有不同的要求，为每一类业务确定合适的计费模式，灵活组合以达到最优效果。 针对长期稳定的成熟业务，使用包年/包月计费模式。 针对不能中断的短期、突增或不可预测的业务，使用按需计费模式。 实现自动化运维 华为云也提供了丰富的运维类产品，帮助您提升运维效率，降低运维的人力成本。例如： 弹性伸缩：持续维护跨计费模式、跨可用区、跨实例规格的实例集群。适合业务负载存在峰谷波动的场景。 资源编排 ：一键部署并维护包含多种云资源和依赖关系的资源栈。适合交付整体系统、克隆环境等场景。 自动化运维：以服务化的方式定义一组运维操作，高效执行运维任务。适合定时运维、批量运维、跨地域运维等场景。

包年/包月资源 对于包年/包月计费模式的资源，例如包年/包月的RocketMQ实例，用户在购买时会一次性付费，服务将在到期后自动停止使用。 如果在计费周期内不再使用包年/包月资源，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。需要注意，如果实例开启了回收站策略，包周期实例退订后，会存入回收站中，此时不会收取实例的费用，但是会按需收取存储空间的费用。如果想要停止计费，请在回收站中删除实例。 如果您已开启“自动续费”功能，为避免继续产生费用，请在自动续费扣款日（默认为到期前7日）之前关闭自动续费。

成本分配 成本管理的基础是树立成本责任制，让各部门、各业务团队、各责任人参与进来，为各自消耗云服务产生的成本负责。企业可以通过成本分配的方式，将云上成本分组，归集到特定的团队或项目业务中，让各责任组织及时了解各自的成本情况。 华为云成本中心支持通过多种不同的方式对成本进行归集和重新分配，您可以根据需要选择合适的分配工具。 通过关联账号进行成本分配 企业主客户可以使用关联账号对子客户的成本进行归集，从而对子账号进行财务管理。详细介绍请参见通过关联账号维度查看成本分配。 通过企业项目进行成本分配 在进行成本分配之前，建议开通企业项目并做好企业项目的规划，可以根据企业的组织架构或者业务项目来划分。在购买云资源时选择指定企业项目，新购云资源将按此企业项目进行成本分配。详细介绍请参见通过企业项目维度查看成本分配。 图2 为RocketMQ实例选择企业项目 通过成本标签进行成本分配 标签是华为云为了标识云资源，按各种维度（例如用途、所有者或环境）对云资源进行分类的标记。推荐企业使用预定义标签进行成本归集，具体流程如下： 图3 为RocketMQ实例添加标签 详细介绍请参见通过成本标签维度查看成本分配。 使用成本单元进行成本分配 企业可以使用成本中心的“成本单元”来拆分公共成本。公共成本是指多个部门共享的计算、网络、存储或资源包产生的云成本，或无法直接通过企业项目、成本标签分配的云成本。这些成本不能直接归属于单一所有者，因此不能直接归属到某一类别。使用拆分规则，可以在各团队或业务部门之间公平地分配这些成本。详细介绍请参见使用成本单元查看成本分配。

续费简介 包年/包月RocketMQ实例到期后会影响RocketMQ实例正常运行。如果您想继续使用，需要在指定的时间内为RocketMQ实例续费，否则RocketMQ实例资源会自动释放，数据丢失且不可恢复。 续费操作仅适用于包年/包月RocketMQ实例，按需计费RocketMQ实例不需要续费，只需要保证账户余额充足即可。 RocketMQ实例在到期前续费成功，所有资源得以保留，且RocketMQ实例的运行不受影响。RocketMQ实例到期后的状态说明，请参见到期后影响。

续费相关的功能 包年/包月RocketMQ实例续费相关的功能如表1所示。 表1 续费相关的功能 功能 说明 手动续费 包年/包月RocketMQ实例从购买到被自动删除之前，您可以随时在RocketMQ控制台为RocketMQ实例续费，以延长RocketMQ实例的使用时间。 自动续费 开通自动续费后，RocketMQ实例会在每次到期前自动续费，避免因忘记手动续费而导致资源被自动删除。 在一个包年/包月RocketMQ实例生命周期的不同阶段，您可以根据需要选择一种方式进行续费，具体如图1所示。 图1 RocketMQ实例生命周期 RocketMQ实例从购买到到期前，处于正常运行阶段，资源状态为“运行中”。 到期后，资源状态变为“已过期”。 到期未续费时，RocketMQ实例首先会进入宽限期，宽限期到期后仍未续费，资源状态变为“已冻结”。 超过宽限期仍未续费将进入保留期，如果保留期内仍未续费，资源将被自动删除。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 在RocketMQ实例到期前均可开通自动续费，到期前7日凌晨3:00首次尝试自动续费，如果扣款失败，每天凌晨3:00尝试一次，直至RocketMQ实例到期或者续费成功。到期前7日自动续费扣款是系统默认配置，您也可以根据需要修改此扣款日。

请求方法 HTTPS请求方法（也称为操作或动词），它告诉服务用户正在请求什么类型的操作。 GET：请求服务器返回指定资源。 PUT：请求服务器更新指定资源。 POST：请求服务器新增资源或执行特殊操作。 DELETE：请求服务器删除指定资源，如删除对象等。 HEAD：请求服务器资源头部。 PATCH：请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取 IAM 用户Token（使用密码）的URI部分，您可以看到其请求方法为“POST”，则其请求为： 1 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取IAM用户Token（使用密码）接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的ID，获取方法请参见获取项目ID。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取IAM用户Token（使用密码）。 1 2 3 4 5 6 7 8 91011121314151617181920212223242526 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json{ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "id": "xxxxxxxxxxxxxxxxxx" } } }} 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求消息头 附加请求头字段，如指定的URI和HTTPS方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 如下公共消息头需要添加到请求中。 Content-Type：消息体的类型（格式），必选，默认取值为“application/json”，有其他取值时会在具体接口中专门说明。 X-Auth-Token：用户Token，可选，当使用Token方式认证时，必须填充该字段。用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参考AK/SK认证。 对于获取IAM用户Token（使用密码）接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 12 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 URI-scheme： 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint： 指定承载REST服务端点的服务器 域名 或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如： BCS 服务在“华北-北京一”区域的Endpoint为“bcs.cn-north-1.myhuaweicloud.com”。 resource-path： 资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string： 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京一”区域的Token，则需使用“华北-北京一”区域的Endpoint（iam.cn-north-1.myhuaweicloud.com），并在获取IAM用户Token（使用密码）的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 1 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

响应示例 状态码： 200 Ok { "bcs" : { "start_time" : "2020-10-15T18:24:48.658236618+08:00", "end_time" : "2020-10-15T18:25:53.552512674+08:00", "status" : "finished", "detail" : "" }, "eip" : { "start_time" : "2020-10-15T18:24:31.957780831+08:00", "end_time" : "2020-10-15T18:24:33.810699517+08:00", "status" : "finished", "detail" : "" }, "sfs" : { "start_time" : "2020-10-15T18:24:31.957781285+08:00", "end_time" : "2020-10-15T18:24:48.611812564+08:00", "status" : "finished", "detail" : "" }} 状态码： 400 Bad Request { "error_code" : "B CS .4006005", "error_msg" : "keyType error, keyType: blok not supported"} 状态码： 401 Unauthorized { "error_code" : "BCS.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"}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 bcs Detail object 区块链 实例创建状态 eip Detail object 弹性IP创建状态 sfs Detail object 弹性文件存储创建状态 obs Detail object OBS实例创建状态 kafka Detail object kafka实例创建状态 cce ComCCE object 云容器引擎创建状态 表4 ComCCE 参数 参数类型 描述 cluster Detail object 云容器引擎集群创建状态 network Detail object 云容器引擎网络创建状态 security_group Detail object 云容器引擎安全组创建状态 表5 Detail 参数 参数类型 描述 start_time String 开始时间 end_time String 结束时间 status String 状态 枚举值： waiting deploying finished failed detail String 细节描述 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 404 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：8 最大长度：36 error_msg String 错误描述 最小长度：2 最大长度：512

响应示例 状态码： 200 请求成功 { "id" : "a75e800b-bd4c-11ec-a5fe-0255ac100409", "type" : "CreateInstance", "status" : "Success", "failed_message" : "", "progress" : 100, "instance_id" : "37f60ab6-bbeb-11ec-9396-0255ac100408", "instance_name" : "cce-test-01", "start_time" : "2022-04-16T07:20:05Z", "end_time" : "2022-04-16T07:40:05Z"}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 id String job ID type String job类型：创建实例（CreateInstance）、删除实例（DeleteInstance）、升级区块链引擎（UpgradeChainEngine）、创建组织（CreateOrganization）、删除组织（DeleteOrganization） status String job状态：初始化（Initializing）、运行中（Running）、失败（Failed）、成功（Success） failed_message String job失败详细描述信息 progress Integer job完成百分比 instance_id String job相关的实例ID instance_name String job相关的实例名称 start_time String job起始时间 end_time String job结束时间 状态码： 400 表4 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 401 表5 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 500 表6 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息

响应示例 状态码： 200 请求成功 { "id" : "0720097286db7edf8627b1eb4b0c9acfd64ba1092bf1472035c7ed1efc0dc048", "type" : "COMMON_TRANSACTION", "status" : "VALID", "block_height" : 2, "create_org" : "org1-jeij39jfo", "contract_name" : "test", "endorsor_orgs" : [ "org1-jeij39jfo" ], "read_set" : [ ], "write_set" : [ "key:\"BS_ADDRESS\" value:\"x.x.x.x\" " ], "create_time" : "2022-04-26T12:37:16Z"}

创建BCS服务实例 接口相关信息 URI格式 ：POST /v2/{project_id}/blockchains 请求示例 POST https://{bcs_endpoint}/v2/{project_id}/blockchains {bcs_endpoint}信息请从地区和终端节点获取。 Body： { "name":"bcs-test", "fabric_version":"2.0", "enterprise_project_id":"0", "resource_password":"xxx", "create_new_cluster":false, "cce_cluster_info":{ "cluster_id":"c11ccc2c-aab9-11ea-99da-0255ac100b03", "cluster_name":"byl-fastfabric" }} 响应示例 { "blockchain_id": "b95133b2-b933-8fd5-3421-e3ce793a3e2f", "blockchain_name": "bcs-test"}

URI GET /v2/{project_id}/huaweicloudchain/instances/{instance_id}/chain/transactions/{transaction_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID instance_id 是 String 实例ID transaction_id 是 String 交易ID

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 id String 交易ID type String 交易类型：普通交易（COMMON_TRANSACTION）、投票交易（VOTE_TRANSACTION） status String 交易状态 block_height Integer 交易所属区块高度 create_org String 交易发起组织 contract_name String 交易执行合约 endorsor_orgs Array of strings 背书组织 read_set Array of KeyVersion objects 交易读集 write_set Array of files 交易写集 create_time String 交易创建时间 表4 KeyVersion 参数 参数类型 描述 key String 交易数据的key version TxDataVersion object 交易数据的版本数据 表5 TxDataVersion 参数 参数类型 描述 block_num Integer 区块号 tx_num Integer 交易序号 状态码： 400 表6 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 401 表7 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 500 表8 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息

API概览 通过使用华为云区块链引擎服务所提供的管理接口，您可以通过调用API使用华为云区块链引擎服务的功能，包括HBS实例的创建、查询，更新等，接口说明如表1所示。 表1 API概览 类型 API 说明 服务管理 查询服务信息 查询服务规格详情。 询价 产品询价。 查询总览信息 查询总览信息。 任务管理 查询job详情 查询job详情，Job由后台自动创建，Job ID可通过列表查询接口获取。 查询job列表 查询租户job列表，单次最多查询100个。 批量删除job 批量删除job，单次最多删除100个。 实例管理 购买实例 购买区块链实例。 查询实例列表 查询区块链实例列表，单次最多查询100个。 查询实例详情 查询区块链实例详情。 更新实例 更新实例：升级区块链引擎。 组织管理 购买组织 购买组织。 查询组织列表 查询实例组织列表，单次最多查询100个。 查询组织详情 查询组织详情。 区块链管理 查询链详情 查询链详情。 查询区块列表 查询区块列表，逆序查询，单次查询限制500个，只支持云端管理实例使用。 查询区块详情 查询区块详情，只支持云端管理实例使用。 查询区块交易列表 查询区块交易列表，单次最多查询500笔，只支持云端管理实例使用。 查询交易详情 查询交易详情，只支持云端管理实例使用。 查询区块、交易统计结果 查询区块、交易统计结果，只支持云端管理实例使用。 下载SDK配置 下载区块链SDK配置文件，只支持云端管理实例使用。 合约管理 安装合约 安装或者更新合约，只支持云端管理实例使用。 查询合约详情 查询合约详情，只支持云端管理实例使用。 查询合约列表 查询合约列表，单次最多查询500个，只支持云端管理实例使用。 获取合约扫描报告 获取合约安全扫描报告，只支持云端管理实例使用，接口返回内容为扫描报告zip文件的字节流。 终端节点管理 创建终端节点 创建 VPC终端节点 ，只支持云端管理实例使用。 查询终端节点列表 查询终端节点列表，单次最多查询100个，只支持云端管理实例使用且只返回创建成功的终端节点。 查询终端节点服务详情 查询终端节点服务详情，只支持云端管理实例使用。 标签管理 查询资源标签 查询资源标签。 批量添加资源标签 批量添加资源标签。 批量删除资源标签 批量删除资源标签。 E2EE 组织用户加密消息 组织用户加密消息。 组织用户解密消息 组织用户解密消息。 父主题： 华为云区块链引擎管理

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 GET：请求服务器返回指定资源。 PUT：请求服务器更新指定资源。 POST：请求服务器新增资源或执行特殊操作。 DELETE：请求服务器删除指定资源，如删除对象等。 HEAD：请求服务器资源头部。 PATCH：请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： 1 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，cn-north-4为项目名称，获取方法请参考终端节点。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参考获取用户Token。 非华为云账号 获取Token 请参考获取用户Token。 1 2 3 4 5 6 7 8 91011121314151617181920212223242526 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json{ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "cn-north-4" } } }} 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 URI-scheme： 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint： 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如：HBS服务在“华北-北京四”区域的Endpoint为“bcs.cn-north-4.myhuaweicloud.com”。 resource-path： 资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string： 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（iam.cn-north-4.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 1 https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 如下公共消息头需要添加到请求中。 Content-Type：消息体的类型（格式），必选，默认取值为“application/json”，有其他取值时会在具体接口中专门说明。 X-Auth-Token：用户Token，可选，当使用Token方式认证时，必须填充该字段。用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参考AK/SK认证。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 12 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json

响应消息体 响应消息体通常以结构化格式（如JSON或XML）返回，与响应消息头中Content-Type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 1 2 3 4 5 6 7 8 9101112 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "az-01",...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_msg": "The format of message is error", "error_code": "AS.0001" } 其中，error_code表示错误码，error_msg表示错误描述信息。

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 block_height String 区块高度 transaction_num Integer 区块包含交易数量 body_hash String 区块hash parent_hash String 父区块hash create_time String 区块创建时间 状态码： 400 表4 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 401 表5 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息 状态码： 500 表6 响应Body参数 参数 参数类型 描述 code String 状态码 error_code String 错误码 error_msg String 错误信息 message String 错误详细信息