Compartir a través de

Job Router Operations - Decline Job Offer

  • Referencia
Servicio:
Communication
Versión de la API:
2023-11-01

Rechaza una oferta para trabajar en un trabajo.

POST {endpoint}/routing/workers/{workerId}/offers/{offerId}:decline?api-version=2023-11-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
endpoint
 path True

string

URI del recurso de comunicación
offerId
 path True

string

Id. de una oferta.
workerId
 path True

string

Id. de un trabajador.
api-version
 query True

string

Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre Tipo Description
retryOfferAt

string

Si no se proporciona RetryOfferAt, este trabajo no se ofrecerá de nuevo al trabajador que rechazó este trabajo a menos que el trabajador se desinscriba y se vuelva a registrar. Si se proporciona una hora RetryOfferAt, el trabajo se volverá a hacer coincidir con los trabajadores elegibles a la hora de reintento en UTC. El trabajador que rechazó el trabajo también será apto para el trabajo en ese momento.

Respuestas

Nombre Tipo Description
200 OK

object

La solicitud se ha realizado correctamente.
Other Status Codes

Azure.Core.Foundations.ErrorResponse

Respuesta de error inesperada.

Encabezados

x-ms-error-code: string

Ejemplos

Declines an offer to work on a job

Solicitud de ejemplo

POST https://contoso.westus.communications.azure.com/routing/workers/DefaultWorker/offers/1d5896f3-8b54-40be-82d3-910323f5e2af:decline?api-version=2023-11-01

{
  "retryOfferAt": "2023-05-26T00:00:00.0000000Z"
}

Respuesta de muestra

status code:
200 
{}

Definiciones

Nombre Description
Azure.Core.Foundations.Error

Objeto de error.
Azure.Core.Foundations.ErrorResponse

Una respuesta que contiene los detalles del error.
Azure.Core.Foundations.InnerError

Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
DeclineJobOfferOptions

Solicitar carga para rechazar ofertas.

Azure.Core.Foundations.Error

Objeto de error.

Nombre Tipo Description
code

string

Uno de los conjuntos de códigos de error definidos por el servidor.
details

Azure.Core.Foundations.Error[]

Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror

Azure.Core.Foundations.InnerError

Objeto que contiene información más específica que el objeto actual sobre el error.
message

string

Representación legible del error.
target

string

Destino del error.

Azure.Core.Foundations.ErrorResponse

Una respuesta que contiene los detalles del error.

Nombre Tipo Description
error

Azure.Core.Foundations.Error

Objeto de error.

Azure.Core.Foundations.InnerError

Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nombre Tipo Description
code

string

Uno de los conjuntos de códigos de error definidos por el servidor.
innererror

Azure.Core.Foundations.InnerError

Error interno.

DeclineJobOfferOptions

Solicitar carga para rechazar ofertas.

Nombre Tipo Description
retryOfferAt

string

Si no se proporciona RetryOfferAt, este trabajo no se ofrecerá de nuevo al trabajador que rechazó este trabajo a menos que el trabajador se desinscriba y se vuelva a registrar. Si se proporciona una hora RetryOfferAt, el trabajo se volverá a hacer coincidir con los trabajadores elegibles a la hora de reintento en UTC. El trabajador que rechazó el trabajo también será apto para el trabajo en ese momento.