Account - List Pool Node Counts

Referencia

Servicio:: Batch Service

Versión de la API:: 2024-07-01.20.0

Obtiene el número de nodos de proceso en cada estado, agrupados por grupo. Tenga en cuenta que es posible que los números devueltos no siempre estén actualizados. Si necesita recuentos exactos de nodos, use una consulta de lista.

GET {batchUrl}/nodecounts?api-version=2024-07-01.20.0

Con parámetros opcionales:

GET {batchUrl}/nodecounts?$filter={$filter}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
batchUrl	path	True	string	Dirección URL base de todas las solicitudes de servicio de Azure Batch.
api-version	query	True	string	Versión de la API de cliente.
$filter	query		string	Una cláusula $filter de OData. Para obtener más información sobre cómo construir este filtro, vea https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.
maxresults	query		integer int32	Número máximo de elementos que se van a devolver en la respuesta.
timeout	query		integer int32	Tiempo máximo que el servidor puede dedicar a procesar la solicitud, en segundos. El valor predeterminado es 30 segundos. Si el valor es mayor que 30, se usará el valor predeterminado en su lugar.

Encabezado de la solicitud

Media Types: "application/json; odata=minimalmetadata"

Nombre	Tipo	Description
client-request-id	string uuid	La identidad de solicitud generada por el autor de la llamada, en forma de GUID sin decoración como llaves, por ejemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Si el servidor debe devolver el client-request-id en la respuesta.
ocp-date	string date-time-rfc1123	Hora en que se emitió la solicitud. Las bibliotecas cliente suelen establecer esto en la hora del reloj del sistema actual; establézcalo explícitamente si llama directamente a la API REST.

Respuestas

Nombre	Tipo	Description
200 OK	PoolNodeCountsListResult	La respuesta contiene el número de nodos de proceso en cada estado de nodo de proceso, agrupado por Grupo. Encabezados client-request-id: string request-id: string
Other Status Codes	BatchError	Error del servicio Batch.

Nombre

Tipo

Description

200 OK

PoolNodeCountsListResult

La respuesta contiene el número de nodos de proceso en cada estado de nodo de proceso, agrupado por Grupo.

Encabezados

client-request-id: string
request-id: string

Other Status Codes

BatchError

Error del servicio Batch.

Seguridad

azure_auth

Flujo de código de autenticación de Microsoft Entra OAuth 2.0

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	Suplantar la cuenta de usuario

Authorization

Tipo: apiKey
En: header

Ejemplos

NodeCountsPayload

Solicitud de ejemplo

HTTP

GET account.region.batch.azure.com/nodecounts?api-version=2024-07-01.20.0

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "poolId": "pool1",
      "dedicated": {
        "creating": 0,
        "deallocated": 0,
        "deallocating": 0,
        "idle": 0,
        "leavingPool": 0,
        "offline": 0,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 0,
        "running": 0,
        "starting": 0,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "upgradingOS": 0,
        "total": 0
      },
      "lowPriority": {
        "creating": 0,
        "deallocated": 0,
        "deallocating": 0,
        "idle": 0,
        "leavingPool": 0,
        "offline": 0,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 0,
        "running": 2,
        "starting": 1,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "upgradingOS": 0,
        "total": 3
      }
    },
    {
      "poolId": "pool2",
      "dedicated": {
        "creating": 0,
        "deallocated": 0,
        "deallocating": 0,
        "idle": 1,
        "leavingPool": 0,
        "offline": 3,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 0,
        "running": 0,
        "starting": 0,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "upgradingOS": 0,
        "total": 4
      },
      "lowPriority": {
        "creating": 0,
        "deallocated": 0,
        "deallocating": 0,
        "idle": 0,
        "leavingPool": 0,
        "offline": 0,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 0,
        "running": 0,
        "starting": 0,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "upgradingOS": 0,
        "total": 0
      }
    },
    {
      "poolId": "pool3",
      "dedicated": {
        "creating": 0,
        "deallocated": 0,
        "deallocating": 0,
        "idle": 5,
        "leavingPool": 0,
        "offline": 0,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 4,
        "running": 0,
        "starting": 0,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "upgradingOS": 0,
        "total": 9
      },
      "lowPriority": {
        "creating": 7,
        "deallocated": 0,
        "deallocating": 0,
        "idle": 0,
        "leavingPool": 0,
        "offline": 0,
        "preempted": 0,
        "rebooting": 0,
        "reimaging": 0,
        "running": 4,
        "starting": 0,
        "startTaskFailed": 0,
        "unknown": 0,
        "unusable": 0,
        "waitingForStartTask": 0,
        "upgradingOS": 0,
        "total": 11
      }
    }
  ]
}

