Updated on 2024-05-23 GMT+08:00

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

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

Table 2 Query parameters

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

Table 3 Request header parameter

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

Table 4 Response body parameter

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.

Table 5 graph_1

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:

  • 100: Indicates that a graph is being prepared.
  • 200: indicates that a graph is running.
  • 201: indicates that a graph is upgrading.
  • 202: indicates that a graph is being imported.
  • 203: indicates that a graph is being rolled back.
  • 204: indicates that a graph is being exported.
  • 205: indicates that a graph is being cleared.
  • 206: indicates that the system is preparing for resize.
  • 207: indicates that the resize is in progress.
  • 208: Indicates that the resize is being rolled back.
  • 210: Preparing for expansion
  • 211: Expanding
  • 300: indicates that a graph is faulty.
  • 303: indicates that a graph fails to be created.
  • 400: indicates that a graph is deleted.
  • 800: indicates that a graph is frozen.
  • 900: indicates that a graph is stopped.
  • 901: indicates that a graph is being stopped.
  • 920: indicates that a graph is being started.

actionProgress

String

Progress of graph creation in percentage

NOTE:

This field is returned only when status is 100.

graphSizeTypeIndex

String

Graph size type index:

  • 0: Ten-thousand-edge
  • 1: Million-edge
  • 2: Ten-million-edge
  • 3: Hundred-million-edge
  • 4: Billion-edge
  • 5: Ten-billion-edge
  • 6: database edition
  • 401: Billion-edge-pro

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:

  • generalCipher: Chinese cryptographic algorithm
  • SMcompatible: Commercial cryptography algorithm (compatible with international ones)

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.

Table 6 schemaPath_1

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:

  • success: Imported successfully.
  • partiallyFailed: Partially failed.
  • failed: Failed to import the file.
Table 7 edgesetPath_1

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:

  • success: Imported successfully.
  • partiallyFailed: Partially failed.
  • failed: Failed to import the file.
Table 8 vertexsetPath_1

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:

  • success: Imported successfully.
  • partiallyFailed: Partially failed.
  • failed: Failed to import the file.

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.