查询图列表(2.1.18)
功能介绍
查询当前租户所有的图。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v1.0/{project_id}/graphs
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
否 |
Integer |
本次请求的起始位置,默认为0。 |
|
limit |
否 |
Integer |
每页资源数量的最大值,默认为10。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口,响应消息头中X-Subject-Token的值即为Token。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
graphCount |
Integer |
图总个数。请求失败时为空。 |
|
graphs |
Array of graph_1 objects |
图列表。请求失败时为空。 |
|
errorMessage |
String |
系统提示信息,执行成功时,字段可能为空。执行失败时,用于显示错误信息。 |
|
errorCode |
String |
系统提示信息,执行成功时,字段可能为空。执行失败时,用于显示错误码。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
图的状态码。
|
|
actionProgress |
String |
图创建进度百分比。
说明:
只有图状态码为100时返回该字段。 |
|
graphSizeTypeIndex |
String |
图规模类型索引。
|
|
vpcId |
String |
虚拟私有云ID。 |
|
subnetId |
String |
指定虚拟私有云下的子网ID。 |
|
securityGroupId |
String |
安全组ID。 |
|
replication |
Integer |
副本个数,默认为1。 |
|
created |
String |
图创建时间。 |
|
updated |
String |
图更新时间。 |
|
privateIp |
String |
图实例私有网络访问浮动IP地址,通过该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 |
图实例加密算法,取值为:
|
|
enableHttps |
Boolean |
是否开启安全模式,开启安全模式会对性能有较大影响 |
|
tags |
Array of objects |
标签列表,每个标签用<key,value>键值对表示。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
jobId |
String |
导入OBS文件对应的jobId。 |
|
path |
String |
OBS存储路径,不包含OBS Endpoint。 |
|
status |
String |
OBS文件导入状态。
|
请求示例
GET https://{Endpoint}/v1.0/{project_id}/graphs?offset=0&limit=10
响应示例
状态码: 200
OK
{
"graphCount": 2,
"graphs": [
{
"id": "f1529b88-c958-493e-8452-fccfe932cde1",
"name": "demo",
"regionCode": "cn-north-1",
"azCode": "cn-north-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",
"updated": "2018-07-23T04:09:44",
"privateIp": "192.168.0.4",
"publicIp": "49.4.81.183",
"dataStoreVersion": "1.0.5",
"arch": "x86_64",
"enableFullTextIndex" : false
},
{
"id": "53205529-026b-455a-9e07-228fae4b12b9",
"name": "ges_c5de",
"regionCode": "cn-north-1",
"azCode": "cn-north-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": "2",
"vpcId": "2d8af840-fd57-4e3b-a8f1-cda0f55ccd99",
"subnetId": "dc018ec3-67d1-46c9-b2fc-19d83367f4e2",
"securityGroupId": "11d27338-8649-4076-8579-5ebc1a60f79e",
"created": "2018-07-18T13:30:16",
"updated": "2018-07-18T13:30:16",
"privateIp": "192.168.0.168",
"dataStoreVersion": "1.0.5",
"arch": "aarch64",
"enableFullTextIndex" : false
}
]
}
状态码
|
状态码 |
说明 |
|---|---|
|
200 |
请求成功。 |
|
400 |
请求错误。 |
|
401 |
鉴权失败。 |
|
403 |
没有操作权限。 |
|
404 |
找不到资源。 |
|
500 |
服务内部错误。 |
|
503 |
服务不可用。 |