华为云用户手册

操作步骤 登录商标注册控制台。 选择左侧目录中“申请人信息模板”。 单击右上角“创建申请人信息模板”。 在创建申请人信息模板中，您可以命名创建的模板名称，便于使用。 图1 添加申请人信息模板 申请人选择“个人”，根据需求选择“个人类型”并填写相关参数，具体填写要求可参考表1。 图2 个人申请人信息填写 表1 申请主体材料及填写要求 填写项 企业或社会团体资质 个人/个体工商户资质 申请人资质 选择企业 选择个人 国家/地区 根据所在地区选择，默认为中国大陆。 个人类型 - 个人名称 个体工商户名称 身份证/护照正反面 不涉及 身份证正反面复印在同一面A4纸上。 复印件空白位置需签署申请人姓名和提交日期。 复印件手写的复印日期至商标注册订单日期之间不得大于1年。 身份证需在有效期内，且距离有效期结束不得低于6个月。 证件号码 不涉及 输入身份证/护照证件号码 营业执照/个体工商户营业执照副本复印件 企业请在复印件空白处加盖公司公章。 上传最新企业营业执照原件正本或副本复印件，执照状态不能是撤销、吊销、注销等。 除中国香港企业证件有效期需大于3个月。其他地域企业证件有效期需大于6个月。 企业营业执照经营范围不可涉及商标代理、知识产权代理、知识产权服务等内容。 个人名称请在复印件空白位置签署申请人姓名及申请日期，申请人身份证姓名与签署申请人姓名需保持一致。 个体工商户请在复印件空白位置加盖公章，无需签字。 个体工商户营业执照需在有效期内，不能是撤销、吊销、注销等。 统一社会信用代码 请填写与营业执照上一致的统一社会信用代码。 企业名称或申请人名称 请填写与营业执照上一致的企业全称。 个人名称请填写申请人身份证件上的姓名。 个体工商户请填写与营业执照上一致的名称。 企业地址或申请人地址 请填写与营业执照上一致的营业地址。 个人名称请填写申请人身份证件上的地址或中国内地（大陆）任意范围内地址。 个体工商户请填写与营业执照上一致的营业地址。 统一社会信用代码 请填写与营业执照上一致的统一社会信用代码。 请填写与营业执照一致的统一社会信用代码。 委托书模板复用法律声明 企业请在文件右下角加盖申请人公章。 个人名称请在文件右下角签署申请人姓名。 个体工商户请在文件右下角位置加盖公章，无需签字。 申请人地址请严格按照营业执照地址填写，申请人地址不需要再填写省级单位（含直辖市、自治区）。 商标注册信息填写带为必填项，不带为选填项。 填写“证件号码”，上传身份证正反面复印件。 图3 上传身份证正反面复印件 证件号码：请输入身份证证件号码，务必保持一致。 图4 身份证正反面复印件 身份证正反面复印在同一面A4纸上。 复印件空白位置需签署申请人姓名和提交日期。 复印件手写的复印日期至商标注册订单日期之间不得大于1年。 身份证需在有效期内，且距离有效期结束不得低于6个月。 填写“统一社会信用代码”，根据个人类型上传营业执照副本复印件。 图5 上传营业执照副本复印件 统一社会信用代码：请填写营业执照上登记的社会信用代码，务必保持一致。 图6 个人提交营业执照副本复印件示例 图7 个体工商户提交营业执照副本复印件示例 个人请在复印件空白位置签署申请人姓名及申请日期，申请人身份证姓名与签署申请人姓名需保持一致。 个体工商户请在复印件空白位置加盖公章，无需签字。 个体工商户营业执照需在有效期内，不能是撤销、吊销、注销等。 上传委托书及服用声明文件。 图8 上传委托书文件 下载委托书及复用声明文件。 在委托书及复用声明文件签署申请人姓名，无需盖章。 拍照并上传委托书文件。 图9 《商标代理委托书》 上传商标代理委托书复用声明。 图10 《商标代理委托书复用声明》 委托书及委托书模板复用法律声明请在文件右下角签署申请人姓名，无需盖章。 填写订单联系人信息。 图11 订单联系人信息 单击“提交”即可。

操作步骤 提交需求 登录商标控制台需求管理页面，单击右上角“免费提交需求”按钮。 选择需求类型为“无忧注册”。 图1 选择需求类型 填写商标注册申请需求、手机号码及验证码，单击“提交需求”即可。 图2 提交需求 沟通并制定方案 商标注册需求提交后，华为云会安排专业顾问与您进行联系： 在工作日期间上午9点-12点，下午14点-18点内提交商标申请咨询单，专业顾问会在一个小时内与您联系。 在非工作日时间内提交商标申请咨询单，专业顾问会在下一个工作日与您取得联系。 确认方案并支付 专业顾问为您填写完商标注册申请订单后，该订单会发送至您的华为云账号。您可登录华为云 商标服务 控制台，在需求管理页面查看订单信息并进行支付。如您对当前方案不满意，您可联系专业顾问重新制定商标注册申请方案。 图3 需求管理界面 图4 支付订单 商标注册申请审核 商标注册进度详情您可前往“商标注册控制台-顾问/无忧列表”页面，单击订单号进入订单详情页面，在“操作日志”中查看。 图5 顾问/无忧列表 图6 操作日志 商标订单支付成功后，您的商标注册申请订单将进入华为云初审。 初审通过后华为云会将您的商标注册申请订单递交至商标局。 商标局将对您提交的商标注册申请进行形式审查和实质审查。 如审查通过，商标局将对商标注册申请进行初步审定公告，详情请参见商标局商标公告。 如审查不通过，您的商标注册申请将被驳回至华为云，商标局将核发商标驳回通知书。如您对商标驳回通知书中注明的驳回原因存在异议，可申请商标驳回复审。 使用商标无忧注册服务当商标申请被商标局全部驳回时，华为云会退还该商标申请的费用。 商标申请成功 商标注册申请公告结束且无人异议后，商标局会核发电子《商标注册证书》，您可前往“商标注册控制台-顾问/无忧列表”页面，单击订单号进入订单详情页面，在“操作日志”中下载。

