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