Skip to content

Commit 2d39ab4

Browse files
authored
Fixing the Acrolinx for Correctness score
1 parent 4d3fed8 commit 2d39ab4

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

articles/batch/batch-get-resource-counts.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -9,19 +9,19 @@ ms.devlang: csharp
99

1010
To monitor and manage large-scale Azure Batch solutions, you may need to determine counts of resources in various states. Azure Batch provides efficient operations to get counts for Batch tasks and compute nodes. You can use these operations instead of potentially time-consuming list queries that return detailed information about large collections of tasks or nodes.
1111

12-
- [Get Task Counts](/rest/api/batchservice/job/gettaskcounts) gets an aggregate count of active, running, and completed tasks in a job, and of tasks that succeeded or failed. By counting tasks in each state, you can more easily display job progress to a user, or detect unexpected delays or failures that may affect the job.
12+
- [Get Task Counts](/rest/api/batchservice/job/gettaskcounts) gets an aggregate count of active, running, and completed tasks in a job, and of tasks that succeeded or failed. By counting tasks in each state, you can easily display job progress to a user, or detect unexpected delays or failures that may affect the job.
1313

1414
- [List Pool Node Counts](/rest/api/batchservice/account/listpoolnodecounts) gets the number of dedicated and [Spot compute nodes](batch-spot-vms.md) in each pool that are in various states: creating, idle, offline, preempted, rebooting, reimaging, starting, and others. By counting nodes in each state, you can determine when you have adequate compute resources to run your jobs, and identify potential issues with your pools.
1515

16-
Note that at times, the numbers returned by these operations may not be up to date. If you need to be sure that a count is accurate, use a list query to count these resources. List queries also let you get information about other Batch resources such as applications. For more information about applying filters to list queries, see [Create queries to list Batch resources efficiently](batch-efficient-list-queries.md).
16+
At times, the numbers returned by these operations may not be up to date. If you need to be sure that a count is accurate, use a list query to count these resources. List queries also let you get information about other Batch resources such as applications. For more information about applying filters to list queries, see [Create queries to list Batch resources efficiently](batch-efficient-list-queries.md).
1717

1818
## Task state counts
1919

20-
The Get Task Counts operation counts tasks by the following states:
20+
The `Get` Task Counts operation counts tasks by the following states:
2121

22-
- **Active**: A task that is queued and able to run, but is not currently assigned to a compute node. A task is also `active` if it is [dependent on a parent task](batch-task-dependencies.md) that has not yet completed.
23-
- **Running**: A task that has been assigned to a compute node, but has not yet completed. 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-
- **Completed**: A task that is no longer eligible to run, because it either finished successfully, or finished unsuccessfully and also exhausted its retry limit.
22+
- **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.
23+
- **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+
- **Completed**: A task that's no longer eligible to run, because it either finished successfully, or finished unsuccessfully and also exhausted its retry limit.
2525
- **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.
2626
- **Failed**: A task where the result of task execution is `failure`.
2727

@@ -43,19 +43,19 @@ You can use a similar pattern for REST and other supported languages to get task
4343

4444
The List Pool Node Counts operation counts compute nodes by the following states in each pool. Separate aggregate counts are provided for dedicated nodes and Spot nodes in each pool.
4545

46-
- **Creating**: An Azure-allocated VM that has not yet started to join a pool.
47-
- **Idle**: An available compute node that is not currently running a task.
46+
- **Creating**: An Azure-allocated VM that hasn't yet started to join a pool.
47+
- **Idle**: A compute node that's availale and currently not running any tasks.
4848
- **LeavingPool**: A node that is leaving the pool, either because the user explicitly removed it or because the pool is resizing or autoscaling down.
4949
- **Offline**: A node that Batch cannot use to schedule new tasks.
5050
- **Preempted**: A Spot node that was removed from the pool because Azure reclaimed the VM. A `preempted` node can be reinitialized when replacement Spot VM capacity is available.
5151
- **Rebooting**: A node that is restarting.
52-
- **Reimaging**: A node on which the operating system is being reinstalled.
52+
- **Reimaging**: A node where the OS is being reinstalled.
5353
- **Running** : A node that is running one or more tasks (other than the start task).
54-
- **Starting**: A node on which the Batch service is starting.
55-
- **StartTaskFailed**: A node on which the [start task](/rest/api/batchservice/pool/add#starttask) failed and exhausted all retries, and on which `waitForSuccess` is set on the start task. The node is not usable for running tasks.
54+
- **Starting**: A node where the Batch service is starting up.
55+
- **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.
5656
- **Unknown**: A node that lost contact with the Batch service and whose state isn't known.
5757
- **Unusable**: A node that can't be used for task execution because of errors.
58-
- **WaitingForStartTask**: A node on which the start task started running, but `waitForSuccess` is set and the start task has not completed.
58+
- **WaitingForStartTask**: A node on which the start task is running, but `waitForSuccess` is enabled and it hasn't completed.
5959

6060
The following C# snippet shows how to list node counts for all pools in the current account:
6161

0 commit comments

Comments
 (0)