约束与限制 使用商标无忧注册服务当商标申请被商标局全部驳回时，您可向华为云申请退还该商标申请的费用。 商标注册申请存在被驳回风险，建议您在注册商标之前先进商标检索并了解商标审核相关规定。避免与已注册成功的商标、商标法、商标局审查规则产生冲突，商标检索详情请参见商标检索。 华为云商标检索的数据及结果仅供参考，不具备法律效力，不作为商标注册成功与否的依据。商标检索结果请参考商标网的查询结果。 营业执照经营范围含有商标代理、知识产权服务，商标申请仅支持申请类别为第45类4506组商标。如需申请注册其他类商标，请先变更营业执照经营范围。 华为云商标注册服务目前仅支持普通商标注册申请服务，暂不支持证明商标、集体商标、肖像商标、声音商标和立体商标申请服务。

商标图样上传要求 表2 商标类型及示例 商标类型 商标说明 正确示例 文字商标 商标仅由文字构成，或以文字为主体的艺术化设计但能够分辨为文字的商标。 商标名称：根据商标构成的文字进行命名。 图2 中文商标 商标名称：华为云 图3 英文商标 商标名称：HUAWEI 图形商标 商标仅由图形构成，不存在文字、数字及字母或以文字为主体的艺术化设计但能够分辨为文字的构成元素。 商标名称：无需填写。 图4 俄语（汉字、英文以外的其他文字）。 图5 特殊字符 文字图形组合商标 商标由文字、数字、字母及图形等构成。 商标名称：按照直观可以识别的文字及图的规则命名。 图6 英文与图形组合 商标名称：HUAWEI 图7 中文与日文组合 商标名称：华为云 图8 中文、英文与图形组合 商标名称：华为云HUAWEI 图9 英文与特殊字符组合 商标名称：huaweicloudcom

申请主体材料及填写要求 由于申请人资质不同所需材料不同，申请人信息填写要求和申请主体材料具体要求请参见表3。 表3 申请主体材料及填写要求 填写项 企业或社会团体资质 个人/个体工商户资质 申请人资质 选择企业 选择个人 国家/地区 根据所在地区选择，默认为中国大陆。 个人类型 - 个人名称 个体工商户名称 身份证/护照正反面 不涉及 身份证正反面复印在同一面A4纸上。 复印件空白位置需签署申请人姓名和提交日期。 复印件手写的复印日期至商标注册订单日期之间不得大于1年。 身份证需在有效期内，且距离有效期结束不得低于6个月。 证件号码 不涉及 输入身份证/护照证件号码 营业执照/个体工商户营业执照副本复印件 企业请在复印件空白处加盖公司公章。 上传最新企业营业执照原件正本或副本复印件，执照状态不能是撤销、吊销、注销等。 除中国香港企业证件有效期需大于3个月。其他地域企业证件有效期需大于6个月。 企业营业执照经营范围不可涉及商标代理、知识产权代理、知识产权服务等内容。 个人名称请在复印件空白位置签署申请人姓名及申请日期，申请人身份证姓名与签署申请人姓名需保持一致。 个体工商户请在复印件空白位置加盖公章，无需签字。 个体工商户营业执照需在有效期内，不能是撤销、吊销、注销等。 统一社会信用代码 请填写与营业执照上一致的统一社会信用代码。 企业名称或申请人名称 请填写与营业执照上一致的企业全称。 个人名称请填写申请人身份证件上的姓名。 个体工商户请填写与营业执照上一致的名称。 企业地址或申请人地址 请填写与营业执照上一致的营业地址。 个人名称请填写申请人身份证件上的地址或中国内地（大陆）任意范围内地址。 个体工商户请填写与营业执照上一致的营业地址。 统一社会信用代码 请填写与营业执照上一致的统一社会信用代码。 请填写与营业执照一致的统一社会信用代码。 委托书模板复用法律声明 企业请在文件右下角加盖申请人公章。 个人名称请在文件右下角签署申请人姓名。 个体工商户请在文件右下角位置加盖公章，无需签字。 若申请人地址修改后委托书文件需重新下载并上传。 若申请商标注册初次填写申请人信息，系统将为您自动保存申请人信息，申请人信息可重复使用；若申请商标注册之前已添加申请人信息模板，可直接选择使用已有模板。 申请材料可上传手动拍摄的照片或扫描件图片，页面上下请勿留空，内容需清晰可见。 请确保上传委托书模板公章清晰完整，纸面工整顺平，不能有褶皱、反光等。

商标智能注册信息填写要求 图1 填写商标信息 表1 商标信息填写项说明 填写项 填写项说明 商标类型 文字商标：仅用文字构成的商标。 图形商标：仅用图形构成的商标。 文字图形组合商标：商标由文字、数字、字母及图形构成。 商标名称 只能使用简体中文、英文或阿拉伯数字，不支持其他字符。 商标名称请使用通用规范汉字，请勿使用繁体字、异体字。 商标含有文字不应过多，文字过多易造成商标显著性不强而被驳回。 商标说明 只能使用简体中文、英文或阿拉伯数字，不支持其他字符。例：商标由中文“***”、英文“***”及图形构成，无特殊含义。 文字商标：该商标由“商标名称”构成。 图形商标：无需填写商标名称。 文字图形组合商标：该商标由“商标名称”及图形构成。 商标图样 自动生成：自动生成图样字体为“黑体”。如果您有设计要求，可自行上传定稿图样。 手动上传： 商标图样应为200KB以内的JPG格式图片，分辨率为400*400-1500*1500。 注册着色商标，注册后只能按照上传图样的颜色进行使用。 注册黑白商标，注册后不限颜色使用，可以根据需求任意更换商标颜色。华为云建议使用黑白图样申请商标。 注意： 请确保商标图样内容清晰可见，无冗余图形或文字。

