华为云用户手册

参数说明 表1 结果格式说明表 名称 类型 说明 project_id String 项目ID，获取方法请参见获取项目ID/账号名/AK/SK。 image_url String 图片的URL路径，目前仅支持华为云上OBS的URL，且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 本地图片文件，图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。 image_base64 String 图像数据，Base64编码，要求： Base64编码后大小不超过8MB，建议。 图片为JPG/JPEG/BMP/PNG格式。 similarity Double 人脸相似度，1表示最大，0表示最小，值越大表示越相似。一般情况下超过0.93即可认为是同一个人。 face_set_name String 人脸库名称，1位到64位之间，可以包含字母、数字、中划线或者下划线，不能包含其他的特殊字符。 face_set_capacity Integer 人脸库最大的容量，填写1万整数倍的数字，例如30000。默认为100000，最大值为100000，可通过创建新的人脸库进行扩容，每个用户可使用10个人脸库，每个人脸库容量为10万个人脸特征。如需扩容单个人脸库规模，请联系华为云客服确认扩容规模与价格。 face_id String 导入人脸时，系统返回的人脸编号，为8个随机生成的大小写字母组成。 external_image_id String 用户指定的图片外部ID，与当前图像绑定。用户没提供，系统会生成一个。该ID长度范围为1～36位，可以包含字母、数字、中划线或者下划线，不包含其他的特殊字符。 external_fields Json 根据用户自定义数据类型，填入相应的数值。创建人脸库时，定义该字段。具体参见自定义字段。 top_n Integer 返回查询到最相似的N张人脸，N默认为10。如果返回前5个，则该变量N的值为5。 取值范围1～1000。 threshold Double 人脸相似度阈值，低于这个阈值则不返回，取值范围[0,1]，一般情况下建议取值0.93，默认为0。 offset Integer 从第几条数据读起，默认为0。 limit Integer 读取多少条，默认为5。 video_url String 视频的URL路径，目前仅支持华为云上OBS的URL，且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。视频要求： 视频Base64编码后大小不超过8MB。 限制视频时长1～15秒。 建议帧率10fps～30fps。 封装格式：mp4、avi、flv、webm、asf、mov。 视频编码格式： h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。 video_file File 本地视频文件。上传文件时，请求格式为multipart。视频要求： 视频文件大小不超过8MB，建议客户端压缩到200KB~2MB。 限制视频时长1～15秒。 建议帧率10fps～30fps。 封装格式：mp4、avi、flv、webm、asf、mov。 视频编码格式： h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。 video_base64 String 视频数据，Base64编码，要求： Base64编码后大小不超过8MB，建议客户端压缩到200KB~2MB。 限制视频时长1～15秒。 建议帧率10fps～30fps。 封装格式：mp4、avi、flv、webm、asf、mov。 视频编码格式： h261、h263、h264、hevc、vc1、vp8、vp9、wmv3。 actions String 动作代码顺序列表，英文逗号（,）分隔。建议单动作，目前支持的动作有： 1：左摇头 2：右摇头 3：点头 4：嘴部动作 action_time String 该参数为动作时间数组拼接的字符串，数组的长度和actions的数量一致，每一项代表了对应次序动作的起始时间和结束时间，单位为距视频开始的毫秒数。 error_code String 调用失败时的错误码。 error_msg String 调用失败时的错误信息。 attributes String 是否返回人脸属性，希望获取的属性列表，多个属性用逗号隔开。目前支持的属性有： 0：人脸姿态 2：年龄 3：人脸关键点 4：装束（帽子、眼镜） 5：笑脸

响应参数 状态码：200 表5 响应Body参数 参数 参数类型 描述 face_set_info FaceSetInfo object 人脸库信息，详见FaceSetInfo。 调用失败时无此字段。 表6 FaceSetInfo 参数 参数类型 描述 face_number Integer 人脸库中已有的人脸特征的数量。 external_fields Object 用户的自定义字段。 face_set_id String 人脸库ID，随机生成的包含八个字符的字符串。 face_set_name String 人脸库名称。 create_date String 创建时间。 face_set_capacity Integer 人脸库最大的容量。创建人脸库时，请求参数如果不设置face_set_capacity参数，默认每个人脸库最大容量为10万个人脸特征。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

