Skip to content

Commit

Permalink
chore: update edge documentation (#245)
Browse files Browse the repository at this point in the history
Co-authored-by: Matthias Veit <[email protected]>
  • Loading branch information
some-ci and aquamatthias authored Dec 11, 2024
1 parent cd98aae commit 926d2d1
Show file tree
Hide file tree
Showing 27 changed files with 62 additions and 96 deletions.
6 changes: 3 additions & 3 deletions docs/reference/api/abort-a-batch-update.api.mdx
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
id: abort-a-batch-update
title: "Abort a batch update"
description: "**Experimental**: This API is not stable and might be subject of change.<br/>"
description: "Abort a batch update."
sidebar_label: "Abort a batch update"
hide_title: true
hide_table_of_contents: true
api: {"description":"**Experimental**: This API is not stable and might be subject of change.<br/>\nAbort a batch update.\n","tags":["graph_management"],"parameters":[{"name":"graph_id","in":"path","example":"fix","description":"The identifier of the graph","required":true,"schema":{"type":"string"}},{"name":"batch_id","in":"path","description":"A batch identifier is a string that uniquely identifies the batch update.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Ok message","content":{"application/json":{"schema":{"type":"string","example":"Batch aborted."}}}}},"method":"delete","path":"/graph/{graph_id}/batch/{batch_id}","servers":[{"url":"https://{host}:{port}","variables":{"host":{"default":"localhost"},"port":{"default":"8900"}}}],"info":{"title":"Fix Inventory Core REST API","version":"V1"},"postman":{"name":"Abort a batch update","description":{"content":"**Experimental**: This API is not stable and might be subject of change.<br/>\nAbort a batch update.\n","type":"text/plain"},"url":{"path":["graph",":graph_id","batch",":batch_id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"disabled":false,"description":{"content":"(Required) The identifier of the graph","type":"text/plain"},"type":"any","value":"","key":"graph_id"},{"disabled":false,"description":{"content":"(Required) A batch identifier is a string that uniquely identifies the batch update.","type":"text/plain"},"type":"any","value":"","key":"batch_id"}]},"header":[{"key":"Accept","value":"application/json"}],"method":"DELETE"}}
api: {"description":"Abort a batch update.\n","tags":["graph_management"],"parameters":[{"name":"graph_id","in":"path","example":"fix","description":"The identifier of the graph","required":true,"schema":{"type":"string"}},{"name":"batch_id","in":"path","description":"A batch identifier is a string that uniquely identifies the batch update.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Ok message","content":{"application/json":{"schema":{"type":"string","example":"Batch aborted."}}}}},"method":"delete","path":"/graph/{graph_id}/batch/{batch_id}","servers":[{"url":"https://{host}:{port}","variables":{"host":{"default":"localhost"},"port":{"default":"8900"}}}],"info":{"title":"Fix Inventory Core REST API","version":"V1"},"postman":{"name":"Abort a batch update","description":{"content":"Abort a batch update.\n","type":"text/plain"},"url":{"path":["graph",":graph_id","batch",":batch_id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"disabled":false,"description":{"content":"(Required) The identifier of the graph","type":"text/plain"},"type":"any","value":"","key":"graph_id"},{"disabled":false,"description":{"content":"(Required) A batch identifier is a string that uniquely identifies the batch update.","type":"text/plain"},"type":"any","value":"","key":"batch_id"}]},"header":[{"key":"Accept","value":"application/json"}],"method":"DELETE"}}
sidebar_class_name: "delete api-method"
info_path: reference/api/fix-inventory-core-rest-api
custom_edit_url: null
Expand Down Expand Up @@ -40,7 +40,7 @@ import TabItem from "@theme/TabItem";

</MethodEndpoint>

**Experimental**: This API is not stable and might be subject of change.<br/> Abort a batch update.
Abort a batch update.

<Heading
id={"request"}
Expand Down
6 changes: 3 additions & 3 deletions docs/reference/api/commit-a-batch-update.api.mdx
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
id: commit-a-batch-update
title: "Commit a batch update"
description: "**Experimental**: This API is not stable and might be subject of change.<br/>"
description: "Commit a batch update."
sidebar_label: "Commit a batch update"
hide_title: true
hide_table_of_contents: true
api: {"description":"**Experimental**: This API is not stable and might be subject of change.<br/>\nCommit a batch update.\n","tags":["graph_management"],"parameters":[{"name":"graph_id","in":"path","example":"fix","description":"The identifier of the graph","required":true,"schema":{"type":"string"}},{"name":"batch_id","in":"path","description":"A batch identifier is a string that uniquely identifies the batch update.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Ok message","content":{"application/json":{"schema":{"type":"string","example":"Batch committed."}}}}},"method":"post","path":"/graph/{graph_id}/batch/{batch_id}","servers":[{"url":"https://{host}:{port}","variables":{"host":{"default":"localhost"},"port":{"default":"8900"}}}],"info":{"title":"Fix Inventory Core REST API","version":"V1"},"postman":{"name":"Commit a batch update","description":{"content":"**Experimental**: This API is not stable and might be subject of change.<br/>\nCommit a batch update.\n","type":"text/plain"},"url":{"path":["graph",":graph_id","batch",":batch_id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"disabled":false,"description":{"content":"(Required) The identifier of the graph","type":"text/plain"},"type":"any","value":"","key":"graph_id"},{"disabled":false,"description":{"content":"(Required) A batch identifier is a string that uniquely identifies the batch update.","type":"text/plain"},"type":"any","value":"","key":"batch_id"}]},"header":[{"key":"Accept","value":"application/json"}],"method":"POST"}}
api: {"description":"Commit a batch update.\n","tags":["graph_management"],"parameters":[{"name":"graph_id","in":"path","example":"fix","description":"The identifier of the graph","required":true,"schema":{"type":"string"}},{"name":"batch_id","in":"path","description":"A batch identifier is a string that uniquely identifies the batch update.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Ok message","content":{"application/json":{"schema":{"type":"string","example":"Batch committed."}}}}},"method":"post","path":"/graph/{graph_id}/batch/{batch_id}","servers":[{"url":"https://{host}:{port}","variables":{"host":{"default":"localhost"},"port":{"default":"8900"}}}],"info":{"title":"Fix Inventory Core REST API","version":"V1"},"postman":{"name":"Commit a batch update","description":{"content":"Commit a batch update.\n","type":"text/plain"},"url":{"path":["graph",":graph_id","batch",":batch_id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"disabled":false,"description":{"content":"(Required) The identifier of the graph","type":"text/plain"},"type":"any","value":"","key":"graph_id"},{"disabled":false,"description":{"content":"(Required) A batch identifier is a string that uniquely identifies the batch update.","type":"text/plain"},"type":"any","value":"","key":"batch_id"}]},"header":[{"key":"Accept","value":"application/json"}],"method":"POST"}}
sidebar_class_name: "post api-method"
info_path: reference/api/fix-inventory-core-rest-api
custom_edit_url: null
Expand Down Expand Up @@ -40,7 +40,7 @@ import TabItem from "@theme/TabItem";

</MethodEndpoint>

**Experimental**: This API is not stable and might be subject of change.<br/> Commit a batch update.
Commit a batch update.

<Heading
id={"request"}
Expand Down
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
id: create-a-new-node-under-the-given-parent-node
title: "Create a new node under the given parent node"
description: "**Experimental**: This API is not stable and might be subject of change.<br/>"
description: "Create a new node under the given parent node."
sidebar_label: "Create a new node under the given parent node"
hide_title: true
hide_table_of_contents: true
api: {"description":"**Experimental**: This API is not stable and might be subject of change.<br/>\nCreate a new node under the given parent node.\n","tags":["node_management"],"parameters":[{"name":"graph_id","in":"path","example":"fix","description":"The identifier of the graph","required":true,"schema":{"type":"string"}},{"name":"node_id","in":"path","description":"The identifier of the node","required":true,"schema":{"type":"string"}},{"name":"parent_node_id","in":"path","description":"The identifier of the parent node","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"The node document to create.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"kind":{"type":"string","description":"The kind of this node."}},"example":{"id":"123456","reported":{"kind":"test.person","name":"Batman","city":"Gotham"}},"title":"Node"}}}},"responses":{"200":{"description":"Return the created node","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"kind":{"type":"string","description":"The kind of this node."}},"example":{"id":"123456","reported":{"kind":"test.person","name":"Batman","city":"Gotham"}},"title":"Node"}}}}},"method":"post","path":"/graph/{graph_id}/node/{node_id}/under/{parent_node_id}","servers":[{"url":"https://{host}:{port}","variables":{"host":{"default":"localhost"},"port":{"default":"8900"}}}],"jsonRequestBodyExample":{"id":"123456","reported":{"kind":"test.person","name":"Batman","city":"Gotham"}},"info":{"title":"Fix Inventory Core REST API","version":"V1"},"postman":{"name":"Create a new node under the given parent node","description":{"content":"**Experimental**: This API is not stable and might be subject of change.<br/>\nCreate a new node under the given parent node.\n","type":"text/plain"},"url":{"path":["graph",":graph_id","node",":node_id","under",":parent_node_id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"disabled":false,"description":{"content":"(Required) The identifier of the graph","type":"text/plain"},"type":"any","value":"","key":"graph_id"},{"disabled":false,"description":{"content":"(Required) The identifier of the node","type":"text/plain"},"type":"any","value":"","key":"node_id"},{"disabled":false,"description":{"content":"(Required) The identifier of the parent node","type":"text/plain"},"type":"any","value":"","key":"parent_node_id"}]},"header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"method":"POST","body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}}}}
api: {"description":"Create a new node under the given parent node.\n","tags":["node_management"],"parameters":[{"name":"graph_id","in":"path","example":"fix","description":"The identifier of the graph","required":true,"schema":{"type":"string"}},{"name":"node_id","in":"path","description":"The identifier of the node","required":true,"schema":{"type":"string"}},{"name":"parent_node_id","in":"path","description":"The identifier of the parent node","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"The node document to create.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"kind":{"type":"string","description":"The kind of this node."}},"example":{"id":"123456","reported":{"kind":"test.person","name":"Batman","city":"Gotham"}},"title":"Node"}}}},"responses":{"200":{"description":"Return the created node","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"kind":{"type":"string","description":"The kind of this node."}},"example":{"id":"123456","reported":{"kind":"test.person","name":"Batman","city":"Gotham"}},"title":"Node"}}}}},"method":"post","path":"/graph/{graph_id}/node/{node_id}/under/{parent_node_id}","servers":[{"url":"https://{host}:{port}","variables":{"host":{"default":"localhost"},"port":{"default":"8900"}}}],"jsonRequestBodyExample":{"id":"123456","reported":{"kind":"test.person","name":"Batman","city":"Gotham"}},"info":{"title":"Fix Inventory Core REST API","version":"V1"},"postman":{"name":"Create a new node under the given parent node","description":{"content":"Create a new node under the given parent node.\n","type":"text/plain"},"url":{"path":["graph",":graph_id","node",":node_id","under",":parent_node_id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"disabled":false,"description":{"content":"(Required) The identifier of the graph","type":"text/plain"},"type":"any","value":"","key":"graph_id"},{"disabled":false,"description":{"content":"(Required) The identifier of the node","type":"text/plain"},"type":"any","value":"","key":"node_id"},{"disabled":false,"description":{"content":"(Required) The identifier of the parent node","type":"text/plain"},"type":"any","value":"","key":"parent_node_id"}]},"header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"method":"POST","body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}}}}
sidebar_class_name: "post api-method"
info_path: reference/api/fix-inventory-core-rest-api
custom_edit_url: null
Expand Down Expand Up @@ -40,7 +40,7 @@ import TabItem from "@theme/TabItem";

</MethodEndpoint>

**Experimental**: This API is not stable and might be subject of change.<br/> Create a new node under the given parent node.
Create a new node under the given parent node.

<Heading
id={"request"}
Expand Down
6 changes: 3 additions & 3 deletions docs/reference/api/delete-a-configuration-by-its-id.api.mdx
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
id: delete-a-configuration-by-its-id
title: "Delete a configuration by its id"
description: "**Experimental**: This API is not stable and might be subject of change.<br/>"
description: "Delete a configuration identified by id with provided value."
sidebar_label: "Delete a configuration by its id"
hide_title: true
hide_table_of_contents: true
api: {"description":"**Experimental**: This API is not stable and might be subject of change.<br/>\nDelete a configuration identified by id with provided value.\n","tags":["config"],"parameters":[{"name":"config_id","in":"path","required":true,"description":"the identifier of the config to get.","schema":{"type":"string"}}],"responses":{"204":{"description":"Signals success of this operation."}},"method":"delete","path":"/config/{config_id}","servers":[{"url":"https://{host}:{port}","variables":{"host":{"default":"localhost"},"port":{"default":"8900"}}}],"info":{"title":"Fix Inventory Core REST API","version":"V1"},"postman":{"name":"Delete a configuration by its id","description":{"content":"**Experimental**: This API is not stable and might be subject of change.<br/>\nDelete a configuration identified by id with provided value.\n","type":"text/plain"},"url":{"path":["config",":config_id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"disabled":false,"description":{"content":"(Required) the identifier of the config to get.","type":"text/plain"},"type":"any","value":"","key":"config_id"}]},"method":"DELETE"}}
api: {"description":"Delete a configuration identified by id with provided value.\n","tags":["config"],"parameters":[{"name":"config_id","in":"path","required":true,"description":"the identifier of the config to get.","schema":{"type":"string"}}],"responses":{"204":{"description":"Signals success of this operation."}},"method":"delete","path":"/config/{config_id}","servers":[{"url":"https://{host}:{port}","variables":{"host":{"default":"localhost"},"port":{"default":"8900"}}}],"info":{"title":"Fix Inventory Core REST API","version":"V1"},"postman":{"name":"Delete a configuration by its id","description":{"content":"Delete a configuration identified by id with provided value.\n","type":"text/plain"},"url":{"path":["config",":config_id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"disabled":false,"description":{"content":"(Required) the identifier of the config to get.","type":"text/plain"},"type":"any","value":"","key":"config_id"}]},"method":"DELETE"}}
sidebar_class_name: "delete api-method"
info_path: reference/api/fix-inventory-core-rest-api
custom_edit_url: null
Expand Down Expand Up @@ -40,7 +40,7 @@ import TabItem from "@theme/TabItem";

</MethodEndpoint>

**Experimental**: This API is not stable and might be subject of change.<br/> Delete a configuration identified by id with provided value.
Delete a configuration identified by id with provided value.

<Heading
id={"request"}
Expand Down
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
---
id: delete-a-node-with-the-given-node-id
title: "Delete a node with the given node id."
description: "**Experimental**: This API is not stable and might be subject of change.<br/>"
description: "Delete a node with the given node id."
sidebar_label: "Delete a node with the given node id."
hide_title: true
hide_table_of_contents: true
api: {"description":"**Experimental**: This API is not stable and might be subject of change.<br/>\nDelete a node with the given node id.\n","tags":["node_management"],"parameters":[{"name":"graph_id","in":"path","example":"fix","description":"The identifier of the graph","required":true,"schema":{"type":"string"}},{"name":"node_id","in":"path","description":"The identifier of the node","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Node is deleted"}},"method":"delete","path":"/graph/{graph_id}/node/{node_id}","servers":[{"url":"https://{host}:{port}","variables":{"host":{"default":"localhost"},"port":{"default":"8900"}}}],"info":{"title":"Fix Inventory Core REST API","version":"V1"},"postman":{"name":"Delete a node with the given node id.","description":{"content":"**Experimental**: This API is not stable and might be subject of change.<br/>\nDelete a node with the given node id.\n","type":"text/plain"},"url":{"path":["graph",":graph_id","node",":node_id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"disabled":false,"description":{"content":"(Required) The identifier of the graph","type":"text/plain"},"type":"any","value":"","key":"graph_id"},{"disabled":false,"description":{"content":"(Required) The identifier of the node","type":"text/plain"},"type":"any","value":"","key":"node_id"}]},"method":"DELETE"}}
api: {"description":"Delete a node with the given node id.\n","tags":["node_management"],"parameters":[{"name":"graph_id","in":"path","example":"fix","description":"The identifier of the graph","required":true,"schema":{"type":"string"}},{"name":"node_id","in":"path","description":"The identifier of the node","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Node is deleted"}},"method":"delete","path":"/graph/{graph_id}/node/{node_id}","servers":[{"url":"https://{host}:{port}","variables":{"host":{"default":"localhost"},"port":{"default":"8900"}}}],"info":{"title":"Fix Inventory Core REST API","version":"V1"},"postman":{"name":"Delete a node with the given node id.","description":{"content":"Delete a node with the given node id.\n","type":"text/plain"},"url":{"path":["graph",":graph_id","node",":node_id"],"host":["{{baseUrl}}"],"query":[],"variable":[{"disabled":false,"description":{"content":"(Required) The identifier of the graph","type":"text/plain"},"type":"any","value":"","key":"graph_id"},{"disabled":false,"description":{"content":"(Required) The identifier of the node","type":"text/plain"},"type":"any","value":"","key":"node_id"}]},"method":"DELETE"}}
sidebar_class_name: "delete api-method"
info_path: reference/api/fix-inventory-core-rest-api
custom_edit_url: null
Expand Down Expand Up @@ -40,7 +40,7 @@ import TabItem from "@theme/TabItem";

</MethodEndpoint>

**Experimental**: This API is not stable and might be subject of change.<br/> Delete a node with the given node id.
Delete a node with the given node id.

<Heading
id={"request"}
Expand Down
Loading

0 comments on commit 926d2d1

Please sign in to comment.