操作步骤 登录商标注册控制台。 单击左侧“智能注册列表”，选择右上角“商标注册”。 图1 商标注册控制台页面 根据界面提示，填写商标信息，具体材料要求请参见表1。 图2 填写商标信息 表1 商标信息填写项说明 填写项 填写项说明 商标类型 文字商标：仅用文字构成的商标。 图形商标：仅用图形构成的商标。 文字图形组合商标：商标由文字、数字、字母及图形构成。 商标名称 只能使用简体中文、英文或阿拉伯数字，不支持其他字符。 商标名称请使用通用规范汉字，请勿使用繁体字、异体字。 商标含有文字不应过多，文字过多易造成商标显著性不强而被驳回。 商标说明 只能使用简体中文、英文或阿拉伯数字，不支持其他字符。例：商标由中文“***”、英文“***”及图形构成，无特殊含义。 文字商标：该商标由“商标名称”构成。 图形商标：无需填写商标名称。 文字图形组合商标：该商标由“商标名称”及图形构成。 商标图样 自动生成：自动生成图样字体为“黑体”。如果您有设计要求，可自行上传定稿图样。 手动上传： 商标图样应为200KB以内的JPG格式图片，分辨率为400*400-1500*1500。 注册着色商标，注册后只能按照上传图样的颜色进行使用。 注册黑白商标，注册后不限颜色使用，可以根据需求任意更换商标颜色。华为云建议使用黑白图样申请商标。 注意： 请确保商标图样内容清晰可见，无冗余图形或文字。 选择商标类别和类别包含的项。 图3 选择商标类别 单击右下角“下一步：申请主体”。 图4 填写商标信息 填写申请人信息，选择申请人资质或使用已有模板，具体填写要求可参考表2。 图5 选择申请人资质 表2 申请主体材料及填写要求 填写项 企业或社会团体资质 个人/个体工商户资质 申请人资质 选择企业 选择个人 国家/地区 根据所在地区选择，默认为中国大陆。 个人类型 - 个人名称 个体工商户名称 身份证/护照正反面 不涉及 身份证正反面复印在同一面A4纸上。 复印件空白位置需签署申请人姓名和提交日期。 复印件手写的复印日期至商标注册订单日期之间不得大于1年。 身份证需在有效期内，且距离有效期结束不得低于6个月。 证件号码 不涉及 输入身份证/护照证件号码 营业执照/个体工商户营业执照副本复印件 企业请在复印件空白处加盖公司公章。 上传最新企业营业执照原件正本或副本复印件，执照状态不能是撤销、吊销、注销等。 除中国香港企业证件有效期需大于3个月。其他地域企业证件有效期需大于6个月。 企业营业执照经营范围不可涉及商标代理、知识产权代理、知识产权服务等内容。 个人名称请在复印件空白位置签署申请人姓名及申请日期，申请人身份证姓名与签署申请人姓名需保持一致。 个体工商户请在复印件空白位置加盖公章，无需签字。 个体工商户营业执照需在有效期内，不能是撤销、吊销、注销等。 统一社会信用代码 请填写与营业执照上一致的统一社会信用代码。 企业名称或申请人名称 请填写与营业执照上一致的企业全称。 个人名称请填写申请人身份证件上的姓名。 个体工商户请填写与营业执照上一致的名称。 企业地址或申请人地址 请填写与营业执照上一致的营业地址。 个人名称请填写申请人身份证件上的地址或中国内地（大陆）任意范围内地址。 个体工商户请填写与营业执照上一致的营业地址。 统一社会信用代码 请填写与营业执照上一致的统一社会信用代码。 请填写与营业执照一致的统一社会信用代码。 委托书模板复用法律声明 企业请在文件右下角加盖申请人公章。 个人名称请在文件右下角签署申请人姓名。 个体工商户请在文件右下角位置加盖公章，无需签字。 企业地址或申请人地址请严格按照营业执照地址填写，不需要再填写省级单位（含直辖市、自治区）。 若申请商标注册初次填写申请人信息，系统将为您自动保存申请人信息，申请人信息可重复使用；若申请商标注册之前已添加申请人信息模板，可直接选择使用已有模板。 若申请人地址修改后委托书文件需重新下载并上传。 请确保上传委托书模板公章清晰完整，纸面工整顺平，不能有褶皱、反光等。 填写订单联系人信息，单击右下角“下一步：确认订单”。 图6 填写订单联系人信息 进入订单页面，查看商标注册信息。 勾选用户协议，单击右下角“去支付”。 图7 确认订单 在支付订单界面，确认无误后，单击“确认付款”。 图8 确认付款 您可在“费用中心-订单管理-我的订单”中查看购买信息。

修订记录 发布日期 修订记录 2023-05-24 第四次正式发布。 更新 商标智能注册操作指导 商标顾问注册操作指导 商标无忧注册操作指导 商标续展注册操作指导 2023-04-20 第三次正式发布。 新增 商标续展注册操作指导 2023-03-01 第二次正式发布。 新增 商标顾问注册操作指导 商标无忧注册操作指导 更新 商标注册材料要求 添加个人申请人信息模板 2022-08-02 第一次正式发布。

注意事项 商标智能注册产品下单后，如果服务商初审材料未完成，支持退订，其余状态均无法退订。 商标智能注册产品下单后，如果服务商初审材料已完成，当且仅当商标局下发《商标注册申请不予受理通知书》时，支持退订，其余状态均无法退订。 当商标智能注册提交订单时长超过28天时，不再支持修改材料，请您在订单被驳回后及时修改并提交材料，避免超期后无法修改；订单时长超过37天时系统将自动退订订单。 商标注册申请存在被驳回风险，建议您在注册商标之前先进商标检索并了解商标审核相关规定。避免与已注册成功的商标、商标法、商标局审查规则产生冲突，商标检索详情请参见商标检索。 华为云商标检索的数据及结果仅供参考，不具备法律效力，不作为商标注册成功与否的依据。商标检索结果请参考商标网的查询结果。 营业执照经营范围含有商标代理、知识产权服务，商标申请仅支持申请类别为第45类4506组商标。如需申请注册其他类商标，请先变更营业执照经营范围。 华为云商标注册服务目前仅支持普通商标注册申请服务，暂不支持证明商标、集体商标、肖像商标、声音商标和立体商标申请服务。

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

状态码 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端，它的部分请求已经被服务器接收，且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如，切换到HTTPS的新版本协议。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 203 Non-Authoritative Information 非授权信息，请求成功。 204 NoContent 请求完全成功，同时HTTP响应不包含响应体。 在响应OPTIONS方法的HTTP请求时返回此状态码。 205 Reset Content 重置内容，服务器处理成功。 206 Partial Content 服务器成功处理了部分GET请求。 300 Multiple Choices 多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择。 301 Moved Permanently 永久移动，请求的资源已被永久的移动到新的URI，返回信息会包括新的URI。 302 Found 资源被临时移动。 303 See Other 查看其它地址。 使用GET和POST请求查看。 304 Not Modified 所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。 305 Use Proxy 所请求的资源必须通过代理访问。 306 Unused 已经被废弃的HTTP状态码。 400 BadRequest 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 402 Payment Required 保留请求。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Time-out 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 410 Gone 客户端请求的资源已经不存在。 返回该状态码，表明请求的资源已被永久删除。 411 Length Required 服务器无法处理客户端发送的不带Content-Length的请求信息。 412 Precondition Failed 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 413 Request Entity Too Large 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息。 414 Request-URI Too Large 请求的URI过长（URI通常为网址），服务器无法处理。 415 Unsupported Media Type 服务器无法处理请求附带的媒体格式。 416 Requested range not satisfiable 客户端请求的范围无效。 417 Expectation Failed 服务器无法满足Expect的请求头信息。 422 UnprocessableEntity 请求格式正确，但是由于含有语义错误，无法响应。 429 TooManyRequests 表明请求超出了客户端访问频率的限制或者服务端接收到多于它能处理的请求。建议客户端读取相应的Retry-After首部，然后等待该首部指出的时间后再重试。 500 InternalServerError 表明服务端能被请求访问到，但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 ServiceUnavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 ServerTimeout 请求在给定的时间内无法完成。客户端仅在为请求指定超时（Timeout）参数时会得到该响应。 505 HTTP Version not supported 服务器不支持请求的HTTP协议的版本，无法完成处理。 父主题： 附录

