Mit dem Vorgang „Entität erstellen“ wird einem Context Graph-Modell eine neue Entität hinzugefügt. Die Metadaten der Entität müssen bereits im Context Graph-Modell vorhanden sein.
URL-Format von HTTP-PUT-Anforderungen
Die Anforderung wird wie folgt angegeben. Der Spectrum-Server unterstützt sowohl HTTP als auch HTTPS.
PUT http://server_name:port/rest/ContextGraph/operations/modelName/entities/entityType/entityLabel
URL-Pfadelemente
- modelName
- Der Name des Context Graph-Modells.
- entityType
- Ein im Modell definierter Entitätstyp
- entityLabel
- Die Beschriftung für die neue Entität
URL PUT-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 nicht erstellt, wenn sie weggelassen wird oder einen Null- oder Leerwert enthält. Die Eigenschaftsnamenpaare sind wie folgt formatiert:
{ "Property1":"Value1", "Property2":"Value2", ... }
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.
Entität mit JSON-Antwort erstellen
Die folgende Anforderung erstellt einen Entitätstyp „Place“ im Modell „911“ mit der Beschriftung „FlightSafety International“ und fügt die folgenden Eigenschaften hinzu: „Latitude“, „Location“, „Longitude“ und „Place“.
PUT http://localhost:8080/rest/ContextGraph/operations/911/entities/Place/FlightSafety%20International
Text:
{ "Latitude":"27.6386433", "Location":"Vero Beach, Florida", "Longitude":"-80.39727", "Place":"FlightSafety International", "Date":1275782400000 }
Antwort:
{ "success":"200 OK" }