更新时间:2025-08-22 GMT+08:00
        
          
          
        
      
      
      
      
      
      
      
      
  
      
      
      
        
批量添加点(2.1.16)
功能介绍
批量添加点。
URI
   POST /ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=batch-add 
   
    
     
   
  
 | 
         参数  | 
       
         是否必选  | 
       
         类型  | 
       
         说明  | 
      
|---|---|---|---|
| 
         project_id  | 
       
         是  | 
       
         String  | 
       
         项目ID。获取方法请参见获取项目ID。  | 
      
| 
         graph_name  | 
       
         是  | 
       
         String  | 
       
         图名称。  | 
      
请求参数
| 
        参数  | 
      
        是否必选  | 
      
        类型  | 
      
        说明  | 
     
|---|---|---|---|
| 
        vertices  | 
      
        是  | 
      
        List  | 
      
        待添加的点数组,一次最多添加1万个点。数组参数详见vertices参数说明。  | 
     
| 
        overrideExists  | 
      
        否  | 
      
        Boolean  | 
      
        对vertices参数中已经存在的点是否采取覆盖写策略。默认值为false。 
  | 
     
响应参数
| 
        参数  | 
      
        类型  | 
      
        说明  | 
     
|---|---|---|
| 
        errorMessage  | 
      
        String  | 
      
        系统提示信息。 
  | 
     
| 
        errorCode  | 
      
        String  | 
      
        系统提示信息。 
  | 
     
| 
        result  | 
      
        String  | 
      
        添加结果。成功时值为success,失败时不存在该参数。  | 
     
请求示例
批量添加点,待添加的点数组的点名称分别为150、6。
POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/vertices/action?action_id=batch-add
{
    "vertices": [
        {
            "vertex": "150",
            "label": "movie",
            "properties": {
                "movieid": [
                    "150"
                ],
                "title": [
                    "testmoive"
                ],
                "genres": [
                    "Comedy"
                ]
            }
        },
        {
            "vertex": "6",
            "label": "movie",
            "properties": {
                "movieid": [
                    "6"
                ],
                "title": [
                    "testmoive_exist_id"
                ],
                "genres": [
                    "Comedy"
                ]
            }
        }
    ],
    "overrideExists": true
}
  
 响应示例
状态码: 200
   成功响应示例
   
  Http Status Code: 200
{
"result": "success"
}
  状态码: 400
失败响应示例
Http Status Code: 400
{
    "errorMessage": "Bad Request, parameter vertices cannot be null",
    "errorCode": "GES.8214"
}
 状态码
| 
        返回值  | 
      
        说明  | 
     
|---|---|
| 
        202 Accepted  | 
      
        请求已接收,暂未处理。  | 
     
| 
        400 Bad Request  | 
      
        请求错误。  | 
     
| 
        401 Unauthorized  | 
      
        鉴权失败。  | 
     
| 
        403 Forbidden  | 
      
        没有操作权限。  | 
     
| 
        404 Not Found  | 
      
        找不到资源。  | 
     
| 
        500 Internal Server Error  | 
      
        服务内部错误。  | 
     
| 
        503 Service Unavailable  | 
      
        服务不可用。  | 
     
错误码
请参见错误码。
   父主题: 点操作API
  
 
    
      