概述 图像搜索 （ Image Search ）基于深度学习与图像识别技术，结合不同应用业务和行业场景，利用特征向量化与搜索能力，帮助您从指定图库中搜索相同或相似的图片。 图像搜索服务以开放API（Application Programming Interface，应用程序编程接口）的方式提供给用户，用户通过实时访问和调用API获取图像搜索结果，帮助用户在图像库中进行相同或相似图像搜索。 您可以使用本文档提供图像搜索服务API的描述、语法、参数说明及样例等内容，进行相关操作，例如图像搜索包含的创建实例、搜索图片和删除图片等具体接口使用说明。支持的全部操作请参见API概览。 在调用图像搜索API之前，请确保已经充分了解图像搜索相关概念，详细信息请参见产品介绍。 父主题： 使用前必读

API概览 图像搜索服务所提供的API为自研API。通过使用图像搜索服务的自研API，您可以完整的使用图像搜索服务的如下所有功能。 API说明章节中请求示例均采用Token方式请求消息头，在实际使用过程中可根据情况选择认证方式。 请求样例中的Token值以实际申请服务时所获取的Token值为准。 endpoint、projectId以实际申请的服务所在区域为准。 API 说明 创建实例 创建实例，实例中会生成图片索引库，用来存放图片特征。 添加图片 将图片导入图片索引库，该图片可以是同一区域OBS桶内的图片或请求消息体里的图片，只有导入图片索引库的图片方可被搜索到。 搜索图片 从图片索引库中搜索相似图片。 查询图片 通过图片路径查询索引库中对应图片是否存在。 删除图片 通过图片路径删除索引库中对应图片。 修改图片信息 修改图像索引库中已存在的图片信息。 删除实例 删除已存在的实例。 查询用户实例信息 查看用户指定实例的详细信息。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见 获取Token 接口，响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 path 是 String 图片URL路径，作为图片库中索引图片的ID。 tags 是 Object 自定义标签，格式为key:value对，其中： 标签名（key值）须存在于实例中； 标签内容（value值）为自定义标签值。

请求示例 输入图片路径，设置自定义标签，修改图像索引库中已存在的图片信息。 PUT https://{endpoint}/v1/{project_id}/{instance_name}/image{ "path" : "https://bucketName.obs.myhuaweicloud.com/image/test1.jpg", "tags" : { "test-tags" : "test-image" }}

终端节点 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 图像搜索的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 图像搜索的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京四 cn-north-4 imagesearch.cn-north-4.myhuaweicloud.com 华北-北京一 cn-north-1 imagesearch.cn-north-1.myhuaweicloud.com 父主题： 使用前必读

响应示例 状态码： 200 成功响应示例 { "count" : 2, "result" : [ { "path" : "https://BucketName.obs.myhuaweicloud.com/CBL025106G/CBL025106G_2.JPG", "sim" : 0.51263, "tags" : { "test-tags" : "test-image" } } ]} 状态码： 400 失败响应示例 { "error_code" : "IS.0003", "error_msg" : "Arguments of path can not be null."}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 file 否 String 图片文件Base64编码字符串，仅支持JPEG/JPG/PNG/BMP格式，图片最小边不小于100px，最大边不超过2048px。该参数与path二选一，如果两个参数都存在，则以file为主。 path 否 String 图片的URL路径，图片库中的图片索引ID。该参数与file二选一，如果两个参数都存在，则以file为主。 limit 否 Integer 返回被检索图像的数量，取值为1~100的整数，默认为10。 最小值：1 最大值：100 缺省值：10 offset 否 Integer 偏移量，指定搜索结果返回起始位置，取值为大于或等于0的整数，默认为0。 最小值：0 tags 否 Object 图片自定义标签，最多不超过10个，格式为key：value对。 标签名（key）添加方式： 登录管理控制台，单击“创建实例”，自定义标签名。 登录管理控制台，在“实例管理”页签，单击实例名称，进入“基础信息”页添加自定义标签。 使用图片标签搜索时该参数必选。 is_crop 否 Boolean 是否用图片中指定区域（参数box）进行搜索。该参数目前仅对某些特定模型有效，其他模型暂不支持目标检测。 取值为true或false。 true：用图片中指定区域（参数box）进行搜索。 false：用全图进行搜索。 默认为false。 box 否 SearchBoxDetail object 图片中指定的区域。 表4 SearchBoxDetail 参数 是否必选 参数类型 描述 x 否 Integer 区域中x坐标的最小值，单位：像素。 y 否 Integer 区域中y坐标的最小值，单位：像素。 width 否 Integer 区域的宽度，单位：像素。 height 否 Integer 区域的高度，单位：像素。

