Job Router Operations - Accept Job Offer

Service:

Communication

API Version:

2023-11-01

Akzeptiert ein Angebot, an einem Auftrag zu arbeiten, und gibt 409/Conflict zurück, wenn ein anderer Agent den Auftrag bereits akzeptiert hat.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string	URI Ihrer Kommunikationsressource
offerId	path	True	string	ID eines Angebots.
workerId	path	True	string	ID eines Workers.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	AcceptJobOfferResult	Die Anforderung war erfolgreich.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Eine unerwartete Fehlerantwort. Headers x-ms-error-code: string

Beispiele

Accepts an offer to work on a job

Sample Request

HTTP

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

Sample Response

Status code:

200

{
  "assignmentId": "246d5a06-c04a-4b6b-8a34-02bbd9fdad68",
  "jobId": "632f5345-220b-4e46-b31f-aeaf03cc2df9",
  "workerId": "DefaultWorker"
}

Definitionen

Name	Beschreibung
AcceptJobOfferResult	Antwort, die IDs für den Worker, den Auftrag und die Zuordnung aus einem akzeptierten Angebot enthält.
Azure.Core.Foundations.Error	Das Fehlerobjekt.
Azure.Core.Foundations.ErrorResponse	Eine Antwort, die Fehlerdetails enthält.
Azure.Core.Foundations.InnerError	Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Richtlinien der Microsoft One-API: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

AcceptJobOfferResult

Antwort, die IDs für den Worker, den Auftrag und die Zuordnung aus einem akzeptierten Angebot enthält.

Name	Typ	Beschreibung
assignmentId	string	ID der Auftragszuweisung, die einen Worker zuweist, der ein Angebot angenommen hat, zu einem Auftrag.
jobId	string	ID des zugewiesenen Auftrags.
workerId	string	ID des Workers, dem dieser Auftrag zugewiesen wurde.

Azure.Core.Foundations.Error

Das Fehlerobjekt.

Name	Typ	Beschreibung
code	string	Einer von einem serverdefiniertem Satz von Fehlercodes.
details	Azure.Core.Foundations.Error[]	Ein Array von Details zu bestimmten Fehlern, die zu diesem gemeldeten Fehler geführt haben.
innererror	Azure.Core.Foundations.InnerError	Ein -Objekt, das spezifischere Informationen enthält als das aktuelle Objekt über den Fehler.
message	string	Eine lesbare Darstellung des Fehlers.
target	string	Das Ziel des Fehlers.

Azure.Core.Foundations.ErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	Azure.Core.Foundations.Error	Das Fehlerobjekt.

Azure.Core.Foundations.InnerError

Ein Objekt, das spezifischere Informationen zum Fehler enthält. Gemäß den Richtlinien der Microsoft One-API: https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Typ	Beschreibung
code	string	Einer von einem serverdefiniertem Satz von Fehlercodes.
innererror	Azure.Core.Foundations.InnerError	Innerer Fehler.