功能介绍 创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库，每个人脸库最大容量为10万个人脸特征。如有更大规格的需求请联系客服。 前提条件： 请确保您已开通人脸搜索服务。 默认情况下，一个人脸库最大可支持10万个人脸特征，一个用户最多可创建10个人脸库，最多可支持10*10万（100万）个人脸特征。 如您的需求超出100万个人脸特征，可通过工单或者服务热线（ 4000-955-988或950808 转1）与我们联系，咨询具体解决方案。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type 是 String 发送的实体的MIME类型，参数值为“application/json”。 Enterprise-Project-Id 否 String 企业项目ID。FRS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账，当前仅支持按需计费模式。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 说明： 创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。 携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 表3 请求Body参数 参数名 参数类型 是否必选 说明 face_id String 是 人脸ID，由系统内部生成的唯一ID。 external_image_id String 否 用户指定的图片外部ID，与当前图像绑定。用户不设置该参数时，系统会自动生成一个。该ID长度范围为[1,36]，可以包含字母、数字、中划线或者下划线，不包含其他的特殊字符。 这里是待修改的参数，external_image_id和external_fields至少选一个。 external_fields Object 否 自定义字段的key值长度范围为[1,36]，string类型的value长度范围为[1,256]，具体参见自定义字段。 这里是待修改的参数，external_image_id和external_fields至少选一个。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 face_number Integer 更新的人脸数量。 调用失败时无此字段。 face_set_id String 人脸库ID。 调用失败时无此字段。 face_set_name String 人脸库名称。 调用失败时无此字段。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

日志告警 如果没有对函数代码执行返回结果有特定要求，例如绑定了APIG触发器的事件函数需要返回一个APIG响应格式的结果如下： import json def handler (event, context): return { "statusCode": 200, "isBase64Encoded": False, "body": json.dumps(event), "headers": { "Content-Type": "application/json" } } 一般不建议在函数代码内捕获异常，其会导致创建的错误次数告警配置不生效。但是FunctionGraph实现了与云日志服务(LTS)的对接，支持在LTS服务中配置告警，LTS支持日志告警实时监控函数日志中出现的异常信息。 父主题： 使用函数访问Redis数据库

处理建议 返回对象选择页面，重新选择要同步的对象后再进行预检查。 预检查阶段，源数据库连接中断，导致检查失败。请确认源数据库连接正常后再重新进行预检查 Oralce为源的任务，由于Oracle Logminer组件限制，增量阶段源库所选表的schema名、表名及其包含的列名不能超过30个字符。请修改不符合要求的schema名、表名及其中的列名，使其长度不超过30个字符，然后重新再进行预检查。 Microsoft SQL Server为源的任务，单个任务同步的表数量不能超过1000张。请减少单个任务同步的表数量，取消勾选不需要同步的表，或者拆分成多个同步任务执行，然后重新再进行预检查。 请检查源或者目标数据库引擎是否属于特殊版本，特殊版本可能存在某些语法不支持，导致预检查不通过，请重新更换源或者目标数据库后重新进行预检查。

主机接入LTS后无法采集到日志？ 若刚完成配置则需要等待片刻，日志才会开始上报。 排查主机配置的采集路径是否重复，即有可能主机的路径配置了多次，这样则需要修改配置，同一个主机的路径只允许存在一种配置。 排查相同主机的同一个日志采集路径，是否已在AOM进行了配置。在AOM配置后则不能在LTS重复配置。 参考ECS接入排查是否存在不规范的配置导致日志采集失败。 若以上解决办法无法解决您的问题，请提交工单寻求技术支持工程师的帮助。 父主题： 日志接入

