Partilhar via


JobClient class

Fornece métodos para criar, atualizar, monitorar e cancelar trabalhos de longa execução em uma instância do Hub IoT, bem como consultar trabalhos existentes. A API de Trabalhos no Hub IoT do Azure permite agendar chamadas diretas de método e atualizações gêmeas em vários dispositivos.

Espera-se que os usuários do SDK criem instâncias JobClient usando os métodos de fábrica fromConnectionString(string) e fromSharedAccessSignature(string).

Métodos

cancelJob(string | number)
cancelJob(string | number, TripleValueCallback<any, any>)

Cancela um trabalho existente.

createQuery(JobType, JobStatus, number)

Cria uma consulta que pode ser usada para retornar páginas de trabalho existente com base no tipo e no status.

fromConnectionString(string)

Constrói um objeto JobClient a partir da cadeia de conexão fornecida.

fromSharedAccessSignature(string)

Constrói um objeto JobClient a partir da assinatura de acesso compartilhado fornecida.

fromTokenCredential(string, TokenCredential)

Constrói um objeto JobClient a partir de determinada TokenCredential compartilhada do Azure.

getJob(string | number)
getJob(string | number, TripleValueCallback<any, any>)

Solicita informações sobre um trabalho existente.

scheduleDeviceMethod(string | number, string, DeviceMethodParams)
scheduleDeviceMethod(string | number, string, DeviceMethodParams, Date)
scheduleDeviceMethod(string | number, string, DeviceMethodParams, Date, number)
scheduleDeviceMethod(string | number, string, DeviceMethodParams, Date, number, TripleValueCallback<any, any>)

Programa um trabalho que executará um método de dispositivo em um conjunto de dispositivos.

scheduleDeviceMethod(string | number, string, DeviceMethodParams, Date, TripleValueCallback<any, any>)
scheduleDeviceMethod(string | number, string, DeviceMethodParams, TripleValueCallback<any, any>)
scheduleTwinUpdate(string | number, string, any)
scheduleTwinUpdate(string | number, string, any, Date)
scheduleTwinUpdate(string | number, string, any, Date, number)
scheduleTwinUpdate(string | number, string, any, Date, number, TripleValueCallback<any, any>)

Agende um trabalho que atualizará um conjunto de gêmeos com o patch fornecido como parâmetro.

scheduleTwinUpdate(string | number, string, any, Date, TripleValueCallback<any, any>)
scheduleTwinUpdate(string | number, string, any, TripleValueCallback<any, any>)

Detalhes de Método

cancelJob(string | number)

function cancelJob(jobId: string | number): Promise<JobStatusResponse>

Parâmetros

jobId

string | number

Devoluções

Promise<JobStatusResponse>

cancelJob(string | number, TripleValueCallback<any, any>)

Cancela um trabalho existente.

function cancelJob(jobId: string | number, done?: TripleValueCallback<any, any>)

Parâmetros

jobId

string | number

O identificador de um trabalho existente.

done

TripleValueCallback<any, any>

A função opcional a ser chamada quando a operação for concluída. done será chamado com três argumentos: um objeto Error (pode ser null), um objeto de trabalho e um objeto de resposta específico de transporte útil para registro em log ou depuração.

createQuery(JobType, JobStatus, number)

Cria uma consulta que pode ser usada para retornar páginas de trabalho existente com base no tipo e no status.

function createQuery(jobType?: JobType, jobStatus?: JobStatus, pageSize?: number): Query

Parâmetros

jobType

JobType

O tipo que deve ser usado para filtrar resultados.

jobStatus

JobStatus

O status que deve ser usado para filtrar resultados.

pageSize

number

O número de elementos a serem retornados por página.

Devoluções

Query

fromConnectionString(string)

Constrói um objeto JobClient a partir da cadeia de conexão fornecida.

static function fromConnectionString(connectionString: string): JobClient

Parâmetros

connectionString

string

Uma cadeia de conexão que encapsula as permissões apropriadas (leitura e/ou gravação) do Registro.

Devoluções

