api.system.node
¶
/system/node/version¶
-
api.system.node.views.
system_node_version_list
(*args, **kwargs)¶ Show (
GET
) Danube Cloud version for all compute nodes.-
GET
/system/node/version
¶ DC-bound?: Permissions: Asynchronous?: Status Codes: - 200 OK – SUCCESS
- 403 Forbidden – Forbidden
-
/system/node/(hostname)/version¶
-
api.system.node.views.
system_node_version
(*args, **kwargs)¶ Show (
GET
) Danube Cloud compute node version.-
GET
/system/node/
(hostname)/version
¶ DC-bound?: Permissions: Asynchronous?: Parameters: - hostname (string) – required - Node hostname
Arg.data.fresh: Refresh cached node version information (default: false)
Status Codes: - 200 OK – SUCCESS
- 403 Forbidden – Forbidden
- 404 Not Found – Node not found
-
/system/node/(hostname)/service/status¶
-
api.system.node.views.
system_node_service_status_list
(*args, **kwargs)¶ Get (
GET
) status of all system services on a compute node.-
GET
/system/node/
(hostname)/service/status
¶ DC-bound?: Permissions: Asynchronous?: Parameters: - hostname (string) – required - Node hostname
Status Codes: - 201 Created – SUCCESS
- 400 Bad Request – FAILURE
- 403 Forbidden – Forbidden
- 404 Not Found – Node not found
- 504 Gateway Timeout – Node worker is not responding
-
/system/node/(hostname)/service/(name)/status¶
-
api.system.node.views.
system_node_service_status
(*args, **kwargs)¶ Get (
GET
) service status on a compute node.-
GET
/system/node/
(hostname)/service/
(name)/status
¶ DC-bound?: Permissions: Asynchronous?: Parameters: - hostname (string) – required - Node hostname
- name (string) – required - Service name
Status Codes: - 201 Created – SUCCESS
- 400 Bad Request – FAILURE
- 403 Forbidden – Forbidden
- 404 Not Found – Node not found / Service not found
- 504 Gateway Timeout – Node worker is not responding
-
/system/node/(hostname)/update¶
-
api.system.node.views.
system_node_update
(*args, **kwargs)¶ Update (
PUT
) Danube Cloud on a compute node.-
PUT
/system/node/
(hostname)/update
¶ Note
The compute node software should be updated to the same
version
as installed on the main Danube Cloud management VM. Use this API call after successfulsystem update
.DC-bound?: Permissions: Asynchronous?: Parameters: - hostname (string) – required - Node hostname
- data.version (string) – required - git tag (e.g.
v2.6.5
) or git commit to which the system should be updated - data.force (boolean) – Whether to perform the update operation even though the software is already at selected version
- data.key (string) – X509 private key file used for authentication against EE git server. Please note that file MUST contain standard x509 file BEGIN/END header/footer. If not present, cached key file “update.key” will be used.
- data.cert (string) – X509 private cert file used for authentication against EE git server Please note that file MUST contain standard x509 file BEGIN/END headers/footer. If not present, cached cert file “update.crt” will be used.
Status Codes: - 200 OK – SUCCESS
- 201 Created – PENDING
- 400 Bad Request – FAILURE
- 403 Forbidden – Forbidden
- 404 Not Found – Node not found
- 423 Locked – Node is not in maintenance state / Node version information could not be retrieved
- 428 – Node is already up-to-date
-
/system/node/(hostname)/logs¶
-
api.system.node.views.
system_node_logs
(*args, **kwargs)¶ Retrieve (
GET
) Danube Cloud log files from compute node.-
GET
/system/node/
(hostname)/logs
¶ In case of a success, the response contains an object with log names as keys and contents of log files (limited to last 10 kB) as values. If the file does not exist the object values will be
null
.DC-bound?: Permissions: Asynchronous?: Parameters: - hostname (string) – required - Node hostname
- data.logname (string) – Name of the specific log file to be retrieved
Status Codes: - 200 OK – SUCCESS
- 403 Forbidden – Forbidden
- 404 Not Found – Node not found /
logname
not found - 423 Locked – Node is not operational
- 504 Gateway Timeout – Node worker is not responding
-