az batch node

Manage Batch compute nodes.

Commands

Name Description Type Status
az batch node delete

Removes Compute Nodes from the specified Pool.

Core GA
az batch node file

Manage Batch compute node files.

Core GA
az batch node file delete

Deletes the specified file from the Compute Node.

Core GA
az batch node file download

Download the content of the a node file.

Core GA
az batch node file list

Lists all of the files in Task directories on the specified Compute Node.

Core GA
az batch node file show

Gets the properties of the specified Compute Node file.

Core GA
az batch node list

Lists the Compute Nodes in the specified Pool.

Core GA
az batch node reboot

Reboot a Batch compute node.

Core GA
az batch node remote-login-settings

Retrieve the remote login settings for a Batch compute node.

Core GA
az batch node remote-login-settings show

Gets the settings required for remote login to a Compute Node.

Core GA
az batch node scheduling

Manage task scheduling for a Batch compute node.

Core GA
az batch node scheduling disable

Disable scheduling on a Batch compute node.

Core GA
az batch node scheduling enable

Enable scheduling on a Batch compute node.

Core GA
az batch node service-logs

Manage the service log files of a Batch compute node.

Core GA
az batch node service-logs upload

Upload service logs from a specified Batch compute node.

Core GA
az batch node show

Gets information about the specified Compute Node.

Core GA
az batch node user

Manage the user accounts of a Batch compute node.

Core GA
az batch node user create

Add a user account to a Batch compute node.

Core GA
az batch node user delete

Deletes a user Account from the specified Compute Node.

Core GA
az batch node user reset

Update the properties of a user account on a Batch compute node. Unspecified properties which can be updated are reset to their defaults.

Core GA

az batch node delete

Removes Compute Nodes from the specified Pool.

This operation can only run when the allocation state of the Pool is steady. When this operation runs, the allocation state changes from steady to resizing. Each request may remove up to 100 nodes.

Azure CLI
az batch node delete --pool-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--json-file]
                     [--node-deallocation-option]
                     [--node-list]
                     [--resize-timeout]

Required Parameters

--pool-id

The ID of the Pool to get. Required.

Optional Parameters

--account-endpoint

Batch service endpoint. Alternatively, set by environment variable: AZURE_BATCH_ENDPOINT.

--account-key

Batch account key. Alternatively, set by environment variable: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch account name. Alternatively, set by environment variable: AZURE_BATCH_ACCOUNT.

--if-match

An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the service exactly matches the value specified by the client.

--if-modified-since

A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has been modified since the specified time.

--if-none-match

An ETag value associated with the version of the resource known to the client. The operation will be performed only if the resource's current ETag on the service does not match the value specified by the client.

--if-unmodified-since

A timestamp indicating the last modified time of the resource known to the client. The operation will be performed only if the resource on the service has been modified since the specified time.

--json-file

A file containing the content specification in JSON (formatted to match the respective REST API body). If this parameter is specified, all 'Content Arguments' are ignored.

--node-deallocation-option

Determines what to do with a Compute Node and its running task(s) after it has been selected for deallocation. The default value is requeue. Known values are: "requeue", "terminate", "taskcompletion", and "retaineddata".

--node-list

A list containing the IDs of the Compute Nodes to be removed from the specified Pool. A maximum of 100 nodes may be removed per request. Required. Space-separated values.

--resize-timeout

The timeout for removal of Compute Nodes to the Pool. The default value is 15 minutes. The minimum value is 5 minutes. If you specify a value less than 5 minutes, the Batch service returns an error; if you are calling the REST API directly, the HTTP status code is 400 (Bad Request). Expected format is an ISO-8601 duration.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az batch node list

Lists the Compute Nodes in the specified Pool.

Azure CLI
az batch node list --pool-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--filter]
                   [--select]

Required Parameters

--pool-id

The ID of the Pool from which you want to list Compute Nodes. Required.

Optional Parameters

--account-endpoint

Batch service endpoint. Alternatively, set by environment variable: AZURE_BATCH_ENDPOINT.

--account-key

Batch account key. Alternatively, set by environment variable: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch account name. Alternatively, set by environment variable: AZURE_BATCH_ACCOUNT.

--filter

An OData $filter clause. For more information on constructing this filter,see https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.

--select

An OData $select clause.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az batch node reboot

Reboot a Batch compute node.

Azure CLI
az batch node reboot --node-id
                     --pool-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--json-file]
                     [--node-reboot-option]

Examples

Reboot the node and requeue tasks.

Azure CLI
az batch node reboot --pool-id pool1 --node-id node1

Reboot the node when tasks complete.

Azure CLI
az batch node reboot --pool-id pool1 --node-id node1 --node-reboot-option taskcompletion

Required Parameters

--node-id

The ID of the Compute Node that you want to restart. Required.

--pool-id

The ID of the Pool that contains the Compute Node. Required.

Optional Parameters

--account-endpoint

Batch service endpoint. Alternatively, set by environment variable: AZURE_BATCH_ENDPOINT.

--account-key

Batch account key. Alternatively, set by environment variable: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch account name. Alternatively, set by environment variable: AZURE_BATCH_ACCOUNT.

--json-file

A file containing the parameters specification in JSON (formatted to match the respective REST API body). If this parameter is specified, all 'Parameters Arguments' are ignored.

--node-reboot-option

When to reboot the Compute Node and what to do with currently running Tasks. The default value is requeue. Known values are: "requeue", "terminate", "taskcompletion", and "retaineddata".

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az batch node show

Gets information about the specified Compute Node.

Azure CLI
az batch node show --node-id
                   --pool-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--select]

Required Parameters

--node-id

The ID of the Compute Node that you want to get information about. Required.

--pool-id

The ID of the Pool that contains the Compute Node. Required.

Optional Parameters

--account-endpoint

Batch service endpoint. Alternatively, set by environment variable: AZURE_BATCH_ENDPOINT.

--account-key

Batch account key. Alternatively, set by environment variable: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch account name. Alternatively, set by environment variable: AZURE_BATCH_ACCOUNT.

--select

An OData $select clause.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.