Job Router Administration Operations - Upsert Distribution Policy
Vytvoří nebo aktualizuje zásady distribuce.
PATCH {endpoint}/routing/distributionPolicies/{distributionPolicyId}?api-version=2023-11-01
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
distribution
|
path | True |
string |
ID zásady distribuce. |
endpoint
|
path | True |
string |
Identifikátor URI vašeho komunikačního prostředku |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro tuto operaci. |
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. |
Media Types: "application/merge-patch+json"
Name | Typ | Description |
---|---|---|
mode | DistributionModeCreateOrUpdate: |
Režim řízení konkrétní metody distribuce |
name |
string |
Popisný název této zásady |
offerExpiresAfterSeconds |
number |
Počet sekund, po jejichž uplynutí vyprší platnost všech nabídek vytvořených v rámci této zásady. |
Name | Typ | Description |
---|---|---|
200 OK |
Požadavek byl úspěšný. Hlavičky
|
|
201 Created |
Požadavek byl úspěšný a v důsledku toho byl vytvořen nový prostředek. Hlavičky
|
|
Other Status Codes |
Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string |
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
Name | Description |
---|---|
https://communication.azure.com/.default |
Ukázkový požadavek
PATCH https://contoso.westus.communications.azure.com/routing/distributionPolicies/d9033d56-659c-437a-b5b7-4f3b14301dd4?api-version=2023-11-01
{
"mode": {
"kind": "longestIdle",
"minConcurrentOffers": 1,
"maxConcurrentOffers": 5,
"bypassSelectors": false
},
"offerExpiresAfterSeconds": 300,
"name": "Main"
}
Ukázková odpověď
{
"id": "d9033d56-659c-437a-b5b7-4f3b14301dd4",
"name": "Main",
"offerExpiresAfterSeconds": 300,
"mode": {
"kind": "longestIdle",
"minConcurrentOffers": 1,
"maxConcurrentOffers": 5,
"bypassSelectors": false
},
"etag": "etag"
}
{
"id": "d9033d56-659c-437a-b5b7-4f3b14301dd4",
"name": "Main",
"offerExpiresAfterSeconds": 300,
"mode": {
"kind": "longestIdle",
"minConcurrentOffers": 1,
"maxConcurrentOffers": 5,
"bypassSelectors": false
},
"etag": "etag"
}
Ukázkový požadavek
PATCH https://contoso.westus.communications.azure.com/routing/distributionPolicies/d9033d56-659c-437a-b5b7-4f3b14301dd4?api-version=2023-11-01
{
"mode": {
"kind": "longestIdle",
"minConcurrentOffers": 1,
"maxConcurrentOffers": 5,
"bypassSelectors": false
},
"offerExpiresAfterSeconds": 300,
"name": "Main"
}
Ukázková odpověď
{
"id": "d9033d56-659c-437a-b5b7-4f3b14301dd4",
"name": "Main",
"offerExpiresAfterSeconds": 300,
"mode": {
"kind": "longestIdle",
"minConcurrentOffers": 1,
"maxConcurrentOffers": 5,
"bypassSelectors": false
},
"etag": "etag"
}
{
"id": "d9033d56-659c-437a-b5b7-4f3b14301dd4",
"name": "Main",
"offerExpiresAfterSeconds": 300,
"mode": {
"kind": "longestIdle",
"minConcurrentOffers": 1,
"maxConcurrentOffers": 5,
"bypassSelectors": false
},
"etag": "etag"
}
Name | Description |
---|---|
Azure. |
Objekt chyby. |
Azure. |
Odpověď obsahující podrobnosti o chybě. |
Azure. |
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. |
Best |
Úlohy se distribuují pracovnímu procesu s nejsilnějšími dostupnými schopnostmi. |
Best |
Úlohy se distribuují pracovnímu procesu s nejsilnějšími dostupnými schopnostmi. |
Direct |
Pravidlo, které vrátí stejné popisky jako vstupní popisky. |
Direct |
Pravidlo, které vrátí stejné popisky jako vstupní popisky. |
Distribution |
Diskriminátor podporovaných typů distribučního režimu. |
Distribution |
Zásady, kterými se řídí způsob distribuce úloh pracovníkům |
Distribution |
Zásady, kterými se řídí způsob distribuce úloh pracovníkům |
Expression |
Pravidlo poskytující pravidla vložených výrazů. |
Expression |
Pravidlo poskytující pravidla vložených výrazů. |
Expression |
Dostupné jazyky výrazů, které lze konfigurovat. |
Function |
Pravidlo poskytující vazbu na funkci Azure aktivovanou protokolem HTTP |
Function |
Pravidlo poskytující vazbu na funkci Azure aktivovanou protokolem HTTP |
Function |
Přihlašovací údaje používané pro přístup k pravidlu funkce Azure. |
Longest |
Úlohy se směrují na pracovníka, který byl nejdéle nečinný. |
Longest |
Úlohy se směrují na pracovníka, který byl nejdéle nečinný. |
OAuth2Webhook |
Přihlašovací údaje OAuth2.0 používané k autorizačnímu serveru společnosti Contoso. Referenční informace: https://www.oauth.com/oauth2-servers/access-tokens/client-credentials/ |
Round |
Úlohy se distribuují pracovníkům, počínaje pracovníkem, který je po posledním pracovním procesu, aby získal úlohu. |
Round |
Úlohy se distribuují pracovníkům, počínaje pracovníkem, který je po posledním pracovním procesu, aby získal úlohu. |
Router |
Diskriminátor podporovaných typů pravidel směrovače. |
Scoring |
Zapouzdřuje všechny možnosti, které lze předat jako parametry pro bodovací pravidlo pomocí BestWorkerMode. |
Scoring |
Podporované parametry pro hodnoticí pracovní procesy používané s BestWorkerMode. |
Static |
Pravidlo poskytující statická pravidla, která vždy vrací stejný výsledek bez ohledu na vstup. |
Static |
Pravidlo poskytující statická pravidla, která vždy vrací stejný výsledek bez ohledu na vstup. |
Webhook |
Pravidlo poskytující vazbu na externí webový server. |
Webhook |
Pravidlo poskytující vazbu na externí webový server. |
Objekt chyby.
Name | Typ | Description |
---|---|---|
code |
string |
Jedna ze serverově definovaných kódů chyb. |
details |
Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě. |
|
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. |
Odpověď obsahující podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
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 |
Vnitřní chyba. |
Úlohy se distribuují pracovnímu procesu s nejsilnějšími dostupnými schopnostmi.
Name | Typ | Default value | Description |
---|---|---|---|
bypassSelectors |
boolean |
False |
Pokud je nastavená hodnota true, bude směrovač odpovídat pracovním procesům i v případě, že neodpovídají selektorům popisků. Upozornění: Pokud tuto proměnnou nastavíte na hodnotu true, můžete získat pracovníky, kteří nejsou kvalifikovaní pro úlohu. Tento příznak je určený pro dočasné použití. Ve výchozím nastavení je nastavená hodnota false. |
kind |
string:
best |
Typ diskriminující popis dílčího typu DistributionMode. |
|
maxConcurrentOffers |
integer |
1 |
Určuje maximální počet aktivních souběžných nabídek, které může mít úloha. |
minConcurrentOffers |
integer |
1 |
Určuje minimální požadovaný počet aktivních souběžných nabídek, které může mít úloha. |
scoringRule | RouterRule: |
Při výpočtu skóre pro určení nejlepšího pracovního procesu definujte pravidlo bodování, které se má použít. Pokud není nastavená hodnota, použije se výchozí bodovací vzorec, který používá počet popisků úloh, které se popisky pracovního procesu shodují, a také počet selektorů popisků, které se budou shodovat s popisky pracovního procesu nebo které překračují pomocí logistické funkce (https://en.wikipedia.org/wiki/Logistic_function). |
|
scoringRuleOptions |
Možnosti konfigurace hodnoticího pravidla Pokud není nastavená, použijí se výchozí hodnoty. |
Úlohy se distribuují pracovnímu procesu s nejsilnějšími dostupnými schopnostmi.
Name | Typ | Default value | Description |
---|---|---|---|
bypassSelectors |
boolean |
False |
Pokud je nastavená hodnota true, bude směrovač odpovídat pracovním procesům i v případě, že neodpovídají selektorům popisků. Upozornění: Pokud tuto proměnnou nastavíte na hodnotu true, můžete získat pracovníky, kteří nejsou kvalifikovaní pro úlohu. Tento příznak je určený pro dočasné použití. Ve výchozím nastavení je nastavená hodnota false. |
kind |
string:
best |
Typ diskriminující popis dílčího typu DistributionMode. |
|
maxConcurrentOffers |
integer |
1 |
Určuje maximální počet aktivních souběžných nabídek, které může mít úloha. |
minConcurrentOffers |
integer |
1 |
Určuje minimální požadovaný počet aktivních souběžných nabídek, které může mít úloha. |
scoringRule | RouterRuleCreateOrUpdate: |
Při výpočtu skóre pro určení nejlepšího pracovního procesu definujte pravidlo bodování, které se má použít. Pokud není nastavená hodnota, použije se výchozí bodovací vzorec, který používá počet popisků úloh, které se popisky pracovního procesu shodují, a také počet selektorů popisků, které se budou shodovat s popisky pracovního procesu nebo které překračují pomocí logistické funkce (https://en.wikipedia.org/wiki/Logistic_function). |
|
scoringRuleOptions |
Možnosti konfigurace hodnoticího pravidla Pokud není nastavená, použijí se výchozí hodnoty. |
Pravidlo, které vrátí stejné popisky jako vstupní popisky.
Name | Typ | Description |
---|---|---|
kind |
string:
direct |
Typ diskriminující popis podtypu RouterRule |
Pravidlo, které vrátí stejné popisky jako vstupní popisky.
Name | Typ | Description |
---|---|---|
kind |
string:
direct |
Typ diskriminující popis podtypu RouterRule |
Diskriminátor podporovaných typů distribučního režimu.
Name | Typ | Description |
---|---|---|
bestWorker |
string |
Diskriminující hodnota pro BestWorkerMode. |
longestIdle |
string |
Diskriminující hodnota pro LongestIdleMode. |
roundRobin |
string |
Diskriminační hodnota pro RoundRobinMode. |
Zásady, kterými se řídí způsob distribuce úloh pracovníkům
Name | Typ | Description |
---|---|---|
etag |
string |
Značka entity pro tento prostředek. |
id |
string |
ID zásady distribuce. |
mode | DistributionMode: |
Režim řízení konkrétní metody distribuce |
name |
string |
Popisný název této zásady |
offerExpiresAfterSeconds |
number |
Počet sekund, po jejichž uplynutí vyprší platnost všech nabídek vytvořených v rámci této zásady. |
Zásady, kterými se řídí způsob distribuce úloh pracovníkům
Name | Typ | Description |
---|---|---|
mode | DistributionModeCreateOrUpdate: |
Režim řízení konkrétní metody distribuce |
name |
string |
Popisný název této zásady |
offerExpiresAfterSeconds |
number |
Počet sekund, po jejichž uplynutí vyprší platnost všech nabídek vytvořených v rámci této zásady. |
Pravidlo poskytující pravidla vložených výrazů.
Name | Typ | Description |
---|---|---|
expression |
string |
Výraz, který se má vyhodnotit. Měl by obsahovat návratový příkaz s počítanými hodnotami. |
kind |
string:
expression |
Typ diskriminující popis podtypu RouterRule |
language |
Jazyk výrazu pro kompilaci a spuštění. |
Pravidlo poskytující pravidla vložených výrazů.
Name | Typ | Description |
---|---|---|
expression |
string |
Výraz, který se má vyhodnotit. Měl by obsahovat návratový příkaz s počítanými hodnotami. |
kind |
string:
expression |
Typ diskriminující popis podtypu RouterRule |
language |
Jazyk výrazu pro kompilaci a spuštění. |
Dostupné jazyky výrazů, které lze konfigurovat.
Name | Typ | Description |
---|---|---|
powerFx |
string |
PowerFx |
Pravidlo poskytující vazbu na funkci Azure aktivovanou protokolem HTTP
Name | Typ | Description |
---|---|---|
credential |
Přihlašovací údaje používané pro přístup k pravidlu funkce Azure. |
|
functionUri |
string |
Adresa URL pro funkci Azure Functions |
kind |
string:
function |
Typ diskriminující popis podtypu RouterRule |
Pravidlo poskytující vazbu na funkci Azure aktivovanou protokolem HTTP
Name | Typ | Description |
---|---|---|
credential |
Přihlašovací údaje používané pro přístup k pravidlu funkce Azure. |
|
functionUri |
string |
Adresa URL pro funkci Azure Functions |
kind |
string:
function |
Typ diskriminující popis podtypu RouterRule |
Přihlašovací údaje používané pro přístup k pravidlu funkce Azure.
Name | Typ | Description |
---|---|---|
appKey |
string |
Přístupový klíč vymezený na aplikaci Funkcí Azure. Tento klíč uděluje přístup ke všem funkcím v aplikaci. |
clientId |
string |
ID klienta, pokud je appKey zadaný v kontextu funkce Azure, je to obvykle název klíče. |
functionKey |
string |
Přístupový klíč vymezený na konkrétní funkci. |
Úlohy se směrují na pracovníka, který byl nejdéle nečinný.
Name | Typ | Default value | Description |
---|---|---|---|
bypassSelectors |
boolean |
False |
Pokud je nastavená hodnota true, bude směrovač odpovídat pracovním procesům i v případě, že neodpovídají selektorům popisků. Upozornění: Pokud tuto proměnnou nastavíte na hodnotu true, můžete získat pracovníky, kteří nejsou kvalifikovaní pro úlohu. Tento příznak je určený pro dočasné použití. Ve výchozím nastavení je nastavená hodnota false. |
kind |
string:
longest |
Typ diskriminující popis dílčího typu DistributionMode. |
|
maxConcurrentOffers |
integer |
1 |
Určuje maximální počet aktivních souběžných nabídek, které může mít úloha. |
minConcurrentOffers |
integer |
1 |
Určuje minimální požadovaný počet aktivních souběžných nabídek, které může mít úloha. |
Úlohy se směrují na pracovníka, který byl nejdéle nečinný.
Name | Typ | Default value | Description |
---|---|---|---|
bypassSelectors |
boolean |
False |
Pokud je nastavená hodnota true, bude směrovač odpovídat pracovním procesům i v případě, že neodpovídají selektorům popisků. Upozornění: Pokud tuto proměnnou nastavíte na hodnotu true, můžete získat pracovníky, kteří nejsou kvalifikovaní pro úlohu. Tento příznak je určený pro dočasné použití. Ve výchozím nastavení je nastavená hodnota false. |
kind |
string:
longest |
Typ diskriminující popis dílčího typu DistributionMode. |
|
maxConcurrentOffers |
integer |
1 |
Určuje maximální počet aktivních souběžných nabídek, které může mít úloha. |
minConcurrentOffers |
integer |
1 |
Určuje minimální požadovaný počet aktivních souběžných nabídek, které může mít úloha. |
Přihlašovací údaje OAuth2.0 používané k autorizačnímu serveru společnosti Contoso. Referenční informace: https://www.oauth.com/oauth2-servers/access-tokens/client-credentials/
Name | Typ | Description |
---|---|---|
clientId |
string |
ClientId pro autorizační server Společnosti Contoso. |
clientSecret |
string |
Tajný klíč klienta pro autorizační server Společnosti Contoso. |
Úlohy se distribuují pracovníkům, počínaje pracovníkem, který je po posledním pracovním procesu, aby získal úlohu.
Name | Typ | Default value | Description |
---|---|---|---|
bypassSelectors |
boolean |
False |
Pokud je nastavená hodnota true, bude směrovač odpovídat pracovním procesům i v případě, že neodpovídají selektorům popisků. Upozornění: Pokud tuto proměnnou nastavíte na hodnotu true, můžete získat pracovníky, kteří nejsou kvalifikovaní pro úlohu. Tento příznak je určený pro dočasné použití. Ve výchozím nastavení je nastavená hodnota false. |
kind |
string:
round |
Typ diskriminující popis dílčího typu DistributionMode. |
|
maxConcurrentOffers |
integer |
1 |
Určuje maximální počet aktivních souběžných nabídek, které může mít úloha. |
minConcurrentOffers |
integer |
1 |
Určuje minimální požadovaný počet aktivních souběžných nabídek, které může mít úloha. |
Úlohy se distribuují pracovníkům, počínaje pracovníkem, který je po posledním pracovním procesu, aby získal úlohu.
Name | Typ | Default value | Description |
---|---|---|---|
bypassSelectors |
boolean |
False |
Pokud je nastavená hodnota true, bude směrovač odpovídat pracovním procesům i v případě, že neodpovídají selektorům popisků. Upozornění: Pokud tuto proměnnou nastavíte na hodnotu true, můžete získat pracovníky, kteří nejsou kvalifikovaní pro úlohu. Tento příznak je určený pro dočasné použití. Ve výchozím nastavení je nastavená hodnota false. |
kind |
string:
round |
Typ diskriminující popis dílčího typu DistributionMode. |
|
maxConcurrentOffers |
integer |
1 |
Určuje maximální počet aktivních souběžných nabídek, které může mít úloha. |
minConcurrentOffers |
integer |
1 |
Určuje minimální požadovaný počet aktivních souběžných nabídek, které může mít úloha. |
Diskriminátor podporovaných typů pravidel směrovače.
Name | Typ | Description |
---|---|---|
directMap |
string |
Diskriminující hodnota pro DirectMapRouterRule. |
expression |
string |
Diskriminující hodnota pro ExpressionRouterRule. |
function |
string |
Diskriminující hodnota pro FunctionRouterRule. |
static |
string |
Diskriminující hodnota pro StaticRouterRule. |
webhook |
string |
Diskriminující hodnota pro WebhookRouterRule. |
Zapouzdřuje všechny možnosti, které lze předat jako parametry pro bodovací pravidlo pomocí BestWorkerMode.
Name | Typ | Default value | Description |
---|---|---|---|
batchSize |
integer |
20 |
Nastavte velikost dávky, pokud je hodnota isBatchScoringEnabled nastavená na hodnotu true. Výchozí hodnota je 20, pokud není nakonfigurovaná. |
descendingOrder |
boolean |
True |
Pokud je false, seřadí skóre vzestupně. Ve výchozím nastavení je nastavená hodnota true. |
isBatchScoringEnabled |
boolean |
False |
Pokud je nastavena hodnota true, bude skóre pracovních procesů v dávkách a název parametru popisků pracovních procesů se odešle jako |
scoringParameters | [ "jobLabels", "workerSelectors" ] |
Seznam dalších parametrů z úlohy, která se odešle jako součást datové části do pravidla bodování Pokud není nastavená, popisky úlohy (odeslané v datové části jako |
Podporované parametry pro hodnoticí pracovní procesy používané s BestWorkerMode.
Name | Typ | Description |
---|---|---|
jobLabels |
string |
Parametr pro přidání popisků úloh do datové části bodování Vlastnost je odeslána jako |
workerSelectors |
string |
Parametr pro přidání selektorů pracovního procesu z úlohy do datové části bodování Vlastnost je odeslána jako |
Pravidlo poskytující statická pravidla, která vždy vrací stejný výsledek bez ohledu na vstup.
Name | Typ | Description |
---|---|---|
kind |
string:
static |
Typ diskriminující popis podtypu RouterRule |
value |
Statická hodnota, kterou toto pravidlo vždy vrátí. Hodnoty musí být primitivní hodnoty – číslo, řetězec, logická hodnota. |
Pravidlo poskytující statická pravidla, která vždy vrací stejný výsledek bez ohledu na vstup.
Name | Typ | Description |
---|---|---|
kind |
string:
static |
Typ diskriminující popis podtypu RouterRule |
value |
Statická hodnota, kterou toto pravidlo vždy vrátí. Hodnoty musí být primitivní hodnoty – číslo, řetězec, logická hodnota. |
Pravidlo poskytující vazbu na externí webový server.
Name | Typ | Description |
---|---|---|
authorizationServerUri |
string |
Identifikátor URI pro autorizační server |
clientCredential |
Přihlašovací údaje OAuth2.0 používané k autorizačnímu serveru společnosti Contoso. Referenční informace: https://www.oauth.com/oauth2-servers/access-tokens/client-credentials/ |
|
kind |
string:
webhook |
Typ diskriminující popis podtypu RouterRule |
webhookUri |
string |
Identifikátor URI webového serveru společnosti Contoso. |
Pravidlo poskytující vazbu na externí webový server.
Name | Typ | Description |
---|---|---|
authorizationServerUri |
string |
Identifikátor URI pro autorizační server |
clientCredential |
Přihlašovací údaje OAuth2.0 používané k autorizačnímu serveru společnosti Contoso. Referenční informace: https://www.oauth.com/oauth2-servers/access-tokens/client-credentials/ |
|
kind |
string:
webhook |
Typ diskriminující popis podtypu RouterRule |
webhookUri |
string |
Identifikátor URI webového serveru společnosti Contoso. |