Job Router Administration Operations - Get Classification Policy

Servizio:

Communication

Versione API:

2023-11-01

Recupera un criterio di classificazione esistente in base all'ID.

GET {endpoint}/routing/classificationPolicies/{classificationPolicyId}?api-version=2023-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
classificationPolicyId	path	True	string	ID di un criterio di classificazione.
endpoint	path	True	string	URI della risorsa di comunicazione
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	ClassificationPolicy	La richiesta ha avuto esito positivo. Intestazioni ETag: string Last-Modified: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Sicurezza

AadOauth2Auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize
URL token: https://login.microsoftonline.com/common/oauth2/token

Ambiti

Nome	Descrizione
https://communication.azure.com/.default

Esempio

Retrieves an existing classification policy by Id

Esempio di richiesta

HTTP

GET https://contoso.westus.communications.azure.com/routing/classificationPolicies/MainClassificationPolicy?api-version=2023-11-01

Risposta di esempio

Codice di stato:

200

{
  "id": "MainClassificationPolicy",
  "name": "Main",
  "fallbackQueueId": "MainQueue",
  "queueSelectorAttachments": [
    {
      "kind": "conditional",
      "condition": {
        "kind": "expression",
        "language": "powerFx",
        "expression": "1 = 1"
      },
      "queueSelectors": [
        {
          "key": "foo",
          "labelOperator": "equal",
          "value": "bar"
        }
      ]
    }
  ],
  "prioritizationRule": {
    "kind": "static",
    "value": "2"
  },
  "workerSelectorAttachments": [
    {
      "kind": "passThrough",
      "key": "language",
      "labelOperator": "equal"
    }
  ],
  "etag": "etag"
}

Definizioni

Nome	Descrizione
Azure.Core.Foundations.Error	Oggetto error.
Azure.Core.Foundations.ErrorResponse	Risposta contenente i dettagli dell'errore.
Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API Microsoft One , https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
ClassificationPolicy	Contenitore per le regole che regolano la classificazione dei processi.
ConditionalQueueSelectorAttachment	Descrive un set di selettori di coda che verranno associati se la condizione specificata viene risolta in true.
ConditionalWorkerSelectorAttachment	Descrive un set di selettori di lavoro che verranno associati se la condizione specificata viene risolta in true.
DirectMapRouterRule	Regola che restituisce le stesse etichette delle etichette di input.
ExpressionRouterRule	Regola che fornisce regole di espressione inline.
ExpressionRouterRuleLanguage	Linguaggi di espressione disponibili che possono essere configurati.
FunctionRouterRule	Regola che fornisce un'associazione a una funzione di Azure attivata da HTTP.
FunctionRouterRuleCredential	Credenziali usate per accedere alla regola della funzione di Azure.
LabelOperator	Vengono descritte le operazioni supportate sui valori delle etichette.
OAuth2WebhookClientCredential	Credenziali OAuth2.0 usate per il server di autorizzazione di Contoso. Riferimento: https://www.oauth.com/oauth2-servers/access-tokens/client-credentials/
PassThroughQueueSelectorAttachment	Collega un selettore di coda in cui il valore viene passato dall'etichetta di un processo con la stessa chiave.
PassThroughWorkerSelectorAttachment	Collega un selettore di lavoro in cui il valore viene passato dall'etichetta di un processo con la stessa chiave.
QueueSelectorAttachmentKind	Discriminanti per i tipi di allegati del selettore di coda supportati.
QueueWeightedAllocation	Contiene i selettori di percentuale di peso e coda da applicare se selezionati per le distribuzioni ponderate.
RouterQueueSelector	Descrive una condizione che deve essere soddisfatta rispetto a un set di etichette per la selezione della coda.
RouterRuleKind	Discriminanti per i tipi di regola router supportati.
RouterWorkerSelector	Descrive una condizione che deve essere soddisfatta in base a un set di etichette per la selezione del ruolo di lavoro.
RouterWorkerSelectorStatus	Descrive lo stato di un selettore di lavoro.
RuleEngineQueueSelectorAttachment	Collega i selettori di coda a un processo quando routerRule viene risolto.
RuleEngineWorkerSelectorAttachment	Collega i selettori di lavoro a un processo quando viene risolto un RouterRule.
StaticQueueSelectorAttachment	Descrive un selettore di coda che verrà collegato a un processo.
StaticRouterRule	Regola che fornisce regole statiche che restituiscono sempre lo stesso risultato, indipendentemente dall'input.
StaticWorkerSelectorAttachment	Descrive un selettore di lavoro che verrà collegato a un processo.
WebhookRouterRule	Regola che fornisce un'associazione a un server Web esterno.
WeightedAllocationQueueSelectorAttachment	Descrive più set di selettori di coda, di cui uno verrà selezionato e collegato in base a un peso.
WeightedAllocationWorkerSelectorAttachment	Descrive più set di selettori di lavoro, di cui uno verrà selezionato e collegato in base a un peso.
WorkerSelectorAttachmentKind	Discriminanti per i tipi di allegati del selettore di lavoro supportati.
WorkerWeightedAllocation	Contiene la percentuale di peso e i selettori di lavoro da applicare se selezionati per le distribuzioni ponderate.

