华为云用户手册

  • 动态配置master.address以及AK/SK APM 支持动态配置master.address以及AK/SK。 用户可以通过配置环境变量的方式,给APM_MASTER_ADDRESS、APM_AC CES S_KEY(apm-ak)以及APM_SECRET_KEY(apm-sk)赋值。获取AK/SK的具体操作,请参见为JAVA应用手工安装Agent,获取master.address,请参见接入地址master.address配置。 如果javaagent配置文件和环境变量同时配置了AK、SK、master.address,那么环境变量配置的值优先生效。 Agent 2.3.19之后版本支持动态配置master.address以及AK/SK。
  • 操作步骤(CCE旧版UI) 登录云容器引擎控制台。 选择“工作负载”,选择“无状态负载”或者“有状态负载”。 在对应界面列表中可通过右上角过滤框筛选,找到要部署Agent的JAVA应用。 图2 查找JAVA应用 单击目标应用的名称,进入应用详情页面。 在应用详情页面,选择“工作负载运维”页签。 在“性能管理配置”卡片查看“APM探针”是否被勾选,如图图1 查看APM探针所示。 图3 查看APM探针 如果“APM探针”已被勾选,需去掉勾选,并重启实例。具体请执行7。 如果“APM探针”未被勾选,则执行8。 单击“性能管理配置”卡片下的“编辑”,去掉勾选,单击“重启实例”,在提示弹框中单击“我知道了”。完成重启实例,此时APM1.0探针已被卸载。 图4 重启实例 图5 重启实例提示 单击“性能管理配置”卡片下的“编辑”,勾选“APM探针”,选择APM2.0探针类型,选择探针版本和APM业务,单击“重启实例”,在提示弹框中单击“我知道了”。 图6 重启实例 图7 重启实例提示 CCE新版UI为部署在CCE容器中的JAVA应用安装Agent的详细操作,请参考《用户指南》。
  • 使用说明 目前只支持部署CCE的JAVA应用。相关参数说明参见表1。 表1 性能管理配置参数列表 参数名称 参数说明 安装探针 选择安装探针。目前支持“不启动”、“APM1.0探针”和“APM2.0探针”。 探针类型 选择探针的版本类型。 探针升级策略 探针升级的方式、策略。默认为“重启自动升级”。 重启自动升级:每次都尝试重新下载镜像。 重启手动升级:如果本地有该镜像,则使用本地镜像,本地不存在时下载镜像。 APM环境 输入APM环境名称,该参数为选填。 APM应用 选择一个已有的APM应用。 子应用 输入APM子应用,该参数为选填。 接入密钥 将会自动获取APM服务的密钥信息,详情参见前提条件。
  • 修订记录 表1 修订记录 发布日期 修订记录 2024-04-15 为部署在CCE容器中的JAVA应用安装Agent新增说明“CCE容器安装Agent建议使用自有探针”。 2024-03-04 新增开始监控C++应用、开始监控Android应用以及开始监控iOS应用。 2024-01-24 新增JavaAgent安装脚本。 2024-01-17 新增支持Node.js支持OpenTelemetry。 2023-12-11 新增支持Agent 2.4.5版本以及下载。 2023-10-30 新增支持OpenTelemetry。 2023-08-08 新增JAVA监控手动接入javaagent支持代理功能。 2023-07-15 新增入门实践章节。 2023-07-05 新增开始监控.Net应用章节。 2023-05-15 新增开始监控Php应用章节。 2023-04-14 新增开始监控Node.js应用、开始监控GO应用和开始监控Python应用章节。 2022-07-15 第一次正式发布。
  • JavaAgent下载地址 区域 下载地址 历史版本下载地址 华北-北京四 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b 2.4.1 sha256:c31cd55ead0b2172eb694fe402242b09caeb67d7059aaf4060258633d9ade9f8 2.3.19 sha256:8755abcd541797ebf900f8f1767d62678b3cd57a6d8e045dcfb2f8c24885bfce 2.3.17 sha256:8893e89cd3174879232704828027fd636471525d6e5772ff77e3313f79a4b6b5 华北-北京一 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b 2.4.1 sha256:c31cd55ead0b2172eb694fe402242b09caeb67d7059aaf4060258633d9ade9f8 2.3.19 sha256:8755abcd541797ebf900f8f1767d62678b3cd57a6d8e045dcfb2f8c24885bfce 2.3.17 sha256:8893e89cd3174879232704828027fd636471525d6e5772ff77e3313f79a4b6b5 华东-上海一 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b 2.4.1 sha256:c31cd55ead0b2172eb694fe402242b09caeb67d7059aaf4060258633d9ade9f8 2.3.19 sha256:8755abcd541797ebf900f8f1767d62678b3cd57a6d8e045dcfb2f8c24885bfce 2.3.17 sha256:8893e89cd3174879232704828027fd636471525d6e5772ff77e3313f79a4b6b5 华东-上海二 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b 2.4.1 sha256:c31cd55ead0b2172eb694fe402242b09caeb67d7059aaf4060258633d9ade9f8 2.3.19 sha256:8755abcd541797ebf900f8f1767d62678b3cd57a6d8e045dcfb2f8c24885bfce 2.3.17 sha256:8893e89cd3174879232704828027fd636471525d6e5772ff77e3313f79a4b6b5 华南-广州 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b 2.4.1 sha256:c31cd55ead0b2172eb694fe402242b09caeb67d7059aaf4060258633d9ade9f8 2.3.19 sha256:8755abcd541797ebf900f8f1767d62678b3cd57a6d8e045dcfb2f8c24885bfce 2.3.17 sha256:8893e89cd3174879232704828027fd636471525d6e5772ff77e3313f79a4b6b5 亚太-新加坡 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b 2.4.1 sha256:c31cd55ead0b2172eb694fe402242b09caeb67d7059aaf4060258633d9ade9f8 2.3.19 sha256:8755abcd541797ebf900f8f1767d62678b3cd57a6d8e045dcfb2f8c24885bfce 2.3.17 sha256:8893e89cd3174879232704828027fd636471525d6e5772ff77e3313f79a4b6b5 华南-广州-友好用户环境 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b 2.4.1 sha256:c31cd55ead0b2172eb694fe402242b09caeb67d7059aaf4060258633d9ade9f8 2.3.19 sha256:8755abcd541797ebf900f8f1767d62678b3cd57a6d8e045dcfb2f8c24885bfce 2.3.17 sha256:8893e89cd3174879232704828027fd636471525d6e5772ff77e3313f79a4b6b5 华北-乌兰察布一 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b 2.4.1 sha256:c31cd55ead0b2172eb694fe402242b09caeb67d7059aaf4060258633d9ade9f8 2.3.19 sha256:8755abcd541797ebf900f8f1767d62678b3cd57a6d8e045dcfb2f8c24885bfce 2.3.17 sha256:8893e89cd3174879232704828027fd636471525d6e5772ff77e3313f79a4b6b5 华北-乌兰察布二零一 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b 2.4.1 sha256:c31cd55ead0b2172eb694fe402242b09caeb67d7059aaf4060258633d9ade9f8 2.3.19 sha256:8755abcd541797ebf900f8f1767d62678b3cd57a6d8e045dcfb2f8c24885bfce 2.3.17 sha256:8893e89cd3174879232704828027fd636471525d6e5772ff77e3313f79a4b6b5 华北-乌兰察布二零二 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b 2.4.1 sha256:c31cd55ead0b2172eb694fe402242b09caeb67d7059aaf4060258633d9ade9f8 2.3.19 sha256:8755abcd541797ebf900f8f1767d62678b3cd57a6d8e045dcfb2f8c24885bfce 2.3.17 sha256:8893e89cd3174879232704828027fd636471525d6e5772ff77e3313f79a4b6b5 华北-乌兰察布汽车一 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b - - - 西南-贵阳一 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b - - - 中国-香港 2.4.5 sha256:37b155626f46f3a8b19772e3fd6597ece92bb255fdffa21e3e9e1467cc009392 2.4.4 sha256:f60b55d646fe592c427143f1c8d8e8f277a647a3dd73dcdca43d7d37655ec573 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b - - - 墨西哥城二 2.4.3 sha256:73de7b49e148b102b74a6075c3d8b25e76f43d6144ec5aafe6ac190ab3c1ef0b - - - - -
  • 操作步骤 下载JavaAgent,参考JavaAgent下载地址下载apm-javaagent,并将javaagent下载到需要接入APM机器的任意目录。 示例命令: curl -O https://xxx/apm-javaagent-x.x.x.tar 执行tar命令解压javaagent。 示例命令: tar -xvf apm-javaagent-x.x.x.tar 修改javaagent中的apm.config配置文件。master.address配置请参见接入地址master.address配置,将AK/SK写入配置文件中,如下图所示。 图3 写入AK/SK 修改java进程启动脚本。 在服务启动脚本的java命令之后,配置apm-javaagent.jar包所在路径,并指定java进程的组件名。 添加-javaagent参数示例: java -javaagent:/xxx/apm-javaagent/apm-javaagent.jar=appName={appName} 当企业业务很多的情况下,也支持更为复杂一些的配置,添加-javaagent参数的复杂模式如: java -javaagent:/xxx/apm-javaagent/apm-javaagent.jar=appName=myApp,env=myEnv,envTag=myTag,business=myBusiness,subBusiness=mySub 上述参数属于APM内置的CMDB信息,具体详情见CMDB管理章节。 由于历史原因,APM启动参数设置的元数据,跟CMDB概念有一些冲突,这里进行说明。 启动参数一般会设置 -javaagent:D:\javaagent-package\apm-javaagent\apm-javaagent.jar=appName=xxx,env=yyy,business=zzz,subBusiness=sss,envTag=xxx,在这里appName代表组件,business代表应用,subBusiness代表子应用,envTag代表环境标签。 如果没有在web界面对business参数进行设置,启动javaagent时系统就会报错;其他参数如果没有设置,在启动javaagent时会自动创建出来,包括子应用、组件、环境及环境标签等。 同一个应用下,组件名称不能重复。 重新部署应用。
  • 计费概述 消息&短信服务支持套餐包和资源包计费方式,您可以根据实际需求选择资源的计费方式。详细的服务资费费率标准请参见产品价格详情。 按套餐包计费:客户购买短信套餐包,超出套餐包的部分,按用量计费。若短信字数超过规定长度,则平台将短信拆分成多条计费。 按资源包计费:客户购买短信资源包,资源用尽时,自动停止使用。 套餐包计费方式 套餐包价格详情 购买短信套餐包 套餐包计费FAQ 资源包计费方式 资源包价格详情 购买短信资源包 资源包计费FAQ 《价格说明》仅展示消息&短信服务官方价格,即创建短信应用时,选择"测试类项目"时的计费价格。 若有大客户商务优惠,请在创建应用时选择“商用生产项目”,具体参见创建短信应用的企业项目介绍。 如有任何疑问,请联系华为云智能客服,将有专人为您解答。
  • 计费规则 短信服务按照使用量,即短信发送成功条数,进行计费。短信字数超过规定长度时,平台将一条长短信拆分成多条计算。 计费方式 计费规则 短信资源包 购买资源包后发送短信扣除短信资源包额度,资源包用尽平台自动停发。继续发送需再次购买资源包。 发送短信即刻计费,即调用接口/群发助手成功则计费。 以下情况不收费:“status”或“状态码”为华为平台错误码。 查看所有状态回执错误码(其中状态码来源是华为平台的不计费)
  • 关于用户欠费后消息&短信服务调整的通知 尊敬的华为云用户: 华为云计划于2024年4月15日 00:00:00(北京时间)对用户欠费后的消息&短信服务做出调整。调整详情如下: 您的账号欠费后,账号下的按需服务将按规则进入宽限期、保留期,影响如下: 类型 调整前 调整后 宽限期 可以继续使用短信服务 已添加的短信签名和短信模板不会被删除 无法使用短信服务 已添加的短信签名和短信模板不会被删除 保留期 无法使用短信服务 已添加的短信签名和短信模板不会被删除 如您有任何问题,请随时通过工单与我们联系。 感谢您对华为云的支持!
  • 高级配置 设置“云服务器名称”。 名称可自定义,但需符合命名规则:只能由中文字符、英文字母、数字及“_”、“-”、“.”组成。 如果同时购买多台弹性云服务器,系统会自动按序增加后缀。 一次创建多台弹性云服务器时,系统自动增加后缀,例如:输入ecs,云服务器名称为ecs-0001, ecs-0002,……。再次创建多台云服务器时,命名从上次最大值连续增加,例如:输入ecs,已有云服务器ecs-0010,新创云服务器名称为ecs-0011、ecs-0012、……,命名达到9999时,从0001开始。 允许重名:允许创建的云服务器名称相同。如果是批量创建,勾选“允许重名”后,批量创建的多台云服务器名称全部相同,不再按序增加。 Windows操作系统云服务器的名称建议不超过15个字符,且不要重名,否则部分Windows应用将无法使用。 本步骤中的“云服务器名称”,会被设置为虚拟机操作系统中初始的主机名。 在将“云服务器名称”设置为虚拟机操作系统中的主机名时,为避免出现未知问题,连续使用的点号(.)或连字符(-),会被替换成首个字符。 设置“登录凭证”。 “密钥对”方式创建的弹性云服务器安全性更高,建议选择“密钥对”方式。如果您习惯使用“密码”方式,请增强密码的复杂度,如表1所示,保证密码符合要求,防止恶意攻击。 密钥对 指使用密钥对作为弹性云服务器的鉴权方式。您可以选择使用已有的密钥,或者单击“新建密钥对”创建新的密钥。 如果选择使用已有的密钥,请确保您已在本地获取该文件,否则,将影响您正常登录弹性云服务器。 密码 指使用设置初始密码方式作为弹性云服务器的鉴权方式,此时,您可以通过用户名密码方式登录弹性云服务器。 Linux操作系统时为root用户的初始密码,Windows操作系统时为Administrator用户的初始密码。 密码复杂度需满足表1要求。 表1 密码设置规则 参数 规则 密码 密码长度范围为8到26位。 密码至少包含以下4种字符中的3种: 大写字母 小写字母 数字 Windows操作系统云服务器特殊字符:包括“$”、“!”、“@”、“%”、“-”、“_”、“=”、“+”、“[”、“]”、“:”、“.”、“/”、“,”和“?” Linux操作系统云服务器特殊字符:包括“!”、“@”、“%”、“-”、“_”、“=”、“+”、“[”、“]”、“:”、“.”、“/”、“^”、“,”、“{”、“}”和“?” 密码不能包含用户名或用户名的逆序。 Windows操作系统的云服务器,不能包含用户名中超过两个连续字符的部分。 Windows操作系统的云服务器,不能以“/”为密码首字符。 系统不会定期自动修改弹性云服务器密码。为安全起见,建议您定期修改密码。 使用镜像密码 如果使用Linux操作系统私有镜像创建云服务器,支持使用私有镜像的密码。请确保所选择的私有镜像已经设置了密码。 创建后设置 暂不设置弹性云服务器的密码。待弹性云服务器创建成功后,您需要单击“操作”列下的“重置密码”,根据界面提示,为弹性云服务器设置密码,然后登录弹性云服务器。 设置“云备份”。 云备份提供对云硬盘和弹性云服务器的备份保护,并支持利用备份数据恢复云服务器和云硬盘的数据。云备份设置完成后,系统会将弹性云服务器绑定至云备份存储库并绑定所选备份策略,定期备份弹性云服务器。 使用云备份功能需要进行单独计费,计费详情请参见云备份是如何计费的? CloudPond不支持设置“云备份”。 您可以根据实际情况选择以下三种方式。 现在购买: 输入云备份存储库的名称:只能由中文字符、英文字母、数字、下划线、中划线组成,且长度小于等于64个字符。例如:vault-f61e。默认的命名规则为“vault_xxxx”。 输入存储库的容量:此容量为备份云服务器所需的容量。存储库的空间不能小于云服务器的空间。取值范围为[云服务器总容量,10485760]GB。 设置备份策略:在下拉列表中选择备份策略,或进入云备份控制台查看或编辑备份策略。 使用已有: 选择云备份存储库的名称:在下拉列表中选择已有的云备份存储库。 设置备份策略:在下拉列表中选择备份策略,或进入云备份控制台查看或编辑备份策略。 暂不购买:跳过云备份的配置步骤。如云服务器购买成功后仍需设置备份保护,请进入云备份控制台找到目标存储库,绑定服务器。 设置“ 云监控 ” 选择部分操作系统的公共镜像时,系统推荐您配套使用主机监控。主机监控采集丰富的操作系统层面监控指标,用于监控服务器资源使用情况,也可查询数据用于资源的故障排查。 勾选“开启详细监控”。勾选后,通过在云服务器中安装Agent插件,开启对云服务器的CPU、内存、网络、磁盘、进程等指标的1分钟详细监控。 安装Agent后的监控指标请参考弹性云服务器支持的操作系统监控指标(安装Agent)。 设置“云服务器组(可选)” 可选配置,云服务器组内的弹性云服务器将遵循反亲和策略或故障域策略,尽量分散地创建在不同主机上。创建云服务器组的详细操作,请参见创建云服务器组(可选)。 包含本地盘的弹性云服务器无法在创建后加入弹性云服务器组,如需使用弹性云服务器组功能,请在创建时选择弹性云服务器组。 配置“高级选项”:如需使用“高级选项”中的功能,请勾选“现在配置”。否则,请勿勾选。 实例自定义数据注入 可选配置,主要用于创建云服务器时向云服务器注入实例自定义数据。配置后,云服务器首次启动时会自行注入数据信息。 以文本形式:在下方文本框内输入用户数据内容。 以文件形式:主要用于创建云服务器时注入的脚本文件或其他文件。 例如:您可以通过注入一段脚本,激活待创建云服务器的root用户权限,注入成功后,您可以使用root用户登录弹云服务器。 实例自定义数据注入的详细操作,请参见实例自定义数据注入。 标签 可选配置,对弹性云服务器的标识。使用标签可以方便识别和管理您拥有的弹性云服务器资源。您最多可以给弹性云服务器添加10个标签。 创建弹性云服务器时添加的标签,将同步添加至一同创建的EIP和云硬盘(包括系统盘、数据盘)上。如果云服务器使用的是已有EIP,则该标签不会在EIP上标识。 如您的组织已经设定弹性云服务器的相关标签策略,则需按照标签策略规则为弹性云服务器添加标签。如果添加的标签不符合标签策略规则,则可能会导致弹性云服务器创建失败,请联系组织管理员了解标签策略详情。 云服务器创建成功后,您可以在弹性云服务器、EIP和云硬盘详情页,查看到对应的标签。 关于标签的详细操作,请参见标签。 委托 可选配置。当需要与其他账号共享云服务器资源,或者委托更专业的人或团队来代为管理时,租户管理员可以在 IAM 创建委托并授予云服务器资源的管理权限。被委托方使用自己的用户登录系统后,切换到您的账号下管理资源,避免您将自己的安全凭证(密码)共享给其他账号,确保了您的账号安全。 如果您在IAM上创建了委托,可以通过单击下拉列表选择委托名称,获取相应权限。更多关于委托的信息,请参见委托其他帐号管理资源。 CPU选项 可选配置。当需要为云服务器实例开启或关闭超线程时,勾选“指定CPU选项”。 关于超线程的详细介绍,请参见开启/关闭超线程。 每核心线程数 当勾选“指定CPU选项”时,显示该参数。在“每核心线程数”下拉框进行设置。 1:关闭超线程 2:开启超线程,默认开启 单击“下一步:确认配置”。
  • 设置开机自动挂载磁盘分区 您可以通过配置fstab文件,设置弹性云服务器系统启动时自动挂载磁盘分区。已有数据的弹性云服务器也可以进行设置,该操作不会影响现有数据。 本文介绍如何在fstab文件中使用UUID来设置自动挂载磁盘分区。不建议采用在“/etc/fstab”直接指定设备名(比如/dev/vdb1)的方法,因为云中设备的顺序编码在关闭或者开启弹性云服务器过程中可能发生改变,例如/dev/vdb1可能会变成/dev/vdb2,可能会导致弹性云服务器重启后不能正常运行。 UUID(universally unique identifier)是Linux系统为磁盘分区提供的唯一的标识字符串。 执行如下命令,查询磁盘分区的UUID。 blkid 磁盘分区 以查询磁盘分区“/dev/vdb1”的UUID为例: blkid /dev/vdb1 回显类似如下信息: [root@ecs-test-0001 ~]# blkid /dev/vdb1 /dev/vdb1: UUID="0b3040e2-1367-4abb-841d-ddb0b92693df" TYPE="ext4" 记录下回显中磁盘分区“/dev/vdb1”的UUID,方便后续步骤使用。 执行以下命令,使用VI编辑器打开“fstab”文件。 vi /etc/fstab 按“i”,进入编辑模式。 将光标移至文件末尾,按“Enter”,添加如下内容。 UUID=0b3040e2-1367-4abb-841d-ddb0b92693df /mnt/sdc ext4 defaults 0 2 以上内容仅为示例,具体请以实际情况为准,参数说明如下: 第一列为UUID,此处填写1中查询到的磁盘分区的UUID。 第二列为磁盘分区的挂载目录,可以通过df -TH命令查询。 第三列为磁盘分区的文件系统格式, 可以通过df -TH命令查询。 第四列为磁盘分区的挂载选项,此处通常设置为defaults即可。 第五列为Linux dump备份选项。 0表示不使用Linux dump备份。现在通常不使用dump备份,此处设置为0即可。 1表示使用Linux dump备份。 第六列为fsck选项,即开机时是否使用fsck检查磁盘。 0表示不检验。 挂载点为(/)根目录的分区,此处必须填写1。 根分区设置为1,其他分区只能从2开始,系统会按照数字从小到大依次检查下去。 按“ESC”后,输入“:wq”,按“Enter”。 保存设置并退出编辑器。 执行以下步骤,验证自动挂载功能。 执行如下命令,卸载已挂载的分区。 umount 磁盘分区 命令示例: umount /dev/vdb1 执行如下命令,将“/etc/fstab”文件所有内容重新加载。 mount -a 执行如下命令,查询文件系统挂载信息。 mount | grep 挂载目录 命令示例: mount | grep /mnt/sdc 回显类似如下信息,说明自动挂载功能生效: root@ecs-test-0001 ~]# mount | grep /mnt/sdc /dev/vdb1 on /mnt/sdc type ext4 (rw,relatime,data=ordered)
  • 操作场景 本文以弹性云服务器的操作系统为“CentOS 7.4 64位”为例,采用fdisk分区工具为数据盘设置分区。 MBR支持的磁盘最大容量为2 TiB,GPT最大支持的磁盘容量为18 EiB,因此当您初始化容量大于2 TiB的磁盘时,分区形式请采用GPT。 fdisk分区工具只适用于MBR分区,parted工具适用于MBR分区和GPT分区。关于磁盘分区形式的更多介绍,请参见场景及磁盘分区形式介绍。 不同弹性云服务器的操作系统的格式化操作可能不同,本文仅供参考,具体操作步骤和差异请参考对应的弹性云服务器操作系统的产品文档。 首次使用磁盘时,如果您未参考本章节对磁盘执行初始化操作,主要包括创建分区和文件系统等操作,那么当后续扩容磁盘时,新增容量部分的磁盘可能无法正常使用。
  • 操作步骤 进入购买注册配置中心页面。 参考下表设置参数,参数前面带*号的是必须设置的参数。 参数 说明 计费模式 选择计费方式,目前支持: 包年/包月 按需计费 *企业项目 选择Nacos所在的项目,可在下拉框中搜索和选择需要的企业项目。 企业项目是一种云资源管理方式,企业项目管理服务提供统一的云资源按项目管理,以及项目内的资源管理、成员管理。 参考开通企业项目,创建并启用新的企业项目后可以使用,默认选择default。 *引擎名称 输入Nacos引擎的名称。 *注册配置中心类型 选择注册配置中心类型“Nacos”。 说明: Nacos引擎默认多可用区部署在三节点上,可提供可用区级别容灾能力。 *选择实例数 选择需要的容量规格。 说明: 当前仅在华东-上海一、华南-广州和华北-北京四支持创建微服务实例数为2,000、3,000和5,000的Nacos引擎。当您需要Nacos引擎微服务实例数大于2,000时需要提交工单申请。 版本 只能创建最新版本。 *网络 选择已创建的虚拟私有云及子网,可在下拉框中搜索和选择合适的虚拟私有云和子网。 虚拟私有云可以为您的引擎构建隔离的、用户自主配置和管理的虚拟网络环境。 说明: 当Nacos引擎创建完成后,不支持变更虚拟私有云。 标签 用于标识云资源,当您拥有相同类型的许多云资源时,可以使用标签按各种维度(例如用途、所有者或环境)对云资源进行分类。 您可以单击“ 添加标签”,在“添加标签”弹框输入标签键和标签值,添加标签,标签的命名规则请参见管理标签。在“添加标签”弹框,可单击“ 新增标签”同时添加多个标签,也可单击标签后的,删除该标签。 *购买时长 计费模式选择“包年/包月”时需要设置。可设置是否开通自动续费。 单击“立即购买”,进入引擎信息确认界面。 单击“提交”,引擎开始创建,当“运行状态”为“可用”时,引擎创建完成。 Nacos引擎创建成功后,“运行状态”为“可用”,查看Nacos引擎状态,请参考查看Nacos引擎详细信息。 按需购买引擎时,可能会由于底层资源不足而导致创建失败,请及时删除引擎,避免当底层资源满足时,引擎恢复可用,从而导致扣费。
  • ServiceComb引擎 ServiceComb引擎采用的注册发现中心Apache ServiceComb Service Center,是一个RESTful风格的、高可用无状态的服务注册发现中心,提供微服务发现和微服务管理功能。服务提供者可以将自身的实例信息注册到服务注册发现中心,以供服务消费者发现并使用。ServiceComb引擎可无缝兼容Spring Cloud、ServiceComb等开源生态。关于Apache ServiceComb Service Center的详细内容请参考: https://github.com/apache/servicecomb-service-center/ https://service-center.readthedocs.io/en/latest/user-guides.html ServiceComb引擎当前仅在华东-上海一、华南-广州、华北-北京四、华北-北京一、西南-贵阳一、华北-乌兰察布一、华东-上海二、中国-香港、亚太-新加坡、拉美-墨西哥城二、土耳其-伊斯坦布尔、中东-利雅得和亚太-雅加达支持。 ServiceComb引擎分为1.x、2.x版本。 ServiceComb引擎2.x版本是可支持大规模微服务应用管理的商用引擎。您可根据业务需要选择不同规格,引擎创建完成后不支持规格变更;引擎资源独享,性能不受其他租户影响。 相较于ServiceComb引擎1.x版本,ServiceComb引擎2.x版本底层架构、功能、安全及性能全面升级,提供了独立的服务注册发现中心和配置中心,支持基于用户业务场景的定义和治理。两个版本的特性比对请参见表2。 表2 ServiceComb引擎2.x和ServiceComb引擎1.x特性比对 功能 特性 2.x 1.x 备注 引擎管理 安全性 支持安全认证 √ √ - 可靠性 3AZ高可靠 √ √ - 微服务管理 基础能力 注册发现 √ √ - 多框架接入 √ √ 支持Spring Cloud、ServiceComb Java Chassis。 无实例版本自动清理 √ x 2.3.7及以后版本,支持保留最近3个微服务版本,并自动清理无实例版本。 性能 实例变化毫秒级推送 √ √ - 配置管理 基础能力 管理配置 √ √ - 配置格式多样化 √ 仅支持文本 2.x新增支持配置格式有:YAML、JSON、TEXT、Properties、INI、XML。 导入导出 √ √ 2.x新增支持设置导入相同配置策略。 高级特性 历史版本 √ x - 版本对比 √ x - 一键回滚 √ x - 配置标签 √ x - 性能 秒级下发 √ x - 微服务治理 业务场景化治理 业务场景定义 √ x - 基于请求Method的匹配规则 √ x - 基于请求Path的匹配规则 √ x - 基于请求Headers的匹配规则 √ x - 治理策略-流量控制 服务端的令牌桶限流 √ √ - 治理策略-重试 客户端通过重试来保证用户业务的可用性、容错性、一致性 √ √ - 治理策略-熔断 服务端通过熔断故障业务,防止故障蔓延到整个服务,发生大规模故障 √ √ - 治理策略-隔离仓 服务端基于信号量控制请求并发能力 √ x - 开发工具 本地轻量化引擎 本地一键启动,方便开发者离线开发微服务 √ √ -
  • Nacos引擎 CS E Nacos是基于开源Nacos 2.x版本开发的一款微服务注册发现、配置管理平台。支持多种开发语言、框架的接入使用,具有基于DNS的服务发现能力。 Nacos引擎当前仅在华东-上海一、华南-广州、华北-北京四、西南-贵阳一、中国-香港、亚太-新加坡、中东-利雅得和拉美-墨西哥城二支持。 Nacos的关键特性包括: 表1 Nacos支持特性 功能 特性 实例管理 创建实例。 查看实例规格。 查看实例列表。 查看实例详情。 实例删除。 按需转包周期。 企业项目。 规格变更 扩容变更。 连接管理 内网访问,通过ip和域名访问。 命名空间管理 查看命名空间清单。 查看命名空间详情。 创建命名空间。 编辑命名空间。 删除命名空间。 命名空间数量限制。 说明: 一共可创建50个命名空间。 服务管理 过滤命名空间。 搜索服务。 过滤空服务。 查看服务清单。 创建服务。 查看服务提供者。 查看服务订阅者。 实例按集群区分。 提供者支持按元数据过滤。 支持服务节点上下线。 支持服务节点权重编辑 配置管理 创建配置。 导入配置。 编辑配置。 删除配置。 配置灰度发布。 单命名空间配置数量限制。 搜索配置。 查看配置清单。 查看配置详情。 查看历史版本。 回滚到历史版本。 配置内容对比。 配置监听查询。
  • 应用网关 CSE应用网关是各类应用的流量入口,是基于Envoy项目增强的云上托管类网关产品,实现Ingress与微服务网关合一的全新形态。 其兼容微服务应用、注册中心对接、容器Service、容器Ingress、固定地址的虚机应用等多种后端形态,支持HTTP、gRPC、Dubbo RPC、WebSocket等多种协议类型,以及全链路灰度发布、安全认证等多种服务治理特性。 应用网关当前仅在华东-上海一、西南-贵阳一支持公测,可单击此处申请公测。
  • 请求示例 Endpoint即调用API的请求地址,不同服务不同区域的Endpoint不同,具体请参见终端节点。 例如,道路运输从业资格证识别服务部署在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”或“ocr.cn-north-4.myhuaweicloud.cn”,请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/transportation-qualification-certificate”,“project_id”为项目ID,获取方法请参见获取项目ID获取项目ID。 如何 获取Token 请参见认证鉴权。 传入道路运输从业资格证图片的base64编码进行 文字识别 POST https://{endpoint}/v2/{project_id}/ocr/transportation-qualification-certificate Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..." } 传入道路运输从业资格证图片的url进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/transportation-qualification-certificate Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName" }
  • 响应示例 状态码: 200 成功响应示例 { "result" : { "id_number" : "140xxxxxxxxxxxxxxx", "assessment_date" : "11月11日", "certificate_number" : "22038119xxxxxxxxxx", "file_number" : "3704020030xxxxxxxxxxxxxxxxx", "union_card_number" : "3105060xxxxxxxxxxxx", "continuing_education_info" : "2020年11月-2022年11月", "sex" : "男", "phone_number" : "139xxxxxxxx", "registration_date" : "2016年07月13日", "work_unit" : "无", "integrity_assessment_info" : "AAA 2019年11月-2020年11月", "nationality" : "中国", "name" : "xxx", "address" : "吉林省xxxx", "driving_class" : "A2", "issuing_authority" : "长春市交通运输局", "birth_date" : "1979/12/22", "qualification_category_list" : [ { "category" : "经营性道路货物运输驾驶员", "initial_issue_date" : "2006年04月03日", "issue_date" : "2021年06月22日", "expiry_date" : "2027年06月22日" } ], "confidence" : { "id_number" : 0.9974, "assessment_date" : 0.9917, "certificate_number" : 0.9957, "file_number" : 0.9873, "union_card_number" : 0.9973, "continuing_education_info" : 0.9795, "sex" : 0.9863, "phone_number" : 0.8987, "registration_date" : 0.9806, "work_unit" : 0.8285, "integrity_assessment_info" : 0.9983, "nationality" : 0.995, "name" : 0.9944, "address" : 0.9565, "driving_class" : 0.5711, "issuing_authority" : 0.9234, "birth_date" : 0.9821, "qualification_category_list" : [ { "category" : 0.9979, "initial_issue_date" : 0.9883, "issue_date" : 0.9964, "expiry_date" : 0.9988 } ] } } } 状态码: 400 失败响应样例 { "error_code" : "AIS.0103", "error_msg" : "The image size does not meet the requirements" }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 result QualificationCertificateResult object 识别结果。 调用失败时不返回此字段。 表5 QualificationCertificateResult 参数 参数类型 描述 id_number String 身份证号(非必有,依赖对应从业资格证板式)。 assessment_date String 考核时间(非必有,依赖对应从业资格证板式)。 certificate_number String 从业资格证号。 file_number String 档案号(非必有,依赖对应从业资格证板式)。 union_card_number String 福路通号(非必有,依赖对应从业资格证板式)。 continuing_education_info String 继续教育信息(非必有,依赖对应从业资格证板式)。 sex String 性别(非必有,依赖对应从业资格证板式)。 phone_number String 联系电话(非必有,依赖对应从业资格证板式)。 registration_date String 登记时间(非必有,依赖对应从业资格证板式)。 work_unit String 单位(非必有,依赖对应从业资格证板式)。 integrity_assessment_info String 诚信考核信息(非必有,依赖对应从业资格证板式)。 nationality String 国籍(非必有,依赖对应从业资格证板式)。 name String 姓名。 address String 住址。 driving_class String 准驾车型(非必有,依赖对应从业资格证板式)。 issuing_authority String 发证机关(非必有,依赖对应从业资格证板式)。 birth_date String 出生日期(非必有,依赖对应从业资格证板式)。 qualification_category_list Array of QualificationCategory objects 从业资格列表。 confidence QualificationConfidence object 各个字段的置信度。 表6 QualificationCategory 参数 参数类型 描述 category String 从业资格类别(非必有,依赖对应从业资格证板式)。 initial_issue_date String 初次领证日期(非必有,依赖对应从业资格证板式) issue_date String 有效起始日期(非必有,依赖对应从业资格证板式) expiry_date String 有效期至xxx。 表7 QualificationConfidence 参数 参数类型 描述 id_number Float 身份证号置信度。 assessment_date Float 考核时间置信度。 certificate_number Float 从业资格证号置信度。 file_number Float 档案号置信度。 union_card_number Float 福路通号置信度。 continuing_education_info Float 继续教育信息置信度。 sex Float 性别置信度。 phone_number Float 联系电话置信度。 registration_date Float 登记时间置信度。 work_unit Float 单位置信度。 integrity_assessment_info Float 诚信考核信息置信度。 nationality Float 国籍置信度。 name Float 姓名置信度。 address Float 住址置信度。 driving_class Float 准驾车型置信度。 issuing_authority Float 发证机关置信度。 birth_date Float 出生日期置信度。 qualification_category_list Array of QualificationCategoryConfidence objects 从业资格列表置信度。 表8 QualificationCategoryConfidence 参数 参数类型 描述 category Float 从业资格类别(非必有,依赖对应从业资格证板式)。 initial_issue_date Float 初次领证日期(非必有,依赖对应从业资格证板式) issue_date Float 有效起始日期(非必有,依赖对应从业资格证板式) expiry_date Float 有效期至xxx。 状态码: 400 表9 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时不返回此字段。 error_msg String 调用失败时返回的错误信息。 调用成功时不返回此字段。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。 Content-Type 是 String 发送的实体的MIME类型,参数值为“application/json”。 Enterprise-Project-Id 否 String 企业项目ID。OCR支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账。 获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。 企业项目创建步骤请参见用户指南。 说明: 该功能仅支持开通在华东-上海一区域的API。 创建企业项目后,在传参时,有以下三类场景。 携带正确的ID,正常使用OCR服务,账单归到企业ID对应的企业项目中。 携带错误的ID,正常使用OCR服务,账单的企业项目会被分类为“未归集”。 不携带ID,正常使用OCR服务,账单的企业项目会被分类为“未归集”。 表3 请求Body参数 参数 是否必选 参数类型 描述 image 否 String 与url二选一 图片的Base64编码,要求Base64编码后大小不超过10MB。 图片最短边不小于15px,最长边不超过8192px,支持JPEG、JPG、PNG、BMP、TIFF格式。 图片Base64编码示例如/9j/4AAQSkZJRgABAg...,带有多余前缀会产生The image format is not supported报错。 url 否 String 与image二选一 图片的URL路径,目前支持: 公网http/https url OBS提供的url,使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权,详情参见配置OBS访问权限。 说明: 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠,推荐使用OBS服务存储图片数据。 url中不能存在中文字符,若存在,中文需要进行utf8编码。
  • URI POST /v2/{project_id}/ocr/transportation-qualification-certificate 表1 路径参数 参数 是否必选 说明 endpoint 是 终端节点,即调用API的请求地址。 不同服务不同区域的endpoint不同,您可以从终端节点中获取。 例如,OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID,您可以从获取项目ID中获取。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 result WaybillElectronicResult object 识别结果。 调用失败时无此字段。 表5 WaybillElectronicResult 参数 参数类型 描述 code String 三段码。 receiver_name String 收件人姓名。 receiver_phone String 收件人电话。 receiver_address String 收件人地址。 sender_name String 寄件人姓名。 sender_phone String 寄件人电话。 sender_address String 寄件人地址。 waybill_number String 条形码运单号。 confidence Object 相关字段的置信度信息,取值范围0~1。 置信度越大,表示本次识别的对应字段的可靠性越高,在统计意义上,置信度越大,准确率越高。 置信度由算法给出,不直接等价于对应字段的准确率。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。
  • 响应示例 状态码: 200 成功响应样例 { "result" : { "code" : "12345678901", "receiver_name" : "张三", "receiver_phone" : "12345678901", "receiver_address" : "深圳市龙岗区坂田街道华为基地", "sender_name" : "生活用品用品专营店", "sender_phone" : "1234567890", "sender_address" : "httpe-//", "waybill_number" : "", "confidence" : { "code" : 0.9899, "receiver_name" : 0.9898, "receiver_phone" : 0.9899, "receiver_address" : 0.9897, "sender_name" : 0.9896, "sender_phone" : 0.9899, "sender_address" : 0.8855, "waybill_number" : 0.0 } } } 状态码: 400 失败响应样例 { "error_code" : "AIS.0103", "error_msg" : "The image size does not meet the requirements." }
  • 请求示例 传入快递单图片的base64编码进行文字识别 POST https://ocr.cn-north-4.xxxx.com/v1.0/ocr/waybill-electronic Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj..." } 传入快递单图片的url进行文字识别 POST https://ocr.cn-north-4.myhuaweicloud.com/v1.0/ocr/waybill-electronic Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url":"https://BucketName.obs.myhuaweicloud.com/ObjectName" }
  • URI POST /v2/{project_id}/ocr/waybill-electronic 表1 路径参数 参数 是否必选 说明 endpoint 是 终端节点,即调用API的请求地址。 不同服务不同区域的endpoint不同,您可以从终端节点中获取。 例如,OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID,您可以从获取项目ID中获取。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。 Content-Type 是 String 发送的实体的MIME类型,参数值为“application/json”。 Enterprise-Project-Id 否 String 企业项目ID。OCR支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账。 获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。 企业项目创建步骤请参见用户指南。 说明: 创建企业项目后,在传参时,有以下三类场景。 携带正确的ID,正常使用OCR服务,账单归到企业ID对应的企业项目中。 携带错误的ID,正常使用OCR服务,账单的企业项目会被分类为“未归集”。 不携带ID,正常使用OCR服务,账单的企业项目会被分类为“未归集”。 表3 请求Body参数 参数 是否必选 参数类型 描述 image 否 String 与url二选一 图片的Base64编码,要求Base64编码后大小不超过10MB。 图像各边的像素大小在15到8192px之间。支持JPG/PNG/BMP/TIFF格式。 图片Base64编码示例如/9j/4AAQSkZJRgABAg...,带有多余前缀会产生The image format is not supported报错。 url 否 String 与image二选一 图片的URL路径,目前支持: 公网http/https url OBS提供的url,使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权,详情参见配置OBS访问权限。 说明: 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠,推荐使用OBS服务存储图片数据。
  • API概览 通过使用文字识别服务的自研API,您可以使用文字识别服务的所有功能,如表1所示。 文字识别服务当前支持通用类、证件类、票据类和智能分类四种不同类型的接口。您可以通过在线体验,体验接口的识别效果。 对于固定板式的图片,如果当前接口不满足您的业务需求,可以使用 ModelArts Pro 服务提供的文字识别套件,零代码搭建出专属的API,详细操作请参见视频指导。 服务部署区域是从地理位置和网络时延维度划分,同一个区域内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。一般情况下,建议就近选择靠近您或者您的目标用户的区域,这样可以减少网络时延,提高访问速度。对于OCR服务,不同的区域之间资源包不互通,请根据您的实际需求慎重选择。 表1 接口说明 类别 API 说明 智能文档解析 智能文档解析 对证件、票据、表单等任意版式文档进行键值对提取、文字识别、以及 表格识别 等任务,实现进阶高效的自动化结构化返回。 通用类 通用表格识别 识别表格图片上的文字内容,并返回识别的结构化结果。 通用文字识别 识别图片上的文字内容,并返回识别的文字和坐标。 网络图片识别 识别网络图片中的文字内容,并以JSON格式返回识别的结构化结果。支持横向、竖向、艺术字识别。 智能分类识别 检测定位图片上指定要识别的票证(票据、证件或其他文字载体),并以JSON格式返回识别的结构化结果。 手写文字识别 识别手写文字图片中的文字内容。 证件类 身份证识别 识别身份证图片中正面与反面的文字内容,并返回识别的文字和坐标。 行驶证识别 识别行驶证图片中主页与副页的文字内容,并返回识别的文字和坐标。 驾驶证识别 识别驾驶证图片中主页与副页的文字内容,并返回识别的文字和坐标。 护照识别 识别护照首页图片中的文字信息,并以JSON格式返回识别的结构化结果。 银行卡识别 识别银行卡上的关键文字信息,并以JSON格式返回识别的结构化结果。 营业执照识别 识别营业执照首页图片中的文字信息,并以JSON格式返回识别的结构化结果。 道路运输证识别 识别道路运输证首页中的文字信息,并以JSON格式返回识别的结构化结果。 车牌识别 识别车牌图片中的车牌信息,并返回其坐标和内容。 名片识别 识别名片图片上的文字信息,并返回识别的结构化结果。支持对多种不同版式名片进行结构化信息提取。 VIN码识别 识别图片中的车架号信息,并将识别结果返回给用户。 电子面单识别 识别用户上传的电子面单图片中的文字内容,并将识别的结果返回给用户。 道路运输从业资格证识别 识别道路运输从业资格证上的关键文字信息,并返回识别的结构化结果。 泰文身份证识别 识别泰国身份证中的文字信息,并以JSON格式返回识别的结构化结果。 不动产证识别 识别不动产证中的文字信息,并返回识别的结构化结果。 车辆合格证识别 识别车辆合格证中的文字信息,并返回识别的结构化结果。 哥伦比亚身份证识别 识别哥伦比亚身份证中的文字信息,并将识别的结构化结果返回给用户。 票据类 增值税发票识别 识别增值税发票图片中的文字内容,并返回识别的结构化结果。 发票验真 支持10种增值税发票的信息核验。 机动车销售发票识别 识别机动车销售发票图片中的文字内容,并返回识别的结构化结果。 出租车发票识别 识别出租车发票中的文字信息,并以JSON格式返回识别的结构化结果。 火车票识别 识别火车票中的文字信息,并以JSON格式返回识别的结构化结果 定额发票识别 识别定额发票中的文字信息,并以JSON格式返回识别的结构化结果。 车辆通行费发票识别 识别车辆通行费发票中的关键文字信息,并以JSON格式返回识别的结构化结果。 飞机行程单识别 识别飞机行程单中的文字信息,并以JSON格式返回识别的结构化结果。 财务报表识别 识别用户上传的表格图片中的文字内容,并将识别的结果返回给用户。 承兑汇票识别 识别承兑汇票识别中的关键字段, 并以json格式返回结构化结果。 行业类 防疫健康码识别 识别防疫健康码中的姓名、健康码更新时间、健康码颜色,并将识别的结构化结果返回给用户。 核酸检测记录识别 支持对全国各地不同版式的核酸检测记录中的4个关键字段进行结构化识别,包括姓名、核酸检测采样时间、检测检测结果更新时间、核酸检测结果(阳性、阴性、未知)。 保险单识别 识别保险单图片上的文字信息,并将识别的结构化结果返回给用户。支持对多板式保险单的扫描图片及手机照片进行结构化信息提取。 自定义模板 自定义模板OCR 自定义模板OCR,支持用户自定义模板,对于版式固定的各种票据和卡证,通过可视化界面操作,指定需要识别的关键字段,实现用户特定格式图片的自动识别和结构化提取。
  • 响应示例 状态码:200 成功响应示例 { "result": { "amount": "¥50.00", "code": "244031XXXX11", "location": "广东省深圳市", "number": "91XXXX61", "confidence": { "amount": 0.9971, "code": 0.9908, "location": 0.9706, "number": 0.9943 } } } 状态码:400 失败响应示例 { "error_code": "AIS.0103", "error_msg": "The image size does not meet the requirements." }
  • 响应参数 根据识别的结果,可能有不同的HTTP响应状态码(status code)。例如,200表示API调用成功,400表示调用失败,详细的状态码和响应参数说明如下。 状态码: 200 表4 响应Body参数 参数 参数类型 描述 result QuotaInvoiceResult object 识别结果。 调用失败时不返回此字段。 表5 QuotaInvoiceResult 参数 参数类型 描述 number String 发票号码。 code String 发票代码。 location String 地址。 amount String 发票金额。 confidence Object 字段的置信度,取值范围0~1。 置信度越大,本次识别的字段的可靠性越高,在统计意义上,置信度越大,准确率越高。 置信度由算法给出,不直接等价于字段的准确率。 状态码: 400 表6 响应Body参数 参数 参数类型 说明 error_code String 调用失败时的错误码,具体请参见错误码。 当出现错误码“ModelArts.4204”时,请参考为什么调用API时提示“ModelArts.4204”?章节。 调用成功时不返回此字段。 error_msg String 调用失败时返回的错误信息。 调用成功时不返回此字段。
  • 请求示例 “endpoint”即调用API的请求地址,不同服务不同区域的“endpoint”不同,具体请参见终端节点。 例如,定额发票识别服务部署在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”或“ocr.cn-north-4.myhuaweicloud.cn”,请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/quota-invoice”,“project_id”为项目ID,获取方法请参见获取项目ID 如何获取Token请参见认证鉴权。 传入定额发票图片的base64编码进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/quota-invoice Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQEBAQIBAQECAgICAgQDAgICAg..." } 传入定额发票图片的url进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/quota-invoice Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url":"https://BucketName.obs.xxxx.com/ObjectName" }
共100000条