From 976963cfaea92c489a0284c1eec73c7dfd541a57 Mon Sep 17 00:00:00 2001 From: Michael Arrastia Date: Thu, 21 Mar 2019 15:20:04 +0000 Subject: [PATCH] Update BULK.md with operation order information Change-Id: Ib3588411548c584902c6f044797c58c9afb26db0 Issue-ID: AAI-2270 Signed-off-by: Michael Arrastia --- BULK.md | 66 ++++++++++++++++++++++++++++++++--------------------------------- 1 file changed, 33 insertions(+), 33 deletions(-) diff --git a/BULK.md b/BULK.md index ba94846..9f2f3dd 100644 --- a/BULK.md +++ b/BULK.md @@ -1,19 +1,19 @@ ## Bulk API -The bulk API allows a client to add/modify/patch/delete multiple vertexes and/or edges within a single request. This request will be treated as an atomic transaction in that all operations within the bulk request will either fail or succeed together. +The bulk API allows a client to add/modify/patch/delete multiple vertexes and/or edges within a single request. This request will be treated as an atomic transaction in that all operations within the bulk request will either fail or succeed together. This is often useful when attempting to add an entire subgraph. -This is often useful when attempting to add an entire subgraph. The following example shows how a client could create 2 vertexes (pserver and vserver) and link them with an edge. +The following example shows how a client could create 2 vertexes (pserver and vserver) and link them with an edge. In the JSON body, the order in which vertex and edge operations are defined within the `objects` and `relationships` arrays is not important. The bulk API will handle the operations requested in a logical order to preserve data integrity. - URL: https://:9520/services/inventory/v11/bulk - Method: POST - Body: - { - "objects":[ - { + URL: https://:9520/services/inventory/v11/bulk + Method: POST + Body: + { + "objects":[ + { "operation":"add", - "v1":{ + "v1":{ "type":"vserver", - "properties":{ + "properties":{ "in-maint":false, "vserver-name":"vserver1", "prov-status":"Provisioned", @@ -24,11 +24,11 @@ This is often useful when attempting to add an entire subgraph. The following e } } }, - { + { "operation":"add", - "v2":{ + "v2":{ "type":"pserver", - "properties":{ + "properties":{ "ptnii-equip-name":"ps1993", "hostname":"pserver1", "equip-type":"server", @@ -41,14 +41,14 @@ This is often useful when attempting to add an entire subgraph. The following e } } ], - "relationships":[ - { + "relationships":[ + { "operation":"add", - "e1":{ + "e1":{ "type":"tosca.relationships.HostedOn", "source":"$v1", "target":"$v2", - "properties":{ + "properties":{ "contains-other-v": "NONE", "delete-other-v": "NONE", "SVC-INFRA": "OUT", @@ -59,9 +59,9 @@ This is often useful when attempting to add an entire subgraph. The following e ] } - Success Response: - Code: 200 - Content: + Success Response: + Code: 200 + Content: { "objects": [ { @@ -124,18 +124,18 @@ This is often useful when attempting to add an entire subgraph. The following e ] } - Error Response: - Code: 400 (BAD REQUEST) - Content: Error message describing the bad request failure. - Situation: Invalid Payload or schema error. + Error Response: + Code: 400 (BAD REQUEST) + Content: Error message describing the bad request failure. + Situation: Invalid Payload or schema error. - Code: 403 (FORBIDDEN) - Content: Error message describing the Authorization failure. - Situation: Authorization failure. + Code: 403 (FORBIDDEN) + Content: Error message describing the Authorization failure. + Situation: Authorization failure. - Code: 415 (UNSUPPORTED MEDIA TYPE) - Situation: Unsupported content type . - - Code: 500 (Internal Server Error) - Content: Error message describing the failure. - Situation: Any scenario not covered by the above error codes. + Code: 415 (UNSUPPORTED MEDIA TYPE) + Situation: Unsupported content type . + + Code: 500 (Internal Server Error) + Content: Error message describing the failure. + Situation: Any scenario not covered by the above error codes. -- 2.16.6