排查方法 登录ICAgent所在ecs主机。 执行“cd /var/ICAgent”进入ICAgent日志目录。 过滤日志文件，排查资源占用是否超过限制。 cat oss.icAgent.trace| grep 'icagent exit' 过滤日志压缩包，排查资源占用是否超过限制。 zgrep 'icagent exit' *.zip 过滤日志文件，ICAgent是否异常。 cat oss.script.trace | grep runtime 过滤日志压缩包，ICAgent是否异常。 zgrep runtime oss.script.*.zip

成本对比 场景一： 假设客户每天原始日志100GB（日志平均速率1.16MB/s），日志平均存储30天，30天原始日志总量为3000GB，日志存储方式为一主一副本。 根据Elasticsearch官方推荐，在一主一副本存储方式下，原始日志+副本数据+索引数据等合计占用的存储空间约为原始日志大小2.2倍，另外由于ES集群存在写不均匀且磁盘不能被耗尽，因此为了存储3000GB原始日志，至少需要准备3000GB*2.2（存储膨胀）*2（50%磁盘冗余） = 13200 GB磁盘。 搭建ES最小典型配置是3台ECS（16U64G5TB），kafka双副本能支持缓存最近12小时的日志 大类 小类 月成本 费用占比 搭建ES 3 * ECS（C6 16U64G） 3*1999=5997 47.6% 云硬盘EVS（高IO 15TB） 0.35*15*1024=5376 42.7% 搭建KAFKA 3 * ECS（2U4G） 3*208=624 4.9% 云硬盘EVS（超高IO 3*200GB） 600 4.7% - - 自建ELK，合计：12597 - LTS使用价格计算器，计算出来月成本约为2102元，使用LTS的成本约为自建ELK成本的16.7%，原因是在小日志量场景下，自建ELK起步资源成本很高，相比于按需付费的LTS，有很大劣势。 场景二： 假设客户每天原始日志1TB（日志平均速率11.6MB/s），日志平均存储7天，7天原始日志总量为7TB，日志存储方式为一主一副本。根据Elasticsearch官方推荐，在一主一副本存储方式下，原始日志+副本数据+索引数据等合计占用的存储空间约为原始日志大小2.2倍，另外由于ES集群存在写不均匀且磁盘不能被耗尽，因此为了存储7TB原始日志，至少需要准备7TB*2.2（存储膨胀）*2（50%磁盘冗余） = 31 TB磁盘。 搭建ES最小典型配置是3台ECS（16U64G10TB），kafka双副本能支持缓存最近12小时的日志 大类 小类 月成本 费用占比 搭建ES 3 * ECS（C6 16U64G） 3*1999=5997 31.7% 云硬盘EVS（高IO 31TB） 0.35*31*1024=11110 58.7% 搭建KAFKA 3 * ECS（2U4G） 3*208=624 3.3% 云硬盘EVS（超高IO 3*400GB） 1200 6.3% - - 自建ELK，合计：18931 - LTS使用价格计算器，计算出来月成本约为13408元，使用LTS的成本约为自建ELK成本的71%，原因是LTS的存储收费是按用量付费，自建ELK为了保证集群的正常运行需要留有很多磁盘冗余。 场景三： 假设客户每天原始日志5TB（日志平均速率58MB/s），日志平均存储30天，30天原始日志总量为150TB，日志存储方式为一主一副本。 根据Elasticsearch官方推荐，在一主一副本存储方式下，原始日志+副本数据+索引数据等合计占用的存储空间约为原始日志大小2.2倍，另外由于ES集群存在写不均匀且磁盘不能被耗尽，因此为了存储150TB原始日志，至少需要准备150TB*2.2（存储膨胀）*2（50%磁盘冗余） = 660 TB磁盘。 搭建ES最小典型配置是66台ECS（16U64G10TB），kafka双副本能支持缓存最近12小时的日志 大类 小类 月成本 费用占比 搭建ES 66 * ECS（C6 16U64G） 66*1999=131934 35.3% 云硬盘EVS（高IO 660TB） 0.35*660*1024=236544 63.2% 搭建KAFKA 3 * ECS（2U4G） 3*208=624 0.2% 云硬盘EVS（超高IO 3*1700GB） 5100 1.4% - - 自建ELK，合计：374202 - LTS使用价格计算器，计算出来月成本约为107655元，使用LTS的成本约为自建ELK成本的28.8%，原因是LTS的存储收费是按用量付费，自建ELK为了保证集群的正常运行需要留有很多磁盘冗余。

