Share via

ComputeNodeOperations Class

  • Reference

ComputeNodeOperations operations.

You should not instantiate directly this class, but create a Client instance that will create it for you and attach it as attribute.

Inheritance
builtins.object
ComputeNodeOperations

Constructor

ComputeNodeOperations(client, config, serializer, deserializer)

Parameters

Name Description
client
Required

Client for service requests.
config
Required

Configuration of service client.
serializer
Required

An object model serializer.
deserializer
Required

An object model deserializer.

Variables

Name Description
api_version

The API version to use for the request. Constant value: "2024-02-01.19.0".

Methods

add_user

Adds a user Account to the specified Compute Node.

You can add a user Account to a Compute Node only when it is in the idle or running state.
delete_user

Deletes a user Account from the specified Compute Node.

You can delete a user Account to a Compute Node only when it is in the idle or running state.
disable_scheduling

Disables Task scheduling on the specified Compute Node.

You can disable Task scheduling on a Compute Node only if its current scheduling state is enabled.
enable_scheduling

Enables Task scheduling on the specified Compute Node.

You can enable Task scheduling on a Compute Node only if its current scheduling state is disabled.
get

Gets information about the specified Compute Node.
get_remote_desktop

Gets the Remote Desktop Protocol file for the specified Compute Node.

Before you can access a Compute Node by using the RDP file, you must create a user Account on the Compute Node. This API can only be invoked on Pools created with a cloud service configuration. For Pools created with a virtual machine configuration, see the GetRemoteLoginSettings API.
get_remote_login_settings

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

Before you can remotely login to a Compute Node using the remote login settings, you must create a user Account on the Compute Node. This API can be invoked only on Pools created with the virtual machine configuration property. For Pools created with a cloud service configuration, see the GetRemoteDesktop API.
list

Lists the Compute Nodes in the specified Pool.
reboot

Restarts the specified Compute Node.

You can restart a Compute Node only if it is in an idle or running state.
reimage

Reinstalls the operating system on the specified Compute Node.

You can reinstall the operating system on a Compute Node only if it is in an idle or running state. This API can be invoked only on Pools created with the cloud service configuration property.
update_user

Updates the password and expiration time of a user Account on the specified Compute Node.

This operation replaces of all the updatable properties of the Account. For example, if the expiryTime element is not specified, the current value is replaced with the default value, not left unmodified. You can update a user Account on a Compute Node only when it is in the idle or running state.
upload_batch_service_logs

Upload Azure Batch service log files from the specified Compute Node to Azure Blob Storage.

This is for gathering Azure Batch service log files in an automated fashion from Compute Nodes if you are experiencing an error and wish to escalate to Azure support. The Azure Batch service log files should be shared with Azure support to aid in debugging issues with the Batch service.

add_user

Adds a user Account to the specified Compute Node.

You can add a user Account to a Compute Node only when it is in the idle or running state.

