更新时间：2022-12-19 GMT+08:00
新增元数据(2.1.18)
功能介绍
新增元数据。
URI
POST /v1.0/{project_id}/graphs/metadatas
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
metadataPath |
是 |
String |
元数据存储地址。 |
|
name |
是 |
String |
元数据的名称，限制为1-64个字符，且只能包含字母，数字或下划线。 |
|
description |
是 |
String |
对元数据的描述信息。 |
|
isOverwrite |
是 |
Boolean |
是否覆盖文件。取值为true或false，默认值为false。
|
|
gesMetadata |
是 |
Object |
存储metadata的消息信息的对象。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errorMessage |
String |
系统提示信息。
|
|
errorCode |
String |
系统提示信息。
|
|
id |
String |
元数据ID。 |
|
name |
String |
元数据的名称。 |
请求示例
POST https://Endpoint/v1.0/{project_id}/graphs/metadatas
{
"metadataPath": "gesdata/demo_movie/schema.xml",
"name": "movie_schema",
"description": "xxxxx",
"isOverwrite": "true",
"encryption":{
"enable":true,
"masterKeyId":"2fc79d04-7010-4f63-9534-d8de74ab67e0"
},
"gesMetadata": {
"labels": [
{
"name": "friends",
"properties": null
},
{
"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": "Name",
"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
OK
{
"id" : "ff8080815f9a3c84015f9a438ff70001",
"name" : "movie_schema"
}
状态码： 500
Internal Server Error
{
"errorCode" : "GES.2067",
"errorMessage" : "name: 1 to 64 characters, only letters, digits, and underscores(_) are allowed."
}
状态码
|
状态码 |
说明 |
|---|---|
|
200 |
请求成功。 |
|
400 |
请求错误。 |
|
401 |
鉴权失败。 |
|
403 |
没有操作权限。 |
|
404 |
找不到资源。 |
|
500 |
服务内部错误。 |
|
503 |
服务不可用。 |
父主题： 元数据管理API
