DurableClient class
Klient pro spouštění, dotazování, ukončování a vyvolávání událostí pro orchestraci a instance entit.
Vlastnosti
| task |
Název centra úloh nakonfigurovaného pro tuto instanci klienta orchestrace. |
Metody
| create |
Vytvoří odpověď HTTP, která je užitečná pro kontrolu stavu zadané instance. |
| create |
Vytvoří HttpManagementPayload objekt, který obsahuje koncové body HTTP správy instancí. |
| get |
Získá stav zadané instance orchestrace. |
| get |
Získá stav všech instancí orchestrace. |
| get |
Získá stav všech instancí orchestrace, které odpovídají zadaným podmínkám. |
| purge |
Vymažte historii pro konkrétní instanci orchestrace. |
| purge |
Vyprázdněte historii orchestrace pro instance, které splňují podmínky. |
| raise |
Odešle zprávu s oznámením události do čekající instance orchestrace. |
| read |
Pokusí se přečíst aktuální stav entity. Vrátí nedefinovanou hodnotu, pokud entita neexistuje nebo pokud je serializovaný stav JSON entity větší než 16 kB. |
| rewind(string, string, Task |
Převiňte zadanou instanci orchestrace, která selhala, s důvodem. |
| signal |
Signalizuje entitu k provedení operace. |
| start |
Spustí novou instanci zadané funkce orchestrátoru. Pokud instance orchestrace se zadaným ID již existuje, stávající instance bude bezobslužně nahrazena touto novou instancí. |
| terminate(string, string) | Ukončí spuštěnou instanci orchestrace. |
| wait |
Vytvoří odpověď HTTP, která obsahuje datovou část adres URL pro správu pro nedokončenou instanci nebo obsahuje datovou část obsahující výstup dokončené orchestrace. Pokud se orchestrace nedokončí v zadaném časovém limitu, bude odpověď HTTP stejná jako metoda createCheckStatusResponse(). |
Podrobnosti vlastnosti
taskHubName
Název centra úloh nakonfigurovaného pro tuto instanci klienta orchestrace.
taskHubName: string
Hodnota vlastnosti
string
Podrobnosti metody
createCheckStatusResponse(undefined | HttpRequest, string)
Vytvoří odpověď HTTP, která je užitečná pro kontrolu stavu zadané instance.
function createCheckStatusResponse(request: undefined | HttpRequest, instanceId: string): HttpResponse
Parametry
- request
-
undefined | HttpRequest
Požadavek HTTP, který aktivoval aktuální instanci orchestrace.
- instanceId
-
string
ID instance orchestrace, která se má zkontrolovat.
Návraty
Odpověď HTTP 202 s hlavičkou Location a datovou částí obsahující adresy URL správy instancí.
createHttpManagementPayload(string)
Vytvoří HttpManagementPayload objekt, který obsahuje koncové body HTTP správy instancí.
function createHttpManagementPayload(instanceId: string): HttpManagementPayload
Parametry
- instanceId
-
string
ID instance orchestrace, která se má zkontrolovat.
Návraty
getStatus(string, GetStatusOptions)
Získá stav zadané instance orchestrace.
function getStatus(instanceId: string, options?: GetStatusOptions): Promise<DurableOrchestrationStatus>
Parametry
- instanceId
-
string
ID instance orchestrace, která se má dotazovat.
- options
- GetStatusOptions
objekt options určující další konfiguraci
Návraty
Promise<DurableOrchestrationStatus>
getStatusAll()
Získá stav všech instancí orchestrace.
function getStatusAll(): Promise<DurableOrchestrationStatus[]>
Návraty
Promise<DurableOrchestrationStatus[]>
getStatusBy(OrchestrationFilter)
Získá stav všech instancí orchestrace, které odpovídají zadaným podmínkám.
function getStatusBy(filter: OrchestrationFilter): Promise<DurableOrchestrationStatus[]>
Parametry
- filter
- OrchestrationFilter
OrchestrationFilter objekt určující, které orchestrace se mají načíst.
Návraty
Promise<DurableOrchestrationStatus[]>
purgeInstanceHistory(string)
Vymažte historii pro konkrétní instanci orchestrace.
function purgeInstanceHistory(instanceId: string): Promise<PurgeHistoryResult>
Parametry
- instanceId
-
string
ID instance orchestrace, která se má vyprázdnit.
Návraty
Promise<PurgeHistoryResult>
purgeInstanceHistoryBy(OrchestrationFilter)
Vyprázdněte historii orchestrace pro instance, které splňují podmínky.
function purgeInstanceHistoryBy(filter: OrchestrationFilter): Promise<PurgeHistoryResult>
Parametry
- filter
- OrchestrationFilter
Objekt OrchestrationFilter určující, které orchestrace se mají vyprázdnit.
Návraty
Promise<PurgeHistoryResult>
raiseEvent(string, string, unknown, TaskHubOptions)
Odešle zprávu s oznámením události do čekající instance orchestrace.
function raiseEvent(instanceId: string, eventName: string, eventData: unknown, options?: TaskHubOptions): Promise<void>
Parametry
- instanceId
-
string
ID instance orchestrace, která bude zpracovávat událost.
- eventName
-
string
Název události.
- eventData
-
unknown
Serializovatelná data JSON přidružená k události.
- options
- TaskHubOptions
objekt poskytující TaskHubName instance orchestrace a název jeho přidruženého připojovacího řetězce
Návraty
Promise<void>
Příslib, který se vyřeší, když je zpráva s oznámením události v frontě.
Aby bylo možné zpracovat událost, musí cílová instance orchestrace čekat na událost s názvem eventName pomocí waitForExternalEvent(string).
Pokud zadaná instance není nalezena nebo není spuštěna, tato operace nebude mít žádný vliv.
readEntityState<T>(EntityId, TaskHubOptions)
Pokusí se přečíst aktuální stav entity. Vrátí nedefinovanou hodnotu, pokud entita neexistuje nebo pokud je serializovaný stav JSON entity větší než 16 kB.
function readEntityState<T>(entityId: EntityId, options?: TaskHubOptions): Promise<EntityStateResponse<T>>
Parametry
- entityId
- EntityId
Cílová entita.
- options
- TaskHubOptions
volitelný objekt, který poskytuje TaskHubName cílové entity a název přidruženého připojovacího řetězce
Návraty
Promise<EntityStateResponse<T>>
Odpověď obsahující aktuální stav entity.
rewind(string, string, TaskHubOptions)
Převiňte zadanou instanci orchestrace, která selhala, s důvodem.
function rewind(instanceId: string, reason: string, options?: TaskHubOptions): Promise<void>
Parametry
- instanceId
-
string
ID instance orchestrace, která se má převinout zpět.
- reason
-
string
Důvod pro převinutí instance orchestrace zpět.
- options
- TaskHubOptions
objekt poskytující TaskHubName instance orchestrace a název jeho přidruženého připojovacího řetězce
Návraty
Promise<void>
Příslib, který se vyřeší při převinutí zprávy zpět do fronty.
Tato funkce je aktuálně ve verzi Preview.
signalEntity(EntityId, string, unknown, TaskHubOptions)
Signalizuje entitu k provedení operace.
function signalEntity(entityId: EntityId, operationName?: string, operationContent?: unknown, options?: TaskHubOptions): Promise<void>
Parametry
- entityId
- EntityId
Cílová entita.
- operationName
-
string
Název operace.
- operationContent
-
unknown
Obsah operace.
- options
- TaskHubOptions
objekt poskytující TaskHubName instance entity a název jeho přidruženého připojovacího řetězce
Návraty
Promise<void>
startNew(string, StartNewOptions)
Spustí novou instanci zadané funkce orchestrátoru.
Pokud instance orchestrace se zadaným ID již existuje, stávající instance bude bezobslužně nahrazena touto novou instancí.
function startNew(orchestratorFunctionName: string, options?: StartNewOptions): Promise<string>
Parametry
- orchestratorFunctionName
-
string
Název funkce orchestrátoru, který se má spustit.
- options
- StartNewOptions
volitelný objekt pro řízení plánovaného orchestrátoru (například zadání vstupu, ID instance)
Návraty
Promise<string>
ID nové instance orchestrace.
terminate(string, string)
Ukončí spuštěnou instanci orchestrace.
function terminate(instanceId: string, reason: string): Promise<void>
Parametry
- instanceId
-
string
ID instance orchestrace, která se má ukončit.
- reason
-
string
Důvod ukončení instance orchestrace.
Návraty
Promise<void>
Příslib, který se vyřeší při zařazení zprávy ukončení do fronty.
Ukončení instance orchestrace nemá žádný vliv na žádné spuštění funkcí aktivity v letu ani dílčí orchestrace, které byly spuštěny aktuální instancí orchestrace.
waitForCompletionOrCreateCheckStatusResponse(HttpRequest, string, WaitForCompletionOptions)
Vytvoří odpověď HTTP, která obsahuje datovou část adres URL pro správu pro nedokončenou instanci nebo obsahuje datovou část obsahující výstup dokončené orchestrace.
Pokud se orchestrace nedokončí v zadaném časovém limitu, bude odpověď HTTP stejná jako metoda createCheckStatusResponse().
function waitForCompletionOrCreateCheckStatusResponse(request: HttpRequest, instanceId: string, waitOptions?: WaitForCompletionOptions): Promise<HttpResponse>
Parametry
- request
- HttpRequest
Požadavek HTTP, který aktivoval aktuální funkci.
- instanceId
-
string
Jedinečné ID instance, které chcete zkontrolovat.
- waitOptions
- WaitForCompletionOptions
objekt options určující časové limity, jak dlouho čekat na výstup z durable funkce a jak často kontrolovat výstup.
Návraty
Promise<HttpResponse>