La operación de lectura de relación devuelve valores de propiedad de una relación presente en el modelo de Context Graph.
Formato de dirección URL de HTTP GET
La solicitud se especifica de la siguiente manera: El servidor de Spectrum es compatible con HTTP y HTTPS.
GET http://server_name:port/rest/ContextGraph/operations/modelName/relationships/relationshipLabel?query_parameters
Elementos de ruta URL
- modelName
- El nombre del modelo de Context Graph.
- relationshipLabel
- El nombre del rótulo de relación que conecta a dos entidades de un modelo.
Parámetros de consulta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| sourceID | cadena | sí | El ID de origen de la entidad que conecta una relación. Este parámetro especifica el par de valor entityType:entityLabel. |
| targetID | cadena | sí | El ID de destino de la entidad que conecta una relación. Este parámetro especifica el par de valor entityType:entityLabel. |
| uniqueID | cadena | no | El valor que distingue una relación cuando hay varias relaciones con el mismo rótulo conectando dos entidades de un modelo. |
Códigos de retorno
La operación devuelve el código de estado "200 OK" cuando se realiza correctamente. La operación devuelve el código de estado 500 (Error) cuando falla.
Respuesta
La respuesta devuelve un par de nombre y valor por cada propiedad de relación en el siguiente formato, cuando una entidad tiene N propiedades.
{"result":{ "Property1":"Value1", "Property2":"Value2", ... "PropertyN":"ValueN" }}Respuesta JSON
La siguiente solicitud lee propiedades del rótulo de relación Roomate en el modelo “911” entre dos entidades de persona.
GET http://localhost:8080/rest/ContextGraph/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20JarrahEsto genera la siguiente respuesta:
{"result":{ "Date":1275782400000, "Rank":"0" }}