Compute Node - List
Enumera los nodos de proceso del grupo especificado.
GET {batchUrl}/pools/{poolId}/nodes?api-version=2024-07-01.20.0
GET {batchUrl}/pools/{poolId}/nodes?$filter={$filter}&$select={$select}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Dirección URL base de todas las solicitudes de servicio de Azure Batch. |
pool
|
path | True |
string |
Identificador del grupo desde el que desea enumerar los nodos de proceso. |
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://docs.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-nodes-in-a-pool. |
|
$select
|
query |
string |
Una cláusula $select de OData. |
|
maxresults
|
query |
integer int32 |
Número máximo de elementos que se van a devolver en la respuesta. Se puede devolver un máximo de 1000 nodos de proceso. |
|
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 | Requerido | 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 |
Respuesta que contiene la lista de nodos de proceso. Encabezados
|
|
Other Status Codes |
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
Node list
Solicitud de ejemplo
GET account.region.batch.azure.com/pools/poolId/nodes?api-version=2024-07-01.20.0
Respuesta de muestra
{
"value": [
{
"id": "tvm-1695681911_1-20161122t193202z",
"url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z",
"state": "idle",
"schedulingState": "enabled",
"stateTransitionTime": "2016-11-22T22:22:27.2236818Z",
"lastBootTime": "2016-11-22T22:22:24.4634125Z",
"allocationTime": "2016-11-22T19:32:02.8155319Z",
"ipAddress": "1.1.1.1",
"affinityId": "TVM:tvm-1695681911_1-20161122t193202z",
"vmSize": "small",
"totalTasksRun": 0,
"totalTasksSucceeded": 0,
"runningTasksCount": 0,
"runningTaskSlotsCount": 0,
"isDedicated": true,
"startTask": {
"commandLine": "cmd /c echo hello",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"maxTaskRetryCount": 0,
"waitForSuccess": false
},
"startTaskInfo": {
"state": "completed",
"startTime": "2016-11-22T22:22:27.2236818Z",
"endTime": "2016-11-22T22:22:27.567189Z",
"exitCode": 0,
"retryCount": 0
},
"nodeAgentInfo": {
"version": "1.2.0.0",
"lastUpdateTime": "2016-11-22T22:22:24.4634125Z"
}
},
{
"id": "tvm-1695681911_2-20161122t193202z",
"url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
"state": "idle",
"schedulingState": "enabled",
"stateTransitionTime": "2016-11-22T19:37:31.4285526Z",
"lastBootTime": "2016-11-22T19:37:28.623369Z",
"allocationTime": "2016-11-22T19:32:02.8155319Z",
"ipAddress": "1.1.1.1",
"affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
"vmSize": "small",
"totalTasksRun": 0,
"totalTasksSucceeded": 0,
"runningTasksCount": 0,
"runningTaskSlotsCount": 0,
"isDedicated": true,
"startTask": {
"commandLine": "cmd /c echo hello",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"maxTaskRetryCount": 0,
"waitForSuccess": false
},
"startTaskInfo": {
"state": "completed",
"startTime": "2016-11-22T19:37:31.4285526Z",
"endTime": "2016-11-22T19:37:31.838028Z",
"exitCode": 0,
"retryCount": 0
},
"nodeAgentInfo": {
"version": "1.2.0.0",
"lastUpdateTime": "2016-11-22T22:22:24.4634125Z"
}
},
{
"id": "tvm-1695681911_3-20161122t193202z",
"url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_3-20161122t193202z",
"state": "idle",
"schedulingState": "enabled",
"stateTransitionTime": "2016-11-22T19:36:51.0013378Z",
"lastBootTime": "2016-11-22T19:36:48.21721Z",
"allocationTime": "2016-11-22T19:32:02.8155319Z",
"ipAddress": "1.1.1.1",
"affinityId": "TVM:tvm-1695681911_3-20161122t193202z",
"vmSize": "small",
"totalTasksRun": 0,
"totalTasksSucceeded": 0,
"runningTasksCount": 0,
"runningTaskSlotsCount": 0,
"isDedicated": true,
"startTask": {
"commandLine": "cmd /c echo hello",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"maxTaskRetryCount": 0,
"waitForSuccess": false
},
"startTaskInfo": {
"state": "completed",
"startTime": "2016-11-22T19:36:51.0013378Z",
"endTime": "2016-11-22T19:36:51.2363447Z",
"exitCode": 0,
"retryCount": 0
},
"nodeAgentInfo": {
"version": "1.2.0.0",
"lastUpdateTime": "2016-11-22T22:22:24.4634125Z"
}
}
]
}
Definiciones
Nombre | Description |
---|---|
Auto |
Ámbito del usuario automático |
Auto |
Especifica los parámetros del usuario automático que ejecuta una tarea en el servicio Batch. |
Batch |
Respuesta de error recibida del servicio Azure Batch. |
Batch |
Un elemento de información adicional incluida en una respuesta de error de Azure Batch. |
Certificate |
Referencia a un certificado que se va a instalar en nodos de proceso de un grupo. |
Certificate |
Ubicación del almacén de certificados en el nodo de proceso en el que se va a instalar el certificado. |
Certificate |
Qué cuentas de usuario del nodo de proceso deben tener acceso a los datos privados del certificado. |
Compute |
Un nodo de proceso en el servicio Batch. |
Compute |
Configuración del punto de conexión para el nodo de proceso. |
Compute |
Error detectado por un nodo de proceso. |
Compute |
Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso. |
Compute |
Resultado de enumerar los nodos de proceso en un grupo. |
Compute |
Estado actual del nodo de proceso. |
Container |
La entrada de la ruta de acceso y el modo de montaje que desea montar en el contenedor de tareas. |
Container |
Rutas de acceso que se montarán en el contenedor de la tarea de contenedor. |
Container |
Un registro de contenedor privado. |
Container |
Ubicación del directorio de trabajo de la tarea de contenedor. |
Elevation |
Nivel de elevación del usuario. |
Environment |
Variable de entorno que se va a establecer en un proceso de tarea. |
Error |
Categoría del error. |
Error |
Mensaje de error recibido en una respuesta de error de Azure Batch. |
Image |
Referencia a una imagen de Marketplace de Azure Virtual Machines o a una imagen de Azure Compute Gallery. Para obtener la lista de todas las referencias de imágenes de Azure Marketplace verificadas por Azure Batch, consulte la operación "Enumerar imágenes admitidas". |
Inbound |
Un punto de conexión de entrada en un nodo de proceso. |
Inbound |
Protocolo del punto de conexión. |
Name |
Representa un par nombre-valor. |
Node |
Información sobre el agente de Nodo de proceso. |
Resource |
Un único archivo o varios archivos que se van a descargar en un nodo de proceso. |
Scheduling |
Indica si el nodo de proceso está disponible para la programación de tareas. |
Start |
Tarea que se ejecuta cuando un nodo se une a un grupo en el servicio Azure Batch, o cuando se reinicia o se vuelve a crear una imagen de imagen del nodo de proceso. |
Start |
Información sobre una startTask que se ejecuta en un nodo de proceso. |
Start |
Estado de StartTask en el nodo de proceso. |
Task |
Contiene información sobre el contenedor que se está ejecutando una tarea. |
Task |
Configuración del contenedor de una tarea. |
Task |
Información sobre la ejecución de una tarea. |
Task |
Resultado de la ejecución de la tarea. |
Task |
Información sobre un error de tarea. |
Task |
Información sobre una tarea que se ejecuta en un nodo de proceso. |
Task |
Estado de la tarea. |
User |
Definición de la identidad de usuario en la que se ejecuta la tarea. |
Virtual |
Información sobre el estado actual de la máquina virtual. |
AutoUserScope
Ámbito del usuario automático
Nombre | Tipo | Description |
---|---|---|
pool |
string |
Especifica que la tarea se ejecuta como la cuenta de usuario automático común que se crea en cada nodo de proceso de un grupo. |
task |
string |
Especifica que el servicio debe crear un nuevo usuario para la tarea. |
AutoUserSpecification
Especifica los parámetros del usuario automático que ejecuta una tarea en el servicio Batch.
Nombre | Tipo | Description |
---|---|---|
elevationLevel |
Nivel de elevación del usuario automático. |
|
scope |
Ámbito del usuario automático |
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 |
Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario. |
|
values |
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. |
CertificateReference
Referencia a un certificado que se va a instalar en nodos de proceso de un grupo.
Nombre | Tipo | Description |
---|---|---|
storeLocation |
Ubicación del almacén de certificados en el nodo de proceso en el que se va a instalar el certificado. |
|
storeName |
string |
Nombre del almacén de certificados en el nodo de proceso en el que se va a instalar el certificado. |
thumbprint |
string |
Huella digital del certificado. |
thumbprintAlgorithm |
string |
Algoritmo con el que está asociada la huella digital. Debe ser sha1. |
visibility |
Qué cuentas de usuario del nodo de proceso deben tener acceso a los datos privados del certificado. |
CertificateStoreLocation
Ubicación del almacén de certificados en el nodo de proceso en el que se va a instalar el certificado.
Nombre | Tipo | Description |
---|---|---|
currentuser |
string |
Los certificados deben instalarse en el almacén de certificados CurrentUser. |
localmachine |
string |
Los certificados deben instalarse en el almacén de certificados LocalMachine. |
CertificateVisibility
Qué cuentas de usuario del nodo de proceso deben tener acceso a los datos privados del certificado.
Nombre | Tipo | Description |
---|---|---|
remoteuser |
string |
El certificado debe ser visible para las cuentas de usuario en las que los usuarios acceden de forma remota al nodo de proceso. |
starttask |
string |
El certificado debe estar visible para la cuenta de usuario en la que se ejecuta StartTask. Tenga en cuenta que si El ámbito de autousuario es Pool para StartTask y una tarea, este certificado también será visible para la tarea. |
task |
string |
El certificado debe estar visible para las cuentas de usuario en las que se ejecutan las tareas de trabajo. |
ComputeNode
Un nodo de proceso en el servicio Batch.
Nombre | Tipo | Description |
---|---|---|
affinityId |
string |
Identificador que se puede pasar al agregar una tarea para solicitar que la tarea se programe en este nodo de proceso. |
allocationTime |
string |
Hora a la que se asignó este nodo de proceso al grupo. |
certificateReferences |
Lista de certificados instalados en el nodo de proceso. Advertencia: esta propiedad está en desuso y se quitará después de febrero de 2024. Use el de extensión de Azure KeyVault de |
|
endpointConfiguration |
Configuración del punto de conexión para el nodo de proceso. |
|
errors |
Lista de errores que se encuentran actualmente en el nodo de proceso. |
|
id |
string |
Identificador del nodo de proceso. |
ipAddress |
string |
Dirección IP que otros nodos pueden usar para comunicarse con este nodo de proceso. |
isDedicated |
boolean |
Si este nodo de proceso es un nodo de proceso dedicado. Si es false, el nodo de proceso es un nodo de proceso de prioridad baja o de acceso puntual. |
lastBootTime |
string |
La última vez en la que se inició el nodo de proceso. |
nodeAgentInfo |
Información sobre la versión del agente de Nodo de proceso y la hora en que el nodo de proceso se actualizó a una nueva versión. |
|
recentTasks |
Lista de tareas cuyo estado ha cambiado recientemente. |
|
runningTaskSlotsCount |
integer |
Número total de ranuras de programación usadas actualmente por la ejecución de tareas de trabajo en el nodo de proceso. Esto incluye tareas del Administrador de trabajos y tareas normales, pero no la preparación del trabajo, la versión del trabajo o las tareas de inicio. |
runningTasksCount |
integer |
Número total de tareas de trabajo que se están ejecutando actualmente en el nodo de proceso. Esto incluye tareas del Administrador de trabajos y tareas normales, pero no la preparación del trabajo, la versión del trabajo o las tareas de inicio. |
schedulingState |
Indica si el nodo de proceso está disponible para la programación de tareas. |
|
startTask |
Tarea especificada para ejecutarse en el nodo de proceso a medida que se une al grupo. |
|
startTaskInfo |
Información en tiempo de ejecución sobre la ejecución de StartTask en el nodo de proceso. |
|
state |
Estado actual del nodo de proceso. |
|
stateTransitionTime |
string |
Hora en la que el nodo de proceso entró en su estado actual. |
totalTasksRun |
integer |
Número total de tareas de trabajo completadas en el nodo de proceso. Esto incluye tareas del Administrador de trabajos y tareas normales, pero no la preparación del trabajo, la versión del trabajo o las tareas de inicio. |
totalTasksSucceeded |
integer |
Número total de tareas de trabajo que se completaron correctamente (con exitCode 0) en el nodo de proceso. Esto incluye tareas del Administrador de trabajos y tareas normales, pero no la preparación del trabajo, la versión del trabajo o las tareas de inicio. |
url |
string |
Dirección URL del nodo de proceso. |
virtualMachineInfo |
Información sobre el estado actual de la máquina virtual. |
|
vmSize |
string |
Tamaño de la máquina virtual que hospeda el nodo de proceso. |
ComputeNodeEndpointConfiguration
Configuración del punto de conexión para el nodo de proceso.
Nombre | Tipo | Description |
---|---|---|
inboundEndpoints |
Lista de puntos de conexión de entrada a los que se puede acceder en el nodo de proceso. |
ComputeNodeError
Error detectado por un nodo de proceso.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Identificador del error de nodo de proceso. Los códigos son invariables y están diseñados para consumirse mediante programación. |
errorDetails |
Lista de detalles de error adicionales relacionados con el error de nodo de proceso. |
|
message |
string |
Mensaje que describe el error de nodo de proceso, diseñado para ser adecuado para mostrarse en una interfaz de usuario. |
ComputeNodeIdentityReference
Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso.
Nombre | Tipo | Description |
---|---|---|
resourceId |
string |
Identificador de recurso de ARM de la identidad asignada por el usuario. |
ComputeNodeListResult
Resultado de enumerar los nodos de proceso en un grupo.
Nombre | Tipo | Description |
---|---|---|
odata.nextLink |
string |
Dirección URL para obtener el siguiente conjunto de resultados. |
value |
Lista de nodos de proceso. |
ComputeNodeState
Estado actual del nodo de proceso.
Nombre | Tipo | Description |
---|---|---|
creating |
string |
El servicio Batch ha obtenido la máquina virtual subyacente de Azure Compute, pero aún no ha empezado a unirse al grupo. |
deallocated |
string |
El nodo de proceso se desasigna. |
deallocating |
string |
El nodo de proceso está desasignando. |
idle |
string |
El nodo de proceso no está ejecutando actualmente una tarea. |
leavingpool |
string |
El nodo de proceso deja el grupo, ya sea porque el usuario lo quitó explícitamente o porque el grupo está ajustando el tamaño o el escalado automático. |
offline |
string |
El nodo de proceso no está ejecutando actualmente una tarea y la programación de nuevas tareas en el nodo de proceso está deshabilitada. |
preempted |
string |
Se ha adelantado el nodo de proceso spot/prioridad baja. Las tareas que se estaban ejecutando en el nodo de proceso cuando se adelantó se volverán a programar cuando haya otro nodo de proceso disponible. |
rebooting |
string |
El nodo de proceso se está reiniciando. |
reimaging |
string |
El nodo de proceso se está volviendo a calcular. |
running |
string |
El nodo de proceso ejecuta una o varias tareas (distintas de StartTask). |
starting |
string |
El servicio Batch se inicia en la máquina virtual subyacente. |
starttaskfailed |
string |
StartTask ha producido un error en el nodo de proceso (y ha agotado todos los reintentos) y se ha establecido waitForSuccess. El nodo de proceso no se puede usar para ejecutar tareas. |
unknown |
string |
El servicio Batch ha perdido el contacto con el nodo de proceso y no conoce su verdadero estado. |
unusable |
string |
No se puede usar el nodo de proceso para la ejecución de tareas debido a errores. |
upgradingos |
string |
El nodo de proceso está experimentando una operación de actualización del sistema operativo. |
waitingforstarttask |
string |
StartTask ha empezado a ejecutarse en el nodo de proceso, pero waitForSuccess está establecido y StartTask aún no se ha completado. |
ContainerHostBatchBindMountEntry
La entrada de la ruta de acceso y el modo de montaje que desea montar en el contenedor de tareas.
Nombre | Tipo | Description |
---|---|---|
isReadOnly |
boolean |
Monte esta ruta de acceso de origen como modo de solo lectura o no. El valor predeterminado es false (modo de lectura y escritura). |
source |
La ruta de acceso que se va a montar en el cliente contenedor puede seleccionar. |
ContainerHostDataPath
Rutas de acceso que se montarán en el contenedor de la tarea de contenedor.
Nombre | Tipo | Description |
---|---|---|
Applications |
string |
Ruta de acceso de las aplicaciones. |
JobPrep |
string |
Ruta de acceso de la tarea de preparación del trabajo. |
Shared |
string |
Ruta de acceso de la tarea de varias instancias para compartir sus archivos. |
Startup |
string |
Ruta de acceso para la tarea de inicio. |
Task |
string |
Ruta de acceso de la tarea. |
VfsMounts |
string |
La ruta de acceso contiene todos los sistemas de archivos virtuales que se montan en este nodo. |
ContainerRegistry
Un registro de contenedor privado.
Nombre | Tipo | Description |
---|---|---|
identityReference |
Referencia a la identidad asignada por el usuario que se va a usar para acceder a una instancia de Azure Container Registry en lugar de un nombre de usuario y una contraseña. |
|
password |
string |
Contraseña que se va a iniciar sesión en el servidor del Registro. |
registryServer |
string |
Dirección URL del Registro. |
username |
string |
Nombre de usuario que se va a iniciar sesión en el servidor del Registro. |
ContainerWorkingDirectory
Ubicación del directorio de trabajo de la tarea de contenedor.
Nombre | Tipo | Description |
---|---|---|
containerImageDefault |
string |
Use el directorio de trabajo definido en la imagen del contenedor. Tenga en cuenta que este directorio no contendrá los archivos de recursos descargados por Batch. |
taskWorkingDirectory |
string |
Use el directorio de trabajo de tarea del servicio Batch estándar, que contendrá los archivos de recursos de tarea rellenados por Batch. |
ElevationLevel
Nivel de elevación del usuario.
Nombre | Tipo | Description |
---|---|---|
admin |
string |
El usuario es un usuario con acceso elevado y funciona con permisos de administrador completos. |
nonadmin |
string |
El usuario es un usuario estándar sin acceso elevado. |
EnvironmentSetting
Variable de entorno que se va a establecer en un proceso de tarea.
Nombre | Tipo | Description |
---|---|---|
name |
string |
Nombre de la variable de entorno. |
value |
string |
Valor de la variable de entorno. |
ErrorCategory
Categoría del error.
Nombre | Tipo | Description |
---|---|---|
servererror |
string |
El error se debe a un problema interno del servidor. |
usererror |
string |
El error se debe a un problema de usuario, como una configuración incorrecta. |
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. |
ImageReference
Referencia a una imagen de Marketplace de Azure Virtual Machines o a una imagen de Azure Compute Gallery. Para obtener la lista de todas las referencias de imágenes de Azure Marketplace verificadas por Azure Batch, consulte la operación "Enumerar imágenes admitidas".
Nombre | Tipo | Description |
---|---|---|
communityGalleryImageId |
string |
Identificador único de la imagen de la galería de la comunidad |
exactVersion |
string |
La versión específica de la imagen de plataforma o la imagen de Marketplace usada para crear el nodo. Este campo de solo lectura difiere de "version" solo si el valor especificado para "version" cuando se creó el grupo era "latest". |
offer |
string |
Tipo de oferta de la imagen de Marketplace de Azure Virtual Machines. |
publisher |
string |
Publicador de la imagen de Marketplace de Azure Virtual Machines. |
sharedGalleryImageId |
string |
Identificador único de la imagen de la galería compartida |
sku |
string |
SKU de la imagen de Marketplace de Azure Virtual Machines. |
version |
string |
Versión de la imagen de Marketplace de Azure Virtual Machines. |
virtualMachineImageId |
string |
Identificador de recursos de ARM de la imagen de Azure Compute Gallery. Los nodos de proceso del grupo se crearán con este identificador de imagen. Se trata del formulario /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} o /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} para la versión de imagen más reciente. |
InboundEndpoint
Un punto de conexión de entrada en un nodo de proceso.
Nombre | Tipo | Description |
---|---|---|
backendPort |
integer |
Número de puerto de back-end del punto de conexión. |
frontendPort |
integer |
Número de puerto público del punto de conexión. |
name |
string |
Nombre del punto de conexión. |
protocol |
Protocolo del punto de conexión. |
|
publicFQDN |
string |
Nombre de dominio completo público para el nodo de proceso. |
publicIPAddress |
string |
Dirección IP pública del nodo de proceso. |
InboundEndpointProtocol
Protocolo del punto de conexión.
Nombre | Tipo | Description |
---|---|---|
tcp |
string |
Use TCP para el punto de conexión. |
udp |
string |
Use UDP para el punto de conexión. |
NameValuePair
Representa un par nombre-valor.
Nombre | Tipo | Description |
---|---|---|
name |
string |
Nombre del par nombre-valor. |
value |
string |
Valor del par nombre-valor. |
NodeAgentInformation
Información sobre el agente de Nodo de proceso.
Nombre | Tipo | Description |
---|---|---|
lastUpdateTime |
string |
Hora a la que se actualizó el agente de nodo de proceso en el nodo de proceso. |
version |
string |
Versión del agente de nodo de proceso de Batch que se ejecuta en el nodo de proceso. |
ResourceFile
Un único archivo o varios archivos que se van a descargar en un nodo de proceso.
Nombre | Tipo | Description |
---|---|---|
autoStorageContainerName |
string |
Nombre del contenedor de almacenamiento en la cuenta de almacenamiento automática. |
blobPrefix |
string |
Prefijo de blob que se va a usar al descargar blobs de un contenedor de Azure Storage. Solo se descargarán los blobs cuyos nombres comienzan por el prefijo especificado. |
fileMode |
string |
Atributo del modo de permiso de archivo en formato octal. |
filePath |
string |
Ubicación en el nodo de proceso al que se van a descargar los archivos, en relación con el directorio de trabajo de la tarea. |
httpUrl |
string |
Dirección URL del archivo que se va a descargar. |
identityReference |
Referencia a la identidad asignada por el usuario que se va a usar para acceder a Azure Blob Storage especificado por storageContainerUrl o httpUrl |
|
storageContainerUrl |
string |
Dirección URL del contenedor de blobs en Azure Blob Storage. |
SchedulingState
Indica si el nodo de proceso está disponible para la programación de tareas.
Nombre | Tipo | Description |
---|---|---|
disabled |
string |
No se programarán nuevas tareas en el nodo de proceso. Las tareas que ya se ejecutan en el nodo de proceso pueden seguir ejecutándose hasta completarse. Todos los nodos de proceso comienzan con la programación habilitada. |
enabled |
string |
Las tareas se pueden programar en el nodo de proceso. |
StartTask
Tarea que se ejecuta cuando un nodo se une a un grupo en el servicio Azure Batch, o cuando se reinicia o se vuelve a crear una imagen de imagen del nodo de proceso.
Nombre | Tipo | Description |
---|---|---|
commandLine |
string |
Línea de comandos de StartTask. |
containerSettings |
Configuración del contenedor en el que se ejecuta StartTask. |
|
environmentSettings |
Lista de opciones de configuración de variables de entorno para StartTask. |
|
maxTaskRetryCount |
integer |
Número máximo de veces que se puede reintentar la tarea. |
resourceFiles |
Lista de archivos que el servicio Batch descargará en el nodo de proceso antes de ejecutar la línea de comandos. Hay un tamaño máximo para la lista de archivos de recursos. Cuando se supera el tamaño máximo, se producirá un error en la solicitud y el código de error de respuesta será RequestEntityTooLarge. Si esto ocurre, la colección de ResourceFiles debe reducirse en tamaño. Esto se puede lograr mediante archivos de .zip, paquetes de aplicación o contenedores de Docker. |
|
userIdentity |
Identidad de usuario en la que se ejecuta StartTask. |
|
waitForSuccess |
boolean |
Si el servicio Batch debe esperar a que StartTask se complete correctamente (es decir, salir con el código de salida 0) antes de programar cualquier tarea en el nodo de proceso. |
StartTaskInformation
Información sobre una startTask que se ejecuta en un nodo de proceso.
Nombre | Tipo | Description |
---|---|---|
containerInfo |
Información sobre el contenedor en el que se ejecuta la tarea. |
|
endTime |
string |
Hora a la que StartTask dejó de ejecutarse. |
exitCode |
integer |
Código de salida del programa especificado en la línea de comandos StartTask. |
failureInfo |
Información que describe el error de tarea, si existe. |
|
lastRetryTime |
string |
La hora más reciente en la que se inició la ejecución de un reintento de la tarea. |
result |
Resultado de la ejecución de la tarea. |
|
retryCount |
integer |
Número de veces que el servicio Batch ha reintentado la tarea. |
startTime |
string |
Hora a la que se inició la ejecución de StartTask. |
state |
Estado de StartTask en el nodo de proceso. |
StartTaskState
Estado de StartTask en el nodo de proceso.
Nombre | Tipo | Description |
---|---|---|
completed |
string |
StartTask se ha cerrado con el código de salida 0 o startTask ha producido un error y se ha alcanzado el límite de reintento o el proceso StartTask no se ejecutó debido a errores de preparación de tareas (como errores de descarga de archivos de recursos). |
running |
string |
StartTask se está ejecutando actualmente. |
TaskContainerExecutionInformation
Contiene información sobre el contenedor que se está ejecutando una tarea.
Nombre | Tipo | Description |
---|---|---|
containerId |
string |
Identificador del contenedor. |
error |
string |
Información detallada del error sobre el contenedor. |
state |
string |
Estado del contenedor. |
TaskContainerSettings
Configuración del contenedor de una tarea.
Nombre | Tipo | Description |
---|---|---|
containerHostBatchBindMounts |
Las rutas de acceso que desea montar en la tarea contenedora. |
|
containerRunOptions |
string |
Opciones adicionales para el comando container create. |
imageName |
string |
Imagen que se va a usar para crear el contenedor en el que se ejecutará la tarea. |
registry |
Registro privado que contiene la imagen de contenedor. |
|
workingDirectory |
Ubicación del directorio de trabajo de la tarea de contenedor. |
TaskExecutionInformation
Información sobre la ejecución de una tarea.
Nombre | Tipo | Description |
---|---|---|
containerInfo |
Información sobre el contenedor en el que se ejecuta la tarea. |
|
endTime |
string |
Hora a la que se completó la tarea. |
exitCode |
integer |
Código de salida del programa especificado en la línea de comandos task. |
failureInfo |
Información que describe el error de tarea, si existe. |
|
lastRequeueTime |
string |
La hora más reciente en la que el servicio Batch ha vuelto a poner en cola la tarea como resultado de una solicitud de usuario. |
lastRetryTime |
string |
La hora más reciente en la que se inició la ejecución de un reintento de la tarea. |
requeueCount |
integer |
Número de veces que el servicio Batch ha vuelto a poner en cola la tarea como resultado de una solicitud de usuario. |
result |
Resultado de la ejecución de la tarea. |
|
retryCount |
integer |
Número de veces que el servicio Batch ha reintentado la tarea. |
startTime |
string |
Hora a la que se inició la ejecución de la tarea. |
TaskExecutionResult
Resultado de la ejecución de la tarea.
Nombre | Tipo | Description |
---|---|---|
failure |
string |
Se produjo un error durante el procesamiento de la tarea. Es posible que se haya producido el error antes de iniciar el proceso de tarea, mientras se estaba ejecutando el proceso de tarea o después de que el proceso de tarea se haya salido. |
success |
string |
La tarea se ejecutó correctamente. |
TaskFailureInformation
Información sobre un error de tarea.
Nombre | Tipo | Description |
---|---|---|
category |
Categoría del error de tarea. |
|
code |
string |
Identificador del error de tarea. Los códigos son invariables y están diseñados para consumirse mediante programación. |
details |
Lista de detalles adicionales relacionados con el error. |
|
message |
string |
Mensaje que describe el error tarea, diseñado para ser adecuado para mostrarse en una interfaz de usuario. |
TaskInformation
Información sobre una tarea que se ejecuta en un nodo de proceso.
Nombre | Tipo | Description |
---|---|---|
executionInfo |
Información sobre la ejecución de la tarea. |
|
jobId |
string |
Identificador del trabajo al que pertenece la tarea. |
subtaskId |
integer |
Identificador de la subtarea si la tarea es una tarea de varias instancias. |
taskId |
string |
Identificador de la tarea. |
taskState |
Estado actual de la tarea. |
|
taskUrl |
string |
Dirección URL de la tarea. |
TaskState
Estado de la tarea.
Nombre | Tipo | Description |
---|---|---|
active |
string |
La tarea se pone en cola y puede ejecutarse, pero no está asignada actualmente a un nodo de proceso. Una tarea entra en este estado cuando se crea, cuando está habilitada después de deshabilitarse o cuando está esperando un reintento después de una ejecución errónea. |
completed |
string |
La tarea ya no es apta para ejecutarse, normalmente porque la tarea ha finalizado correctamente o la tarea ha finalizado sin éxito y ha agotado su límite de reintento. Una tarea también se marca como completada si se produjo un error al iniciar la tarea o cuando se ha terminado la tarea. |
preparing |
string |
La tarea se ha asignado a un nodo de proceso, pero espera a que se complete una tarea de preparación de trabajos necesaria en el nodo de proceso. Si la tarea de preparación del trabajo se realiza correctamente, la tarea pasará a ejecutarse. Si se produce un error en la tarea de preparación del trabajo, la tarea volverá a activa y será apta para asignarse a otro nodo de proceso. |
running |
string |
La tarea se ejecuta en un nodo de proceso. Esto incluye la preparación de nivel de tarea, como la descarga de archivos de recursos o la implementación de paquetes especificados en la tarea; no significa necesariamente que la línea de comandos de la tarea haya empezado a ejecutarse. |
UserIdentity
Definición de la identidad de usuario en la que se ejecuta la tarea.
Nombre | Tipo | Description |
---|---|---|
autoUser |
Usuario automático en el que se ejecuta la tarea. |
|
username |
string |
Nombre de la identidad de usuario en la que se ejecuta la tarea. |
VirtualMachineInfo
Información sobre el estado actual de la máquina virtual.
Nombre | Tipo | Description |
---|---|---|
imageReference |
Referencia a la imagen de Marketplace de la máquina virtual de Azure. |
|
scaleSetVmResourceId |
string |
Identificador de recurso de la máquina virtual actual del conjunto de escalado de máquinas virtuales del nodo de proceso. Solo se define si la cuenta de Batch se creó con su propiedad poolAllocationMode establecida en "UserSubscription". |