文档首页/图引擎服务 GES/API参考/历史API/管理面API（V1）/图管理API/查询图详情(1.0.0)
更新时间：2025-06-05 GMT+08:00
查看PDF
分享

查询图详情(1.0.0)

功能介绍

根据图ID查询某个图详情。

URI

GET /v1.0/{project_id}/graphs/{graph_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。获取方法请参见获取项目ID。

graph_id

是

String

图ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

graph

graph_1 object

请求失败时为空。

errorMessage

String

系统提示信息。

  • 执行成功时，字段可能为空。
  • 执行失败时，用于显示错误信息。

errorCode

String

系统提示信息。

  • 执行成功时，字段可能为空。
  • 执行失败时，用于显示错误码。
表4 graph_1

参数

参数类型

描述

id

String

图ID。

name

String

图名称。

createdBy

String

IAM用户名。

isMultiAz

String

是否支持跨AZ高可用。

regionCode

String

域编码。

azCode

String

可用区编码。

schemaPath

Array of schemaPath_1 objects

元数据文件路径。

edgesetPath

Array of edgesetPath_1 objects

边数据集OBS路径。

edgesetFormat

String

边数据集文件格式。

edgesetDefaultLabel

String

边数据集文件默认Label。

vertexsetPath

Array of vertexsetPath_1 objects

点数据集OBS路径。

vertexsetFormat

String

点数据集文件格式。

vertexsetDefaultLabel

String

点数据集文件默认Label。

dataStoreVersion

String

图版本。

sys_tags

Array of strings

企业项目信息，如果未指定则不开启，默认不开启。

status

String

图的状态码。

  • 100：准备中
  • 200：运行中
  • 201：升级中
  • 202：导入中
  • 203：回滚中
  • 204：导出中
  • 205：清空中
  • 206：扩容准备中
  • 207：扩容中
  • 208：扩容回退中
  • 210：扩副本准备中
  • 211：扩副本中
  • 300：故障
  • 303：创建失败
  • 400：被删除
  • 800：已冻结
  • 900：停止
  • 901：停止中
  • 920：启动中

actionProgress

String

图创建进度百分比。

说明：

只有图状态码为100时返回该字段。

graphSizeTypeIndex

String

图规模类型索引。

  • 0：一万边
  • 1：百万边
  • 2：千万边
  • 3：一亿边
  • 4：十亿边
  • 5：百亿边
  • 401：十亿增强边

vpcId

String

虚拟私有云ID。

subnetId

String

指定虚拟私有云下的子网ID。

securityGroupId

String

安全组ID。

replication

Integer

副本个数，默认为1。

created

String

图创建时间。

updated

String

图更新时间。

privateIp

String

图实例私有网络访问地址，通过该IP用户可以通过私有网络中已部署的弹性云服务器对图实例进行访问。

publicIp

String

图实例公网访问地址，通过该IP用户可以从互联网对图实例进行访问。

arch

String

图实例CPU架构类型，取值为x86_64和aarch64。

masterKeyId

String

用户主密钥ID。

masterKeyName

String

用户主密钥名称。

enableRBAC

Boolean

是否启用细粒度权限控制。

enableFulltextIndex

Boolean

是否启用全文索引。

enableHyG

Boolean

是否启用HyG，该参数只对持久化版规格图生效

trafficIpList

Array of strings

图实例私有网络访问物理地址列表。为了防止浮动IP切换造成业务闪断，推荐您通过轮询的方式使用物理IP访问图实例。

cryptAlgorithm

String

图实例加密算法，取值为：

  • generalCipher：国密算法
  • SMcompatible：商密算法（兼容国际）

enableHttps

Boolean

是否开启安全模式，开启安全模式会对性能有较大影响。

tags

Array of strings

标签列表，每个标签用<key,value>键值对表示。

表5 schemaPath_1

参数

参数类型

描述

jobId

String

导入OBS文件对应的jobId。

path

String

OBS存储路径，不包含OBS Endpoint。

status

String

OBS文件导入状态。

  • success：完全导入成功
  • partiallyFailed：部分失败
  • failed：完全导入失败
表6 edgesetPath_1

参数

参数类型

描述

jobId

String

导入OBS文件对应的jobId。

path

String

OBS存储路径，不包含OBS Endpoint。

status

String

OBS文件导入状态。

  • success：完全导入成功
  • partiallyFailed：部分失败
  • failed：完全导入失败
表7 vertexsetPath_1

参数

参数类型

描述

jobId

String

导入OBS文件对应的jobId。

path

String

OBS存储路径，不包含OBS Endpoint。

status

String

OBS文件导入状态。

  • success：完全导入成功
  • partiallyFailed：部分失败
  • failed：完全导入失败

请求示例

GET https://{Endpoint}/v1.0/{project_id}/graphs/{graph_id}

响应示例

状态码： 200

OK

{
    "graph": {
        "id": "f1529b88-c958-493e-8452-fccfe932cde1",
        "name": "demo",
        "regionCode": "ap-southeast-1",
        "azCode": "ap-southeast-1a",
             "schemaPath": [
              {
              "path": "ges-graphs/demo_movie/schema.xml",
              "jobId": "ff80808167bb90340167bc7445670428",
               "status": "success"
              }
             ],
             "edgesetPath": [
              {
               "path": "ges-graphs/demo_movie/edge.csv",
               "jobId": "ff80808167bb90340167bc7445670428",
               "status": "success"
              }
            ],
             "vertexsetPath": [
             {
              "path": "",
              "jobId": "ff80808167bb90340167bc7445670428",
              "status": "success"
             }
           ],
        "status": "200",
        "graphSizeTypeIndex": "1",
        "vpcId": "2d8af840-fd57-4e3b-a8f1-cda0f55ccd99",
        "subnetId": "dc018ec3-67d1-46c9-b2fc-19d83367f4e2",
        "securityGroupId": "11d27338-8649-4076-8579-5ebc1a60f79e",
        "created": "2018-07-23T04:09:44",
        "privateIp": "192.168.0.4",
        "publicIp": "49.4.81.183",
        "dataStoreVersion": "1.0.5",
        "arch": "x86_64"
    }
}

状态码

状态码

说明

200

请求成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。

父主题：图管理API