Task - List
Enumera todas las tareas asociadas al trabajo especificado.
Para tareas de varias instancias, la información como affinityId, executionInfo y nodeInfo hacen referencia a la tarea principal. Use la API de subtareas de lista para recuperar información sobre las subtareas.
GET {batchUrl}/jobs/{jobId}/tasks?api-version=2024-07-01.20.0
GET {batchUrl}/jobs/{jobId}/tasks?$filter={$filter}&$select={$select}&$expand={$expand}&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. |
job
|
path | True |
string |
Identificador del trabajo. |
api-version
|
query | True |
string |
Versión de la API de cliente. |
$expand
|
query |
string |
Una cláusula $expand OData. |
|
$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#list-tasks. |
|
$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 tareas. |
|
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 tareas. 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
Task list
Solicitud de ejemplo
GET account.region.batch.azure.com/jobs/jobId/tasks?api-version=2024-07-01.20.0
Respuesta de muestra
{
"value": [
{
"id": "task1",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task1",
"eTag": "0x8D4125FD1A825A4",
"creationTime": "2016-11-21T22:43:31.4733476Z",
"lastModified": "2016-11-21T22:43:31.4733476Z",
"state": "active",
"stateTransitionTime": "2016-11-21T22:43:31.4733476Z",
"commandLine": "cmd /c echo task1",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 0
},
"requiredSlots": 2,
"executionInfo": {
"retryCount": 0,
"requeueCount": 0
}
},
{
"id": "task2",
"url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task2",
"eTag": "0x8D4125FD2153345",
"creationTime": "2016-11-21T22:43:31.6736345Z",
"lastModified": "2016-11-21T22:43:32.1880389Z",
"state": "active",
"stateTransitionTime": "2016-11-21T22:43:31.6736345Z",
"commandLine": "cmd /c echo task2",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"retentionTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 3
},
"requiredSlots": 2,
"executionInfo": {
"retryCount": 0,
"requeueCount": 0
}
}
]
}
Definiciones
Nombre | Description |
---|---|
Access |
Recursos de Batch a los que el token concede acceso. |
Affinity |
Sugerencia de localidad que puede usar el servicio Batch para seleccionar un nodo de proceso en el que iniciar una tarea. |
Application |
Referencia a un paquete que se va a implementar en nodos de proceso. |
Authentication |
La configuración de un token de autenticación que la tarea puede usar para realizar operaciones del servicio Batch. |
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. |
Cloud |
Una tarea de Azure Batch. |
Cloud |
Resultado de enumerar las tareas en un trabajo. |
Compute |
Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso. |
Compute |
Información sobre el nodo de proceso en el que se ejecutó una tarea. |
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. |
Dependency |
Acción que el servicio Batch realiza en Tareas que dependen de esta tarea. |
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. |
Exit |
Cómo debe responder el servicio Batch si una tarea sale con un código de salida determinado. |
Exit |
Un intervalo de códigos de salida y cómo el servicio Batch debe responder a los códigos de salida dentro de ese intervalo. |
Exit |
Especifica cómo debe responder el servicio Batch cuando se complete la tarea. |
Exit |
Especifica cómo responde el servicio Batch a una condición de salida determinada. |
Http |
Un par nombre-valor de encabezado HTTP |
Job |
Una acción que se realizará en el trabajo que contiene la tarea, si la tarea se completa con la condición de salida especificada y la propiedad onTaskFailed del trabajo es "performExitOptionsJobAction". |
Multi |
Configuración que especifica cómo ejecutar una tarea de varias instancias. |
Name |
Representa un par nombre-valor. |
Output |
Especificación para cargar archivos desde un nodo de proceso de Azure Batch a otra ubicación después de que el servicio Batch haya terminado de ejecutar el proceso de tarea. |
Output |
Especifica un destino de carga de archivos dentro de un contenedor de Azure Blob Storage. |
Output |
Destino al que se debe cargar un archivo. |
Output |
Condiciones en las que se debe cargar un archivo de salida de tarea o un conjunto de archivos. |
Output |
Detalles sobre una operación de carga de archivos de salida, incluidas las condiciones para realizar la carga. |
Resource |
Un único archivo o varios archivos que se van a descargar en un nodo de proceso. |
Task |
Restricciones de ejecución que se aplicarán a una tarea. |
Task |
Contiene información sobre el contenedor que se está ejecutando una tarea. |
Task |
Configuración del contenedor de una tarea. |
Task |
Especifica las dependencias de una tarea. Cualquier tarea especificada explícitamente o dentro de un intervalo de dependencias debe completarse antes de que se programe la tarea dependiente. |
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 |
Intervalo de identificadores de tarea de los que puede depender una tarea. Todas las tareas con identificadores del intervalo deben completarse correctamente antes de que se pueda programar la tarea dependiente. |
Task |
Estado de la tarea. |
Task |
Estadísticas de uso de recursos para una tarea. |
User |
Definición de la identidad de usuario en la que se ejecuta la tarea. |
AccessScope
Recursos de Batch a los que el token concede acceso.
Nombre | Tipo | Description |
---|---|---|
job |
string |
Concede acceso para realizar todas las operaciones en el trabajo que contiene la tarea. |
AffinityInformation
Sugerencia de localidad que puede usar el servicio Batch para seleccionar un nodo de proceso en el que iniciar una tarea.
Nombre | Tipo | Description |
---|---|---|
affinityId |
string |
Cadena opaca que representa la ubicación de un nodo de proceso o una tarea que se ha ejecutado anteriormente. |
ApplicationPackageReference
Referencia a un paquete que se va a implementar en nodos de proceso.
Nombre | Tipo | Description |
---|---|---|
applicationId |
string |
Identificador de la aplicación que se va a implementar. |
version |
string |
Versión de la aplicación que se va a implementar. Si se omite, se implementa la versión predeterminada. |
AuthenticationTokenSettings
La configuración de un token de autenticación que la tarea puede usar para realizar operaciones del servicio Batch.
Nombre | Tipo | Description |
---|---|---|
access |
Recursos de Batch a los que el token concede acceso. |
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. |
CloudTask
Una tarea de Azure Batch.
Nombre | Tipo | Description |
---|---|---|
affinityInfo |
Sugerencia de localidad que puede usar el servicio Batch para seleccionar un nodo de proceso en el que iniciar la nueva tarea. |
|
applicationPackageReferences |
Lista de paquetes que el servicio Batch implementará en el nodo de proceso antes de ejecutar la línea de comandos. |
|
authenticationTokenSettings |
La configuración de un token de autenticación que la tarea puede usar para realizar operaciones del servicio Batch. |
|
commandLine |
string |
Línea de comandos de la tarea. |
constraints |
Restricciones de ejecución que se aplican a esta tarea. |
|
containerSettings |
Configuración del contenedor en el que se ejecuta la tarea. |
|
creationTime |
string |
Hora de creación de la tarea. |
dependsOn |
Las tareas de las que depende esta tarea. |
|
displayName |
string |
Nombre para mostrar de la tarea. |
eTag |
string |
ETag de la tarea. |
environmentSettings |
Lista de opciones de configuración de variables de entorno para la tarea. |
|
executionInfo |
Información sobre la ejecución de la tarea. |
|
exitConditions |
Especifica cómo debe responder el servicio Batch cuando se complete la tarea. |
|
id |
string |
Cadena que identifica de forma única la tarea dentro del trabajo. |
lastModified |
string |
Hora de la última modificación de la tarea. |
multiInstanceSettings |
Objeto que indica que la tarea es una tarea de varias instancias y contiene información sobre cómo ejecutar la tarea de varias instancias. |
|
nodeInfo |
Información sobre el nodo de proceso en el que se ejecutó la tarea. |
|
outputFiles |
Lista de archivos que el servicio Batch cargará desde el nodo de proceso después de ejecutar la línea de comandos. |
|
previousState |
Estado anterior de la tarea. |
|
previousStateTransitionTime |
string |
Hora a la que la tarea entró en su estado anterior. |
requiredSlots |
integer |
Número de ranuras de programación que requiere la tarea para ejecutarse. |
resourceFiles |
Lista de archivos que el servicio Batch descargará en el nodo de proceso antes de ejecutar la línea de comandos. |
|
state |
Estado actual de la tarea. |
|
stateTransitionTime |
string |
Hora en la que la tarea entró en su estado actual. |
stats |
Estadísticas de uso de recursos para la tarea. |
|
url |
string |
Dirección URL de la tarea. |
userIdentity |
Identidad de usuario en la que se ejecuta la tarea. |
CloudTaskListResult
Resultado de enumerar las tareas en un trabajo.
Nombre | Tipo | Description |
---|---|---|
odata.nextLink |
string |
Dirección URL para obtener el siguiente conjunto de resultados. |
value |
Lista de tareas. |
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. |
ComputeNodeInformation
Información sobre el nodo de proceso en el que se ejecutó una tarea.
Nombre | Tipo | Description |
---|---|---|
affinityId |
string |
Identificador del nodo en el que se ejecutó la tarea, que se puede pasar al agregar una tarea para solicitar que la tarea se programe en este nodo de proceso. |
nodeId |
string |
Identificador del nodo de proceso en el que se ejecutó la tarea. |
nodeUrl |
string |
Dirección URL del nodo de proceso en el que se ejecutó la tarea. |
poolId |
string |
Identificador del grupo en el que se ejecutó la tarea. |
taskRootDirectory |
string |
Directorio raíz de la tarea en el nodo de proceso. |
taskRootDirectoryUrl |
string |
Dirección URL al directorio raíz de la tarea en el nodo de proceso. |
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. |
DependencyAction
Acción que el servicio Batch realiza en Tareas que dependen de esta tarea.
Nombre | Tipo | Description |
---|---|---|
block |
string |
Bloquea las tareas en espera de esta tarea, lo que impide que se programen. |
satisfy |
string |
Satisfacer las tareas que esperan esta tarea; Una vez que se cumplen todas las dependencias, la tarea se programará para ejecutarse. |
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. |
ExitCodeMapping
Cómo debe responder el servicio Batch si una tarea sale con un código de salida determinado.
Nombre | Tipo | Description |
---|---|---|
code |
integer |
Código de salida de proceso. |
exitOptions |
Cómo debe responder el servicio Batch si la tarea sale con este código de salida. |
ExitCodeRangeMapping
Un intervalo de códigos de salida y cómo el servicio Batch debe responder a los códigos de salida dentro de ese intervalo.
Nombre | Tipo | Description |
---|---|---|
end |
integer |
Último código de salida del intervalo. |
exitOptions |
Cómo debe responder el servicio Batch si la tarea sale con un código de salida en el intervalo de inicio a fin (inclusivo). |
|
start |
integer |
Primer código de salida del intervalo. |
ExitConditions
Especifica cómo debe responder el servicio Batch cuando se complete la tarea.
Nombre | Tipo | Description |
---|---|---|
default |
Cómo debe responder el servicio Batch si se produce un error en la tarea con una condición de salida no cubierta por ninguna de las otras propiedades. |
|
exitCodeRanges |
Lista de intervalos de código de salida de tarea y cómo debe responder el servicio Batch. |
|
exitCodes |
Lista de códigos de salida de tareas individuales y cómo debe responder el servicio Batch. |
|
fileUploadError |
Cómo debe responder el servicio Batch si se produce un error de carga de archivos. |
|
preProcessingError |
Cómo debe responder el servicio Batch si la tarea no se inicia debido a un error. |
ExitOptions
Especifica cómo responde el servicio Batch a una condición de salida determinada.
Nombre | Tipo | Description |
---|---|---|
dependencyAction |
Acción que el servicio Batch realiza en Tareas que dependen de esta tarea. |
|
jobAction |
Una acción que se realizará en el trabajo que contiene la tarea, si la tarea se completa con la condición de salida especificada y la propiedad onTaskFailed del trabajo es "performExitOptionsJobAction". |
HttpHeader
Un par nombre-valor de encabezado HTTP
Nombre | Tipo | Description |
---|---|---|
name |
string |
Nombre que no distingue mayúsculas de minúsculas del encabezado que se va a usar al cargar archivos de salida |
value |
string |
Valor del encabezado que se va a usar al cargar archivos de salida |
JobAction
Una acción que se realizará en el trabajo que contiene la tarea, si la tarea se completa con la condición de salida especificada y la propiedad onTaskFailed del trabajo es "performExitOptionsJobAction".
Nombre | Tipo | Description |
---|---|---|
disable |
string |
Deshabilite el trabajo. Esto equivale a llamar a la API disable Job, con un valor disableTasks de requeue. |
none |
string |
No tome ninguna acción. |
terminate |
string |
Finalice el trabajo. TerminateReason en executionInfo del trabajo se establece en "TaskFailed". |
MultiInstanceSettings
Configuración que especifica cómo ejecutar una tarea de varias instancias.
Nombre | Tipo | Description |
---|---|---|
commonResourceFiles |
Lista de archivos que el servicio Batch descargará antes de ejecutar la línea de comandos de coordinación. |
|
coordinationCommandLine |
string |
Línea de comandos que se va a ejecutar en todos los nodos de proceso para que puedan coordinarse cuando el principal ejecuta el comando task principal. |
numberOfInstances |
integer |
Número de nodos de proceso requeridos por la tarea. |
NameValuePair
Representa un par nombre-valor.
Nombre | Tipo | Description |
---|---|---|
name |
string |
Nombre del par nombre-valor. |
value |
string |
Valor del par nombre-valor. |
OutputFile
Especificación para cargar archivos desde un nodo de proceso de Azure Batch a otra ubicación después de que el servicio Batch haya terminado de ejecutar el proceso de tarea.
Nombre | Tipo | Description |
---|---|---|
destination |
Destino de los archivos de salida. |
|
filePattern |
string |
Patrón que indica qué archivos se van a cargar. |
uploadOptions |
Opciones adicionales para la operación de carga, incluidas las condiciones para realizar la carga. |
OutputFileBlobContainerDestination
Especifica un destino de carga de archivos dentro de un contenedor de Azure Blob Storage.
Nombre | Tipo | Description |
---|---|---|
containerUrl |
string |
Dirección URL del contenedor dentro de Azure Blob Storage en la que se cargan los archivos. |
identityReference |
Referencia a la identidad asignada por el usuario que se va a usar para acceder a Azure Blob Storage especificado por containerUrl |
|
path |
string |
Blob de destino o directorio virtual dentro del contenedor de Azure Storage. |
uploadHeaders |
Lista de pares nombre-valor para los encabezados que se usarán en la carga de archivos de salida |
OutputFileDestination
Destino al que se debe cargar un archivo.
Nombre | Tipo | Description |
---|---|---|
container |
Ubicación en Azure Blob Storage en la que se cargan los archivos. |
OutputFileUploadCondition
Condiciones en las que se debe cargar un archivo de salida de tarea o un conjunto de archivos.
Nombre | Tipo | Description |
---|---|---|
taskcompletion |
string |
Cargue los archivos después de que se cierre el proceso de tarea, independientemente del código de salida. |
taskfailure |
string |
Cargue los archivos solo después de que el proceso de tarea salga con un código de salida distinto de cero. |
tasksuccess |
string |
Cargue los archivos solo después de que el proceso de tarea salga con un código de salida de 0. |
OutputFileUploadOptions
Detalles sobre una operación de carga de archivos de salida, incluidas las condiciones para realizar la carga.
Nombre | Tipo | Description |
---|---|---|
uploadCondition |
Condiciones en las que se debe cargar el archivo de salida de la tarea o el conjunto de archivos. |
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. |
TaskConstraints
Restricciones de ejecución que se aplicarán a una tarea.
Nombre | Tipo | Description |
---|---|---|
maxTaskRetryCount |
integer |
Número máximo de veces que se puede reintentar la tarea. El servicio Batch vuelve a intentar una tarea si su código de salida es distinto de cero. |
maxWallClockTime |
string |
Tiempo máximo transcurrido que se puede ejecutar la tarea, medido desde el momento en que se inicia la tarea. Si la tarea no se completa dentro del límite de tiempo, el servicio Batch lo finaliza. |
retentionTime |
string |
El tiempo mínimo para conservar el directorio Task en el nodo de proceso donde se ejecutó, desde el momento en que completa la ejecución. Después de este tiempo, el servicio Batch puede eliminar el directorio Task y todo su contenido. |
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. |
TaskDependencies
Especifica las dependencias de una tarea. Cualquier tarea especificada explícitamente o dentro de un intervalo de dependencias debe completarse antes de que se programe la tarea dependiente.
Nombre | Tipo | Description |
---|---|---|
taskIdRanges |
Lista de intervalos de id. de tarea de los que depende esta tarea. Todas las tareas de todos los intervalos deben completarse correctamente antes de que se pueda programar la tarea dependiente. |
|
taskIds |
string[] |
Lista de identificadores de tarea de los que depende esta tarea. Todas las tareas de esta lista deben completarse correctamente antes de que se pueda programar la tarea dependiente. |
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. |
TaskIdRange
Intervalo de identificadores de tarea de los que puede depender una tarea. Todas las tareas con identificadores del intervalo deben completarse correctamente antes de que se pueda programar la tarea dependiente.
Nombre | Tipo | Description |
---|---|---|
end |
integer |
El último identificador de tarea del intervalo. |
start |
integer |
El primer identificador de tarea del intervalo. |
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. |
TaskStatistics
Estadísticas de uso de recursos para una tarea.
Nombre | Tipo | Description |
---|---|---|
kernelCPUTime |
string |
Tiempo total de CPU del modo kernel (sumado en todos los núcleos y todos los nodos de proceso) consumidos por la tarea. |
lastUpdateTime |
string |
Hora a la que se actualizaron las estadísticas por última vez. Todas las estadísticas se limitan al intervalo entre startTime y lastUpdateTime. |
readIOGiB |
number |
El total de gibibytes leídos del disco por la tarea. |
readIOps |
integer |
Número total de operaciones de lectura de disco realizadas por la tarea. |
startTime |
string |
Hora de inicio del intervalo de tiempo cubierto por las estadísticas. |
url |
string |
Dirección URL de las estadísticas. |
userCPUTime |
string |
Tiempo total de CPU del modo de usuario (sumado en todos los núcleos y todos los nodos de proceso) consumidos por la tarea. |
waitTime |
string |
Tiempo de espera total de la tarea. El tiempo de espera de una tarea se define como el tiempo transcurrido entre la creación de la tarea y el inicio de la ejecución de la tarea. (Si se reintenta la tarea debido a errores, el tiempo de espera es el tiempo de ejecución de la tarea más reciente). |
wallClockTime |
string |
Tiempo total del reloj de la tarea. |
writeIOGiB |
number |
El total de gibibytes escritos en disco por la tarea. |
writeIOps |
integer |
Número total de operaciones de escritura de disco realizadas por la tarea. |
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. |