Azure.Core.Foundations.Error

Oggetto error.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	Azure.Core.Foundations.Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

Azure.Core.Foundations.ErrorResponse

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	Azure.Core.Foundations.Error	Oggetto error.

Azure.Core.Foundations.InnerError

Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API Microsoft One , https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
innererror	Azure.Core.Foundations.InnerError	Errore interno.

ClassificationPolicy

Contenitore per le regole che regolano la classificazione dei processi.

Nome	Tipo	Descrizione
etag	string	Tag di entità per questa risorsa.
fallbackQueueId	string	ID di una coda di fallback da selezionare se gli allegati del selettore di coda non trovano una corrispondenza.
id	string	ID di un criterio di classificazione.
name	string	Nome descrittivo di questo criterio.
prioritizationRule	RouterRule: DirectMapRouterRule ExpressionRouterRule FunctionRouterRule StaticRouterRule WebhookRouterRule	Regola per determinare un punteggio di priorità per un processo.
queueSelectorAttachments	QueueSelectorAttachment[]: ConditionalQueueSelectorAttachment[] PassThroughQueueSelectorAttachment[] RuleEngineQueueSelectorAttachment[] StaticQueueSelectorAttachment[] WeightedAllocationQueueSelectorAttachment[]	Allegati del selettore di coda usati per risolvere una coda per un processo.
workerSelectorAttachments	WorkerSelectorAttachment[]: ConditionalWorkerSelectorAttachment[] PassThroughWorkerSelectorAttachment[] RuleEngineWorkerSelectorAttachment[] StaticWorkerSelectorAttachment[] WeightedAllocationWorkerSelectorAttachment[]	Allegati del selettore di lavoro usati per collegare i selettori di lavoro a un processo.

ConditionalQueueSelectorAttachment

Descrive un set di selettori di coda che verranno associati se la condizione specificata viene risolta in true.

Nome	Tipo	Descrizione
condition	RouterRule: DirectMapRouterRule ExpressionRouterRule FunctionRouterRule StaticRouterRule WebhookRouterRule	Condizione che deve essere true per i selettori di coda da associare.
kind	string: conditional	Il discriminante del tipo che descrive un sottotipo di QueueSelectorAttachment.
queueSelectors	RouterQueueSelector[]	Selettori di coda da collegare.

ConditionalWorkerSelectorAttachment

Descrive un set di selettori di lavoro che verranno associati se la condizione specificata viene risolta in true.

Nome	Tipo	Descrizione
condition	RouterRule: DirectMapRouterRule ExpressionRouterRule FunctionRouterRule StaticRouterRule WebhookRouterRule	Condizione che deve essere true per i selettori di lavoro da associare.
kind	string: conditional	Il discriminante del tipo che descrive un sottotipo di WorkerSelectorAttachment.
workerSelectors	RouterWorkerSelector[]	Selettori di lavoro da collegare.

DirectMapRouterRule

Regola che restituisce le stesse etichette delle etichette di input.

Nome	Tipo	Descrizione
kind	string: directMap	Il discriminante del tipo che descrive un sottotipo di RouterRule

ExpressionRouterRule

Regola che fornisce regole di espressione inline.

Nome	Tipo	Descrizione
expression	string	Espressione da valutare. Deve contenere un'istruzione return con valori calcolati.
kind	string: expression	Il discriminante del tipo che descrive un sottotipo di RouterRule
language	ExpressionRouterRuleLanguage	Linguaggio delle espressioni da compilare ed eseguire.

ExpressionRouterRuleLanguage

Linguaggi di espressione disponibili che possono essere configurati.

Nome	Tipo	Descrizione
powerFx	string	PowerFx

FunctionRouterRule

Regola che fornisce un'associazione a una funzione di Azure attivata da HTTP.

Nome	Tipo	Descrizione
credential	FunctionRouterRuleCredential	Credenziali usate per accedere alla regola della funzione di Azure.
functionUri	string	URL per la funzione di Azure.
kind	string: function	Il discriminante del tipo che descrive un sottotipo di RouterRule

FunctionRouterRuleCredential

Credenziali usate per accedere alla regola della funzione di Azure.