功能对比 云日志服务（LTS）在功能特性的完备度、日志搜索分析性能方面对比ELK有明显的优势，详细对比请见如下表格： 特性 子特性 LTS ELK 描述 日志采集 云服务日志采集 ☆☆☆☆☆ 无 ELK：不支持采集云服务日志。 LTS：云服务租户面日志统一采集到LTS。 虚机和容器日志采集 ☆☆☆☆☆ ☆☆☆☆ ELK：使用logstash或者filebeat等开源采集器采集日志。 LTS：使用ICAgent采集日志，有提供向导页面，上手难度低。 多语言SDK日志采集 ☆☆☆ 无 ELK：不支持。 LTS：提供java SDK直接上报日志到LTS 主机组管理（主机动态扩缩容） ☆☆☆☆☆ 无 ELK：不支持。 LTS：提供主机管理、主机组管理能力，主机组支持自定义标识主机组，可以管理动态扩缩容主机组。 日志结构化解析 ☆☆☆☆ ☆☆☆☆☆ ELK：基于采集器实现自定义日志结构化解析。 LTS：提供结构化解析能力，可以正则表达式、JSON、分隔符、自定义模板等方式解析日志。 日志搜索 关键词搜索、模糊搜索、快速分析 ☆☆☆☆☆ ☆☆☆☆☆ ELK和LTS：提供类似的日志关键词搜索能力。 实时日志查看 ☆☆☆☆☆ 无 ELK：未提供实时日志查看页面。 LTS：提供实时日志查看页面。 百亿日志秒级搜索 ☆☆☆☆☆ ☆☆ ELK：自建ELK受限于机器资源数量，搜索海量日志时耗时较长。 LTS：利用公有云海量的弹性计算资源，百亿日志可以在3秒内返回搜索结果。 千亿级日志迭代搜索 ☆☆☆☆☆ 无 ELK：无法直接搜索千亿条日志，会出现响应超时。 LTS：提供迭代搜索能力，用户可以直接搜索千亿条日志。 日志管理规模 百PB级 百TB级 ELK：经常要关注机器扩容，费时费力。 LTS：按需付费，LTS自动管理百PB级日志，不用关心底层资源消耗情况。 日志搜索 SQL分析日志 ☆☆☆☆☆ ☆☆ ELK：SQL性能差，语法上不支持嵌套SQL。 LTS：SQL性能强，支持嵌套SQL。 日志搜索 SQL函数 ☆☆☆☆☆ ☆☆ ELK：只支持最基础的SQL统计函数。 LTS：在基础SQL函数基础上，提供了大量的扩展函数，例如IP函数、统计函数、环比同比函数、URL函数等，极大扩展了使用场景。 日志搜索 可视化图表 ☆☆☆☆ ☆☆☆ LTS：提供了表格、折线图、饼图、柱状图等多种可视化图表 日志搜索 仪表盘 ☆☆☆☆☆ ☆☆ ELK：没有云服务日志开箱即用仪表盘。 LTS：提供开箱即用的仪表盘，对常见的云服务日志例如ELB/APIG/DDS/DCS/CFW等提供开箱即用的仪表盘。 日志告警 日志关键词告警和SQL告警 ☆☆☆☆☆ ☆ ELK：没有日志告警功能。 LTS：提供准实时的日志关键词和SQL告警功能。 告警通知渠道（邮件、短信、HTTPS等） ☆☆☆☆☆ ☆ ELK：无法将告警方便的以钉钉、微信、短信等方式通知用户。 LTS：对接华为云消息通知服务，能以邮件、短信、微信、钉钉、飞书、HTTP等多种渠道通知客户。 日志转储 转储到对象存储 ☆☆☆☆☆ 无 ELK：无法直接转储对象存储。 LTS：页面简单配置可以将日志转储到对象存储。 日志转储 转储到kafka ☆☆☆☆☆ ☆☆ ELK：需要自己部署程序将日志转发到KAFKA LTS：页面简单配置可以将日志实时转储到KAFKA 日志转储 转储到数据仓库 ☆☆☆☆☆ 无 ELK：无法直接将日志转储到数据仓库 LTS：页面简单配置可以将日志转储到数据仓库 日志加工 定时SQL作业 ☆☆☆☆☆ 无 ELK：没有定时SQL作业能力 LTS：可以配置定时SQL作业，将原始日志加工统计为想要的少量日志结果 函数加工 ☆☆☆☆☆ 无 ELK：没有日志加工功能。 LTS：提供函数触发器，在函数服务中可以配置自定义脚本将日志灵活加工。

