Der Vorgang „Beziehung aktualisieren“ ersetzt Eigenschaftswerte in einer vorhandenen Beziehung.
URL-Format von HTTP-POST-Anforderungen
Die Anforderung wird wie folgt angegeben. Der Spectrum-Server unterstützt sowohl HTTP als auch HTTPS.
POST http://server_name:port/rest/ContextGraph/operations/modelName/relationships/relationshipLabel?query_parameters
URL-Pfadelemente
- modelName
- Der Name des Context Graph-Modells.
- relationshipLabel
- Der Name der Beziehungsbeschriftung, die zwei Entitäten in einem Modell verbindet.
Abfrageparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| sourceID | string | ja | Die Quell-ID der Entität, die eine Beziehung verbindet. Dieser Parameter gibt ein Wertepaar des Typs entityType:entityLabel an. |
| targetID | string | ja | Die Ziel-ID der Entität, die eine Beziehung verbindet. Dieser Parameter gibt ein Wertepaar des Typs entityType:entityLabel an. |
| uniqueID | string | no | Der Wert, der eine Beziehung auszeichnet, wenn mehrere Beziehungen mit derselben Beschriftung vorhanden sind, die zwei Entitäten in einem Modell verbinden. |
URL-POST-Textformat
Content-Type:application/json {Property Name-Value Pairs}
Optional können Sie für jede vorhandene Eigenschaft einen Eigenschaftsnamen und ein Wertepaar im folgenden Format angeben: Eine Eigenschaft wird entfernt, wenn hier ein Nullwert oder ein leerer Wert angegeben wird. Die Eigenschaftsnamenpaare sind wie folgt formatiert:
{ "Property1":"Value1", "Property2":"Value2", ... }Mindestens eine Eigenschaft ist erforderlich, um den Vorgang erfolgreich abzuschließen. Ausgelassene Eigenschaften werden nicht geändert.
Antwort
Der Vorgang gibt bei Erfolg den Statuscode „200 OK“ zurück. Der Vorgang gibt den Statuscode „500 (Fehler)“ zurück, wenn er fehlschlägt.
Beziehung mit JSON-Antwort aktualisieren
Die folgende Anforderung aktualisiert die Datumseigenschaft für eine Roomate-Beziehungsbeschriftung im Modell „911“.
POST http://localhost:8080/rest/ContextGraph/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20JarrahText:
{ "Date":1275782400000 }Antwort:
{ "success":"200 OK" }Beziehung mit derselben Beschriftung aktualisieren
Im Folgenden wird eine Roomate-Beziehungsbeschriftung im Modell „911“ aktualisiert, bei der die Beziehungs-ID zwischen zwei Personenentitäten gleich „4“ ist.
POST http://localhost:8080/rest/ContextGraph/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20Jarrah&uniqueID=4