新增元数据(2.1.18)
功能介绍
新增元数据。
URI
POST /v2/{project_id}/graphs/metadatas
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
metadata_path |
是 |
String |
元数据存储地址。 |
name |
是 |
String |
元数据的名字,限制为1-64个字符,且只能包含字母,数字或下划线。 |
description |
是 |
String |
对元数据的描述。 |
is_overwrite |
是 |
Boolean |
是否覆盖文件。 |
ges_metadata |
是 |
ges_metadata object |
存储metadata的消息信息的对象。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
元数据ID。 |
name |
String |
元数据名字。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
系统提示信息。
|
error_msg |
String |
系统提示信息。
|
请求示例
新增元数据,元数据存储地址为devdata/unionsdk/unionsdk_test.xml,不覆盖文件,元数据的名字为unionsdk_test,对元数据的描述为测试。
POST https://Endpoint/v2/{project_id}/graphs/metadatas { "metadata_path" : "devdata/unionsdk/unionsdk_test.xml", "is_overwrite" : false, "name" : "unionsdk_test", "description" : "测试", "ges_metadata" : { "labels" : [ { "name" : "friends" }, { "name" : "movie", "properties" : [ { "dataType" : "string", "name" : "ChineseTitle", "cardinality" : "single" }, { "dataType" : "int", "name" : "Year", "cardinality" : "single" }, { "dataType" : "string", "name" : "Genres", "cardinality" : "set" } ] }, { "name" : "user", "properties" : [ { "dataType" : "string", "name" : "ChineseName", "cardinality" : "single" }, { "typeName1" : "F", "typeName2" : "M", "typeNameCount" : "2", "dataType" : "enum", "name" : "Gender", "cardinality" : "single" }, { "typeName1" : "Under 18", "typeName2" : "18-24", "typeName3" : "25-34", "typeName4" : "35-44", "typeNameCount" : "7", "dataType" : "enum", "name" : "Age", "typeName5" : "45-49", "typeName6" : "50-55", "cardinality" : "single", "typeName7" : "56+" }, { "dataType" : "string", "name" : "Occupation", "cardinality" : "single" }, { "dataType" : "char array", "name" : "Zip-code", "maxDataSize" : "12", "cardinality" : "single" } ] }, { "name" : "rate", "properties" : [ { "dataType" : "int", "name" : "Score", "cardinality" : "single" }, { "dataType" : "date", "name" : "Datetime", "cardinality" : "single" } ] } ] } }
响应示例
状态码: 200
成功响应示例
{ "id" : "ff8080815f9a3c84015f9a438ff70001", "name" : "movie_schema" }
状态码: 400
失败响应示例
{ "error_msg" : "The metadata file already exists.", "error_code" : "GES.2067" }
状态码
返回值 |
说明 |
---|---|
400 Bad Request |
请求错误 |
401 Unauthorized |
鉴权失败 |
403 Forbidden |
没有操作权限 |
404 Not Found |
找不到资源 |
500 Internal Server Error |
服务内部错误 |
503 Service Unavailable |
服务不可用 |
错误码
请参见错误码。