通过读取文件删除点边

功能介绍

通过读取文件删除点边。

URL

• URI 格式

  POST  /v1.0/{project_id}/graphs/{graph_name}/action?action_id=delete-by-file

• 参数说明

  表1 URI参数说明

  参数	是否必选	类型	说明
  project_id	是	String	项目编号，用于资源隔离。请参考获取项目ID。
  graph_name	是	String	图名称。

请求

• 请求样例

POST http://Endpoint/v1.0/{project_id}/graphs/{graph_name}/action?action_id=delete-by-file
{
  "vertexsetPath": "datasets/movie/movie.csv",
  "vertexsetFormat": "csv",
  "edgesetPath": "datasets/movie/ranking_edge.csv",
  "edgesetFormat": "csv",
  "targetProperties": [
    {
      "label": "rate",
      "properties": [
        "Rating"
      ]
    }
  ],
  "delimiter": ",",
  "trimQuote": "\"",
  "obsParameters": {
  "accessKey": "XXXXXXX",
  "secretKey": "XXXXXXX"
  }
}

• 参数说明

  表2 Body参数说明

  参数	是否必选	类型	说明
  vertexsetPath	vertexsetPath和edgesetPath至少有一个	String	点文件目录或点文件名。
  vertexsetFormat	否	String	点数据集格式。当前仅支持csv。 默认为csv。
  edgesetPath	vertexsetPath和edgesetPath至少有一个	String	边文件目录或边文件名。
  edgesetFormat	否	String	边数据集格式。当前仅支持csv。 默认为csv。
  targetProperties	否	Json	边文件中用于区分重复边的属性信息，JsonArray格式。请参见表3。
  delimiter	否	Character	csv格式文件字段分隔符，默认值为逗号（,）。list/set类型的字段内元素分隔符默认为分号（;）。
  trimQuote	否	Character	csv格式文件字段包围符，默认值为双引号（"）。用来包围一个字段，如字段中含有分隔符或者换行等。
  obsParameters	是	String	OBS认证参数。请参见表3。

  表3 targetProperties参数说明

  参数	是否必选	类型	说明
  label	是	String	label名称。
  properties	是	Json	边ID属性信息，JsonArray格式。当前仅支持一个属性。

  

  导入文件更新属性的csv文件格式如下：

  • 点文件：点ID。
  • 边文件（不包含label）：源点ID,目的点ID。
  • 边文件（包含label）：源点ID,目的点ID,label,边ID属性。

响应

• 要素说明

  参数	是否必选	类型	说明
  errorMessage	否	String	系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误信息。
  errorCode	否	String	系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误码。
  job_id	否	String	执行该异步任务的jobId。 可以查询jobId查看任务执行状态、获取返回结果，详情参考Job管理API。

• 请求成功样例

  Http Status Code: 200
  {
    "jobId": "b4f2e9a0-0439-4edd-a3ad-199bb523b613"
  }

• 请求失败样例

  Http Status Code: 400
  {
    "errorMessage": "parameter format error",
    "errorCode": "GES.8013"
  }

返回值

• 正常

200

• 异常