Der Vorgang zum Lesen der Beziehung gibt Eigenschaftswerte für eine Beziehung in einem Context Graph-Modell zurück.
URL-Format von HTTP-GET-Anforderungen
Die Anforderung wird wie folgt angegeben. Der Spectrum-Server unterstützt sowohl HTTP als auch HTTPS.
GET 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. |
Rückgabecodes
Der Vorgang gibt bei Erfolg den Statuscode „200 OK“ zurück. Der Vorgang gibt den Statuscode „500 (Fehler)“ zurück, wenn er fehlschlägt.
Antwort
Die Antwort gibt ein Name-Wert-Paar für jede Beziehungseigenschaft im folgenden Format zurück, wenn eine Beziehung N Eigenschaften hat.
{"result":{ "Property1":"Value1", "Property2":"Value2", ... "PropertyN":"ValueN" }}JSON-Antwort
Mithilfe der folgenden Anforderung werden Eigenschaften aus der Roomate-Beziehungsbeschriftung im Modell „911“ zwischen zwei Personenentitäten gelesen.
GET http://localhost:8080/rest/ContextGraph/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20JarrahDies führt zu folgender Antwort:
{"result":{ "Date":1275782400000, "Rank":"0" }}