排查方法 确认日志采集开关是否开启。 登录云日志服务LTS控制台，选择“配置中心”。 在“日志采集开关”页签，确认日志采集开关是否开启，若没有开启，需要开启日志采集开关。 检查最近一次下发的日志采集开关配置。 登录ICAgent所在的ecs主机。 执行“cd /var/ICAgent”进入ICAgent日志目录。 执行如下命令，查询日志采集配置。 zgrep switchList *.zip //查询已转储日志压缩包 cat oss.icAgent.trace | grep switchList //查询当前日志文件 从过滤结果查找日志时间最新的配置，并查看switch.log是否为true（代表开启日志采集开关）。 检查日志采集开关文件的内容switch.log是否为true（代表开启日志采集开关）。 登录ICAgent所在的主机。 查询日志采集开关文件。 cat /var/share/oss/manager/ICProbeAgent/internal/TRACE_CONFIG/swithes_context.json 日志采集开关文件的内容switch.log为true。 确认是否日志发送失败。 登录ICAgent所在ecs主机。 执行“cd /var/ICAgent”进入ICAgent日志目录。 查询发送失败日志。 cat oss.icAgent.trace | grep httpsend | grep 'dataType:TRACE' | grep failed zgrep 'dataType:TRACE' *.zip | grep httpsend | grep failed 若显示failed代表日志发送失败，则需要联系LTS技术支持工程师排查。 确认LTS下发配置。 登录ICAgent所在ecs主机。 执行“cd /var/ICAgent”进入ICAgent日志目录。 过滤日志文件查询LTS下发的日志采集配置。 cat oss.icAgent.trace | grep 'als event' | grep -v grep | tail -n 1 以上截图仅供参考，请以实际查询结果为准。从过滤结果查找用户实际设置的日志组、日志流以及采集路径，则确保已下发采集配置。 如果日志文件查询不到，则查询日志压缩包。 zgrep 'als event' *.zip | grep -v grep | tail -n 1 登录云日志服务LTS控制台，确认是否正确下发了采集配置。

LTS日志使用冷存储保存后遇到问题怎么办？ 问题：标准存储日志如何转换成冷存储？ 答：当日志保存时间大于标准存储层数据保存时间，且小于日志存储时间时，数据将自动转换为智能冷存储层数据存储。 例如：日志存储时间是30天，标准存储层数据保存时间是10天，假设只有第一天有日志上报，那么到第11天时，第1天的日志会存储到冷存储中，到第12天时，第2天的日志会存储到冷存储中，以此类推。 图1 冷存储 问题：冷存储的日志是否能重新变成标准存储日志？ 答：不能，冷存储的日志不支持重新转为标准存储。 问题：标准存储的日志转换成冷存储的生效周期有多久？ 答：1个小时内。 问题：日志存储一段时间后，修改日志流的配置，设置日志冷存储，存量日志会自动转存到冷存储中吗？比如用户日志存储时间设置为30天，当前日志已经存储了10天，现在修改日志流配置，开启智能冷存储，标准存储层数据保存时间设置为7天，那超过7天的历史日志会存放到冷存储中吗？ 答：历史日志达到标准存储层数据保存时间了就会放入冷存储，如上问题，标准存储层数据保存时间为7天，现在日志已经存储了10天，那么前3天的日志就会存放到冷存储中。 父主题： 日志管理

