Job Router Operations - Decline Job Offer

Service:

Communication

API-versie:

2023-11-01

Weigert een aanbieding om aan een job te werken.

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

URI-parameters

Name	In	Vereist	Type	Description
endpoint	path	True	string	URI van uw communicatieresource
offerId	path	True	string	Id van een aanbieding.
workerId	path	True	string	Id van een werkrol.
api-version	query	True	string	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Type	Description
retryOfferAt	string	Als de RetryOfferAt niet is opgegeven, wordt deze taak niet opnieuw aangeboden aan de werknemer die deze taak heeft geweigerd, tenzij de werkrol de registratie ongedaan maakt en opnieuw is geregistreerd. Als er een RetryOfferAt-tijd wordt opgegeven, wordt de taak opnieuw gekoppeld aan in aanmerking komende werkrollen op het tijdstip van de nieuwe poging in UTC. De werknemer die de taak heeft geweigerd, komt op dat moment ook in aanmerking voor de taak.

Antwoorden

Name	Type	Description
200 OK	object	De aanvraag is geslaagd.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Een onverwacht foutbericht. Kopteksten x-ms-error-code: string

Voorbeelden

Declines an offer to work on a job

Voorbeeldaanvraag

HTTP

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"
}

Voorbeeldrespons

Statuscode:

200

{}

Definities

Name	Description
Azure.Core.Foundations.Error	Het foutobject.
Azure.Core.Foundations.ErrorResponse	Een antwoord met foutdetails.
Azure.Core.Foundations.InnerError	Een object met specifiekere informatie over de fout. Volgens de Richtlijnen voor Microsoft One API: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
DeclineJobOfferOptions	Nettolading aanvragen voor weigerende aanbiedingen.

Azure.Core.Foundations.Error

Het foutobject.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
details	Azure.Core.Foundations.Error[]	Een matrix met details over specifieke fouten die tot deze gerapporteerde fout hebben geleid.
innererror	Azure.Core.Foundations.InnerError	Een object met specifiekere informatie dan het huidige object over de fout.
message	string	Een door mensen leesbare weergave van de fout.
target	string	Het doel van de fout.

Azure.Core.Foundations.ErrorResponse

Een antwoord met foutdetails.

Name	Type	Description
error	Azure.Core.Foundations.Error	Het foutobject.

Azure.Core.Foundations.InnerError

Een object met specifiekere informatie over de fout. Volgens de Richtlijnen voor Microsoft One API: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
innererror	Azure.Core.Foundations.InnerError	Interne fout.

DeclineJobOfferOptions

Nettolading aanvragen voor weigerende aanbiedingen.

Name	Type	Description
retryOfferAt	string	Als de RetryOfferAt niet is opgegeven, wordt deze taak niet opnieuw aangeboden aan de werknemer die deze taak heeft geweigerd, tenzij de werkrol de registratie ongedaan maakt en opnieuw is geregistreerd. Als er een RetryOfferAt-tijd wordt opgegeven, wordt de taak opnieuw gekoppeld aan in aanmerking komende werkrollen op het tijdstip van de nieuwe poging in UTC. De werknemer die de taak heeft geweigerd, komt op dat moment ook in aanmerking voor de taak.