云服务器内容精选

  • URI POST /v1/{project_id}/kg/kg-instances/{kg_id}/apps/entity-linking 表1 路径参数 参数 是否必选 参数类型 描述 kg_id 是 String 知识图谱ID。在KG服务控制台“我的图谱”页面,单击图谱名称,进入图谱详情页左上角获取知识图谱ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID。
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 entities Array of EntityLinkingRespEntityMention objects 实体链接结果。 表4 EntityLinkingRespEntityMention 参数 参数类型 描述 entity_id String 链接到的图谱节点对应的实体id。 entity_title String 链接到的图谱节点对应的实体名称。 mention String 实体名称。 offset Integer 实体文本在待分析文本中的起始位置。
  • 请求示例 分析识别文本为 "李娜唱的青藏高原真好听"的实体 https://nlp-ext.cn-north-4.myhuaweicloud.com/v1/1604d8170cd84440a81281e5a3a04f8b/kg/kg-instances/6cdcea01-bac0-48f6-acb5-9385ea3e24ad/apps/entity-linking { "text" : "李娜唱的青藏高原真好听" }
  • 响应示例 状态码: 200 OK { "entities" : [ { "mention" : "李娜", "offset" : 0, "entity_id" : "6939670486880563336", "entity_title" : "李娜(流行歌手、佛门女弟子)" }, { "mention" : "青藏高原", "offset" : 4, "entity_id" : "8654144631589645401", "entity_title" : "青藏高原(李娜演唱歌曲)" } ] } 状态码: 400 Bad Request { "error_code" : "KGP.2007", "error_msg" : "kg not found" } 状态码: 403 Forbidden { "error_code" : "KGP.0004", "error_msg" : "Auth failed" }
  • 基本概念 账号 用户注册华为云时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用他们进行日常管理工作。 用户 由账号在IAM中创建的用户,是云服务的使用人员,具有身份凭证(密码和访问密钥)。 在我的凭证下,您可以查看账号ID和用户ID。通常在调用API的鉴权过程中,您需要用到账号、用户和密码等信息。 区域 指云资源所在的物理位置,同一区域内可用区间内网互通,不同区域间内网不互通。通过在不同地区创建云资源,可以将应用程序设计的更接近特定客户的要求,或满足不同地区的法律或其他要求。 可用区 一个可用区是一个或多个物理数据中心的集合,有独立的风火水电,AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连,以满足用户跨AZ构建高可用性系统的需求。 项目 华为云的区域默认对应一个项目,这个项目由系统预置,用来隔离物理区域间的资源(计算资源、存储资源和网络资源),以默认项目为单位进行授权,用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制,可以在区域默认的项目中创建子项目,并在子项目中购买资源,然后以子项目为单位进行授权,使得用户仅能访问特定子项目中资源,使得资源的权限控制更加精确。 图1 项目隔离模型 同样在我的凭证下,您可以查看项目ID。 企业项目 企业项目是项目的升级版,针对企业不同项目间资源的分组和管理,是逻辑隔离。企业项目中可以包含多个区域的资源,且项目中的资源可以迁入迁出。 关于企业项目ID的获取及企业项目特性的详细信息,请参见《企业管理服务用户指南》。 父主题: 使用前必读
  • 请求示例 进行KBQA会话,询问小明的身高 https://nlp-ext.cn-north-4.myhuaweicloud.com/v1/1604d8170cd84440a81281e5a3a04f8b/kg/kg-instances/6cdcea01-bac0-48f6-acb5-9385ea3e24ad/apps/kbqa/converse { "session_id" : "b22ce1e7-72e6-4846-86e5-65f66a882989", "query" : "小明的身高" }
  • URI POST /v1/{project_id}/kg/kg-instances/{kg_id}/apps/kbqa/converse 表1 路径参数 参数 是否必选 参数类型 描述 kg_id 是 String 知识图谱ID。在KG服务控制台“我的图谱”页面,单击图谱名称,进入图谱详情页左上角获取知识图谱ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID。
  • 响应示例 状态码: 200 OK { "answer" : "小明的身高是175cm。", "session_id" : "b22ce1e7-72e6-4846-86e5-65f66a882989", "frame" : [ { "formatted_question" : "[小明]的[身高]", "match_type" : "SYS_TEMPLATE", "template_id" : "77396e46-6eec-49bb-bb84-84faa4229090", "template_name" : "xx实体的xx属性", "template_score" : 1.0, "query" : "g.V('6155801785020056890').valueMap('name', '身高').path()", "result" : { "vertices" : [ { "id" : "6155801785020056890", "label" : "人物" } ], "runtime" : 0.007594787999999999, "results" : [ { "name" : [ "小明" ], "身高" : [ "175cm" ] } ] }, "answer" : "小明的身高是175cm。" } ] } 状态码: 400 Bad Request { "error_code" : "KGP.2007", "error_msg" : "kg not found" } 状态码: 403 Forbidden { "error_code" : "KGP.0004", "error_msg" : "Auth failed" }
  • 响应示例 状态码: 200 OK { "data" : { "vertices" : [ { "id" : "9070097808196707553", "label" : "电影", "properties" : { "上映时间" : [ "1958年1月16日" ], "name" : [ "保卫和平" ], "票房" : [ "39.04亿" ] } } ], "runtime" : 0.02850004 } } 状态码: 400 Bad Request { "error_code" : "KGP.2003", "error_msg" : "Gremlin query return error" } 状态码: 403 Forbidden { "error_code" : "KGP.0004", "error_msg" : "Auth failed" } 状态码: 500 Internal Server Error { "error_code" : "KGP.9001", "error_msg" : "Internal server error." }
  • 响应示例 状态码: 200 OK { "entity" : { "id" : "8039469283414000536", "label" : "人物", "properties" : { "职业" : [ "演员,歌手" ], "出生日期" : [ "1980年12月13日" ], "name" : [ "计广" ], "国籍" : [ "中国" ] } }, "results" : [ { "direction" : "IN", "adjacent_entity_id" : "8886811463068384992", "edge" : { "source_id" : "8886811463068384992", "target_id" : "8039469283414000536", "relation_label" : "主演", "properties" : null } }, { "direction" : "IN", "adjacent_entity_id" : "7146030181767445493", "edge" : { "source_id" : "7146030181767445493", "target_id" : "8039469283414000536", "relation_label" : "主演", "properties" : null } } ], "total" : 20, "count" : 2 }
  • 请求示例 查询关联实体,最多返回两条结果 https://nlp-ext.cn-north-4.myhuaweicloud.com/v1/1604d8170cd84440a81281e5a3a04f8b/kg/kg-instances/6cdcea01-bac0-48f6-acb5-9385ea3e24ad/entities/8039469283414000536/adjacent-entities?offset=0&limit=2
  • URI GET /v1/{project_id}/kg/kg-instances/{kg_id}/entities/{entity_id}/adjacent-entities 表1 路径参数 参数 是否必选 参数类型 描述 entity_id 是 String 实体ID。 kg_id 是 String 知识图谱ID。在KG服务控制台“我的图谱”页面,单击图谱名称,进入图谱详情页左上角获取知识图谱ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 label 否 String 具有一跳关系的实体类型。默认为空,即查询有一跳关系的所有类型的实体。 说明: N跳关系说明:如果从一个实体A出发,经过N条关系(不论方向),能够到达实体B,则实体A、B之间是N跳关系。 特别地,如果两个实体之间是一跳关系,说明两个实体之间通过一条关系直接相连。 limit 否 Integer 最大返回结果条数,默认为10,最大为100。 最小值:0 最大值:100 缺省值:10 offset 否 Integer 翻页偏移量,默认为0。 最小值:0 最大值:100 缺省值:0 relation_name 否 String 需要查询的关系名称。默认为空,即查询所有一跳关系。
  • URI POST /v1/{project_id}/kg/kg-instances/{kg_id}/entities/property-query 表1 路径参数 参数 是否必选 参数类型 描述 kg_id 是 String 知识图谱ID。在KG服务控制台“我的图谱”页面,单击图谱名称,进入图谱详情页左上角获取知识图谱ID。 project_id 是 String 用户项目ID。获取方法请参见获取项目ID。
  • 响应示例 状态码: 200 OK { "count" : 1, "entities" : [ { "id" : "-8886811463068384992", "label" : "电影", "properties" : { "上映时间" : [ "1982年4月22日" ], "name" : [ "一条牧羊犬" ], "票房" : [ "34.72亿" ] } } ] }
  • 请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 labels 否 Array of strings 实体类型列表。 offset 否 Integer 翻页偏移量,默认为0。 limit 否 Integer 最大返回结果条数,默认为10,最大为100。 conditions 是 conditions object 过滤查询条件。 condition_type 否 String 筛选条件之间的逻辑关系。 缺省值:and 枚举值: and or 表3 conditions 参数 是否必选 参数类型 描述 property_name 否 String 属性名称。 property_value 否 Array of strings 属性值,目前只支持设置一个属性值。