fromSharedAccessSignature(string)

Constrói um objeto JobClient a partir da assinatura de acesso compartilhado fornecida.

static function fromSharedAccessSignature(sharedAccessSignature: string): JobClient

Parâmetros

sharedAccessSignature

string

Uma assinatura de acesso compartilhado que encapsula as permissões apropriadas (leitura e/ou gravação) do Registro.

Devoluções

fromTokenCredential(string, TokenCredential)

Constrói um objeto JobClient a partir de determinada TokenCredential compartilhada do Azure.

static function fromTokenCredential(hostName: string, tokenCredential: TokenCredential): JobClient

Parâmetros

hostName

string

Nome do host do serviço do Azure.

tokenCredential
TokenCredential

Uma TokenCredential do Azure usada para autenticar com o serviço do Azure

Devoluções

getJob(string | number)

function getJob(jobId: string | number): Promise<JobStatusResponse>

Parâmetros

jobId

string | number

Devoluções

Promise<JobStatusResponse>

getJob(string | number, TripleValueCallback<any, any>)

Solicita informações sobre um trabalho existente.

function getJob(jobId: string | number, done?: TripleValueCallback<any, any>)

Parâmetros

jobId

string | number

O identificador de um trabalho existente.

done

TripleValueCallback<any, any>

A função opcional a ser chamada quando a operação for concluída. done será chamado com três argumentos: um objeto Error (pode ser null), um objeto de trabalho e um objeto de resposta específico de transporte útil para registro em log ou depuração.

scheduleDeviceMethod(string | number, string, DeviceMethodParams)

function scheduleDeviceMethod(jobId: string | number, queryCondition: string, methodParams: DeviceMethodParams): Promise<JobStatusResponse>

Parâmetros

jobId

string | number

queryCondition

string

methodParams
DeviceMethodParams

Devoluções

Promise<JobStatusResponse>

scheduleDeviceMethod(string | number, string, DeviceMethodParams, Date)

function scheduleDeviceMethod(jobId: string | number, queryCondition: string, methodParams: DeviceMethodParams, jobStartTime: Date): Promise<JobStatusResponse>

Parâmetros

jobId

string | number

queryCondition

string

methodParams
DeviceMethodParams
jobStartTime

Date

Devoluções

Promise<JobStatusResponse>

scheduleDeviceMethod(string | number, string, DeviceMethodParams, Date, number)

function scheduleDeviceMethod(jobId: string | number, queryCondition: string, methodParams: DeviceMethodParams, jobStartTime: Date, maxExecutionTimeInSeconds: number): Promise<JobStatusResponse>

Parâmetros

jobId

string | number

queryCondition

string

methodParams
DeviceMethodParams
jobStartTime

Date

maxExecutionTimeInSeconds

number

Devoluções

Promise<JobStatusResponse>

scheduleDeviceMethod(string | number, string, DeviceMethodParams, Date, number, TripleValueCallback<any, any>)

Programa um trabalho que executará um método de dispositivo em um conjunto de dispositivos.

function scheduleDeviceMethod(jobId: string | number, queryCondition: string, methodParams: DeviceMethodParams, jobStartTime?: Date, maxExecutionTimeInSeconds?: number, done?: TripleValueCallback<any, any>)

Parâmetros

jobId

string | number

O identificador exclusivo que deve ser usado para este trabalho.

queryCondition

string

Uma cláusula WHERE de consulta SQL usada para calcular a lista de dispositivos nos quais esse trabalho deve ser executado.

methodParams
DeviceMethodParams

Um objeto que descreve o método e deve ter as seguintes propriedades: - methodName O nome do método que deve ser invocado. - payload [optional] A carga útil a utilizar para a chamada do método. - responseTimeoutInSeconds [opcional] O número de segundos que o Hub IoT deve esperar pelo dispositivo

jobStartTime

Date

Hora em que o trabalho deve começar

maxExecutionTimeInSeconds

number

O tempo máximo alocado para que este trabalho seja executado em segundos.

done

TripleValueCallback<any, any>