Windows环境下安装ICAgent失败，并提示SERVICE STOP 现象：在Windows环境下安装ICAgent失败，提示SERVICE STOP。任务管理器中不存在ICAgent任务。系统服务列表中不存在ICAgent服务。命令行下执行sc query icagent提示未找到。 原因：一般为360安全卫士等杀毒软件拦截了icagent服务注册。 解决方法： 检查360安全卫士等杀毒软件是否正在运行。 关闭360安全卫士后再进行icagent安装。 Windows下ICAgent采集文件类型需要手动配置采集路径*.log、 *.trace、 *.out等文本文件，不支持二进制文件。

使用LTS SDK相关问题 本文介绍使用LTS SDK的常见问题和相关报错的处理方法。 端侧SDK日志接入LTS时需要注意什么？ 答：请用户在使用端侧SDK日志接入LTS时，建议提前做好一键关闭日志上报、逐步提升上报流量等措施，做到及时止损，如果您的移动端日志流量非常大，请提前知会LTS技术支持为您提前预留资源。 端侧SDK中的上报日志report接口和立即上报日志reportImmediately接口如何选择？ 答：建议使用上报日志report接口，通过调整上报策略，配置上报间隔、上报大小等参数。重要紧急的数据使用立即上报日志reportImmediately接口，即可进行立即上报。 端侧SDK上报的数据是放到labels参数还是contents参数？ 答：固定数据（例如用户ID、设备型号、渠道、系统、网络等）可以放到labels参数，方便进行维度分析；其他数据建议都放到contents参数，然后按需进行索引配置。 集成接入SDK包后对于客户App大小和性能有什么影响吗？ 答：iOS端App大小增加50KB左右，Android端App大小增加200KB左右，Web端大小可以忽略不计。在上传日志数据100条/每秒的情况下对性能没有影响。 iOS SDK和Android SDK支持哪些版本？ 答：iOS SDK支持iOS10及以上版本，Android SDK支持Android7及以上版本。如果需要支持更低版本，请提交工单申请开通。 按文档要求操作接入后，但在LTS控制台查询不到上报的日志数据？ 答：首先检查AK，SK，region，projectId这四个参数是否正确，更多信息请参考SDK接入。其次，在App控制台查看报错提示，详细请参考错误码。最后，请检查端侧权限是否已开通LTS白名单，若有需要，请提交工单申请开通。 App控制台上报日志失败，报错提示接口403？ 答：在云日志服务控制台查看日志流是否开启了匿名上报。详细请参考日志流章节中如何开启匿名写入。 集成接入SDK的时候提示SDK初始化失败。 答：可以先开启debug模式，每个参数都会打印，根据提示可以定位到初始化失败的原因。 端侧上报一条日志长度和大小限制。 答：一条日志长度是30720个字符，超过该长度的内容会被删除，只截取30*1024长度的内容，然后以字符串方式上报LTS。上报日志的大小限制为1MB。 端侧SDK日志的上报策略是什么样的？ 答：端侧SDK日志有时间和空间维度的自定义上报策略，上报间隔默认3s，上报条数默认200条，哪个先触发就先上报。 端侧SDK日志发送是异步发送还是同步发送？ 答：端侧SDK日志发送是异步发送。 LTS能支持多大的端侧SDK并发量？ 答：端侧SDK并发量与资源容量大小有关，理论上来说只要LTS资源足够，并发量不是问题。若需要支持更多端侧SDK并发量，请提交工单申请开通。 父主题： SDK接入

如何获取AK/SK？ AK/SK（Access Key ID/Secret Access Key）即访问密钥，表示一组密钥对。请参考如何获取访问密钥AK/SK获取AK和SK。 AK：访问密钥ID，是与私有访问密钥关联的唯一标识符。访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 请获取并使用公共用户账号的AK/SK，请勿使用个人账号的AK/SK。 父主题： 主机管理

