nodes

Note:

This is a legacy API. This endpoint is deprecated, disabled by default in new installations, and slated to be removed entirely in a future major release of Arvados. It is replaced by cloud dispatcher API.

API endpoint base: https://pirca.arvadosapi.com/arvados/v1/nodes

Object type: 7ekkf

Example UUID: zzzzz-7ekkf-0123456789abcde

Resource

Node resources list compute nodes on which Crunch may schedule work.

Each Node has, in addition to the Common resource fields:

Attribute Type Description Example
slot_number integer
hostname string
domain string
ip_address string
job_uuid string The UUID of the job that this node is assigned to work on. If you do not have permission to read the job, this will be null.
first_ping_at datetime
last_ping_at datetime
info hash Sensitive information about the node (only visible to admin) such as ‘ping_secret’ and ‘ec2_instance_id’. May be used in queries using subproperty filters
properties hash Public information about the node, such as ‘total_cpu_cores’, ‘total_ram_mb’, and ‘total_scratch_mb’. May be used in queries using subproperty filters

Methods

See Common resource methods for more information about create, delete, get, list, and update.

Required arguments are displayed in green.

create

Create a new Node.

Arguments:

Argument Type Description Location Example
node object query

delete

Delete an existing Node.

Arguments:

Argument Type Description Location Example
uuid string The UUID of the Node in question. path

get

Gets a Node’s metadata by UUID.

Arguments:

Argument Type Description Location Example
uuid string The UUID of the Node in question. path

list

List nodes.

See common resource list method.

ping

Process a ping from a compute node.

Arguments:

Argument Type Description Location Example
ping_secret string query
uuid string path

update

Update attributes of an existing Node.

Arguments:

Argument Type Description Location Example
uuid string The UUID of the Node in question. path
node object query

To remove a node’s job assignment, update the node object’s job_uuid to null.


Previous: pipeline_templates Next: repositories

The content of this documentation is licensed under the Creative Commons Attribution-Share Alike 3.0 United States licence.
Code samples in this documentation are licensed under the Apache License, Version 2.0.