Querying the Graph List (2.1.18)
Function
This API is used to query all graphs owned by the current tenant.
URI
GET /v1.0/{project_id}/graphs
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID. For details about how to obtain the project ID, see Obtaining a Project ID. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
offset |
No |
Integer |
Start position of the request. The default value is 0. |
limit |
No |
Integer |
Maximum number of resources displayed on a single page. The default value is 10. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token. It is used to obtain the permission to call APIs. For details about how to obtain the token, see Authentication. The value of X-Subject-Token in the response header is the token. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
graphCount |
Integer |
Total number of graphs. This parameter is left blank when the request fails. |
graphs |
Array of graph_1 objects |
Graph list. This parameter is left blank when the request fails. |
errorMessage |
String |
System prompt. If execution succeeds, this parameter may be left blank. If execution fails, this parameter is used to display the error message. |
errorCode |
String |
System prompt. If execution succeeds, this parameter may be left blank. If execution fails, this parameter is used to display the error code. |
Parameter |
Type |
Description |
---|---|---|
id |
String |
Graph ID |
name |
String |
Graph name |
createdBy |
String |
IAM username |
isMultiAz |
String |
Whether to enable cross-AZ HA |
regionCode |
String |
Region code |
azCode |
String |
AZ code |
schemaPath |
Array of schemaPath_1 objects |
Path for storing the metadata file |
edgesetPath |
Array of edgesetPath_1 objects |
OBS path for storing the edge data set |
edgesetFormat |
String |
Format of the edge data file |
edgesetDefaultLabel |
String |
Default label of the edge data file |
vertexsetPath |
Array of vertexsetPath_1 objects |
OBS path for storing the vertex data set |
vertexsetFormat |
String |
Format of the vertex data file |
vertexsetDefaultLabel |
String |
Default label of the vertex data file |
dataStoreVersion |
String |
Graph version |
sys_tags |
Array of strings |
Enterprise project information. If this parameter is not specified, this function is disabled (default). |
status |
String |
Status code of a graph:
|
actionProgress |
String |
Progress of graph creation in percentage
NOTE:
This field is returned only when status is 100. |
graphSizeTypeIndex |
String |
Graph size type index:
|
vpcId |
String |
VPC ID |
subnetId |
String |
Subnet ID in the VPC |
securityGroupId |
String |
Security group ID |
replication |
Integer |
Number of replicas. The default value is 1. |
created |
String |
Time when a graph is created |
updated |
String |
Time when a graph is updated |
privateIp |
String |
Floating IP address of a graph instance. Users can access the instance using the IP address through the ECS deployed on a private network. |
publicIp |
String |
Public network access address of a graph instance. Users can access the instance using the IP address from the Internet. |
arch |
String |
Graph instance's CPU architecture type. The value can be x86_64 or aarch64. |
encrypted |
Boolean |
Whether to encrypt backup data. The default value is false, indicating that the backup data is not encrypted. |
masterKeyId |
String |
User master key ID |
masterKeyName |
String |
User master key name |
enableRBAC |
Boolean |
Whether to enable granular permission control |
enableFulltextIndex |
Boolean |
Whether to enable full-text indexes |
enableHyG |
Boolean |
Whether to enable HyG. This parameter is available only for database edition graphs. |
trafficIpList |
Array of strings |
Physical addresses of a graph instance for access from private networks. To prevent service interruption caused by floating IP address switchover, poll the physical IP addresses to access the graph instance. |
cryptAlgorithm |
String |
Graph instance cryptography algorithm. Available values are as follows:
|
enableHttps |
Boolean |
Whether to enable the security mode. This mode may damage GES performance greatly. |
tags |
Array of objects |
Tag list. Each tag is in <key,value> format. |
Parameter |
Type |
Description |
---|---|---|
jobId |
String |
Job ID corresponding to OBS file import |
path |
String |
OBS storage path, excluding OBS endpoint |
status |
String |
OBS file status:
|
Example Request
GET https://Endpoint/v1.0/{project_id}/graphs?offset=0&limit=10
Example Response
Status code: 200
OK
{ "graphCount": 2, "graphs": [ { "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", "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": "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": "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 } ] }
Status Codes
Status Code |
Description |
---|---|
200 |
Request sent. |
400 |
Request error. |
401 |
Authorization failed. |
403 |
No operation permissions. |
404 |
No resources found. |
500 |
Internal server error. |
503 |
Service unavailable. |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot