Job Router Operations - Decline Job Offer

Serviço:

Communication

Versão da API:

2023-11-01

Recusa uma oferta para trabalhar em um trabalho.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
endpoint	path	True	string	URI do recurso de Comunicação
offerId	path	True	string	ID de uma oferta.
workerId	path	True	string	ID de um trabalhador.
api-version	query	True	string	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
retryOfferAt	string	Se RetryOfferAt não for fornecido, esse trabalho não será oferecido novamente ao trabalhador que recusou esse trabalho, a menos que o trabalhador esteja desassociado e registrado novamente. Se um tempo retryOfferAt for fornecido, o trabalho será correspondido novamente aos trabalhadores qualificados no momento da repetição em UTC. O trabalhador que recusou o trabalho também será elegível para o trabalho nesse momento.

Respostas

Nome	Tipo	Description
200 OK	object	A solicitação foi bem-sucedida.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Uma resposta de erro inesperada. Cabeçalhos x-ms-error-code: string

Exemplos

Declines an offer to work on a job

Solicitação de exemplo

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

Resposta de exemplo

Código de status:

200

{}

Definições

Nome	Description
Azure.Core.Foundations.Error	O objeto de erro.
Azure.Core.Foundations.ErrorResponse	Uma resposta que contém detalhes do erro.
Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
DeclineJobOfferOptions	Conteúdo da solicitação para ofertas em declínio.

Azure.Core.Foundations.Error

O objeto de erro.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
details	Azure.Core.Foundations.Error[]	Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
innererror	Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
message	string	Uma representação legível do erro.
target	string	O destino do erro.

Azure.Core.Foundations.ErrorResponse

Uma resposta que contém detalhes do erro.

Nome	Tipo	Description
error	Azure.Core.Foundations.Error	O objeto de erro.

Azure.Core.Foundations.InnerError

Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
innererror	Azure.Core.Foundations.InnerError	Erro interno.

DeclineJobOfferOptions

Conteúdo da solicitação para ofertas em declínio.

Nome	Tipo	Description
retryOfferAt	string	Se RetryOfferAt não for fornecido, esse trabalho não será oferecido novamente ao trabalhador que recusou esse trabalho, a menos que o trabalhador esteja desassociado e registrado novamente. Se um tempo retryOfferAt for fornecido, o trabalho será correspondido novamente aos trabalhadores qualificados no momento da repetição em UTC. O trabalhador que recusou o trabalho também será elegível para o trabalho nesse momento.