Job Router Administration Operations - Upsert Exception Policy

Reference

Služba:: Communication

Verze rozhraní API:: 2023-11-01

Vytvoří nebo aktualizuje zásadu výjimky.

PATCH {endpoint}/routing/exceptionPolicies/{exceptionPolicyId}?api-version=2023-11-01

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string	Identifikátor URI vašeho komunikačního prostředku
exceptionPolicyId	path	True	string	ID zásady výjimky.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Media Types: "application/merge-patch+json"

Name	Vyžadováno	Typ	Description
If-Match		string	Požadavek by měl pokračovat pouze v případě, že entita odpovídá tomuto řetězci.
If-Unmodified-Since		string (date-time-rfc7231)	Požadavek by měl pokračovat pouze v případě, že po této době nebyla entita změněna.

Text požadavku

Media Types: "application/merge-patch+json"

Name	Typ	Description
exceptionRules	ExceptionRule[]	Kolekce pravidel výjimek pro zásady výjimek.
name	string	Popisný název této zásady

Odpovědi

Name	Typ	Description
200 OK	ExceptionPolicy	Požadavek byl úspěšný. Hlavičky ETag: string Last-Modified: string
201 Created	ExceptionPolicy	Požadavek byl úspěšný a v důsledku toho byl vytvořen nový prostředek. Hlavičky ETag: string Last-Modified: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Name

Typ

Description

200 OK

ExceptionPolicy

Požadavek byl úspěšný.

Hlavičky

ETag: string
Last-Modified: string

201 Created

ExceptionPolicy

Požadavek byl úspěšný a v důsledku toho byl vytvořen nový prostředek.

Hlavičky

ETag: string
Last-Modified: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Neočekávaná chybová odpověď

Hlavičky

x-ms-error-code: string

Zabezpečení

AadOauth2Auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize
URL tokenu: https://login.microsoftonline.com/common/oauth2/token

Rozsahy

Name	Description
https://communication.azure.com/.default

Příklady

Creates an exception policy

Updates an exception policy

Creates an exception policy

Ukázkový požadavek

HTTP

PATCH https://contoso.westus.communications.azure.com/routing/exceptionPolicies/cf1cda69-6f41-45ac-b252-213293f1b1cb?api-version=2023-11-01

{
  "name": "Main",
  "exceptionRules": [
    {
      "id": "MaxWaitTimeExceeded",
      "actions": [
        {
          "kind": "reclassify",
          "classificationPolicyId": "Main",
          "labelsToUpsert": {
            "escalated": true
          }
        }
      ],
      "trigger": {
        "kind": "waitTime",
        "thresholdSeconds": 20
      }
    }
  ]
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "cf1cda69-6f41-45ac-b252-213293f1b1cb",
  "name": "Main",
  "exceptionRules": [
    {
      "id": "MaxWaitTimeExceeded",
      "trigger": {
        "kind": "waitTime",
        "thresholdSeconds": 20
      },
      "actions": [
        {
          "id": "babd4f6f-916e-4e91-9c89-e0bb05a2c425",
          "kind": "reclassify",
          "classificationPolicyId": "Main",
          "labelsToUpsert": {
            "escalated": true
          }
        }
      ]
    }
  ],
  "etag": "etag"
}

Stavový kód:: 201

{
  "id": "cf1cda69-6f41-45ac-b252-213293f1b1cb",
  "name": "Main",
  "exceptionRules": [
    {
      "id": "MaxWaitTimeExceeded",
      "trigger": {
        "kind": "waitTime",
        "thresholdSeconds": 20
      },
      "actions": [
        {
          "id": "babd4f6f-916e-4e91-9c89-e0bb05a2c425",
          "kind": "reclassify",
          "classificationPolicyId": "Main",
          "labelsToUpsert": {
            "escalated": true
          }
        }
      ]
    }
  ],
  "etag": "etag"
}

Updates an exception policy

Ukázkový požadavek

HTTP

PATCH https://contoso.westus.communications.azure.com/routing/exceptionPolicies/cf1cda69-6f41-45ac-b252-213293f1b1cb?api-version=2023-11-01

{
  "name": "Main test",
  "exceptionRules": [
    {
      "id": "MaxWaitTimeExceeded",
      "actions": [
        {
          "kind": "reclassify",
          "classificationPolicyId": "Main",
          "labelsToUpsert": {
            "escalated": true
          }
        }
      ],
      "trigger": {
        "kind": "waitTime",
        "thresholdSeconds": 20
      }
    }
  ]
}

Ukázková odpověď

Stavový kód:: 200

{
  "id": "cf1cda69-6f41-45ac-b252-213293f1b1cb",
  "name": "Main test",
  "exceptionRules": [
    {
      "id": "MaxWaitTimeExceeded",
      "trigger": {
        "kind": "waitTime",
        "thresholdSeconds": 20
      },
      "actions": [
        {
          "id": "babd4f6f-916e-4e91-9c89-e0bb05a2c425",
          "kind": "reclassify",
          "classificationPolicyId": "Main",
          "labelsToUpsert": {
            "escalated": true
          }
        }
      ]
    }
  ],
  "etag": "etag"
}

Stavový kód:: 201

{
  "id": "cf1cda69-6f41-45ac-b252-213293f1b1cb",
  "name": "Main test",
  "exceptionRules": [
    {
      "id": "MaxWaitTimeExceeded",
      "trigger": {
        "kind": "waitTime",
        "thresholdSeconds": 20
      },
      "actions": [
        {
          "id": "babd4f6f-916e-4e91-9c89-e0bb05a2c425",
          "kind": "reclassify",
          "classificationPolicyId": "Main",
          "labelsToUpsert": {
            "escalated": true
          }
        }
      ]
    }
  ],
  "etag": "etag"
}

Definice

Name	Description
Azure.Core.Foundations.Error	Objekt chyby.
Azure.Core.Foundations.ErrorResponse	Odpověď obsahující podrobnosti o chybě.
Azure.Core.Foundations.InnerError	Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní API Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
CancelExceptionAction	Akce, která označí úlohu jako zrušenou
ExceptionActionKind	Diskriminátory podporovaných typů akcí výjimek.
ExceptionPolicy	Zásada, která definuje akce, které se mají provést při aktivaci výjimky.
ExceptionPolicyCreateOrUpdate	Zásada, která definuje akce, které se mají provést při aktivaci výjimky.
ExceptionRule	Pravidlo, které definuje akce, které se mají provést na konkrétní aktivační události.
ExceptionTriggerKind	Diskriminátory podporovaných typů aktivačních událostí výjimek.
LabelOperator	Popisuje podporované operace s hodnotami popisků.
ManualReclassifyExceptionAction	Akce, která ručně přetřídí úlohu poskytnutím fronty, priority a selektorů pracovních procesů.
QueueLengthExceptionTrigger	Aktivace akce výjimky při překročení délky fronty
ReclassifyExceptionAction	Akce, která upraví popisky úlohy, a pak ji znovu klasifikuje.
RouterWorkerSelector	Popisuje podmínku, která musí být splněna u sady popisků pro výběr pracovního procesu.
RouterWorkerSelectorStatus	Popisuje stav selektoru pracovního procesu.
WaitTimeExceptionTrigger	Aktivace akce výjimky při překročení doby čekání

Azure.Core.Foundations.Error

Objekt

Objekt chyby.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
details	Azure.Core.Foundations.Error[]	Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
innererror	Azure.Core.Foundations.InnerError	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
message	string	Čitelné znázornění chyby člověkem.
target	string	Cíl chyby.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	Azure.Core.Foundations.Error	Objekt chyby.

Azure.Core.Foundations.InnerError

Objekt

Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní API Microsoft One – https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
innererror	Azure.Core.Foundations.InnerError	Vnitřní chyba.

CancelExceptionAction

Objekt

Akce, která označí úlohu jako zrušenou

Name	Typ	Description
dispositionCode	string	Označuje výsledek úlohy a naplní toto pole vlastními hodnotami.
id	string	Jedinečné ID akce výjimky.
kind	string: cancel	Typ diskriminující popis dílčího typu ExceptionAction.
note	string	Poznámka, která se připojí ke kolekci poznámek úlohy s aktuálním časovým razítkem.

ExceptionActionKind

Výčet

Diskriminátory podporovaných typů akcí výjimek.

Hodnota	Description
cancel	Diskriminující hodnota pro CancelExceptionAction.
manualReclassify	Diskriminující hodnota pro ManualReclassifyExceptionAction.
reclassify	Diskriminující hodnota pro ReclassifyExceptionAction.

ExceptionPolicy

Objekt

Zásada, která definuje akce, které se mají provést při aktivaci výjimky.

Name	Typ	Description
etag	string	Značka entity pro tento prostředek.
exceptionRules	ExceptionRule[]	Kolekce pravidel výjimek pro zásady výjimek.
id	string	ID zásady výjimky.
name	string	Popisný název této zásady

ExceptionPolicyCreateOrUpdate

Objekt

Zásada, která definuje akce, které se mají provést při aktivaci výjimky.

Name	Typ	Description
exceptionRules	ExceptionRule[]	Kolekce pravidel výjimek pro zásady výjimek.
name	string	Popisný název této zásady

ExceptionRule

Objekt

Pravidlo, které definuje akce, které se mají provést na konkrétní aktivační události.

