Job Router Operations - Accept Job Offer

Служба:

Communication

Версия API:

2023-11-01

Принимает предложение для работы над заданием и возвращает значение 409/Конфликт, если другой агент уже принял задание.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string	Uri ресурса коммуникации
offerId	path	True	string	Идентификатор предложения.
workerId	path	True	string	Идентификатор рабочей роли.
api-version	query	True	string	Версия API, используемая для этой операции.

Ответы

Имя	Тип	Описание
200 OK	AcceptJobOfferResult	Запрос выполнен успешно.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Непредвиденное сообщение об ошибке. Заголовки x-ms-error-code: string

Безопасность

AadOauth2Auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize
URL-адрес токена: https://login.microsoftonline.com/common/oauth2/token

Области

Имя	Описание
https://communication.azure.com/.default

Примеры

Accepts an offer to work on a job

Образец запроса

HTTP

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

Пример ответа

Код состояния:

200

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

Определения

Имя	Описание
AcceptJobOfferResult	Ответ, содержащий идентификаторы для рабочей роли, задания и назначения из принятого предложения.
Azure.Core.Foundations.Error	Объект ошибки.
Azure.Core.Foundations.ErrorResponse	Ответ, содержащий сведения об ошибке.
Azure.Core.Foundations.InnerError	Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по API Microsoft One — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

AcceptJobOfferResult

Ответ, содержащий идентификаторы для рабочей роли, задания и назначения из принятого предложения.

Имя	Тип	Описание
assignmentId	string	Идентификатор назначения задания, назначающего рабочую роль, которая приняла предложение заданию.
jobId	string	Идентификатор назначенного задания.
workerId	string	Идентификатор рабочей роли, назначаемой этой задачей.

Azure.Core.Foundations.Error

Объект ошибки.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
details	Azure.Core.Foundations.Error[]	Массив сведений об определенных ошибках, которые привели к этой сообщаемой ошибке.
innererror	Azure.Core.Foundations.InnerError	Объект, содержащий более конкретные сведения, чем текущий объект об ошибке.
message	string	Читаемое пользователем представление ошибки.
target	string	Целевой объект ошибки.

Azure.Core.Foundations.ErrorResponse

Ответ, содержащий сведения об ошибке.

Имя	Тип	Описание
error	Azure.Core.Foundations.Error	Объект ошибки.

Azure.Core.Foundations.InnerError

Объект, содержащий более конкретные сведения об ошибке. В соответствии с рекомендациями по API Microsoft One — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
innererror	Azure.Core.Foundations.InnerError	Внутренняя ошибка.