api.dc.node

/dc/(dc)/node

api.dc.node.views.dc_node_list(*args, **kwargs)

List (GET) available compute nodes in current datacenter.

GET /dc/(dc)/node
DC-bound?:
Permissions:
Asynchronous?:
Parameters:
  • request.dc (string) – required - Datacenter name
  • data.full (boolean) – Return list of objects with all node related details (default: false)
  • data.extended (boolean) – Return list of objects with extended compute node details (default: false)
  • data.order_by (string) – Available fields for sorting: hostname (default: hostname)
Status Codes:

es example:

es get /dc/cloud1/node
{
    "url": "https://my.erigones.com/api/dc/cloud1/node/",
    "status": 200,
    "method": "GET",
    "text": {
        "status": "SUCCESS",
        "result": [
            "node99.erigones.com"
        ],
        "task_id": "1e1d23-6f75849b-21ea-4187-8e00"
}

/dc/(dc)/node/(hostname)

api.dc.node.views.dc_node(*args, **kwargs)

Show (GET), create (POST), change (PUT) or remove (DELETE) a compute node (hostname) association with a datacenter (dc).

GET /dc/(dc)/node/(hostname)
DC-bound?:
Permissions:
Asynchronous?:
Parameters:
  • request.dc (string) – required - Datacenter name
  • hostname (string) – required - Compute node hostname
  • data.extended (boolean) – Display extended compute node details (default: false)
Status Codes:
POST /dc/(dc)/node/(hostname)
DC-bound?:
Permissions:
Asynchronous?:
Parameters:
  • request.dc (string) – required - Datacenter name
  • hostname (string) – required - Compute node hostname
  • data.strategy (integer) – Attachment strategy (1 - Shared, 2 - Shared with limit, 3 - Reserved) (default: 1)
  • data.cpu (integer) – CPU (core) count reservation or limit (not used in Shared strategy, otherwise required)
  • data.ram (integer) – RAM size (MB) reservation or limit (not used in Shared strategy, otherwise required)
  • data.disk (integer) – Local disk pool size (MB) reservation or limit (not used in Shared strategy, otherwise required)
  • data.priority (integer) – Higher priority (0 - 9999) means that the automatic node chooser will more likely choose this node (default: 100)
Status Codes:
PUT /dc/(dc)/node/(hostname)
DC-bound?:
Permissions:
Asynchronous?:
Parameters:
  • request.dc (string) – required - Datacenter name
  • hostname (string) – required - Compute node hostname
  • data.strategy (integer) – Attachment strategy (1 - Shared, 2 - Shared with limit, 3 - Reserved)
  • data.cpu (integer) – CPU (core) count reservation or limit (not used in Shared strategy, otherwise required)
  • data.ram (integer) – RAM size (MB) reservation or limit (not used in Shared strategy, otherwise required)
  • data.disk (integer) – Local disk pool size (MB) reservation or limit (not used in Shared strategy, otherwise required)
  • data.priority (integer) – Higher priority (0 - 9999) means that the automatic node chooser will more likely choose this node
Status Codes:
DELETE /dc/(dc)/node/(hostname)
DC-bound?:
Permissions:
Asynchronous?:
Parameters:
  • request.dc (string) – required - Datacenter name
  • hostname (string) – required - Compute node hostname
Status Codes:

es example:

es create /dc/cloud1/node/node99.erigones.com -strategy 1
{
    "url": "https://my.erigones.com/api/dc/cloud1/node/node99.erigones.com/",
    "status": 200,
    "method": "POST",
    "text": {
        "status": "SUCCESS",
        "result": {
            "ram_free": 7680,
            "ram": 16384,
            "hostname": "node99.erigones.com",
            "strategy": 1,
            "priority": 100,
            "disk_free": 109772,
            "cpu_free": 3,
            "disk": 314572,
            "cpu": 8
        },
        "task_id": "1e7d23-6f75849b-8e41-4f5d-8393"
    }
}