Task - Reactivate

Reactiva una tarea, lo que le permite volver a ejecutarse incluso si se ha agotado su recuento de reintentos.
La reactivación hace que una tarea sea apta para reintentar de nuevo hasta su número máximo de reintentos. El estado de la tarea se cambia a activo. Dado que la tarea ya no está en estado completado, ningún código de salida o información de error anterior ya no está disponible después de la reactivación. Cada vez que se reactiva una tarea, su recuento de reintentos se restablece a 0. Se producirá un error en la reactivación de las tareas que no se hayan completado o que se hayan completado correctamente (con un código de salida de 0). Además, se producirá un error si el trabajo se ha completado (o está finalizando o eliminando).

POST {batchUrl}/jobs/{jobId}/tasks/{taskId}/reactivate?api-version=2022-01-01.15.0
POST {batchUrl}/jobs/{jobId}/tasks/{taskId}/reactivate?timeout={timeout}&api-version=2022-01-01.15.0

Parámetros de identificador URI

Name In Required Type Description
batchUrl
path True
  • string

Dirección URL base de todas las solicitudes de servicio de Azure Batch.

jobId
path True
  • string

Identificador del trabajo que contiene la tarea.

taskId
path True
  • string

Identificador de la tarea que se va a reactivar.

api-version
query True
  • string

Versión de la API de cliente.

timeout
query
  • integer
int32

Tiempo máximo que el servidor puede dedicar a procesar la solicitud, en segundos. El valor predeterminado es 30 segundos.

Encabezado de la solicitud

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

Name Required Type 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.

If-Match
  • string

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio coincide exactamente con el valor especificado por el cliente.

If-None-Match
  • string

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio no coincide con el valor especificado por el cliente.

If-Modified-Since
  • string
date-time-rfc1123

Marca de tiempo que indica la hora de la última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio se ha modificado desde la hora especificada.

If-Unmodified-Since
  • string
date-time-rfc1123

Marca de tiempo que indica la hora de la última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio no se ha modificado desde el momento especificado.

Respuestas

Name Type Description
204 No Content

La solicitud al servicio Batch se realizó correctamente.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

Error del servicio Batch.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Suplantación de su cuenta de usuario

Authorization

Type: apiKey
In: header

Ejemplos

Task reactivate

Sample Request

POST account.region.batch.azure.com/jobs/jobId/tasks/taskId/reactivate?api-version=2022-01-01.15.0


Sample Response

Definiciones

BatchError

Respuesta de error recibida del servicio Azure Batch.

BatchErrorDetail

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

ErrorMessage

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

BatchError

Respuesta de error recibida del servicio Azure Batch.

Name Type 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 su presentación en una interfaz de usuario.

values

Colección de pares clave-valor que contienen detalles adicionales sobre el error.

BatchErrorDetail

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

Name Type Description
key
  • string

Identificador que especifica el significado de la propiedad Value.

value
  • string

Información adicional incluida con la respuesta de error.

ErrorMessage

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

Name Type Description
lang
  • string

Código de idioma del mensaje de error

value
  • string

Texto del mensaje.