エンティティの作成操作

エンティティの作成操作により、Data Hub モデルに新しいエントリが追加されます。Data Hub モデルにはエンティティメタデータが既に存在している必要があります。

HTTP PUT URL 形式

このリクエストは次のように指定します。Spectrum サーバーは HTTP と HTTPS の両方をサポートしています。

PUT http://server_name:port/rest/DataHub/operations/modelName/entities/entityType/entityLabel

URL パス要素

modelName: Data Hub モデルの名前。
entityType: モデルで定義されているエンティティタイプ。
entityLabel: 新しいエンティティのラベル。

URL PUT 本文のフォーマット

Content-Type:application/json {Property Name-Value Pairs}

オプションで、既存のプロパティのプロパティ名と値のペアを次の形式で指定することができます。省略された場合や NULL または空の値が含まれている場合は、プロパティが作成されません。プロパティ名のペアは次のように書式設定されます。

{
    "Property1":"Value1",
    "Property2":"Value2",
    ...
}

応答

操作が成功するとステータスコード "200 OK" を返します。操作が失敗するとステータスコード 500 (エラー) を返します。

JSON レスポンスによるエンティティの作成

次のリクエストは、ラベル "FlightSafety International" を持つ "911" モデルの "Place" エンティティタイプを作成し、"Latitude"、"Location"、"Longitude"、"Place" の各プロパティを追加します。

PUT http://localhost:8080/rest/DataHub/operations/911/entities/Place/FlightSafety%20International

本文:

{
    "Latitude":"27.6386433",
    "Location":"Vero Beach, Florida",
    "Longitude":"-80.39727",
    "Place":"FlightSafety International",
    "Date":1275782400000
}

注: 日付、時刻、日時のプロパティ値は、リクエストとレスポンスのどちらでも、long データタイプ形式の UNIX エポック時間の値です。

レスポンス:

{
"success":"200 OK"
}