Composed nodes¶
List, Searching, Creating, Updating, and Deleting of Composed Node resources
are done through the /v1/nodes resource.
A Composed node may be referenced both by its UUID and by a unique “name”. Send feedback to Valence team or [chester.kuo@gmail.com]
Create Node¶
Creates a new Composed node with specific resources or empty request in json request file.
Normal response codes: 200
Error response codes: badRequest(400), unauthorized(401), forbidden(403)
Response¶
The response will contain the complete node uuid and name record
The list and example below are representative of the response as of API
Example JSON representation of a Node:
List Nodes¶
Return a list of Composed nodes. some filtering is possible by passing in flags with the request.
By default, this query will return node object with the name, uuid and node_power_state
Normal response codes: 200
Error response codes: badRequest(400), unauthorized(401), forbidden(403)
Request¶
Response¶
Example list of composed nodes:
List Composed node Details¶
Shows details for a composed node. This will return the full representation of the resources
Normal response codes: 200
Error response codes: badRequest(400), unauthorized(401), forbidden(403)
Request¶
Response¶
Example JSON representation of a Node:
Update Node¶
Updates the property stored about a composed node.
Note that this endpoint can not be used to request state changes, which are managed through sub-resources.
Normal response codes: 200
Error response codes: badRequest(400), unauthorized(401), forbidden(403), 404
Request¶
The BODY of the PATCH request must be a JSON PATCH document, adhering to RFC 6902.
Example PATCH document updating composed node :
Response¶
Example JSON representation of a Node:
Response¶
There is no body content for the response of a successful POST operation.
Delete Node¶
Deletes a node.
Normal response codes: 204
Error response codes: 401,403, 404 ,409
Request¶
Node action¶
Send a POST cmd to a composed node, includes reset node state and set boot source.
Normal response codes: 204
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404), conflict(409)
Response¶
There is no body content for the response of a successful POST operation.
Resource attach/detach¶
Send an attach/detach cmd to a composed node.
Normal response codes: 204
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404), conflict(409)
Request¶
Example POST action cmd for composed node :
Response¶
There is no body content for the response of a successful POST operation. Once attach action successful, the resources state need to be updated to “allocated”, and the new resources can show up as asset under a composde node.
Node Assets¶
Get all of Assets info of Composed node , Asset included pooled resource and fixed inventory of Compute System.
Normal response codes: 200
Error response codes: badRequest(400), unauthorized(401), forbidden(403)
Request¶
Response¶
Example JSON representation of a Node:
Manage Node¶
Manage a composed node already existing in the RSD rack by creating a Valence database entry for it, allowing Valence to perform all operations on it.
Normal response codes: 200
Error response codes: badRequest(400), unauthorized(401), forbidden(403), itemNotFound(404), conflict(409)