DurableClient class

Klient pro spouštění, dotazování, ukončování a vyvolávání událostí pro orchestraci a instance entit.

Vlastnosti

taskHubName

Název centra úloh nakonfigurovaného pro tuto instanci klienta orchestrace.

Metody

createCheckStatusResponse(undefined | HttpRequest, string)

Vytvoří odpověď HTTP, která je užitečná pro kontrolu stavu zadané instance.

createHttpManagementPayload(string)

Vytvoří HttpManagementPayload objekt, který obsahuje koncové body HTTP správy instancí.

getStatus(string, GetStatusOptions)

Získá stav zadané instance orchestrace.

getStatusAll()

Získá stav všech instancí orchestrace.

getStatusBy(OrchestrationFilter)

Získá stav všech instancí orchestrace, které odpovídají zadaným podmínkám.

purgeInstanceHistory(string)

Vymažte historii pro konkrétní instanci orchestrace.

purgeInstanceHistoryBy(OrchestrationFilter)

Vyprázdněte historii orchestrace pro instance, které splňují podmínky.

raiseEvent(string, string, unknown, TaskHubOptions)

Odešle zprávu s oznámením události do čekající instance orchestrace.

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.

rewind(string, string, TaskHubOptions)

Převiňte zadanou instanci orchestrace, která selhala, s důvodem.

signalEntity(EntityId, string, unknown, TaskHubOptions)

Signalizuje entitu k provedení operace.

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í.

terminate(string, string)

Ukončí spuštěnou instanci 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().

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

getStatusAll()

Získá stav všech instancí orchestrace.

function getStatusAll(): Promise<DurableOrchestrationStatus[]>

Návraty

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

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

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

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>