Nome	Tipo	Descrizione
appKey	string	Chiave di accesso con ambito a un'app per le funzioni di Azure. Questa chiave concede l'accesso a tutte le funzioni nell'app.
clientId	string	ID client, quando AppKey viene fornito Nel contesto della funzione di Azure, questo è in genere il nome della chiave.
functionKey	string	Chiave di accesso con ambito a una funzione specifica.

LabelOperator

Vengono descritte le operazioni supportate sui valori delle etichette.

Nome	Tipo	Descrizione
equal	string	Uguale.
greaterThan	string	Maggiore.
greaterThanOrEqual	string	Maggiore o uguale a.
lessThan	string	Meno di.
lessThanOrEqual	string	Minore o uguale a.
notEqual	string	Diverso da.

OAuth2WebhookClientCredential

Credenziali OAuth2.0 usate per il server di autorizzazione di Contoso. Riferimento: https://www.oauth.com/oauth2-servers/access-tokens/client-credentials/

Nome	Tipo	Descrizione
clientId	string	ClientId per il server di autorizzazione Contoso.
clientSecret	string	Segreto client per il server di autorizzazione Contoso.

PassThroughQueueSelectorAttachment

Collega un selettore di coda in cui il valore viene passato dall'etichetta di un processo con la stessa chiave.

Nome	Tipo	Descrizione
key	string	Chiave dell'etichetta su cui eseguire una query.
kind	string: passThrough	Il discriminante del tipo che descrive un sottotipo di QueueSelectorAttachment.
labelOperator	LabelOperator	Descrive il modo in cui il valore dell'etichetta viene confrontato con il pass-through del valore.

PassThroughWorkerSelectorAttachment

Collega un selettore di lavoro in cui il valore viene passato dall'etichetta di un processo con la stessa chiave.

Nome	Tipo	Descrizione
expiresAfterSeconds	number	Descrive per quanto tempo il selettore di etichette associato è valido in secondi.
key	string	Chiave dell'etichetta su cui eseguire una query.
kind	string: passThrough	Il discriminante del tipo che descrive un sottotipo di WorkerSelectorAttachment.
labelOperator	LabelOperator	Descrive il modo in cui il valore dell'etichetta viene confrontato con il pass-through del valore.

QueueSelectorAttachmentKind

Discriminanti per i tipi di allegati del selettore di coda supportati.

Nome	Tipo	Descrizione
conditional	string	Valore discriminatorio per ConditionalQueueSelectorAttachment.
passThrough	string	Valore discriminatorio per PassThroughQueueSelectorAttachment.
ruleEngine	string	Valore discriminatorio per RuleEngineQueueSelectorAttachment.
static	string	Valore discriminatorio per StaticQueueSelectorAttachment.
weightedAllocation	string	Valore discriminatorio per WeightedAllocationQueueSelectorAttachment.

QueueWeightedAllocation

Contiene i selettori di percentuale di peso e coda da applicare se selezionati per le distribuzioni ponderate.

Nome	Tipo	Descrizione
queueSelectors	RouterQueueSelector[]	Raccolta di selettori di coda che verranno applicati se questa allocazione è selezionata.
weight	number	Percentuale di questo peso, espressa come frazione di 1.

RouterQueueSelector

Descrive una condizione che deve essere soddisfatta rispetto a un set di etichette per la selezione della coda.

Nome	Tipo	Descrizione
key	string	Chiave dell'etichetta su cui eseguire una query.
labelOperator	LabelOperator	Descrive il modo in cui il valore dell'etichetta viene confrontato con il valore definito nel selettore di etichette.
value		Valore da confrontare con il valore effettivo dell'etichetta con l'operatore specificato. I valori devono essere valori primitivi: numero, stringa, booleano.

RouterRuleKind

Discriminanti per i tipi di regola router supportati.

Nome	Tipo	Descrizione
directMap	string	Valore discriminatorio per DirectMapRouterRule.
expression	string	Valore discriminatorio per ExpressionRouterRule.
function	string	Valore discriminatorio per FunctionRouterRule.
static	string	Valore discriminatorio per StaticRouterRule.
webhook	string	Valore discriminatorio per WebhookRouterRule.

RouterWorkerSelector

Descrive una condizione che deve essere soddisfatta in base a un set di etichette per la selezione del ruolo di lavoro.

Nome	Tipo	Descrizione
expedite	boolean	Esegue il push di un processo all'inizio della coda, purché questo selettore sia attivo.
expiresAfterSeconds	number	Descrive per quanto tempo questo selettore di etichetta è valido in secondi.
expiresAt	string	Ora in cui il selettore del ruolo di lavoro scade in formato UTC.
key	string	Chiave dell'etichetta su cui eseguire una query.
labelOperator	LabelOperator	Descrive il modo in cui il valore dell'etichetta viene confrontato con il valore definito nel selettore di lavoro.
status	RouterWorkerSelectorStatus	Stato del selettore di lavoro.
value		Valore da confrontare con il valore effettivo dell'etichetta con l'operatore specificato. I valori devono essere valori primitivi: numero, stringa, booleano.