A função opcional a ser chamada quando a operação for concluída. done será chamado com três argumentos: um objeto Error (pode ser null), um objeto de trabalho e um objeto de resposta específico de transporte útil para registro em log ou depuração.

scheduleDeviceMethod(string | number, string, DeviceMethodParams, Date, TripleValueCallback<any, any>)

function scheduleDeviceMethod(jobId: string | number, queryCondition: string, methodParams: DeviceMethodParams, jobStartTime: Date, done: TripleValueCallback<any, any>)

Parâmetros

jobId

string | number

queryCondition

string

methodParams
DeviceMethodParams
jobStartTime

Date

done

TripleValueCallback<any, any>

scheduleDeviceMethod(string | number, string, DeviceMethodParams, TripleValueCallback<any, any>)

function scheduleDeviceMethod(jobId: string | number, queryCondition: string, methodParams: DeviceMethodParams, done: TripleValueCallback<any, any>)

Parâmetros

jobId

string | number

queryCondition

string

methodParams
DeviceMethodParams
done

TripleValueCallback<any, any>

scheduleTwinUpdate(string | number, string, any)

function scheduleTwinUpdate(jobId: string | number, queryCondition: string, patch: any): Promise<JobStatusResponse>

Parâmetros

jobId

string | number

queryCondition

string

patch

any

Devoluções

Promise<JobStatusResponse>

scheduleTwinUpdate(string | number, string, any, Date)

function scheduleTwinUpdate(jobId: string | number, queryCondition: string, patch: any, jobStartTime: Date): Promise<JobStatusResponse>

Parâmetros

jobId

string | number

queryCondition

string

patch

any

jobStartTime

Date

Devoluções

Promise<JobStatusResponse>

scheduleTwinUpdate(string | number, string, any, Date, number)

function scheduleTwinUpdate(jobId: string | number, queryCondition: string, patch: any, jobStartTime: Date, maxExecutionTimeInSeconds?: number): Promise<JobStatusResponse>

Parâmetros

jobId

string | number

queryCondition

string

patch

any

jobStartTime

Date

maxExecutionTimeInSeconds

number

Devoluções

Promise<JobStatusResponse>

scheduleTwinUpdate(string | number, string, any, Date, number, TripleValueCallback<any, any>)

Agende um trabalho que atualizará um conjunto de gêmeos com o patch fornecido como parâmetro.

function scheduleTwinUpdate(jobId: string | number, queryCondition: string, patch: any, jobStartTime?: Date, maxExecutionTimeInSeconds?: number, done?: TripleValueCallback<any, any>)

Parâmetros

jobId

string | number

O identificador exclusivo que deve ser usado para este trabalho.

queryCondition

string

Uma cláusula WHERE de consulta SQL usada para calcular a lista de dispositivos nos quais esse trabalho deve ser executado.

patch

any

O adesivo gémeo que deve ser aplicado nos gémeos.

jobStartTime

Date

Hora em que o trabalho deve começar

maxExecutionTimeInSeconds

number

O tempo máximo alocado para que este trabalho seja executado em segundos.

done

TripleValueCallback<any, any>

A função opcional a ser chamada quando a operação for concluída. done será chamado com três argumentos: um objeto Error (pode ser null), um objeto de trabalho e um objeto de resposta específico de transporte útil para registro em log ou depuração.

scheduleTwinUpdate(string | number, string, any, Date, TripleValueCallback<any, any>)

function scheduleTwinUpdate(jobId: string | number, queryCondition: string, patch: any, jobStartTime: Date, done: TripleValueCallback<any, any>)

Parâmetros

jobId

string | number

queryCondition

string

patch

any

jobStartTime

Date

done

TripleValueCallback<any, any>

scheduleTwinUpdate(string | number, string, any, TripleValueCallback<any, any>)

function scheduleTwinUpdate(jobId: string | number, queryCondition: string, patch: any, done: TripleValueCallback<any, any>)

Parâmetros

jobId

string | number

queryCondition

string

patch

any

done

TripleValueCallback<any, any>