请求示例 方式一：使用图片的BASE64编码，从图片索引库中搜索相似图片，返回被检索图像的数量为10。 POST https://{endpoint}/v1/{project_id}/{instance_name}/image/search{ "limit" : 10, "offset" : 0, "file" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAA..."} 方式二：使用图片的url，从图片索引库中搜索相似图片，返回被检索图像的数量为10。 POST https://{endpoint}/v1/{project_id}/{instance_name}/image/search{ "limit" : 10, "offset" : 0, "path" : "https://BucketName.obs.myhuaweicloud.com/image/test1.jpg"} 方式三：使用标签，从图片索引库中搜索相似图片，返回被检索图像的数量为10 POST https://{endpoint}/v1/{project_id}/{instance_name}/image/search{ "limit" : 10, "offset" : 0, "tags" : { "test-tags" : "test-image" }} 方式四：使用图片的BASE64编码和标签，从图片索引库中搜索相似图片，返回被检索图像的数量为10。 POST https://{endpoint}/v1/{project_id}/{instance_name}/image/search{ "limit" : 10, "offset" : 0, "file" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAA...", "tags" : { "test-tags" : "test-image" }} 方式五：使用图片URL和标签，从图片索引库中搜索相似图片，返回被检索图像的数量为10。 POST https://{endpoint}/v1/{project_id}/{instance_name}/image/search{ "limit" : 10, "offset" : 0, "path" : "https://BucketName.obs.myhuaweicloud.com/image/test1.jpg", "tags" : { "test-tags" : "test-image" }} 方式六：使用指定区域进行搜索，从图片索引库中搜索相似图片，返回被检索图像的数量为10。 POST https://{endpoint}/v1/{project_id}/{instance_name}/image/search{ "limit" : 10, "offset" : 0, "path" : "https://BucketName.obs.myhuaweicloud.com/image/test1.jpg", "box" : { "x" : 100, "y" : 200, "height" : 50, "width" : 20 }}

响应参数 状态码： 200 表5 响应Body参数 参数 参数类型 描述 count Integer 搜索结果总数。 result Array of SearchPictureItem objects 搜索结果详情。 表6 SearchPictureItem 参数 参数类型 描述 path String 被搜索图片的路径。 sim Float 查询图片和被搜索图片的相似度，值越接近1表示越相似。 tags Object 自定义的标签名称和标签内容。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 exist String 调用成功时表示调用结果。 调用失败时无此字段。取值为“true”或者“false”，默认为“false”。 “true”表示图像索引库中存在查询的图片。 “false”表示图像索引库中不存在查询的图片。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

请求示例 通过图片路径查询索引库中对应图片，图片URL路径为https://bucketName.obs.myhuaweicloud.com/image/test1.jpg。 POST https://{endpoint}/v1/{project_id}/{instance_name}/image/check{ "path" : "https://bucketName.obs.myhuaweicloud.com/image/test1.jpg"}

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 表3 请求Body参数 参数 是否必选 参数类型 描述 file 否 String 图片文件Base64编码字符串，仅支持JPEG/JPG/PNG/BMP格式，图片最小边不小于100px，最大边不超过2048px。 path 是 String 图片的URL路径，作为图片库中索引图片的ID，是必选参数。 说明： 当file字段不为空时，图片从file获取，path作为图片索引ID使用；当file字段不存在或者为空时，图片需要通过下载获取，此时path作为下载图片的地址（当前仅支持从华为云图像搜索服务所在区域的OBS下载图片），同时，path也作为图片索引ID。 tags 否 Object 图片自定义标签。格式为key：value对，所有图片的key总数最多不超过10个，但是每个key对应的value不限制个数，例如：key为动物，对应的value可以是猫、狗、鸟等多个。 标签名（key）添加方式： 登录管理控制台，单击“创建实例”自定义标签名。 在“实例管理”页签，单击实例名称，进入“基础信息”页添加自定义标签。

请求示例 方式一：使用图片的BASE64编码，将图片导入图片索引库，图片的URL路径为/../image.jpg。 POST https://{endpoint}/v1/{project_id}/{instance_name}/image{ "path" : "/../image.jpg", "file" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAA..."} 方式二：使用图片的url，将图片导入图片索引库，图片的URL路径为https://bucketName.obs.myhuaweicloud.com/image/test1.jpg。 POST https://{endpoint}/v1/{project_id}/{instance_name}/image{ "path" : "https://bucketName.obs.myhuaweicloud.com/image/test1.jpg"} 方式三：使用图片的BASE64编码和标签，将图片导入图片索引库，图片的URL路径为https://bucketName.obs.myhuaweicloud.com/image/test1.jpg。 POST https://{endpoint}/v1/{project_id}/{instance_name}/image{ "path" : "https://bucketName.obs.myhuaweicloud.com/image/test1.jpg", "file" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAA...", "tags" : { "test-tags" : "test-image" }} 方式四：使用图片的url和标签，将图片导入图片索引库，图片的URL路径为https://bucketName.obs.myhuaweicloud.com/image/test1.jpg。 POST https://{endpoint}/v1/{project_id}/{instance_name}/image{ "path" : "https://bucketName.obs.myhuaweicloud.com/image/test1.jpg", "tags" : { "test-tags" : "test-image" }}