操作步骤 若是ECS接入时，安装ICAgent完成后在主机页面不显示。 在安装ICAgent页面确认安装命令复制正确，不能使用跨region的安装命令。 检查已获取的AK/SK是否正确，且AK/SK没有被删除。 执行“netstat -nap | grep icagent”命令查看主机网络是否正常。 若是CCE接入时，安装ICAgent完成后在主机页面不显示。 确保CCE集群已安装ICAgent并且已创建相关节点自定义标识的主机组，若没有安装ICAgent，请到主机管理页面进行升级。详细操作请参考升级ICAgent。 在Windows环境安装ICAgent失败。 确保使用administrator账户安装。 检查已获取的AK/SK是否正确，且AK/SK没有被删除。

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 name String 存证名称 ev_id String 存证ID file_hash String 文件内容Hash, 即存证指纹 charge_type String 存证类型, normal:普通存证 create_time String 创建时间 tx_id String 交易ID block_hash String 区块哈希 block_height Integer 区块高度 user_addr String 用户地址，基于用户证书生成的公钥 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：20 error_msg String 错误描述 最小长度：1 最大长度：512

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 tx_id String 交易ID, 64位哈希值 最小长度：64 最大长度：64 ev_id String 存证ID 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：20 error_msg String 错误描述 最小长度：1 最大长度：512

URI GET /v1/{project_id}/evidences 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从IAM申请到的projectid，一般为32位字符串 最小长度：32 最大长度：64 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 分页，每页大小,分页大小只支持10、20、50/页，默认显示10条/页 最小值：10 最大值：50 offset 否 Integer 偏移量，从第几项开始,默认值为0 最小值：0 最大值：65535 name 否 String 按照存证名称字段搜索，不支持模糊匹配 最小长度：4 最大长度：765 charge_type 否 String 按照存证类型，精确匹配 最小长度：4 最大长度：64 begin_time 是 String 按照时间范围搜索，起始时间 （UTC时间，毫秒级)，和end_time配合使用。最大时间不超过30天。 最小长度：13 最大长度：16 end_time 是 String 按照时间范围搜索，截止时间 （UTC时间，毫秒级)，和begin_time配合使用。最大时间不超过30天 最小长度：13 最大长度：16

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 total_count Integer 总记录 evidences Array of Evidence objects 存证信息列表 表4 Evidence 参数 参数类型 描述 name String 存证名称 ev_id String 存证ID file_hash String 存证指纹 charge_type String 存证类型, normal:普通存证 create_time String 创建时间 tx_id String 交易ID 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：20 error_msg String 错误描述 最小长度：1 最大长度：512

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 tx_id String 交易ID, 64位哈希值 最小长度：64 最大长度：64 ev_id String 存证ID 最小长度：0 最大长度：64 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：20 error_msg String 错误描述 最小长度：1 最大长度：512

URI GET /v1/{project_id}/evidences/trend 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从IAM申请到的projectid，一般为32位字符串 最小长度：32 最大长度：64 表2 Query参数 参数 是否必选 参数类型 描述 charge_type 是 String 存证类型， 取值normal，表示普通存证 最小长度：1 最大长度：64 time_mode 是 String 时间模式，取值支持hour;day;week;month。hour返回30个点,粒度为2分钟；day返回24个点，粒度为1小时；week返回个28点，粒度为6小时；month返回30个点，粒度为1天； 最小长度：3 最大长度：16

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 usages Array of UsageTrendElement objects 使用量趋势 表4 UsageTrendElement 参数 参数类型 描述 t String 时间戳，（UTC时间，毫秒级) v Integer 使用量 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：20 error_msg String 错误描述 最小长度：1 最大长度：512

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 account Integer 此projectID下的存证总数 最小值：0 最大值：18446744073709551615 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：20 error_msg String 错误描述 最小长度：1 最大长度：512

