华为云用户手册

  • 环境参数值使用内置函数的设置说明 环境参数不支持内置函数嵌套,如果有嵌套则原样输出。 环境参数支持的内置函数如表1。 表1 环境参数支持的内置函数表 序号 函数 描述 1 $random_string(intA) 生成指定长度随机字符串 2 $random_int(intA, intB) 生成指定范围随机数 3 $timestamp() 获取当前时间戳 4 $timestamp_format(String A, String B) 时间戳转日期 5 $uuid() 生成UUID 6 $encode_base64(StringA) 生成Base64编码 7 $md5(StringA) 生成MD5哈希值 8 $sha512(StringA) 生成SHA512编码 环境参数支持内置函数使用举例如下。 正常场景:引用$random_string(intA),输出$random_string(intA)。 正常场景:函数前后拼接字符,按照字符串解析,原样输出。例如引用aa$random_string(10)或者$random_string(10)aa,则输出aa$random_string(10)或者$random_string(10)aa。 异常场景:传参所需一个参数,实际传两个参数,例如$random_string(1,1) ,执行时抛出异常。 传参类型和实际函数所需参数类型不匹配,例如$random_string(fff)或$random_string() ,执行时抛出异常 。
  • 环境参数引用形式 环境参数的引用形式为“$${参数名}”。例如:参数名为“hostname”,则可以使用“$${hostname}”来引用该参数。 根据需要可以对环境参数进行分组配置管理,例如:参数hostname在类生产环境中的值为“stage.example.com”,在生产环境中的值为“prod.example.com”,测试脚本使用“$${hostname}”引用该参数,执行测试时选择不同环境执行,实现一套接口自动化用例在所有环境复用。
  • 环境参数设置方法 进入接口自动化用例编辑的“脚本”页签,单击图标。 单击“新建变量”,输入参数信息,单击“确定”。 配置项 说明 参数名 参数的名称。 类型 参数的类型。支持文本、随机字符串、随机整数、时间戳等多种类型。 值 参数的值。 描述 对参数的描述。 敏感参数 勾选为敏感数据后,对参数值加密存储,在测试结果日志中使用星号覆盖处理。敏感数据类型适用并不限于个人信息、鉴权信息,例如姓名、地址、用户名等。 动态参数 动态参数设置,动态参数的值可以在用例执行过程中被赋值。动态参数初始值可为空,被赋值之后,此处显示的是最新值。 在用例测试步骤“响应提取”的“赋值给环境动态参数”列中设置后,在测试执行时,响应提取的内容将被赋值给动态参数。详细介绍请参见动态变量说明。 页面中会有一个默认环境。 如果需要设置其它环境为默认环境,单击该环境卡片右上角图标,在下拉列表中选择“设为默认环境”。
  • 实例 请求url路径 如下图所示,请求url路径中参数“test”的值为大写转小写运算函数,函数中的参数A为“TEST”。 请求头 如下图所示,请求头中参数“lower”的值为大写转小写运算函数,函数中的参数A为“Test”。 请求体 如下图所示,请求体中应用了大写转小写运算函数,函数中的参数A为“Test”。 检查点属性 如下图所示,检查点属性“result”的目标值为大写转小写运算函数,函数中的参数A为“Test”。 if判断 如下图所示,if判断的目标值为大写转小写运算函数,函数中的参数A为“AAAAA”。 for循环中断条件 如下图所示,for循环中断条件的目标值为大写转小写运算函数,函数中的参数A为“OK”。
  • 内置参数 内置参数是将HTTP/HTTPS响应的对应部分参数化,在检查点、响应提取功能中的“来源”选项中可以选择内置参数。 测试计划服务中的内置参数如下表: 内置参数 参数说明 是否支持多级取值 用途 举例 响应体(json) 表示接口返回的响应体。 是 检查点的属性字段 参数传递的属性字段 检查点:判断响应体中的id等于100。 设置方法:设置检查点来源为响应体(JSON),属性为id(前提条件响应体JSON串有id字段),设置比较符为等于(字符串、不区分大小写),设置目标值为100。 响应头 表示接口返回的响应头。 是 检查点的属性字段 参数传递的属性字段 检查点:判断响应头中的token等于abcd。 设置方法:设置来源为响应头,属性为token(前提条件响应头有token),设置比较符为等于(字符串、不区分大小写),设置目标值为abcd。 响应码 表示接口返回的响应码。 否 检查点的属性或值字 变量的属性字段 检查点:判断响应码等于200。 设置方法:设置来源为响应码,设置比较符为等于(数字),设置目标值为200。 内置参数支持多级取值,例如 响应体为“{"result":{"appId":12}}”时,则取appId的格式为:来源选择响应体,属性为“result.appId”。如果result是数组格式。则属性为“result[i].appId”,其中,i为非负整数。
  • 局部参数 局部参数使用范围是当前测试用例,如:测试步骤的参数、检查点、变量等都可以引用局部参数。 局部参数引用形式为“${参数名}”,如:参数名为“hostIp”,则可以使用“${hostIp}”来引用该参数。 局部参数主要配置项如下: 表1 参数主要配置项 配置项 是否必填 描述 名称 是 支持中英文、数字、点号、中文短横线、下划线的半角字符,并且长度范围是1~300。 类型 是 支持文本、随机字符串、随机整数、时间戳、格式化时间戳、生成UUID、Base64编码、MD5哈希值、密码或认证信息、SHA512编码。 详情介绍请参考表2。 描述 否 对参数的简要描述,上限为3000字符。默认为当前参数类型的描述。 单击“文本框”后,用户可以直接输入文本描述。 单击,输入一个json,单击“Json转换”,可以给没有换行的Json添加换行和缩进,单击“回填”添加成功。 值 否 用户可以为不同类型的参数赋值,详情请参考表2。 敏感变量 否 勾选为敏感数据后,测试计划对参数值加密存储,在测试结果日志中使用星号覆盖处理。敏感数据类型适用并不限于个人信息、鉴权信息,例如姓名、地址、用户名等。 动态变量 否 动态参数的值可以在用例执行过程中被赋值。动态参数初始值可为空,被赋值之后,此处显示的是最新值。 动态参数赋值方法:在用例测试步骤“响应提取”的“赋值给环境动态参数”中设置后,在测试执行时,响应提取的内容将被赋值给动态参数。 表2 参数类型 名称 描述 文本 上限为10000字符,支持设置“敏感参数”、“动态参数” ,默认为否。 随机字符串 随机生成指定长度字符串,随机字符串的变量值长度校验范围【1-9999】,不支持设置“敏感参数”及“动态参数”。 随机整数 随机生成指定范围整数,区间范围校验为【-999999999~999999999】,不支持设置“敏感参数”及“动态参数” 。 例如:设置【-9999,9999】 ,会获取这个区间内的随机整数。 时间戳 无需输入,生成当前整数时间戳,不支持设置“敏感参数”及“动态参数”。 格式化时间戳 格式为yyyy-MM-dd HH:mm:ss 或yyyy-MM-dd,不支持设置“敏感参数”及“动态参数”。 例如:1.yyyy-MM-dd HH:mm:ss:33250825252000 , 预期值为3023-09-05 20:20:52。 2.yyyy-MM-dd:33250825252000,预期值为3023-09-05。 生成UUID 无需输入,不支持设置“敏感参数”及“动态参数”。 Base64编码 使用Base64方法编码参数,上限为256字符,不支持设置“敏感参数”及“动态参数”。 MD5哈希值 使用指定参数生成MD5哈希值,上限为256字符,不支持设置“敏感参数”及“动态参数”。 密码或认证信息 上限为256字符,不支持设置“敏感参数”及“动态参数”。默认勾选“敏感参数”。 SHA512编码 上限为256字符,不支持设置“敏感参数”及“动态参数”。默认勾选“敏感参数”。 数组 数组的内容是json数组格式,上限为10000字符,不支持设置“敏感参数”及“动态参数”。 局部参数配置方法如下: 在界面新建变量 进入接口自动化用例编辑的“脚本”页签,单击图标。 单击左上方“新建变量”,输入参数名、类型、值。 全部参数设置完毕,单击“保存”。 从本地批量导入变量 进入接口自动化用例编辑的“脚本”页签,单击图标。 单击“导入”。 在弹框中单击“下载模板”。 按照模板中的格式要求填写参数信息,返回页面,在弹框中单击,上传编写好的文档,单击“确定”。 查看导入结果: 导入成功:列表中将新增参数,新增的参数条数与Excel中编辑的行数相同。 导入失败:页面右上角会显示弹框提示失败,单击“详情”可以查看错误原因,修改后请重新导入。
  • 示例 请求url路径 如下图所示,请求url路径中参数“test”的值为二元加法运算函数,函数中的参数A、B均为“1000”。 请求头 如下图所示,请求头中参数“add”的值为二元加法运算函数,函数中的参数A为二元减法运算“$subtract(1001,1000)”、参数B为“-1”。 检查点属性 如下图所示,检查点属性“result”的目标值为二元加法运算函数,函数中的参数A为局部参数“test”,参数B为“1”。局部参数的设置方式请参考局部参数。 if判断 如下图所示,if判断的目标值为二元加法运算函数,函数中的参数A为数字“1”,参数B为环境变量“status”。环境参数的设置方式请参考设置环境参数。 for循环中断条件 如下图所示,for循环中断条件的目标值为二元加法运算函数,函数中的参数A、B均为“1000”。
  • AstroZero权限 默认情况下,新建的IAM用户没有任何权限,需要将其加入用户组,并给用户组授予策略或角色,才能使得用户组中的用户获得对应的权限,这一过程称为授权。授权后,用户就可以基于被授予的权限对云服务进行操作。 AstroZero部署时通过物理区域划分,为项目级服务。授权时,“作用范围”需要选择“区域级项目”,然后在指定区域(如华北-北京4)对应的项目(cn-north-4)中设置相关权限,并且该权限仅对此项目生效。如果在“所有项目”中设置权限,则该权限在所有区域项目中都生效。访问AstroZero时,需要先切换至授权区域。 根据授权精细程度分为角色和策略。 角色:IAM最初提供的一种根据用户的工作职能,定义权限的粗粒度授权机制。该机制以服务为粒度,提供有限的服务相关角色用于授权。由于华为云各服务之间存在业务依赖关系,因此给用户授予角色时,可能需要一并授予依赖的其他角色,才能正确完成业务。角色并不能满足用户对精细化授权的要求,无法完全达到企业对权限最小化的安全管控要求。 策略:IAM最新提供的一种细粒度授权的能力,可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式,能够满足企业对权限最小化的安全管控要求。 如表1所示,包括了AstroZero的所有系统权限。 表1 AstroZero系统权限 系统角色/策略名称 描述 类别 依赖关系 Astro Zero Instance ManageAccess Astro轻应用实例管理权限,拥有订购、退订、查看和升级AstroZero实例的权限。 系统策略 无 Astro Zero Instance ViewAccess Astro轻应用实例查看权限,只拥有查看AstroZero实例的权限,不可进行退订、升级等操作。 若IAM用户登录AstroZero服务控制台,查看不到AstroZero实例,处理方式有以下两种(任选其一即可): 给IAM用户所在用户组,添加“Astro Zero Instance ViewAccess”权限。 不要将IAM用户,添加到任何用户组中。 系统策略 无 Astro Zero IAM User QueryAccess Astro轻应用IAM用户查询权限,只有华为云账号或具有“Astro Zero IAM User QueryAccess”权限的IAM用户,才能执行创建AstroZero开发者账号的操作。 系统策略 无 表2列出了AstroZero常用操作与系统策略的授权关系,您可以参照该表选择合适的系统策略。 表2 AstroZero常用操作与系统策略之间的关系 操作 Astro Zero Instance ManageAccess Astro Zero Instance ViewAccess Astro Zero IAM User QueryAccess 查看Astro轻应用实例列表及详情 √ √ x 订购Astro轻应用实例 √ x x 退订Astro轻应用实例 √ x x 变更Astro轻应用实例规格 √ x x 修改Astro轻应用实例详情 √ x x 创建Astro轻应用开发者账号 x x √ 除了具备该权限外,还需要具备AstroZero本身的权限,即在权限配置文件Profile中,还需勾选“管理用户&用户权限”。 查询Astro轻应用IAM用户 x x √ 除了IAM提供的认证和授权功能,AstroZero本身也提供了用户管理和权限配置(Profile)功能,来管理用户(包括业务用户),控制用户、业务用户等的操作权限。
  • 产品规格差异 AstroZero提供了免费版、标准版、专业版和专享版四种规格套餐,各套餐的功能说明如表1所示,具体计费详情请参见产品价格详情。 免费版:免费使用,最多可添加10个用户(包括业务用户),可以使用的资源有限,免费版提供开发环境和开发零代码应用的运行环境,不提供低代码应用的运行环境。 标准版:适用于零代码应用开发场景,开发者不需要有代码开发经验,企业自用首选。 标准版270元/月,最多可添加30个用户(包括业务用户),超过的用户数将额外收取费用(9元/用户/月)。 专业版:专业版在标准版基础上提供了低代码应用运行环境(多租户共享运行环境),且提供了更多功能和资源,适用于专业开发者。 专业版1170元/月,最多可添加30个用户(包括业务用户),超过的用户数将额外收取费用(39元/用户/月)。 专享版:使用专享版前,请确认已提交工单申请开通专享版,否则,您将无法购买专享版。专享版提供了物理隔离的运行环境,运行环境实例发放到租户虚拟私有云中。 专享版提供了如下三种规格,供您选择。 500人:48000元/月,最多可添加500用户(包括业务用户)。 2000人:82000元/月,最多可添加2000用户(包括业务用户)。 5000人:128000元/月,最多可添加5000用户(包括业务用户)。 专业版和专享版支持回退到免费版,回退后不支持访问运行环境。 应用正式发布上线前,需要在测试环境上进行测试,AstroZero使用沙箱环境作为测试环境,四种规格套餐均支持购买沙箱。 沙箱1000元/月,沙箱的用户数和主规格一致,应用数不限,数据库容量限额为50M,文件/附件容量限额为500M,单表最大记录数为100万条,API和数据接入调用限制为10万次/天。 表1中的“不限制”,是在系统允许的范围内不进行限制。若想了解更多,请参考AstroZeroLicense。 表1 套餐规格说明 功能特性 免费版 标准版 专业版 专享版 用户数 业务用户数 总数默认最多10个,不支持扩展用户。 总数默认最多30个,支持扩展用户。 总数默认最多30个,支持扩展用户。 500 2000 5000 开发者账号数 扩展用户/新增用户 不支持 9元/用户/月 39元/用户/月 不支持 零代码应用构建 内部分享 支持 支持 支持 支持 公开分享 支持 支持 支持 支持 附件上传 不支持 支持 支持 支持 低代码应用开发 企业应用开发 支持 支持 支持 支持 资产开发 支持 支持 支持 支持 低代码应用数(除了BO和Native Service,其他所有类型的定制应用数) 10 50 不限 不限 物联接入 不支持 不支持 支持 支持 原生服务接入 不支持 不支持 支持 支持 发布移动应用 不支持 不支持 支持 支持 应用运行 运行零代码应用 支持 支持 支持 支持 零代码应用数 100 不限 不限 不限 数据量(租户级) 1万条(不支持扩容) 4000条/用户 4000条/用户(支持单独扩容) 500人:200G 2000人:800G 5000人:2T 运行低代码应用 不支持 不支持 支持 支持 低代码应用数 不支持 不支持 不限 不限 物联接入调用次数(租户级) 不支持 不支持 2500次/用户/天 次数不限制 环境管理 租户子域名 支持 支持 支持 支持 开发环境 支持 支持 支持 支持 商用运行环境 不支持 共享环境(多租户共享运行环境) 共享环境(多租户共享运行环境) 独享运行环境、物理隔离 企业独立域名 不支持 不支持 支持 支持,可独立域名 调测沙箱 不支持 不支持 按需购买沙箱 按需购买沙箱 租户级日志服务 不支持 不支持 支持 支持
  • 下载备案材料模板 各省份的备案材料下载模板如表1所示: 表1 备案材料下载模板 类别 模板下载地址 各省份通用 主体负责人授权书 ICP负责人授权书 不涉及药品及医疗器械承诺书(除特殊省份通用) 不涉及新闻承诺书(除特殊省份通用) 不涉及教育承诺书(除特殊省份通用) 不涉及互联网直播承诺书(除特殊省份通用) 不涉及互联网金融承诺书(除特殊省份通用) 不涉及规定文化类目经营承诺书(除特殊省份通用) ICP备案不涉及前置审批承诺书(除特殊省份通用) 不涉及出版物承诺书(除特殊省份通用) 不涉及保险承诺书(除特殊省份通用) 企业网站建设方案书 北京 北京不涉及金融承诺书 北京不涉及前置审批承诺书(新闻/网约车) 北京注销网站备案申请表 北京不涉及医疗及药品承诺书 北京不涉及校外培训承诺书 北京不涉及文化承诺书 天津 天津注销网站备案申请表 天津网站迁移情况说明 天津不涉及前置审批承诺书(新闻/拍卖) 天津网站不涉及互联网金融的承诺书 天津不涉及医疗器械承诺书 天津不涉及教育承诺书 天津不涉及规定文化类目经营承诺书 天津不涉及前置审批承诺书(广播) 河北 河北不涉及药品及医疗器械承诺书 河北注销网站备案申请表 河北网站不涉及互联网金融承诺书 河北不涉及教育承诺书 河北不涉及规定文化类目经营承诺书. 河北不涉及前置审批承诺书(广播/网约车/出版) 山西 山西不涉及文化承诺书 山西不涉及教育承诺书 山西不涉及医疗器械承诺书 山西不涉及互联网金融承诺书 山西注销网站备案申请表(企业) 山西注销网站备案申请表(个人) 山西不涉及前置审批承诺书(网约车/广播/出版) 内蒙 内蒙古不涉及教育承诺书 内蒙古注销申请表 内蒙古不涉及在线直播教育承诺书 内蒙古不涉及药品及医疗器械承诺书 内蒙古不涉及增值电信业务承诺书(网站) 内蒙古不涉及增值电信业务承诺书(APP) 内蒙古不涉及金融承诺书(网站) 内蒙古不涉及金融承诺书(APP) 内蒙古新增接入承诺书(个人) 内蒙古新增接入承诺书(企业) 上海 上海域名授权书 上海不涉及文化承诺书(网站) 上海不涉及文化承诺书(APP) 上海非经营性互联网信息服务备案ICP负责人授权书模板(2023版) 上海市非经营性互联网信息服务备案承诺书-企业(2023版) 上海市非经营性互联网信息服务备案承诺书-个人(2023版) 江苏 江苏注销网站备案申请表 江苏省注销网站授权书 ICP备案信息真实性责任告知书 ICP备案信息真实性承诺书 浙江 浙江注销网站备案申请表 浙江省不涉及教育承诺书 安徽 安徽注销网站备案申请表 福建 福建不涉及前置审批承诺书 福建不涉及教育承诺书 山东 山东省不涉及互联网金融承诺书(网站) 山东省不涉及互联网金融承诺书(APP) 江西 江西省注销网站备案申请表 江西不涉及前置审批承诺书(出版) 江西不涉及教育承诺书 江西不经营广播节目制作承诺书 江西不涉及药品及医疗器械承诺书 江西不经营金融承诺书 江西不涉及规定文化类目承诺书 广东 广东注销网站备案申请表 广东互联网信息服务备案承诺书(企业) 广东互联网信息服务备案承诺书(个人) 广东省线下培训承诺书 广东省线上培训承诺书 广东省不涉及校外培训承诺书 广西 广西不涉及互联网金融承诺书 广西不涉及药品及医疗器械承诺书 广西不涉及规定文化类目经营的承诺书 广西不涉及前置审批承诺书(广播/新闻/出版) 广西不涉及教育承诺书 广西注销网站备案申请表 海南 海南注销网站备案申请表 河南 河南注销网站备案申请表 河南电子商务承诺书 河南个人网站备案承诺书 河南商贸、百货备案承诺书 河南省不涉及相关审批的承诺书 湖北 湖北注销网站备案申请表 湖北不涉及销售备案承诺书(APP) 湖北不涉及销售备案承诺书(网站) 湖北不开展教育培训承诺书(APP) 湖北不开展教育培训承诺书(网站) 湖北涉及销售备案承诺书(APP) 湖北涉及销售备案承诺书(网站) 湖南 湖南注销网站备案申请表 湖南网站不涉及互联网金融承诺书 湖南个人备案网站建设方案书 湖南不涉及药品及医疗器械承诺书 湖南不涉及教育承诺书 湖南不涉及规定文化类目经营承诺书 湖南不涉及前置审批承诺书(广播电视节目/网约车) 湖南不涉及出版承诺书 湖南不涉及新闻承诺书 陕西 陕西注销网站备案申请表 陕西不涉及药品及医疗器械承诺书 陕西不涉及规定文化类目经营承诺书 陕西不涉及前置审批承诺书(广播电视节目制作/新闻) 陕西不涉及教育承诺书 陕西不涉及金融承诺书 陕西不涉及出版承诺书 陕西不涉及网络预约车承诺书 甘肃 甘肃不涉及药品及医疗器械的情况说明 甘肃不涉及教育说明书 甘肃不涉及前置审批承诺书(新闻/出版/广播电视节目制作) 甘肃不涉及互联网金融说明书 甘肃不涉及规定文化类目经营的承诺书 青海 青海不涉及规定文化类目经营的承诺书 宁夏 宁夏网站情况说明书(备案网站数5个以上) 宁夏个人备案承诺书 宁夏不涉及非法应用人类辅助生殖技术经营活动承诺书(医疗服务、健康咨询、母婴保健) 重庆 重庆注销网站备案申请表 重庆企业备案承诺书 重庆个人备案承诺书 重庆不涉及药品及医疗器械承诺书 四川 四川关于不涉及前置审批承诺书 四川注销网站备案申请表 四川网站名称情况说明(网站名称与单位名称无关联) 四川备案情况说明(域名超过5个以上) 四川不涉及教育承诺书 四川不涉及药品及医疗器械承诺书 四川不涉及动漫游戏开发承诺书 四川不涉及互联网游戏承诺书 四川不涉及游戏开发承诺书 四川不涉及广播电视节目制作承诺书 四川不涉及信息网络试听传播节目承诺书 四川不涉及互联网新闻承诺书 四川不涉及保险代理业务承诺书 四川不涉及出版承诺书 四川不涉及金融承诺书 四川不涉及融资、融资担保承诺书 四川不涉及区块链承诺书 四川不涉及直播承诺书 贵州 贵州注销网站备案申请表 贵州不涉及前置审批的承诺书 黑龙江 黑龙江不涉及前置审批项承诺书(网站) 黑龙江不涉及前置审批项承诺书(APP) 黑龙江网站不涉及金融专项内容承诺书 吉林 吉林注销网站备案申请表 辽宁 辽宁不涉及药品及医疗器械承诺书 辽宁网站不涉及互联网金融承诺书 辽宁不涉及前置审批承诺书(新闻/文化/出版/广播) 辽宁不涉及教育承诺书
  • 服装商品搜索 搜索类型 服装商品搜索目前仅支持CATEGORY一种搜索类型。 CATEGORY: 类目检索。 高级配置 服装商品搜索允许用户对服务实例进行高级配置,以满足业务应用的差异化需求。 商品图像配置 添加图像商品数量: 单张图像允许的最大添加商品数量,默认为1,取值范围为[1, 3]。该配置对有效并发影响较大,需要根据实际情况合理配置。 搜索图像商品数量: 搜索图像返回的最大检测商品数量,默认为3,取值范围为[1, 5]。搜索时会直接使用最显著商品进行搜索,同时返回图像中所有商品用于后续精准搜索。 请求高阶参数 服装商品搜索允许用户在调用API接口时传递高阶参数,以满足业务应用的差异化需求。 CATEGORY 针对类目检索的搜索类型,服务实例具有如下高阶请求参数: 添加数据API do_det: 是否进行目标检测,默认为true。 box: 目标矩形框左边,如给定则不进行目标检测,直接使用该box作为目标。 do_cls: 是否进行对象分类,默认为true。 category: 对象类目,如给定则不进行对象分类,直接使用该category作为类目。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1 } 搜索API do_det: 是否进行目标检测,默认为true。 box: 目标矩形框左边,如给定则不进行目标检测,直接使用该box作为目标。 do_cls: 是否进行对象分类,默认为true。 category: 对象类目,如给定则不进行对象分类,直接使用该category作为类目。 collapse_key: 去重标签名,如给定则会基于其对搜索结果进行去重。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1, "collapse_key": "spu_id" } 响应高阶字段 服装商品搜索的请求响应存在高阶字段,以满足业务应用的潜在感知需求。 CATEGORY 针对类目检索的搜索类型,服务实例具有如下高阶响应字段: 添加数据API image_info: 添加图像数据的相关信息。 { "image_info": { "objects": [ { "box": "135,489,1117,1341", "category": 1, "category_name": "top" } ] } } 搜索API image_info: 搜索图像的相关信息。 { "image_info": { "box": "135,489,1117,1341", "category": 1, "category_name": "top", "objects": [ { "category_name": "top", "box": "135,489,1117,1341", "category": 1 }, { "category_name": "others", "box": "373,99,661,468", "category": 0 } ] } } 商品类目 服装商品搜索支持的商品类目详见表2。 表2 服装商品类目表 类目ID 英文描述 中文描述 0 others 其他商品 1 top 上装 2 bottom 裤子 3 skirt 裙装 4 underwear 内衣
  • 通用商品搜索 搜索类型 通用商品搜索目前仅支持CATEGORY一种搜索类型。 CATEGORY: 类目检索。 高级配置 通用商品搜索允许用户对服务实例进行高级配置,以满足业务应用的差异化需求。 商品图像配置 添加图像商品数量: 单张图像允许的最大添加商品数量,默认为1,取值范围为[1, 3]。该配置对有效并发影响较大,需要根据实际情况合理配置。 搜索图像商品数量: 搜索图像返回的最大检测商品数量,默认为3,取值范围为[1, 5]。搜索时会直接使用最显著商品进行搜索,同时返回图像中所有商品用于后续精准搜索。 请求高阶参数 通用商品搜索允许用户在调用API接口时传递高阶参数,以满足业务应用的差异化需求。 CATEGORY 针对类目检索的搜索类型,服务实例具有如下高阶请求参数: 添加数据API do_det: 是否进行目标检测,默认为true。 box: 目标矩形框左边,如给定则不进行目标检测,直接使用该box作为目标。 do_cls: 是否进行对象分类,默认为true。 category: 对象类目,如给定则不进行对象分类,直接使用该category作为类目。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1 } 搜索API do_det: 是否进行目标检测,默认为true。 box: 目标矩形框左边,如给定则不进行目标检测,直接使用该box作为目标。 do_cls: 是否进行对象分类,默认为true。 category: 对象类目,如给定则不进行对象分类,直接使用该category作为类目。 collapse_key: 去重标签名,如给定则会基于其对搜索结果进行去重。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1, "collapse_key": "spu_id" } 响应高阶字段 通用商品搜索的请求响应存在高阶字段,以满足业务应用的潜在感知需求。 CATEGORY 针对类目检索的搜索类型,服务实例具有如下高阶响应字段: 添加数据API image_info: 添加图像数据的相关信息。 { "image_info": { "objects": [ { "box": "135,489,1117,1341", "category": 1, "category_name": "top" } ] } } 搜索API image_info: 搜索图像的相关信息。 { "image_info": { "box": "135,489,1117,1341", "category": 1, "category_name": "top", "objects": [ { "category_name": "top", "box": "135,489,1117,1341", "category": 1 }, { "category_name": "others", "box": "373,99,661,468", "category": 0 } ] } } 商品类目 通用商品搜索支持的商品类目详见表1。 表1 通用商品类目表 类目ID 英文描述 中文描述 0 others 其他商品 1 top 上装 2 bottom 裤子 3 skirt 裙装 4 underwear 内衣 5 jewelry 珠宝配饰 6 bags 箱包 7 shoes 鞋 8 toy 玩具 9 furniture 家具 10 health_beauty 美容与健康 11 electronics 数码电子产品
  • 通用图像搜索 搜索类型 通用图像搜索目前支持IMAGE/KEYWORD/TEXT三种搜索类型,用户可根据业务需要选择启用一种或多种搜索类型。 IMAGE: 图像检索。 KEYWORD: 关键词检索。 TEXT: 文本检索。 高级配置 通用图像搜索允许用户对服务实例进行高级配置,以满足业务应用的差异化需求。 图像关键词配置 语言类型: 自动生成的关键词语言,可选zh/en,默认zh。 最大数量: 关键词返回数量,默认为50,取值范围为[1, 100]。 置信度阈值: 关键词置信度阈值,默认为20,取值范围为[0, 100]。
  • 系统级约束 服务区域仅支持“华为-北京四”。 请求body使用标准json格式,且大小不超过12M。 默认不保存用户的图像或视频等数据。 实例数量:每个用户默认可创建5个服务实例。如需创建更多服务实例,请联系华为云客服。 接口并发:每个用户的默认搜索接口并发为5QPS。有更高的接口并发需求请联系华为云客服,接口并发调整需要额外收费。 存储规格:创建服务实例的默认存储规格为100万,有其他的存储规格需求请联系华为云客服。默认不支持调整已创建服务实例的存储规格,有特殊需求需要调整,请联系华为云客服。
  • 代码示例 使用代码示例时请根据需要调整刷新类型(type)及需要刷新的URL(urls)。 # -*- coding:utf-8 -*- import json import requests def handler (event, context): header = {"x-auth-token":context.getToken(),'content-type':'application/json;charset=utf-8'} data = { "refresh_task":{ "type":"file", "urls":["https://test.xxx.com/1.txt"] } } url = 'https://cdn.myhuaweicloud.com/v1.0/cdn/content/refresh-tasks' result = requests.post(url=url,headers=header,data=json.dumps(data)) context.getLogger().info(result.text) return { 'statusCode': 200, 'body': result.text, 'isBase64Encoded': False, 'headers': { 'Content-Type': 'application/json' } }
  • 版本更新说明 表1 版本更新说明 版本号 更新说明 1.0.24 支持更多region:华东-上海一、华南-广州。 1.0.23 新增支持快应用上报。 1.0.21 废弃config方法,优先使用new SDK创建一个新的实例。 去除代码中对三方包的依赖和存在的中文符号。 1.0.19 修改时间阈值的范围从1-60改为1-1800,其默认值从30改为3。 1.0.18 调整日志级别等级。 支持labels嵌套。 1.0.15 新增多实例上报。
  • 示例代码 const miniSDK = require('lts-mini-sdk').default; // import miniSDK from 'lts-mini-sdk'; App({ onLaunch(options) { // 初始化 const mymini = new miniSDK({ // 上报region region: string, // 华为云项目ID projectId: string, // 上报地址 url: string, // LTS日志组ID groupId: string, // LTS日志流ID streamId: string, // 调试日志等级 debug: string, // 当前小程序所属平台 platform: 'my', // 上报条数阈值 cacheThreshold: number, // 上报时间阈值 timeInterval: number, }); // 立即上报单条带标签 mymini.reportImmediately({ 'name': 'xiaoming', 'age': 18 }, { 'key': 'value' }); // 立即上报单条 不带标签 mymini.reportImmediately([{ key: 'value', number: 1, array: [], json: { json: 'json' } }, { 'key': 'value' }]); // 缓存上报多条 带标签 mymini.report([{ 'name': 'xiaohong', 'age': 18 }, { 'name': 'xiaobai', 'age': 20 }], { 'key': 'value' }); // 缓存上报多条 不带标签 mymini.report([{ 'name': 'xiaohong', 'age': 18 }, { key: 'value', number: 1, array: [], json: { json: 'json' } }]); // 缓存上报多条 带多个标签(最多50个) mymini.report([{ 'name': 'xiaohong', 'name': 'xiaolan' }], {'version': '1.0.0', 'render': 'mini', 'link': '/', from: 'zhifubao'}); } });
  • 资源统计 图1 资源统计 资源统计主要展示日志资源数据,默认展示时间为1周(相对)的日志资源数据,您可以根据自己的实际需求选择时间范围。 时间范围有三种方式,分别是相对时间、整点时间和自定义。您可以根据自己的实际需求,选择时间范围。 相对时间:表示查询距离当前时间1分钟、5分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31,设置相对时间1小时,表示查询18:20:31~19:20:31的日志数据。 整点时间:表示查询最近整点1分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31,设置整点时间1小时,表示查询18:00:00~19:00:00的日志数据。 自定义:表示查询指定时间范围的日志数据。 统计选择时间范围内的读写流量、索引流量等数据。 显示选择时间范围内的环比值,查看变化趋势。 按照选择时间范围显示流量数据趋势图。趋势图中每个点表示某时间内的数据统计,单位为KB、MB和GB,根据实际情况进行统计。
  • 资源详情 资源详情按照读写流量、索引流量和最新标准存储量三种方式,分别展示其Top100的日志组/日志流,默认按照最新标准存储量的Top100显示,单位为GB。您可根据自己的实际情况,选择读写流量、索引流量或最新标准存储量任一方式,进行Top100的日志组/日志流资源统计。 新创建的日志组/日志流,需间隔至少1小时才能进行资源统计。 单击Top100中的日志组名称,可查询该日志组下的日志流资源统计。 单击按钮,可下载日志组资源统计和日志流资源统计。 下载的日志组资源统计和日志流资源统计文件为.CSV格式。 资源详情可选择时间范围统计。 时间范围有三种方式,分别是相对时间、整点时间和自定义时间。您可以根据自己的实际需求,选择时间范围。 相对时间:表示查询距离当前时间1分钟、5分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31,设置相对时间1小时,表示查询18:20:31~19:20:31的日志数据。 整点时间:表示查询最近整点1分钟、15分钟等时间区间的日志数据。例如当前时间为19:20:31,设置整点时间1小时,表示查询18:00:00~19:00:00的日志数据。 自定义:表示查询指定时间范围的日志数据。 根据选择的时间范围,展示每日标准存储量(GB)、每日索引流量(GB)和每日读写流量(GB)的数据。 有两种展示方式: 表格 柱状图
  • 创建日志组 在云日志服务管理控制台,进入“日志管理”页面,单击“创建日志组”。 在“创建日志组”页面中,参考表1填写日志组相关信息。 表1 日志组参数说明 参数 说明 日志组名称 日志组名称只支持输入英文、数字、中文、中划线、下划线及小数点,且不能以小数点、下划线开头或以小数点结尾。长度为1-64个字符。 日志采集后,将发送到对应的日志组中的日志流,如果日志较多,需要分门别类,建议您给日志组做好命名,方便后续快速查找日志。 企业项目 选择业务需要的企业项目,也可单击“查看企业项目”,在企业项目管理页面查看全部企业项目。 日志存储时间(天) 日志组的存储时间。 说明: 目前白名单用户的日志存储时间支持1095天,如有需要,请提工单申请。详细操作请参考提交工单。 创建日志组免费,使用阶段按照日志量收费,详细请参考价格计算器。 标签 按照业务需求对不同的日志组添加对应的标签。单击添加标签,分别填写标签键key和标签值value,开启应用到日志流。 说明: 如需添加多个标签可重复该步骤。 如需删除标签可单击标签操作列的。 标签键长度不能超过128个字符;标签值长度不能超过255个字符。 标签键名称不可重复。 如果配置转储时使用了该标签,删除标签后,请同步修改转储配置信息。 备注 自定义填写备注信息,字符长度0-1024个字符。 单击“确定”,日志组创建成功,即可在日志组列表下方生成一条日志组信息。 在日志组列表中,可以查看日志组名称、标签、日志流数量等信息。 单击日志组名称,可跳转到日志流详情页面。 并发创建时,可能会偶现创建个数超过限制。
  • 示例代码 const miniSDK = require('lts-mini-sdk/quick-app').default; // import miniSDK from 'lts-mini-sdk/quick-app'; App({ onLaunch(options) { // 初始化 const quickAppSdk = new miniSDK({ // 上报region region: string, // 华为云项目ID projectId: string, // 上报地址 url: string, // LTS日志组ID groupId: string, // LTS日志流ID streamId: string, // 日志所属组 group: string, // 调试日志等级 debug: string, // 当前小程序所属平台 platform: string, // 上报条数阈值 cacheThreshold: number, // 上报时间阈值 timeInterval: number, }); // 立即上报单条带标签 quickAppSdk.reportImmediately({ 'name': 'xiaoming', 'age': 18 }, { 'key': 'value' }); // 立即上报单条 不带标签 quickAppSdk.reportImmediately([{ key: 'value', number: 1, array: [], json: { json: 'json' } }, { 'key': 'value' }]); // 缓存上报多条 带标签 quickAppSdk.report([{ 'name': 'xiaohong', 'age': 18 }, { 'name': 'xiaobai', 'age': 20 }], { 'key': 'value }); // 缓存上报多条 不带标签 quickAppSdk.report([{ 'name': 'xiaohong', 'age': 18 }, { key: 'value', number: 1, array: [], json: { json: 'json' } }]); // 缓存上报多条 带多个标签(最多50个) quickAppSdk.report([{ 'name': 'xiaohong', 'name': 'xiaolan' }], {'version': '1.0.0', 'render': 'mini', 'link': '/', from: 'baidu'}); } });
  • 版本更新说明 表1 版本更新说明 版本号 更新说明 1.0.24 支持更多region:华东-上海一、华南-广州。 1.0.23 新增支持快应用上报。 1.0.21 废弃config方法,优先使用new SDK创建一个新的实例。 去除代码中对三方包的依赖和存在的中文符号。 1.0.19 修改时间阈值的范围从1-60改为1-1800,其默认值从30改为3。 1.0.18 调整日志级别等级。 支持labels嵌套。 1.0.15 新增多实例上报。
  • 示例流程 图1 给用户授权LTS 权限流程 登录统一身份认证服务IAM控制台。在IAM控制台创建用户组,并授予云日志服务操作权限“LTS FullAccess”。详细操作请参考创建用户组并授权 图2 授权成功后 选择“LTS FullAccess”,由于该策略有依赖,除了勾选LTS FullAccess外,还需要在同项目中勾选依赖的策略:Tenant Guest、以及“全局区域 对象存储服务项目”中勾选依赖的策略:Tenant Administrator。 在IAM控制台创建用户,并将其加入步骤1中创建的用户组。详细操作请参考创建用户并加入用户组 图3 添加用户到用户组 使用新创建的用户登录控制台,切换至授权区域,验证权限。详细操作请参考用户登录并验证权限。 图4 登录成功后进入云日服务控制台
  • 版本更新说明 表1 版本更新说明 版本号 更新说明 1.0.24 支持更多region:华东-上海一、华南-广州。 1.0.23 新增支持快应用上报。 1.0.21 废弃config方法,优先使用new SDK创建一个新的实例。 去除代码中对三方包的依赖和存在的中文符号。 1.0.19 修改时间阈值的范围从1-60改为1-1800,其默认值从30改为3。 1.0.18 调整日志级别等级。 支持labels嵌套。 1.0.15 新增多实例上报。
  • 示例代码 const miniSDK = require('lts-mini-sdk').default; // import miniSDK from 'lts-mini-sdk'; App({ onLaunch(options) { // 初始化 const ddmini = new miniSDK({ // 上报region region: string, // 华为云项目ID projectId: string, // 上报地址 url: string, // LTS日志组ID groupId: string, // LTS日志流ID streamId: string, // 调试日志等级 debug: string, // 当前小程序所属平台 platform: 'dd', // 上报条数阈值 cacheThreshold: number, // 上报时间阈值 timeInterval: number, }); // 立即上报单条带标签 ddmini.reportImmediately({ 'name': 'xiaoming', 'age': 18 }, { 'key': 'value' }); // 立即上报单条 不带标签 ddmini.reportImmediately([{ key: 'value', number: 1, array: [], json: { json: 'json' } }, { 'key': 'value' }]); // 缓存上报多条 带标签 ddmini.report([{ 'name': 'xiaohong', 'age': 18 }, { 'name': 'xiaobai', 'age': 20 }], { 'key': 'value' }); // 缓存上报多条 不带标签 ddmini.report([{ 'name': 'xiaohong', 'age': 18 }, { key: 'value', number: 1, array: [], json: { json: 'json' } }]); // 缓存上报多条 带多个标签(最多50个) ddmini.report([{ 'name': 'xiaohong', 'name': 'xiaolan' }], {'version': '1.0.0', 'render': 'mini', 'link': '/', from: 'dd'}); } });
  • 创建快速分析 可通过日志结构化打开“快速分析”按钮进行创建。也可通过如下步骤进行创建。 登录云日志服务控制台,在左侧导航栏中选择“日志管理”。 快速分析以日志流为单位,请在“日志管理”页面选择目标日志组和日志流。 支持两种方式创建快速分析: 单击进入设置详情页面,在索引配置页签的字段索引下方,添加字段时开启快速分析。 在云端结构化解析页签,开启自动配置索引和快速分析,默认是开启状态。开启后将使用结构化字段配置字段索引并打开快速分析。 在“原始日志”页签,单击“创建快速分析”,跳转到索引配置页面添加需要快速分析的字段。 单击“确定”,快速分析创建完成。 图1 查看快速分析 表示String类型字段。 表示float类型字段。 表示long类型字段。 快速分析的字段长度最大为2000字节。 快速分析字段展示前100条数据。 单击即可查看一键生成的图表展示,string类型的字段支持展示字段分布值统计和智能聚合时间折线图,long和float数值类型的字段只支持展示智能聚合时间折线图。单击图表即可进入详情页面。 图2 string类型展示的图形 图3 long和float数值类型展示的图形 单击字段分布值统计或智能聚合时间折线图,会自动跳转到可视化界面并生成对应的SQL查询语句进行查询,更加直观地展示字段值的分布和变化趋势。更多信息请参见可视化。
  • 示例代码 const miniSDK = require('lts-mini-sdk').default; // import miniSDK from 'lts-mini-sdk'; App({ onLaunch(options) { // 初始化 const baidumini = new miniSDK({ // 上报region region: string, // 华为云项目ID projectId: string, // 上报地址 url: string, // LTS日志组ID groupId: string, // LTS日志流ID streamId: string, // 日志所属组 group: string, // 调试日志等级 debug: string, // 当前小程序所属平台 platform: string, // 上报条数阈值 cacheThreshold: number, // 上报时间阈值 timeInterval: number, }); // 立即上报单条带标签 baidumini.reportImmediately({ 'name': 'xiaoming', 'age': 18 }, { 'key': 'value' }); // 立即上报单条 不带标签 baidumini.reportImmediately([{ key: 'value', number: 1, array: [], json: { json: 'json' } }, { 'key': 'value' }]); // 缓存上报多条 带标签 baidumini.report([{ 'name': 'xiaohong', 'age': 18 }, { 'name': 'xiaobai', 'age': 20 }], { 'key': 'value }); // 缓存上报多条 不带标签 baidumini.report([{ 'name': 'xiaohong', 'age': 18 }, { key: 'value', number: 1, array: [], json: { json: 'json' } }]); // 缓存上报多条 带多个标签(最多50个) baidumini.report([{ 'name': 'xiaohong', 'name': 'xiaolan' }], {'version': '1.0.0', 'render': 'mini', 'link': '/', from: 'baidu'}); } });
  • 版本更新说明 表1 版本更新说明 版本号 更新说明 1.0.24 支持更多region:华东-上海一、华南-广州。 1.0.23 新增支持快应用上报。 1.0.21 废弃config方法,优先使用new SDK创建一个新的实例。 去除代码中对三方包的依赖和存在的中文符号。 1.0.19 修改时间阈值的范围从1-60改为1-1800,其默认值从30改为3。 1.0.18 调整日志级别等级。 支持labels嵌套。 1.0.15 新增多实例上报。
  • 删除日志流 如果日志流不再需要使用,可以删除日志流,日志流删除后,日志流中的日志数据将被同时删除。日志流删除后无法恢复,请谨慎操作。 删除日志流前请确认该日志流下没有配置日志采集任务,否则删除后可能影响正常的日志上报。 如果日志流绑定了日志转储任务,删除日志流之前,需要先删除该日志流关联的日志转储任务。 在日志流列表中,单击待删除日志流所在行的。 在弹出框中输入“DELETE”后,单击“确定”,完成日志流删除。 图3 删除日志流
  • 创建日志流 在云日志服务管理控制台,单击日志组名称对应的按钮。 单击“创建日志流”,在创建日志流页面,参考表1填写日志流相关信息。 表1 日志流参数说明 参数 说明 日志组名称 默认显示目标日志组名称。 日志流名称 日志流名称只支持输入英文、数字、中文、中划线、下划线及小数点,且不能以小数点、下划线开头或以小数点结尾。长度为1-64个字符。 日志采集后,以日志流为单位,将多条日志数据发往云日志服务。如果日志较多,需要分门别类,建议您创建多个日志流,并给日志流做好命名,方便后续快速查找日志。 企业项目 选择业务需要的企业项目,默认为default。也可单击“查看企业项目”,在企业项目管理页面查看全部企业项目。 日志存储 开启日志存储:日志将会被存入搜索引擎,能使用日志全量功能。 关闭日志存储:日志不会落盘存储,可节约索引流量和存储费用,只能使用日志生成指标、转储功能,不能使用日志搜索分析、告警、消费加工等其他功能。 说明: 若关闭日志存储,则无法开启日志存储时间。 目前此功能仅支持白名单用户提交工单申请使用。详细操作请参考提交工单。 日志存储时间(天) 日志流的存储时间。 关闭开关: 使用日志组的日志存储时间。 打开开关: 使用日志流的日志存储时间。 智能冷存储 开启日志存储时间后,根据业务需要设置智能冷存储功能,详细请参考智能冷存储。 说明: 开启智能冷存储需要日志存储时间大于7天。 匿名写入 匿名写入默认关闭,适用于安卓/IOS/小程序/浏览器端上报日志,打开匿名写入则表示该日志流打开匿名写入权限,不会经过有效鉴权,可能产生脏数据。关于SDK使用请参考SDK接入。 标签 按照业务需求对不同的日志流添加对应的标签,单击添加标签,分别填写标签键key和标签值value。 说明: 如需添加多个标签可重复该步骤。 如需删除标签可单击标签操作列的。 标签键长度不能超过128个字符;标签值长度不能超过255个字符。 标签键名称不可重复。 如果配置转储时使用了该标签,删除标签后,请同步修改转储配置信息。 备注 自定义填写备注信息,字符长度0-1024个字符。 单击“确定”,完成日志流的创建。在日志流列表中,可以查看日志流名称、操作等信息。 支持查看日志流计费状态,日志计费请参考价格计算器。 按日志流维度上报话单功能目前在友好用户内测中,您可以提交工单申请开通。
共100000条