错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便我们尽快帮您解决问题。 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 表1 错误码 状态码 错误码 错误信息 描述 处理措施 400 IS.0001 The request parameter is missing or empty. 缺少请求参数或者参数为空。 检查请求参数是否合法。 400 IS.0002 The type of the request parameter is not supported. 请求参数类型不支持。 检查请求参数是否合法。 400 IS.0003 The request parameter cannot be empty. 请求参数不能为空。 检查请求参数是否合法。 400 IS.0004 Exception verifying token. 验证Token异常。 检查Token是否为最新获取。 400 IS.0005 The header is missing or empty. 缺少Header或者Header为空。 检查Header是否正确。 400 IS.0006 The request body is too big. 请求体大小超过限制。 请求体应限制在合理范围内。 400 IS.0007 Invalid instance name. 无效的实例名称。 检查实例名称是否正确。 400 IS.0008 The JSON format of the input data is incorrect. 输入数据JSON格式错误。 检查输入JSON格式是否合法。 400 IS.0009 The request failed due to an internal error. 服务内部错误导致请求失败。 根据服务返回错误信息定位问题。 400 IS.0010 The request method is not allowed. 请求方法不允许。 检查请求方法是否合理。 400 IS.0011 The user is not allowed to use the request method. 请求方法不允许此用户使用。 更换用户或添加权限。 400 IS.0012 Operation timed out. 操作超时。 检查服务是否正常运行。 400 IS.0013 The token is empty. Token为空。 填写正确的Token。 400 IS.0014 Instance status is abnormal. 实例状态异常。 检查实例是否异常。 400 IS.0015 The model file does not exist. 模型文件不存在。 检查模型文件是否存在。 400 IS.0016 The path is invalid. 路径不合法。 检查路径是否合法。 400 IS.0017 The request is not authorized. 请求未授权。 申请授权。 400 IS.0018 The OBT is not applied for. 未申请公测。 申请公测。 400 IS.0019 The user service ID does not match the project ID. 用户服务ID与项目ID不匹配。 输入匹配的ID。 400 IS.0020 The value cannot be obtained. 禁止获取。 检查是否在黑名单中，若在黑名单中，需要先删除。 400 IS.0021 The token has expired. Token已过期。 获取最新的Token。 400 IS.0022 The current user has restricted rights. 当前用户权限被限制。 检查账户余额或联系管理员。 400 IS.1001 The service does not exist. 服务不存在。 检查服务名是否正确。 400 IS.1002 No tag value. 无标签值。 查看输入图片中是否带有标签信息。 400 IS.1003 Too many tags. 标签数量超出大小限制。 标签数量应限制在合理范围内。 400 IS.1004 The tag does not match. 标签不匹配。 输入正确的tag名称。 400 IS.1005 Failed to add the image. 添加图片失败。 检查请求参数是否合法。 400 IS.1006 Failed to delete the image. 删除图片失败。 检查请求参数是否合法。 400 IS.1007 Failed to update the image. 更新图片失败。 检查请求参数是否合法。 400 IS.1008 Failed to search for the image. 搜索图片失败。 检查请求参数是否合法。 400 IS.1009 Failed to query the image. 查询图片失败。 检查请求参数是否合法。 400 IS.1010 The value of limit is incorrect. 参数limit不合理。 参数limit要求为正整数，要求为大于0。 400 IS.1011 The value of offset is incorrect. 参数offset不合理。 参数offset要求为大于等于0的整数。 400 IS.1015 Too many images in the instance. 实例图片数量超过规格。 联系华为云客服，扩大实例规格。 400 IS.1016 Failed to detect the image. 检测图片失败。 检查行业类型是否支持。 400 IS.2000 Failed to download the image. 图片下载失败。 检查图片路径是否存在。 400 IS.2001 The image format is not supported. 图片格式不支持。 更换图片格式，仅支持JPEG/JPG/PNG/BMP格式。 400 IS.2002 The image file has been damaged. 图片文件已损坏。 检查图像文件是否完整。 400 IS.2003 The OBS object cannot be obtained. 无法获取OBS对象。 检查OBS访问是否正常，若正常，检查对象是否存在。 400 IS.2004 The OBS bucket does not exist. OBS桶不存在。 检查OBS桶，是否存在。 400 IS.2005 Failed to save the temporary file. 临时文件保存失败。 查看图像搜索服务是否正常。 400 IS.2006 The image is not indexed. 图片未被索引。 查看图像搜索服务是否正常。 400 IS.2007 Base64 decoding of the input data is incorrect. 输入数据BASE64解码错误。 检查输入数据是否正确。 400 IS.2008 The request parameters must contain path information. 请求参数中需要有路径信息。 在请求参数中添加路径信息。 400 IS.2009 The request parameters must contain tag information. 请求参数中需要有tag信息。 在请求参数中添加tag信息。 400 IS.2010 The request parameter does not exist. 请求参数不存在。 检查请求参数是否完整。 400 IS.2011 OBS is not authorized to obtain images. 无OBS获取图片权限。 检查OBS是否授权。 400 IS.2012 The image path cannot be empty. 图像路径不能为空。 请求参数中需要包含path字段。 400 IS.2013 The path and file in the request parameter cannot be empty at the same time. 请求参数中path和file不能同时为空。 请求参数中path和file不能同时为空。 400 IS.2014 Failed to create the cache file path. 缓存文件路径创建失败。 重新请求。 400 IS.2015 The request parameter must contain path or file. 请求参数中必须包含path或file。 请求参数中必须包含path或file。 400 IS.2016 Failed to create the OBS client. 创建OBS客户端失败。 检查OBS桶是否授权。 400 IS.2019 The instance does not exist. 实例不存在。 检查是否存在。 400 IS.2100 Failed to add the image. 图片添加失败。 查看图像搜索服务是否正常。 400 IS.2101 Failed to delete the image. 图片删除失败。 查看图像搜索服务是否正常。 400 IS.2102 Failed to search for the image. 图片搜索失败。 查看图像搜索服务是否正常。 400 IS.2103 Failed to check the image. 图片检查失败。 查看图像搜索服务是否正常。 400 IS.2104 Failed to update the image information. 更新图片信息失败。 检查更新请求是否正确。 400 IS.2105 The service is not running properly. 服务未正常运行。 重启服务或联系管理员。 400 IS.2106 The image is too big. 图像尺寸超过最大限制。 图像尺寸最大不超过2048*2048。 400 IS.2107 The image is too small. 图像尺寸未达到最小限制。 图像尺寸不能小于100*100。 400 IS.2108 An error occurred while the service is running. 服务运行过程中发生错误。 检查调用接口方法是否正确。 400 IS.2109 Failed to connect to the gallery. 连接图片库失败。 检查实例是否正常。 400 IS.2111 Failed to perform image detection. 图片检测过程失败。 检查行业类型参数是否支持。 400 IS.2112 The request parameter must contain image. 请求参数中必须包含image。 检查请求参数image是否存在。 400 IS.3000 The service name already exists. 服务名称已存在。 服务已存在。 400 IS.3001 Failed to save the service information. 服务信息保存失败。 查看图像搜索服务是否正常。 400 IS.3002 Failed to delete services from some nodes. 部分节点删除服务失败。 查看图像搜索服务是否正常。 400 IS.3003 Failed to delete the instance from the node. 节点删除实例失败。 查看图像搜索服务是否正常。 400 IS.3004 The model cannot be used. 模型不允许使用。 检查模型名称，路径是否正确。 400 IS.3005 The service name does not exist. 服务名称不存在。 服务名错误或服务未创建。 400 IS.3006 The model is in use. 模型已被用户使用。 模型已使用，无需重新添加模型。 400 IS.3007 The user does not exist. 用户不存在。 确定用户名是否正确。 400 IS.3008 Failed to start the instance. 启动实例失败。 查看图像搜索服务是否正常。 400 IS.3009 Decompressing failed. 解压失败。 查看图像搜索服务是否正常。 400 IS.3010 Failed to start the service. 启动服务失败。 查看图像搜索服务是否正常。 400 IS.3011 Failed to initialize the configuration file. 初始化配置文件失败。 查看图像搜索服务是否正常。 400 IS.3012 No management instance is found. 未发现管理实例。 查看图像搜索服务是否正常。 400 IS.3013 Failed to obtain the instance. 无法获取实例。 查看图像搜索服务是否正常。 400 IS.3014 The model name does not exist. 模型名称不存在。 检查模型名称是否正确。 400 IS.3015 Failed to obtain the OBS bucket. 获取OBS桶失败。 检查OBS桶名是否正确。 400 IS.3016 Failed to authorize the OBS bucket. OBS桶授权失败。 检查OBS服务是否正常。 400 IS.3017 The OBS bucket is empty. OBS桶为空。 OBS桶中无内容。 400 IS.3018 Failed to obtain the OBS bucket list. 获取OBS桶列表失败。 检查OBS操作是否正确。 400 IS.3019 Failed to add the OBS bucket. 添加OBS桶失败。 检查OBS操作是否正确。 400 IS.3020 Failed to obtain the bucket listening event. 获取桶监听事件失败。 检查OBS操作是否正确。 400 IS.3021 No instance is found. 未发现实例。 检查实例是否存在。 400 IS.3022 Failed to change the instance name. 修改实例名称失败。 检查请求是否正确。 400 IS.3023 The instance tag does not exist. 实例标签不存在。 检查是否创建实例标签。 400 IS.3024 Too many instance tags. 实例标签超过最大数量限制。 实例标签数量不能超过10个。 400 IS.3025 The instance tag cannot be deleted. 实例标签无法删除。 暂不支持删除实例标签功能。 400 IS.3026 Failed to add the instance tag. 添加实例标签失败。 检查添加请求是否正确。 400 IS.3027 Failed to upload the model to OBS. 向OBS上传模型失败。 检查OBS服务是否正常。 400 IS.3028 Failed to create the instance. 创建实例失败。 检查创建请求是否正确。 400 IS.3029 Failed to obtain the instance model. 获取实例模型失败。 检查实例模型是否存在。 400 IS.3030 The instance cannot be deleted because it is being created. 实例创建中，无法删除。 实例创建过程中无法执行删除操作。 400 IS.3031 Failed to obtain the statistics. 获取统计信息失败。 检查请求是否正确，检查服务是否正常。 400 IS.3032 The instance is being deleted. 实例正在删除。 实例删除中，不能重复执行删除操作。 400 IS.3033 Failed to obtain the batch import task. 获取批量导入任务失败。 检查批导数据是否存在。 400 IS.3034 The blacklist or whitelist is invalid. 无效的黑白名单。 检查黑白名单。 400 IS.3035 The instance scale does not exist. 不包含对应的实例规格。 检查实例规格是否正确。 400 IS.3036 The user instance description is too long. 用户实例描述信息过长。 描述字符数量不能超过512个。 400 IS.3037 A bucket event exists in the instance. 实例存在桶事件。 实例不能存在多个桶事件。 400 IS.3038 An offline import task is running on the instance. The instance cannot be deleted. 实例有脱机导入任务，现在无法删除。 等待脱机导入任务结束后删除。 400 IS.3039 Failed to reset the instance scale. 实例重置规格失败。 检查服务状态并重试。 400 IS.3040 Failed to reset the instance to a smaller scale. 重置实例规格小于原有规格。 重置规格需要大于原有规格。 400 IS.3041 Failed to obtain the instance scale. 获取实例规格失败。 检查服务状态，重新获取。 400 IS.3050 Failed to obtain the OBS bucket folder list. 获取OBS桶文件夹列表失败。 该OBS桶名下不存在文件夹列表。 400 IS.3051 The bucket name in the path does not match the name of the selected OBS bucket. 该路径中的桶名和选择的OBS桶名不一致。 检查路径中包含的桶名与选择的桶名是否一致。 400 IS.3052 The path does not contain the file directory or list in the bucket. 该路径中未包含桶内文件目录或列表。 检查输入路径是否正确。 400 IS.3053 The file list or directory in the path does not exist. 该路径中的文件列表或目录不存在。 检查输入路径是否正确。 400 IS.4000 Failed to download the system package. 下载系统包失败。 查看图像搜索服务是否正常。 400 IS.4001 The OBS bucket is empty. OBS桶为空。 OBS桶为空。 400 IS.4002 The service cannot be initialized. 无法初始化服务。 查看图像搜索服务是否正常。 400 IS.4003 Failed to obtain the search result. 无法获取搜索结果。 查看图像搜索服务是否正常。 400 IS.4004 The instance name does not exist. 实例名不存在。 检查实例名是否存在。 400 IS.4005 Failed to create the offline import task. 创建离线导入任务失败。 重新启动离线导入任务。 400 IS.4006 The account is frozen. 账号被冻结。 检查账号是否欠费，若欠费，充值后系统自动解冻。 400 APIG.0101 The API does not exist or has not been published. 您所访问的API不存在或尚未在环境中发布。 请检查输入的api信息是否正确，是否该服务存在在对应的区域中。检查API的URL是否拼写正确，HTTP请求方法（POST，GET等）是否正确，请检查服务调用配置的域名和uri信息是否正确，域名可参考域名。 400 APIG.0301 1. Incorrect IAM authentication information: Failed to decrypt the token. Check whether the entered token is complete. 2. The validity period of a token is 24 hours. If the token expires, obtain a new token and pass it. 3. The AK/SK authentication fails. Check whether the AK/SK is correct and whether the account is restricted due to arrears. 1.IAM身份验证信息不正确：解密令牌失败，检查输入的token是否完整。 2.token有效期为24小时，token超时，重新传入获取token值。 3.因为AK/SK认证失败，请检查AK/SK是否正确，账号是否因欠费等原因权限被限制。 decrypt token fail：发送的HTTP请求header中x-auth-token的token请求认证信息错误，请检查发送的请求和token。 token expires：token超时，请重新获取新token传入。 verify aksk signature fail：请检查AK、SK是否正确，账号是否欠费。 400 APIG.0201 The request body is oversized. 请求体过大。 请检查请求的body体是否过大，具体请参见《图像搜索使用限制》，进行调整。 400 APIG.0308 The request is sent too fast and exceeds the default rate limit of the service. 请求发送太快，超过了服务的默认配置限流。 请求发送太快，达到了API的限速阈值，请降低请求速度。如有更高请求速度要求，请联系华为云支持人员，通过工单联系我们。 400 ModelArts.0203 Invalid token. 非法Token。 请检查Token是否正确。 400 ModelArts.4101 The token is empty. Token为空。 发送的HTTP请求header中没有带x-auth-token的token请求认证信息，请检查发送的请求。 400 ModelArts.4102 Failed to parse the token. 解析Token失败。 发送的HTTP请求header中x-auth-token的token请求认证信息错误，请检查发送的请求和token。 400 ModelArts.4103 The token is invalid. Token不合法。 发送的HTTP请求header中x-auth-token的token请求认证信息错误，请检查发送的请求和token。 400 ModelArts.4104 The length of the request body is invalid. 请求body体长度不合法。 请检查请求body体长度。 400 ModelArts.4105 The JSON format of the request body is incorrect. 请求body体json格式不对。 请检查请求body体是否符合json格式。 400 ModelArts.4106 The account is restricted. 用户账号受限。 请检查用户资源状态，账号受限原因请参考账号中心相关描述账号中心相关描述。 400 ModelArts.4107 An exception occurred when obtaining the temporary AK/SK. 获取用户临时AK，SK异常。 请联系华为云支持人员，通过工单联系我们。 400 ModelArts.4201 The request URL does not contain the service ID. 请求url中需要包含服务ID。 请检查请求url中的服务ID。 400 ModelArts.4202 The request URL format is invalid. 请求url格式不合法。 请检查请求url格式。 400 ModelArts.4203 No access permission. 没有权限访问。 请检查访问权限。 400 ModelArts.4204 The API is not subscribed to. 没有订阅该API。 请订阅该API，订阅API请参考服务介绍开通申请服务。如已开通服务，请检查开通服务的区域与服务调用的一致，若一致请检查API的URL是否拼写正确，HTTP请求方法（POST，GET等）是否正确。 400 ModelArts.4601 The external URL is invalid. 外网下载地址不合法。 请检查输入的url下载地址参数格式。 400 ModelArts.4603 The file failed to be downloaded from the external URL. 下载外网URL文件失败。 请检查输入的url是否可下载。 400 ModelArts.4702 The OBS agency failed to be queried. 查询OBS委托失败。 请检查是否已开通给服务的OBS委托。 400 ModelArts.4703 The OBS URL is invalid. OBS地址不合法。 请检查输入的OBS的url地址。 400 ModelArts.4704 Failed to obtain the OBS file. 获取OBS文件失败。 下载OBS文件失败，请检查对应的文件是否存在。 400 ModelArts.4705 The OBS file is oversized. OBS文件大小超限。 请使用符合服务大小限制的文件作为输入，具体请参见《图像搜索使用限制》。 400 ModelArts.4706 The OBS file does not exist. OBS文件不存在。 下载OBS文件失败，请检查对应的文件是否存在。 400 其他 如若出现其他无法解决的错误码，请通过工单联系我们。 父主题： 附录

