You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/batch/batch-applications-to-pool-nodes.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,9 +20,9 @@ You need to determine the scope of a file - is the file required for a pool, a j
20
20
21
21
For applications or data that need to be installed on every node in the pool, use pool start task resource files. Use this method along with either an [application package](batch-application-packages.md) or the start task's resource file collection in order to perform an install command.
22
22
23
-
For example, you can use the start task command line to move or install applications. You can also specify a list of files or containers in an Azure storage account. For more information, see [Add#ResourceFile in REST documentation](/rest/api/batchservice/pool/add#resourcefile).
23
+
For example, you can use the start task command line to move or install applications. You can also specify a list of files or containers in an Azure storage account. For more information, see [Add#ResourceFile in REST documentation](/rest/api/batchservice/pools/create-pool#resourcefile).
24
24
25
-
If every job that runs on the pool runs an application (.exe) that must first be installed with a .msi file, you'll need to set the start task's **wait for success** property to **true**. For more information, see [Add#StartTask in REST documentation](/rest/api/batchservice/pool/add#starttask).
25
+
If every job that runs on the pool runs an application (.exe) that must first be installed with a .msi file, you'll need to set the start task's **wait for success** property to **true**. For more information, see [Add#StartTask in REST documentation](/rest/api/batchmanagement/pool/create#starttask).
Copy file name to clipboardExpand all lines: articles/batch/batch-custom-images.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,7 +39,7 @@ To scale Batch pools reliably with a managed image, we recommend creating the ma
39
39
40
40
### Prepare a VM
41
41
42
-
If you're creating a new VM for the image, use a first party Azure Marketplace image supported by Batch as the base image for your managed image. Only first party images can be used as a base image. To get a full list of Azure Marketplace image references supported by Azure Batch, see [List Supported Images](/rest/api/batchservice/account/listsupportedimages).
42
+
If you're creating a new VM for the image, use a first party Azure Marketplace image supported by Batch as the base image for your managed image. Only first party images can be used as a base image. To get a full list of Azure Marketplace image references supported by Azure Batch, see [List Supported Images](/rest/api/batchservice/pools/list-supported-images).
43
43
44
44
> [!NOTE]
45
45
> You can't use a third-party image that has additional license and purchase terms as your base image. For information about these Marketplace images, see the guidance for [Linux](/azure/virtual-machines/linux/cli-ps-findimage#check-the-purchase-plan-information) or [Windows](/azure/virtual-machines/windows/cli-ps-findimage#view-purchase-plan-properties) VMs.
@@ -138,7 +138,7 @@ Also note the following considerations:
-**Resizetimeout**-Ifyourpoolcontainsafixednumberofnodes (doesn't autoscale), increase the resizeTimeout property of the pool to a value such as 20-30 minutes. If your pool doesn'treachitstargetsizewithinthetimeoutperiod, performanother [resizeoperation](/rest/api/batchservice/pool/resize).
141
+
-**Resizetimeout**-Ifyourpoolcontainsafixednumberofnodes (doesn't autoscale), increase the resizeTimeout property of the pool to a value such as 20-30 minutes. If your pool doesn'treachitstargetsizewithinthetimeoutperiod, performanother [resizeoperation](/rest/api/batchservice/pools/resize-pool).
Copy file name to clipboardExpand all lines: articles/batch/batch-customer-managed-key.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -215,7 +215,7 @@ az batch account set \
215
215
-**How can I rotate my keys?** Customer-managed keys aren't automatically rotated unless the [key is versionless with an appropriate key rotation policy set within Key Vault](/azure/key-vault/keys/how-to-configure-key-rotation). To manually rotate the key, update the Key Identifier that the account is associated with.
216
216
-**After I restore access how long will it take for the Batch account to work again?** It can take up to 10 minutes for the account to be accessible again once access is restored.
217
217
-**While the Batch Account is unavailable what happens to my resources?** Any pools that are active when Batch access to the customer-managed key is lost will continue to run. However, the nodes in these pools will transition into an unavailable state, and tasks will stop running (and be requeued). Once access is restored, nodes become available again, and tasks are restarted.
218
-
- **Does this encryption mechanism apply to VM disks in a Batch pool?** No. For Cloud Services Configuration pools (which are [deprecated](https://azure.microsoft.com/updates/azure-batch-cloudserviceconfiguration-pools-will-be-retired-on-29-february-2024/)), no encryption is applied for the OS and temporary disk. For Virtual Machine Configuration pools, the OS and any specified data disks are encrypted with a Microsoft platform managed key by default. Currently, you can't specify your own key for these disks. To encrypt the temporary disk of VMs for a Batch pool with a Microsoft platform managed key, you must enable the [diskEncryptionConfiguration](/rest/api/batchservice/pool/add#diskencryptionconfiguration) property in your [Virtual Machine Configuration](/rest/api/batchservice/pool/add#virtualmachineconfiguration) Pool. For highly sensitive environments, we recommend enabling temporary disk encryption and avoiding storing sensitive data on OS and data disks. For more information, see [Create a pool with disk encryption enabled](./disk-encryption.md)
218
+
- **Does this encryption mechanism apply to VM disks in a Batch pool?** No. For Cloud Services Configuration pools (which are [deprecated](https://azure.microsoft.com/updates/azure-batch-cloudserviceconfiguration-pools-will-be-retired-on-29-february-2024/)), no encryption is applied for the OS and temporary disk. For Virtual Machine Configuration pools, the OS and any specified data disks are encrypted with a Microsoft platform managed key by default. Currently, you can't specify your own key for these disks. To encrypt the temporary disk of VMs for a Batch pool with a Microsoft platform managed key, you must enable the [diskEncryptionConfiguration](/rest/api/batchservice/pools/create-pool#diskencryptionconfiguration) property in your [Virtual Machine Configuration](/rest/api/batchservice/pools/create-pool#virtualmachineconfiguration) Pool. For highly sensitive environments, we recommend enabling temporary disk encryption and avoiding storing sensitive data on OS and data disks. For more information, see [Create a pool with disk encryption enabled](./disk-encryption.md)
219
219
-**Is the system-assigned managed identity on the Batch account available on the compute nodes?** No. The system-assigned managed identity is currently used only for accessing the Azure Key Vault for the customer-managed key. To use a user-assigned managed identity on compute nodes, see [Configure managed identities in Batch pools](managed-identity-pools.md).
Copy file name to clipboardExpand all lines: articles/batch/batch-efficient-list-queries.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -52,7 +52,7 @@ You can use the [Batch .NET](/dotnet/api/microsoft.azure.batch) and [Batch REST]
52
52
53
53
For the Batch .NET API, see the [ODATADetailLevel Class properties](/dotnet/api/microsoft.azure.batch.odatadetaillevel#properties). Also review the section [Efficient querying in Batch .NET](#efficient-querying-in-batch-net).
54
54
55
-
For the Batch REST API, see the [Batch REST API reference](/rest/api/batchservice/). Find the **List** reference for the resource you want to query. Then, review the **URI Parameters** section for details about `$filter`, `$select`, and `$expand`. For example, see the [URI parameters for Pool - List](/rest/api/batchservice/pool/list#uri-parameters). Also see [how to make efficient Batch queries with the Azure CLI](batch-cli-get-started.md#query-batch-resources-efficiently).
55
+
For the Batch REST API, see the [Batch REST API reference](/rest/api/batchservice/). Find the **List** reference for the resource you want to query. Then, review the **URI Parameters** section for details about `$filter`, `$select`, and `$expand`. For example, see the [URI parameters for Pool - List](/rest/api/batchservice/pools/create-pool#uri-parameters). Also see [how to make efficient Batch queries with the Azure CLI](batch-cli-get-started.md#query-batch-resources-efficiently).
56
56
57
57
> [!NOTE]
58
58
> When constructing any of the three query string types, you must ensure that the property names and case match that of their REST API element counterparts. For example, when working with the .NET [CloudTask](/dotnet/api/microsoft.azure.batch.cloudtask) class, you must specify **state** instead of **State**, even though the .NET property is [CloudTask.State](/dotnet/api/microsoft.azure.batch.cloudtask.state#Microsoft_Azure_Batch_CloudTask_State). For more information, see the [property mappings between the .NET and REST APIs](#mappings-for-select-strings).
@@ -141,16 +141,16 @@ Property names in filter, select, and expand strings must reflect their REST API
141
141
142
142
| .NET list methods | REST list requests |
143
143
| --- | --- |
144
-
|[CertificateOperations.ListCertificates](/dotnet/api/microsoft.azure.batch.certificateoperations)|[List the certificates in an account](/rest/api/batchservice/certificate/list)|
144
+
|[CertificateOperations.ListCertificates](/dotnet/api/microsoft.azure.batch.certificateoperations)|[List the certificates in an account](/rest/api/batchmanagement/certificate/list-by-batch-account)|
145
145
|[CloudTask.ListNodeFiles](/dotnet/api/microsoft.azure.batch.cloudtask)|[List the files associated with a task](/rest/api/batchservice/file/listfromtask)|
146
146
|[JobOperations.ListJobPreparationAndReleaseTaskStatus](/dotnet/api/microsoft.azure.batch.joboperations)|[List the status of the job preparation and job release tasks for a job](/rest/api/batchservice/job/listpreparationandreleasetaskstatus)|
147
-
|[JobOperations.ListJobs](/dotnet/api/microsoft.azure.batch.joboperations)|[List the jobs in an account](/rest/api/batchservice/job/list)|
147
+
|[JobOperations.ListJobs](/dotnet/api/microsoft.azure.batch.joboperations)|[List the jobs in an account](/rest/api/batchservice/jobs/list-jobs-from-schedule)|
148
148
|[JobOperations.ListNodeFiles](/dotnet/api/microsoft.azure.batch.joboperations)|[List the files on a node](/rest/api/batchservice/file/listfromcomputenode)|
149
-
|[JobOperations.ListTasks](/dotnet/api/microsoft.azure.batch.joboperations)|[List the tasks associated with a job](/rest/api/batchservice/task/list)|
149
+
|[JobOperations.ListTasks](/dotnet/api/microsoft.azure.batch.joboperations)|[List the tasks associated with a job](/rest/api/batchservice/tasks/list-tasks)|
150
150
|[JobScheduleOperations.ListJobSchedules](/dotnet/api/microsoft.azure.batch.jobscheduleoperations)|[List the job schedules in an account](/rest/api/batchservice/jobschedule/list)|
151
151
|[JobScheduleOperations.ListJobs](/dotnet/api/microsoft.azure.batch.jobscheduleoperations)|[List the jobs associated with a job schedule](/rest/api/batchservice/job/listfromjobschedule)|
152
-
|[PoolOperations.ListComputeNodes](/dotnet/api/microsoft.azure.batch.pooloperations)|[List the compute nodes in a pool](/rest/api/batchservice/computenode/list)|
153
-
|[PoolOperations.ListPools](/dotnet/api/microsoft.azure.batch.pooloperations)|[List the pools in an account](/rest/api/batchservice/pool/list)|
152
+
|[PoolOperations.ListComputeNodes](/dotnet/api/microsoft.azure.batch.pooloperations)|[List the compute nodes in a pool](/rest/api/batchservice/nodes/list-nodes)|
153
+
|[PoolOperations.ListPools](/dotnet/api/microsoft.azure.batch.pooloperations)|[List the pools in an account](/rest/api/batchservice/pools/list-pools)|
154
154
155
155
### Mappings for select strings
156
156
@@ -159,16 +159,16 @@ Property names in filter, select, and expand strings must reflect their REST API
159
159
160
160
| Batch .NET types | REST API entities |
161
161
| --- | --- |
162
-
|[Certificate](/dotnet/api/microsoft.azure.batch.certificate)|[Get information about a certificate](/rest/api/batchservice/certificate/get)|
162
+
|[Certificate](/dotnet/api/microsoft.azure.batch.certificate)|[Get information about a certificate](/rest/api/batchmanagement/certificate/get)|
163
163
|[CloudJob](/dotnet/api/microsoft.azure.batch.cloudjob)|[Get information about a job](/rest/api/batchservice/job/get)|
164
-
|[CloudJobSchedule](/dotnet/api/microsoft.azure.batch.cloudjobschedule)|[Get information about a job schedule](/rest/api/batchservice/jobschedule/get)|
164
+
|[CloudJobSchedule](/dotnet/api/microsoft.azure.batch.cloudjobschedule)|[Get information about a job schedule](/rest/api/batchservice/jobs/get-job)|
165
165
|[ComputeNode](/dotnet/api/microsoft.azure.batch.computenode)|[Get information about a node](/rest/api/batchservice/computenode/get)|
166
-
|[CloudPool](/dotnet/api/microsoft.azure.batch.cloudpool)|[Get information about a pool](/rest/api/batchservice/pool/get)|
167
-
|[CloudTask](/dotnet/api/microsoft.azure.batch.cloudtask)|[Get information about a task](/rest/api/batchservice/task/get)|
166
+
|[CloudPool](/dotnet/api/microsoft.azure.batch.cloudpool)|[Get information about a pool](/rest/api/batchservice/pools/get-pool)|
167
+
|[CloudTask](/dotnet/api/microsoft.azure.batch.cloudtask)|[Get information about a task](/rest/api/batchservice/tasks/get-task)|
168
168
169
169
## Example: construct a filter string
170
170
171
-
To construct a filter string for [ODATADetailLevel.FilterClause](/dotnet/api/microsoft.azure.batch.odatadetaillevel.filterclause), find the [corresponding REST API page](#mappings-for-filter-strings). Selectable properties and their supported operators are in the first multi-row table. For example, to retrieve all tasks whose exit code was nonzero, check [List the tasks associated with a job](/rest/api/batchservice/task/list) for the applicable property string and allowable operators:
171
+
To construct a filter string for [ODATADetailLevel.FilterClause](/dotnet/api/microsoft.azure.batch.odatadetaillevel.filterclause), find the [corresponding REST API page](#mappings-for-filter-strings). Selectable properties and their supported operators are in the first multi-row table. For example, to retrieve all tasks whose exit code was nonzero, check [List the tasks associated with a job](/rest/api/batchservice/tasks/list-tasks) for the applicable property string and allowable operators:
172
172
173
173
| Property | Operations allowed | Type |
174
174
|:--- |:--- |:--- |
@@ -180,7 +180,7 @@ The related filter string is:
180
180
181
181
## Example: construct a select string
182
182
183
-
To construct [ODATADetailLevel.SelectClause](/dotnet/api/microsoft.azure.batch.odatadetaillevel.selectclause), find the [corresponding REST API page](#mappings-for-filter-strings) for the entity that you're listing. Selectable properties and their supported operators are in the first multi-row table. For example, to retrieve only the ID and command line for each task in a list, check [Get information about a task](/rest/api/batchservice/task/get):
183
+
To construct [ODATADetailLevel.SelectClause](/dotnet/api/microsoft.azure.batch.odatadetaillevel.selectclause), find the [corresponding REST API page](#mappings-for-filter-strings) for the entity that you're listing. Selectable properties and their supported operators are in the first multi-row table. For example, to retrieve only the ID and command line for each task in a list, check [Get information about a task](/rest/api/batchservice/tasks/get-task):
Copy file name to clipboardExpand all lines: articles/batch/batch-get-resource-counts.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,9 +21,9 @@ At times, the numbers returned by these operations may not be up to date. If you
21
21
The `Get` Task Counts operation counts tasks by the following states:
22
22
23
23
-**Active**: A task that's queued and ready to run but isn't currently assigned to any compute node. A task is also `active` if it's [dependent on a parent task](batch-task-dependencies.md) that hasn't yet completed.
24
-
-**Running**: A task that has been assigned to a compute node but hasn't yet finished. A task is counted as `running` when its state is either `preparing` or `running`, as indicated by the [`Get`information about a task](/rest/api/batchservice/task/get) operation.
24
+
-**Running**: A task that has been assigned to a compute node but hasn't yet finished. A task is counted as `running` when its state is either `preparing` or `running`, as indicated by the [`Get`information about a task](/rest/api/batchservice/tasks/get-task) operation.
25
25
-**Completed**: A task that's no longer eligible to run, because it either finished successfully, or finished unsuccessfully and also exhausted its retry limit.
26
-
-**Succeeded**: A task where the result of task execution is `success`. Batch determines whether a task has succeeded or failed by checking the `TaskExecutionResult` property of the [executionInfo](/rest/api/batchservice/task/get) property.
26
+
-**Succeeded**: A task where the result of task execution is `success`. Batch determines whether a task has succeeded or failed by checking the `TaskExecutionResult` property of the [executionInfo](/rest/api/batchservice/tasks/get-task) property.
27
27
-**Failed**: A task where the result of task execution is `failure`.
28
28
29
29
The following .NET code sample shows how to retrieve task counts by state.
@@ -53,7 +53,7 @@ The List Pool Node Counts operation counts compute nodes by the following states
53
53
-**Reimaging**: A node where the OS is being reinstalled.
54
54
-**Running** : A node that is running one or more tasks (other than the start task).
55
55
-**Starting**: A node where the Batch service is starting up.
56
-
-**StartTaskFailed**: A node where the [start task](/rest/api/batchservice/pool/add#starttask) failed after all retries, and `waitForSuccess` is enabled. This node cannot run tasks.
56
+
-**StartTaskFailed**: A node where the [start task](/rest/api/batchmanagement/pool/create#starttask) failed after all retries, and `waitForSuccess` is enabled. This node cannot run tasks.
57
57
-**Unknown**: A node that lost contact with the Batch service and whose state isn't known.
58
58
-**Unusable**: A node that can't be used for task execution because of errors.
59
59
-**WaitingForStartTask**: A node on which the start task is running, but `waitForSuccess` is enabled and it hasn't completed.
0 commit comments