URI GET /v1/{project_id}/evidences/usage 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户从IAM申请到的projectid，一般为32位字符串 最小长度：32 最大长度：64 表2 Query参数 参数 是否必选 参数类型 描述 charge_type 是 String 存证类型， 取值normal，表示普通存证 最小长度：1 最大长度：64

URI GET /v1/open/evidences/verification 表1 Query参数 参数 是否必选 参数类型 描述 index 否 String 通用搜索条件：取值为存证ID、证据指纹、交易ID中任意1个值 最小长度：32 最大长度：64 file_hash 否 String 证据指纹搜索条件：取值为证据指纹 最小长度：32 最大长度：64 tx_id 否 String 交易ID搜索条件：取值为交易ID 最小长度：32 最大长度：64 ev_id 否 String 存证ID搜索条件：取值为存证ID 最小长度：32 最大长度：64

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 name String 存证名称 ev_id String 存证ID file_hash String 文件内容Hash, 即存证指纹 block_hash String 区块哈希 block_height Integer 区块高度 create_time String 创建时间 tx_id String 交易ID 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：1 最大长度：20 error_msg String 错误描述 最小长度：1 最大长度：512

访问方式 公有云提供了Web化的服务管理平台（即管理控制台）和基于HTTPS请求的API（Application programming interface）管理方式。 API方式 如果用户需要将镜像服务集成到第三方系统，用于二次开发，请使用API方式访问镜像服务。具体操作请参见《镜像服务API参考》。 管理控制台方式 其他相关操作，请使用管理控制台方式访问镜像服务。如果用户已在云平台注册，可直接登录管理控制台，从主页选择“镜像服务”。 如果未注册，请参见“注册华为账号并开通华为云”。

镜像类型 镜像分为公共镜像、私有镜像、共享镜像、市场镜像。公共镜像为系统默认提供的镜像，私有镜像为用户自己创建的镜像，共享镜像为其他用户共享的私有镜像。 图1以动图的形式展示了各类型镜像间的关系。 图1 镜像类型 镜像类型 说明 公共镜像 常见的标准操作系统镜像，所有用户可见，包括操作系统以及预装的公共应用。公共镜像具有高度稳定性，皆为正版授权，请放心使用，您也可以根据实际需求自助配置应用环境或相关软件。 官方公共镜像支持的操作系统类型包括：Huawei Cloud EulerOS、Windows，CentOS，Debian，openSUSE，Fedora，Ubuntu，EulerOS，CoreOS。 说明： Windows操作系统为市场镜像，该服务由第三方提供。为方便用户选用，在公共镜像中提供入口。 更多关于公共镜像的介绍，请参见“公共镜像概述”。 私有镜像 包含操作系统或业务数据、预装的公共应用以及用户的私有应用的镜像，仅用户个人可见。 私有镜像包括系统盘镜像、数据盘镜像、ISO 镜像和整机镜像，其中： 系统盘镜像：包含用户运行业务所需的操作系统、应用软件的镜像。系统盘镜像可以用于创建云服务器，迁移用户业务到云。 数据盘镜像：只包含用户业务数据的镜像。数据盘镜像可以用于创建云硬盘，将用户的业务数据迁移到云上。 ISO 镜像：将外部镜像的ISO文件注册到云平台的私有镜像。ISO镜像是特殊的镜像，只能发放用作临时过渡的云服务器。 整机镜像：也叫全镜像，包含用户运行业务所需的操作系统、应用软件和业务数据的镜像。整机镜像基于差量备份制作，相比同样磁盘容量的系统盘镜像和数据盘镜像，创建效率更高。 共享镜像 由其他用户共享而来的私有镜像。 更多关于共享镜像的使用，请参见“共享镜像”。 市场镜像 提供预装操作系统、应用环境和各类软件的优质第三方镜像。无需配置，可一键部署，满足建站、应用开发、可视化管理等个性化需求。 市场镜像通常由具有丰富云服务器维护和配置经验的服务商提供，并且经过华为云云市场和服务商的严格测试和审核，可保证镜像的安全性。