功能介绍

新增元数据。

URI

• URI 格式

  POST /v1.0/{projectId}/graphs/metadatas

• 参数说明

  表1 URI参数说明

  参数	是否必选	类型	说明
  projectId	是	String	项目编号，用于资源隔离。请参考获取项目ID。
  metadataPath	是	String	元数据存储地址。
  name	是	String	元数据的名字，限制为1-64个字符，且只能包含字母，数字或下划线。
  description	否	String	对元数据的描述。
  isOverwrite	是	Boolean	是否覆盖文件。
  gesMetadata	是	GesMetaData	存储metadata的消息信息的对象。

请求

• 请求样例

  POST https://Endpoint/v1.0/{projectId}/graphs/metadatas 
  {
      "metadataPath": "gesdata/demo_movie/schema.xml",
      "name": "movie_schema",
      "description": "xxxxx",
      "isOverwrite": "true",
      "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": "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"
                      }
                  ]
              }
          ]
      }
  }

响应

• 要素说明

  表2 要素说明

  参数	类型	说明
  errorMessage	String	系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误信息。
  errorCode	String	系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误码。
  metadataId	String	元数据ID。
  name	String	元数据名字。

• 请求成功样例

  Http Status Code: 200
    {
     "id" : "ff8080815f9a3c84015f9a438ff70001",
     "name" : "movie_schema"
    }

• 请求失败样例

  Http Status: 500
     {
       "errorCode": "GES.2067",
       "errorMessage": "name: 1 to 64 characters, only letters, digits, and underscores(_) are allowed."
     }

返回值

• 正常

  200

• 异常

  表3 异常返回值说明

  返回值	说明
  400 Bad Request	请求错误。
  401 Unauthorized	鉴权失败。
  403 Forbidden	没有操作权限。
  404 Not Found	找不到资源。
  500 Internal Server Error	服务内部错误。
  503 Service Unavailable	服务不可用。