関連性の更新操作
関連性の更新操作により、既存の関連性内のプロパティ値が置き換えられます。
HTTP POST URL 形式
このリクエストは次のように指定します。Spectrum サーバーは HTTP と HTTPS の両方をサポートしています。
POST http://server_name:port/rest/DataHub/operations/modelName/relationships/relationshipLabel?query_parameters
URL パス要素
- modelName
- Data Hub モデルの名前。
- relationshipLabel
- モデル内にある 2 つのエンティティを接続する関連性ラベルの名前。
クエリ パラメータ
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
| sourceID | string | はい | 関連性をつなげるエンティティのソース ID。このパラメータは entityType:entityLabel 値のペアを指定します。 |
| targetID | string | はい | 関連性をつなげるエンティティのターゲット ID。このパラメータは entityType:entityLabel 値のペアを指定します。 |
| uniqueID | string | いいえ | 2 つのエンティティを接続する関連性がモデル内に複数あってそれらが同じラベルを持つ場合に、関連性を識別する値。 |
URL POST 本文フォーマット
Content-Type:application/json {Property Name-Value Pairs}
オプションで、既存のプロパティのプロパティ名と値のペアを次の形式で指定することができます。ここで NULL または空の値が指定された場合、プロパティは削除されます。プロパティ名のペアは次のように書式設定されます。
{
"Property1":"Value1",
"Property2":"Value2",
...
}この操作を首尾よく完了するには、少なくとも 1 つのプロパティが必要です.省略されたプロパティは変更されません。
応答
操作が成功するとステータス コード "200 OK" を返します。操作が失敗するとステータス コード 500 (エラー) を返します。
JSON レスポンスによる関連性の更新
次のリクエストは、"911" モデルの Roomate (同室者) 関連性ラベルの日付プロパティを更新します。
POST http://localhost:8080/rest/DataHub/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20Jarrah本文:
{
"Date":1275782400000
}レスポンス:
{
"success":"200 OK"
}注: 日付、時刻、日時のプロパティ値は、リクエストとレスポンスのどちらでも、long データ タイプ形式の UNIX エポック時間の値です。
同じラベルを持つ関連性の更新
次のコマンドは、2 つの person (人物) エンティティ間の関連性 ID が "4" である "911" モデルの Roomate (同室者) 関連性ラベルを更新します。
POST http://localhost:8080/rest/DataHub/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20Jarrah&uniqueID=4