Definiciones

Nombre	Description
BatchError	Respuesta de error recibida del servicio Azure Batch.
BatchErrorDetail	Un elemento de información adicional incluida en una respuesta de error de Azure Batch.
ErrorMessage	Mensaje de error recibido en una respuesta de error de Azure Batch.
NodeCounts	Número de nodos de proceso en cada estado de nodo de proceso.
PoolNodeCounts	Número de nodos de proceso en cada estado de un grupo.
PoolNodeCountsListResult	Resultado de enumerar los recuentos de nodos de proceso en la cuenta.

BatchError

Respuesta de error recibida del servicio Azure Batch.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
message	ErrorMessage	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
values	BatchErrorDetail[]	Colección de pares clave-valor que contienen detalles adicionales sobre el error.

BatchErrorDetail

Un elemento de información adicional incluida en una respuesta de error de Azure Batch.

Nombre	Tipo	Description
key	string	Identificador que especifica el significado de la propiedad Value.
value	string	La información adicional incluida con la respuesta de error.

ErrorMessage

Mensaje de error recibido en una respuesta de error de Azure Batch.

Nombre	Tipo	Description
lang	string	El código de idioma del mensaje de error
value	string	Texto del mensaje.

NodeCounts

Número de nodos de proceso en cada estado de nodo de proceso.

Nombre	Tipo	Description
creating	integer	Número de nodos de proceso en el estado de creación.
deallocated	integer	Número de nodos de proceso en el estado desasignado.
deallocating	integer	Número de nodos de proceso en el estado de desasignación.
idle	integer	Número de nodos de proceso en estado inactivo.
leavingPool	integer	Número de nodos de proceso en el estado leavingPool.
offline	integer	Número de nodos de proceso en estado sin conexión.
preempted	integer	Número de nodos de proceso en estado adelantado.
rebooting	integer	Recuento de nodos de proceso en el estado de reinicio.
reimaging	integer	Número de nodos de proceso en el estado de restablecimiento de imagen.
running	integer	Número de nodos de proceso en estado en ejecución.
startTaskFailed	integer	Número de nodos de proceso en el estado startTaskFailed.
starting	integer	Número de nodos de proceso en el estado inicial.
total	integer	Número total de nodos de proceso.
unknown	integer	Número de nodos de proceso en el estado desconocido.
unusable	integer	Número de nodos de proceso en estado inutilizable.
upgradingOS	integer	Número de nodos de proceso en el estado upgradeOS.
waitingForStartTask	integer	Número de nodos de proceso en estado waitingForStartTask.

PoolNodeCounts

Número de nodos de proceso en cada estado de un grupo.

Nombre	Tipo	Description
dedicated	NodeCounts	Número de nodos de proceso dedicados en cada estado.
lowPriority	NodeCounts	Número de nodos de proceso de prioridad baja o de acceso puntual en cada estado.
poolId	string	Identificador del grupo.

PoolNodeCountsListResult

Resultado de enumerar los recuentos de nodos de proceso en la cuenta.

Nombre	Tipo	Description
odata.nextLink	string	Dirección URL para obtener el siguiente conjunto de resultados.
value	PoolNodeCounts[]	Lista de recuentos de nodos de proceso por grupo.

Compartir a través de

Account - List Pool Node Counts

Parámetros de identificador URI

Encabezado de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Authorization

Ejemplos

NodeCountsPayload

Solicitud de ejemplo

Respuesta de muestra

Definiciones

BatchError

BatchErrorDetail

ErrorMessage

NodeCounts

PoolNodeCounts

PoolNodeCountsListResult

Recursos adicionales