summaryrefslogtreecommitdiff
path: root/api-ref
diff options
context:
space:
mode:
Diffstat (limited to 'api-ref')
-rw-r--r--api-ref/source/baremetal-api-v1-nodes.inc16
-rw-r--r--api-ref/source/parameters.yaml12
-rw-r--r--api-ref/source/samples/node-create-response.json2
-rw-r--r--api-ref/source/samples/node-show-response.json2
-rw-r--r--api-ref/source/samples/node-update-driver-info-response.json2
-rw-r--r--api-ref/source/samples/nodes-list-details-response.json4
6 files changed, 37 insertions, 1 deletions
diff --git a/api-ref/source/baremetal-api-v1-nodes.inc b/api-ref/source/baremetal-api-v1-nodes.inc
index 49ac3fe23..28e345be1 100644
--- a/api-ref/source/baremetal-api-v1-nodes.inc
+++ b/api-ref/source/baremetal-api-v1-nodes.inc
@@ -139,7 +139,7 @@ and any defaults added for non-specified fields. Most fields default to "null"
or "".
The list and example below are representative of the response as of API
-microversion 1.46.
+microversion 1.48.
.. rest_parameters:: parameters.yaml
@@ -186,6 +186,8 @@ microversion 1.46.
- vendor_interface: vendor_interface
- volume: n_volume
- conductor_group: conductor_group
+ - protected: protected
+ - protected_reason: protected_reason
**Example JSON representation of a Node:**
@@ -302,6 +304,9 @@ Nova instance, eg. with a request to ``v1/nodes/detail?instance_uuid={NOVA INSTA
.. versionadded:: 1.46
Introduced the ``conductor_group`` field.
+.. versionadded:: 1.48
+ Introduced the ``protected`` and ``protected_reason`` fields.
+
Normal response codes: 200
Error codes: 400,403,406
@@ -372,6 +377,8 @@ Response
- vendor_interface: vendor_interface
- volume: n_volume
- conductor_group: conductor_group
+ - protected: protected
+ - protected_reason: protected_reason
**Example detailed list of Nodes:**
@@ -400,6 +407,9 @@ only the specified set.
.. versionadded:: 1.46
Introduced the ``conductor_group`` field.
+.. versionadded:: 1.48
+ Introduced the ``protected`` and ``protected_reason`` fields.
+
Normal response codes: 200
Error codes: 400,403,404,406
@@ -460,6 +470,8 @@ Response
- vendor_interface: vendor_interface
- volume: n_volume
- conductor_group: conductor_group
+ - protected: protected
+ - protected_reason: protected_reason
**Example JSON representation of a Node:**
@@ -546,6 +558,8 @@ Response
- vendor_interface: vendor_interface
- volume: n_volume
- conductor_group: conductor_group
+ - protected: protected
+ - protected_reason: protected_reason
**Example JSON representation of a Node:**
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 6b234aaa6..c05bc3571 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -987,6 +987,18 @@ properties:
in: body
required: true
type: array
+protected:
+ description: |
+ Whether the node is protected from undeploying, rebuilding and deletion.
+ in: body
+ required: false
+ type: boolean
+protected_reason:
+ description: |
+ The reason the node is marked as protected.
+ in: body
+ required: false
+ type: string
provision_state:
description: |
The current provisioning state of this Node.
diff --git a/api-ref/source/samples/node-create-response.json b/api-ref/source/samples/node-create-response.json
index ca165c223..33d075a10 100644
--- a/api-ref/source/samples/node-create-response.json
+++ b/api-ref/source/samples/node-create-response.json
@@ -59,6 +59,8 @@
"power_interface": null,
"power_state": null,
"properties": {},
+ "protected": false,
+ "protected_reason": null,
"provision_state": "enroll",
"provision_updated_at": null,
"raid_config": {},
diff --git a/api-ref/source/samples/node-show-response.json b/api-ref/source/samples/node-show-response.json
index 2ecf7b4c6..8e0078c8d 100644
--- a/api-ref/source/samples/node-show-response.json
+++ b/api-ref/source/samples/node-show-response.json
@@ -61,6 +61,8 @@
"power_interface": null,
"power_state": "power off",
"properties": {},
+ "protected": false,
+ "protected_reason": null,
"provision_state": "available",
"provision_updated_at": "2016-08-18T22:28:49.946416+00:00",
"raid_config": {},
diff --git a/api-ref/source/samples/node-update-driver-info-response.json b/api-ref/source/samples/node-update-driver-info-response.json
index 53ec73fd2..420772242 100644
--- a/api-ref/source/samples/node-update-driver-info-response.json
+++ b/api-ref/source/samples/node-update-driver-info-response.json
@@ -63,6 +63,8 @@
"power_interface": null,
"power_state": "power off",
"properties": {},
+ "protected": false,
+ "protected_reason": null,
"provision_state": "available",
"provision_updated_at": "2016-08-18T22:28:49.946416+00:00",
"raid_config": {},
diff --git a/api-ref/source/samples/nodes-list-details-response.json b/api-ref/source/samples/nodes-list-details-response.json
index f0fc4d8e8..a6ba4480d 100644
--- a/api-ref/source/samples/nodes-list-details-response.json
+++ b/api-ref/source/samples/nodes-list-details-response.json
@@ -63,6 +63,8 @@
"power_interface": null,
"power_state": "power off",
"properties": {},
+ "protected": false,
+ "protected_reason": null,
"provision_state": "available",
"provision_updated_at": "2016-08-18T22:28:49.946416+00:00",
"raid_config": {},
@@ -160,6 +162,8 @@
"power_interface": "ipmitool",
"power_state": null,
"properties": {},
+ "protected": false,
+ "protected_reason": null,
"provision_state": "enroll",
"provision_updated_at": null,
"raid_config": {},