RouterWorkerSelectorStatus

Descrive lo stato di un selettore di lavoro.

Nome	Tipo	Descrizione
active	string	Il selettore di lavoro è valido.
expired	string	Selettore di lavoro non valido.

RuleEngineQueueSelectorAttachment

Collega i selettori di coda a un processo quando routerRule viene risolto.

Nome	Tipo	Descrizione
kind	string: ruleEngine	Il discriminante del tipo che descrive un sottotipo di QueueSelectorAttachment.
rule	RouterRule: DirectMapRouterRule ExpressionRouterRule FunctionRouterRule StaticRouterRule WebhookRouterRule	RouterRule che risolve una raccolta di selettori di coda da collegare.

RuleEngineWorkerSelectorAttachment

Collega i selettori di lavoro a un processo quando viene risolto un RouterRule.

Nome	Tipo	Descrizione
kind	string: ruleEngine	Il discriminante del tipo che descrive un sottotipo di WorkerSelectorAttachment.
rule	RouterRule: DirectMapRouterRule ExpressionRouterRule FunctionRouterRule StaticRouterRule WebhookRouterRule	RouterRule che risolve una raccolta di selettori di lavoro da collegare.

StaticQueueSelectorAttachment

Descrive un selettore di coda che verrà collegato a un processo.

Nome	Tipo	Descrizione
kind	string: static	Il discriminante del tipo che descrive un sottotipo di QueueSelectorAttachment.
queueSelector	RouterQueueSelector	Selettore della coda da collegare.

StaticRouterRule

Regola che fornisce regole statiche che restituiscono sempre lo stesso risultato, indipendentemente dall'input.

Nome	Tipo	Descrizione
kind	string: static	Il discriminante del tipo che descrive un sottotipo di RouterRule
value		Il valore statico restituito da questa regola. I valori devono essere valori primitivi: numero, stringa, booleano.

StaticWorkerSelectorAttachment

Descrive un selettore di lavoro che verrà collegato a un processo.

Nome	Tipo	Descrizione
kind	string: static	Il discriminante del tipo che descrive un sottotipo di WorkerSelectorAttachment.
workerSelector	RouterWorkerSelector	Selettore di lavoro da collegare.

WebhookRouterRule

Regola che fornisce un'associazione a un server Web esterno.

Nome	Tipo	Descrizione
authorizationServerUri	string	URI per il server di autorizzazione.
clientCredential	OAuth2WebhookClientCredential	Credenziali OAuth2.0 usate per il server di autorizzazione di Contoso. Riferimento: https://www.oauth.com/oauth2-servers/access-tokens/client-credentials/
kind	string: webhook	Il discriminante del tipo che descrive un sottotipo di RouterRule
webhookUri	string	Uri per il server Web di Contoso.

WeightedAllocationQueueSelectorAttachment

Descrive più set di selettori di coda, di cui uno verrà selezionato e collegato in base a un peso.

Nome	Tipo	Descrizione
allocations	QueueWeightedAllocation[]	Raccolta di allocazioni ponderate in base alla percentuale.
kind	string: weightedAllocation	Il discriminante del tipo che descrive un sottotipo di QueueSelectorAttachment.

WeightedAllocationWorkerSelectorAttachment

Descrive più set di selettori di lavoro, di cui uno verrà selezionato e collegato in base a un peso.

Nome	Tipo	Descrizione
allocations	WorkerWeightedAllocation[]	Raccolta di allocazioni ponderate in base alla percentuale.
kind	string: weightedAllocation	Il discriminante del tipo che descrive un sottotipo di WorkerSelectorAttachment.

WorkerSelectorAttachmentKind

Discriminanti per i tipi di allegati del selettore di lavoro supportati.

Nome	Tipo	Descrizione
conditional	string	Valore discriminatorio per ConditionalWorkerSelectorAttachment.
passThrough	string	Valore discriminatorio per PassThroughWorkerSelectorAttachment.
ruleEngine	string	Valore discriminatorio per RuleEngineWorkerSelectorAttachment.
static	string	Valore discriminatorio per StaticWorkerSelectorAttachment.
weightedAllocation	string	Valore discriminatorio per WeightedAllocationWorkerSelectorAttachment.

WorkerWeightedAllocation

Contiene la percentuale di peso e i selettori di lavoro da applicare se selezionati per le distribuzioni ponderate.

Nome	Tipo	Descrizione
weight	number	Percentuale di questo peso, espressa come frazione di 1.
workerSelectors	RouterWorkerSelector[]	Raccolta di selettori di lavoro che verranno applicati se questa allocazione è selezionata.