Adding a Label

Function

This API is used to add a label.

URI

Request Parameters

• Request parameters (OBS scenario)

  Table 2 Request body parameters

  Parameter	Mandatory	Type	Description
  name	Yes	String	Name of a label A label name can contain a maximum of 256 characters. Only letters, digits, spaces, and special characters %,@,#,$,:,?,*, .,+,- are allowed.
  type	No	String	Label type, indicating that the label is used for vertices or edges. The options are as follows: vertex: indicates that the label is used for vertices. edge: indicates that the label is used for edges. all: indicates that the label is used for vertices and edges. The default value is all.
  properties	Yes	Object	Properties you want to add to the label. For details about the parameters, see Table 3.

  Table 3 properties parameter description

  Parameter	Mandatory	Type	Description
  property	No	Object	Label properties. For details about the parameters, see Table 4.

  Table 4 property parameters

  Parameter	Mandatory	Type	Description
  name	Yes	String	Property name A property name can contain a maximum of 256 characters. A property name cannot contain <, >, &, ASCII 14,15 or 30. The property under a label must be unique.
  cardinality	Yes	String	Cardinality type of a property. The options include: single list set
  dataType	Yes	String	Data type of a property. For details, see the metadata types in Specification Description.

Response Parameters

Example Request

Add a label. The label name is book. The label has one property to add.

POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/schema/labels  
{
  "name": "book",
  "type": "vertex",
  "properties": [
    {
      "property": {
        "name": "Title",
        "cardinality": "single",
        "dataType": "string"
      }
    },
    {
      "property": {
        "name": "Version",
        "cardinality": "single",
        "dataType": "string"
      }
    }
  ]
}

SERVER_URL: Address for accessing a graph. For details about its value, see Using Service Plane APIs.

Example Response

Status code: 200

Example response for a successful request

Http Status Code: 200
{
 "result": "success"
}

Status code: 400

Http Status Code: 400
 {
  "errorMessage": "label already exists",
  "errorCode": "GES.8801"
 }

Status Codes

Error Codes

See Error Codes.