响应示例 状态码： 200 成功响应示例 { "instanceName" : "test-instance", "level" : 30000000, "expiredDate" : 1530848365207, "domain" : "model description", "desc" : "register service for instance test.", "registerDate" : 1529377136279, "tags" : [ "tag1", "tag2" ], "status" : "NORMAL"} 状态码： 400 失败响应示例 { "error_code" : "IS.0004", "error_msg" : "The authentication token is abnormal."}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 domain String 模型展示名或领域名称。 desc String 描述。 registerDate Long 注册时间。 expiredDate Long 过期时间，-1表示永不过期。 level Integer 规格，即实例的图片数量规格，默认为30000000（单位：张）。 tags Array of strings 图片自定义标签。 status String 实例的状态，有以下状态信息： NORMAL：正常。 ARREARAGE：欠费。 CREATION：创建中。 CREATION_FAILD：创建失败。 DELETING：删除中。 DELETING_FAILED：删除失败。 ABNORMAL：异常。 instanceName String 实例名称。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

LakeFormation自定义策略样例 示例1：授权用户批量LakeFormation只读权限 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "lakeformation:instance:describe", "lakeformation:role:describe", "lakeformation:policy:export", "lakeformation:group:describe", "lakeformation:function:describe", "lakeformation:catalog:describe", "lakeformation:policy:describe", "lakeformation:table:describe", "lakeformation:database:describe" ] } ]} 示例2：拒绝用户删除数据 拒绝策略需要同时配合其他策略使用，否则没有实际作用。用户被授予的策略中，一个授权项的作用如果同时存在Allow和Deny，则遵循Deny优先原则。 如果您给用户授予Admin的系统策略，但不希望用户拥有删除LakeFormation的Catalog、数据库、表的权限，您可以创建一条拒绝删除云服务的自定义策略，然后同时将Admin和拒绝策略授予用户，根据Deny优先原则，则用户可以对LakeFormation执行除了删除Catalog、数据库、表外的所有操作。 拒绝策略示例如下： { "Version": "1.1", "Statement": [ { "Effect": "Deny", "Action": [ "lakeformation:database:drop", "lakeformation:table:drop", "lakeformation:catalog:drop" ] } ]} 示例3：多个云服务同时授权项策略 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "obs:bucket:CreateBucket" ] }, { "Effect": "Allow", "Action": [ "lakeformation:table:create", "lakeformation:database:create", "lakeformation:catalog:create" ] } ]}