add_user(pool_id, node_id, user, compute_node_add_user_options=None, custom_headers=None, raw=False, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

The ID of the machine on which you want to create a user Account.
user
Required
ComputeNodeUser

The user Account to be created.
compute_node_add_user_options
ComputeNodeAddUserOptions

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
operation_config
Required

Operation configuration overrides.

Returns

Type Description
None,
<xref:msrest.pipeline.ClientRawResponse>

None or ClientRawResponse if raw=true

Exceptions

Type Description
BatchErrorException

delete_user

Deletes a user Account from the specified Compute Node.

You can delete a user Account to a Compute Node only when it is in the idle or running state.

delete_user(pool_id, node_id, user_name, compute_node_delete_user_options=None, custom_headers=None, raw=False, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

The ID of the machine on which you want to delete a user Account.
user_name
Required
str

The name of the user Account to delete.
compute_node_delete_user_options
ComputeNodeDeleteUserOptions

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
operation_config
Required

Operation configuration overrides.

Returns

Type Description
None,
<xref:msrest.pipeline.ClientRawResponse>

None or ClientRawResponse if raw=true

Exceptions

Type Description
BatchErrorException

disable_scheduling

Disables Task scheduling on the specified Compute Node.

You can disable Task scheduling on a Compute Node only if its current scheduling state is enabled.

disable_scheduling(pool_id, node_id, node_disable_scheduling_option=None, compute_node_disable_scheduling_options=None, custom_headers=None, raw=False, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

The ID of the Compute Node on which you want to disable Task scheduling.
node_disable_scheduling_option
str or DisableComputeNodeSchedulingOption

The default value is requeue. Possible values include: 'requeue', 'terminate', 'taskCompletion'

Default value: None
compute_node_disable_scheduling_options
ComputeNodeDisableSchedulingOptions

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
operation_config
Required

Operation configuration overrides.

Returns

Type Description
None,
<xref:msrest.pipeline.ClientRawResponse>

None or ClientRawResponse if raw=true

Exceptions

Type Description
BatchErrorException

enable_scheduling

Enables Task scheduling on the specified Compute Node.

You can enable Task scheduling on a Compute Node only if its current scheduling state is disabled.

enable_scheduling(pool_id, node_id, compute_node_enable_scheduling_options=None, custom_headers=None, raw=False, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

The ID of the Compute Node on which you want to enable Task scheduling.
compute_node_enable_scheduling_options
ComputeNodeEnableSchedulingOptions

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
operation_config
Required

Operation configuration overrides.

Returns

Type Description
None,
<xref:msrest.pipeline.ClientRawResponse>

None or ClientRawResponse if raw=true

Exceptions

Type Description
BatchErrorException

get

Gets information about the specified Compute Node.

get(pool_id, node_id, compute_node_get_options=None, custom_headers=None, raw=False, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

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

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
operation_config
Required

Operation configuration overrides.

Returns

Type Description
ComputeNode,
<xref:msrest.pipeline.ClientRawResponse>

ComputeNode or ClientRawResponse if raw=true

Exceptions

Type Description
BatchErrorException

get_remote_desktop

Gets the Remote Desktop Protocol file for the specified Compute Node.

Before you can access a Compute Node by using the RDP file, you must create a user Account on the Compute Node. This API can only be invoked on Pools created with a cloud service configuration. For Pools created with a virtual machine configuration, see the GetRemoteLoginSettings API.

get_remote_desktop(pool_id, node_id, compute_node_get_remote_desktop_options=None, custom_headers=None, raw=False, callback=None, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

The ID of the Compute Node for which you want to get the Remote Desktop Protocol file.
compute_node_get_remote_desktop_options
ComputeNodeGetRemoteDesktopOptions

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
callback
Callable[<xref:Bytes>, <xref:response=None>]

When specified, will be called with each chunk of data that is streamed. The callback should take two arguments, the bytes of the current chunk of data and the response object. If the data is uploading, response will be None.

Default value: None
operation_config
Required

Operation configuration overrides.

Returns

Type Description
Generator,
<xref:msrest.pipeline.ClientRawResponse>

object or ClientRawResponse if raw=true

Exceptions

Type Description
BatchErrorException

get_remote_login_settings

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

Before you can remotely login to a Compute Node using the remote login settings, you must create a user Account on the Compute Node. This API can be invoked only on Pools created with the virtual machine configuration property. For Pools created with a cloud service configuration, see the GetRemoteDesktop API.

get_remote_login_settings(pool_id, node_id, compute_node_get_remote_login_settings_options=None, custom_headers=None, raw=False, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

The ID of the Compute Node for which to obtain the remote login settings.
compute_node_get_remote_login_settings_options
ComputeNodeGetRemoteLoginSettingsOptions

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
operation_config
Required

Operation configuration overrides.

Returns

Type Description
ComputeNodeGetRemoteLoginSettingsResult,
<xref:msrest.pipeline.ClientRawResponse>

ComputeNodeGetRemoteLoginSettingsResult or ClientRawResponse if raw=true

Exceptions

Type Description
BatchErrorException

list

Lists the Compute Nodes in the specified Pool.

list(pool_id, compute_node_list_options=None, custom_headers=None, raw=False, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
operation_config
Required

Operation configuration overrides.

Returns

Type Description
ComputeNodePaged[ComputeNode]

An iterator like instance of ComputeNode

Exceptions

Type Description
BatchErrorException

reboot

Restarts the specified Compute Node.

You can restart a Compute Node only if it is in an idle or running state.

reboot(pool_id, node_id, node_reboot_option=None, compute_node_reboot_options=None, custom_headers=None, raw=False, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

The ID of the Compute Node that you want to restart.
node_reboot_option
str or ComputeNodeRebootOption

The default value is requeue. Possible values include: 'requeue', 'terminate', 'taskCompletion', 'retainedData'

Default value: None
compute_node_reboot_options
ComputeNodeRebootOptions

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
operation_config
Required

Operation configuration overrides.

Returns

Type Description
None,
<xref:msrest.pipeline.ClientRawResponse>

None or ClientRawResponse if raw=true

Exceptions

Type Description
BatchErrorException

reimage

Reinstalls the operating system on the specified Compute Node.

You can reinstall the operating system on a Compute Node only if it is in an idle or running state. This API can be invoked only on Pools created with the cloud service configuration property.

reimage(pool_id, node_id, node_reimage_option=None, compute_node_reimage_options=None, custom_headers=None, raw=False, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

The ID of the Compute Node that you want to restart.
node_reimage_option
str or ComputeNodeReimageOption

The default value is requeue. Possible values include: 'requeue', 'terminate', 'taskCompletion', 'retainedData'

Default value: None
compute_node_reimage_options
ComputeNodeReimageOptions

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
operation_config
Required

Operation configuration overrides.

Returns

Type Description
None,
<xref:msrest.pipeline.ClientRawResponse>

None or ClientRawResponse if raw=true

Exceptions

Type Description
BatchErrorException

update_user

Updates the password and expiration time of a user Account on the specified Compute Node.

This operation replaces of all the updatable properties of the Account. For example, if the expiryTime element is not specified, the current value is replaced with the default value, not left unmodified. You can update a user Account on a Compute Node only when it is in the idle or running state.

update_user(pool_id, node_id, user_name, node_update_user_parameter, compute_node_update_user_options=None, custom_headers=None, raw=False, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

The ID of the machine on which you want to update a user Account.
user_name
Required
str

The name of the user Account to update.
node_update_user_parameter
Required
NodeUpdateUserParameter

The parameters for the request.
compute_node_update_user_options
ComputeNodeUpdateUserOptions

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
operation_config
Required

Operation configuration overrides.

Returns

Type Description
None,
<xref:msrest.pipeline.ClientRawResponse>

None or ClientRawResponse if raw=true

Exceptions

Type Description
BatchErrorException

upload_batch_service_logs

Upload Azure Batch service log files from the specified Compute Node to Azure Blob Storage.

This is for gathering Azure Batch service log files in an automated fashion from Compute Nodes if you are experiencing an error and wish to escalate to Azure support. The Azure Batch service log files should be shared with Azure support to aid in debugging issues with the Batch service.

upload_batch_service_logs(pool_id, node_id, upload_batch_service_logs_configuration, compute_node_upload_batch_service_logs_options=None, custom_headers=None, raw=False, **operation_config)

Parameters

Name Description
pool_id
Required
str

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

The ID of the Compute Node from which you want to upload the Azure Batch service log files.
upload_batch_service_logs_configuration
Required
UploadBatchServiceLogsConfiguration

The Azure Batch service log files upload configuration.
compute_node_upload_batch_service_logs_options
ComputeNodeUploadBatchServiceLogsOptions

Additional parameters for the operation

Default value: None
custom_headers
dict

headers that will be added to the request

Default value: None
raw
bool

returns the direct response alongside the deserialized response

Default value: False
operation_config
Required

Operation configuration overrides.

Returns

Type Description
UploadBatchServiceLogsResult,
<xref:msrest.pipeline.ClientRawResponse>

UploadBatchServiceLogsResult or ClientRawResponse if raw=true

Exceptions

Type Description
BatchErrorException

Attributes

models 

models = <module 'azure.batch.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.9\\x64\\Lib\\site-packages\\azure\\batch\\models\\__init__.py'>