Name	Typ	Description
actions	ExceptionAction[]: CancelExceptionAction[] ManualReclassifyExceptionAction[] ReclassifyExceptionAction[]	Kolekce akcí, které se mají provést po aktivaci výjimky.
id	string	ID pravidla výjimky.
trigger	ExceptionTrigger: QueueLengthExceptionTrigger WaitTimeExceptionTrigger	Aktivační událost pro toto pravidlo výjimky.

ExceptionTriggerKind

Výčet

Diskriminátory podporovaných typů aktivačních událostí výjimek.

Hodnota	Description
queueLength	Diskriminující hodnota pro QueueLengthExceptionTrigger.
waitTime	Diskriminující hodnota pro WaitTimeExceptionTrigger.

LabelOperator

Výčet

Popisuje podporované operace s hodnotami popisků.

Hodnota	Description
equal	Rovný.
greaterThan	Větší než.
greaterThanOrEqual	Větší než nebo rovno.
lessThan	Méně než.
lessThanOrEqual	Menší než nebo rovno.
notEqual	Nerovná se.

ManualReclassifyExceptionAction

Objekt

Akce, která ručně přetřídí úlohu poskytnutím fronty, priority a selektorů pracovních procesů.

Name	Typ	Description
id	string	Jedinečné ID akce výjimky.
kind	string: manualReclassify	Typ diskriminující popis dílčího typu ExceptionAction.
priority	integer (int32)	Aktualizace priority.
queueId	string	Aktualizace QueueId.
workerSelectors	RouterWorkerSelector[]	Aktualizované pracovní výběry.

QueueLengthExceptionTrigger

Objekt

Aktivace akce výjimky při překročení délky fronty

Name	Typ	Description
kind	string: queueLength	Typ diskriminující popis podtypu ExceptionTrigger.
threshold	integer (int32)	Prahová hodnota počtu úloh před frontou, aby se tento trigger aktivoval.

ReclassifyExceptionAction

Objekt

Akce, která upraví popisky úlohy, a pak ji znovu klasifikuje.

Name	Typ	Description
classificationPolicyId	string	Nové zásady klasifikace, které určují frontu, prioritu a selektory pracovních procesů.
id	string	Jedinečné ID akce výjimky.
kind	string: reclassify	Typ diskriminující popis dílčího typu ExceptionAction.
labelsToUpsert		Slovník obsahující popisky, které se mají aktualizovat (nebo přidat, pokud neexistují) ve dvojicích klíč-hodnota. Hodnoty musí být primitivní hodnoty – číslo, řetězec, logická hodnota.

RouterWorkerSelector

Objekt

Popisuje podmínku, která musí být splněna u sady popisků pro výběr pracovního procesu.

Name	Typ	Description
expedite	boolean	Nasdílí úlohu do fronty, pokud je tento selektor aktivní.
expiresAfterSeconds	number (double)	Popisuje, jak dlouho je tento selektor popisků platný v sekundách.
expiresAt	string (date-time)	Čas vypršení platnosti tohoto selektoru pracovního procesu ve standardu UTC.
key	string	Klíč popisku pro dotazování.
labelOperator	LabelOperator	Popisuje, jak se hodnota popisku porovnává s hodnotou definovanou v selektoru pracovního procesu.
status	RouterWorkerSelectorStatus	Stav selektoru pracovního procesu
value		Hodnota, která se má porovnat se skutečnou hodnotou popisku s daným operátorem. Hodnoty musí být primitivní hodnoty – číslo, řetězec, logická hodnota.

RouterWorkerSelectorStatus

Výčet

Popisuje stav selektoru pracovního procesu.

Hodnota	Description
active	Selektor pracovního procesu je platný.
expired	Selektor pracovního procesu není platný.

WaitTimeExceptionTrigger

Objekt

Aktivace akce výjimky při překročení doby čekání

Name	Typ	Description
kind	string: waitTime	Typ diskriminující popis podtypu ExceptionTrigger.
thresholdSeconds	number (double)	Prahová hodnota pro dobu čekání pro tento trigger

Sdílet prostřednictvím

Job Router Administration Operations - Upsert Exception Policy

Parametry identifikátoru URI

Hlavička požadavku

Text požadavku

Odpovědi

Zabezpečení

AadOauth2Auth

Rozsahy

Příklady

Creates an exception policy

Ukázkový požadavek

Ukázková odpověď

Updates an exception policy

Ukázkový požadavek

Ukázková odpověď

Definice

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

CancelExceptionAction

ExceptionActionKind

ExceptionPolicy

ExceptionPolicyCreateOrUpdate

ExceptionRule

ExceptionTriggerKind

LabelOperator

ManualReclassifyExceptionAction

QueueLengthExceptionTrigger

ReclassifyExceptionAction

RouterWorkerSelector

RouterWorkerSelectorStatus

WaitTimeExceptionTrigger

Další materiály