支持审计日志的操作 表1 云审计 服务支持的LakeFormation服务操作 操作名称 资源类型 事件名称 创建Catalog Catalog createCatalog 删除Catalog Catalog dropCatalog 修改Catalog Catalog alterCatalog 创建数据库 Database createDatabase 删除数据库 Database dropDatabase 修改数据库 Database alterDatabase 创建数据表 Table createTable 删除数据表 Table dropTable 修改数据表 Table alterTable 清空表的数据 Table truncateTable 创建函数 Function createFunction 修改函数属性 Function alterFunction 删除函数 Function dropFunction 创建实例 instance createInstance 修改实例 instance updateInstance 删除实例 instance deleteInstance 授予权限 Access grantAccess 取消授权 Access revokeAccess 更新表的指定列统计信息 TableColumnStatistic setTableColumnStatistics 删除表的指定列统计信息 TableColumnStatistic deleteTableColumnStatistics 批量创建表的列限制条件 TableConstraint addConstraints 删除列限制条件 TableConstraint deleteConstraints 批量添加分区信息 Partition addPartitions 批量修改分区信息 Partition alterPartitions 批量删除分区信息 Partition dropPartitions 批量清空列表信息 Partition truncatePartitions 批量设置分区的统计信息 PartitionColumnStatistic setPartitionColumnStatistics 删除分区列的统计信息 PartitionColumnStatistic deletePartitionColumnStatistics

响应示例 状态码： 200 OK { "total" : 1, "device_id" : "D2102412469WLL3000011", "channel_id" : "CLL3000011", "records" : [ { "record_id" : "1000000", "start_time" : "2020-06-12 17:31:00", "end_time" : "2020-06-13 12:50:00", "record_name" : "录像1", "record_size" : 1024, "record_type" : "NORMAL_RECORD" } ]}