共用方式為


Task class

代表Task的類別。

建構函式

Task(BatchServiceClientContext)

建立工作。

方法

add(string, TaskAddParameter, ServiceCallback<void>)
add(string, TaskAddParameter, TaskAddOptionalParams)

從完成到完成的工作最長存留期為 180 天。 如果工作尚未在新增的 180 天內完成,Batch 服務將會終止工作,並在當時處於任何狀態。

add(string, TaskAddParameter, TaskAddOptionalParams, ServiceCallback<void>)
addCollection(string, TaskAddParameter[], ServiceCallback<TaskAddCollectionResult>)
addCollection(string, TaskAddParameter[], TaskAddCollectionOptionalParams)

請注意,每個工作都必須有唯一標識符。 Batch 服務可能不會依照此要求中提交工作的順序,傳回每個工作的結果。 如果伺服器在要求期間逾時或連接已關閉,則要求可能已部分或完全處理,或完全未處理。 在這種情況下,用戶應該重新發出要求。 請注意,重新發出要求時,用戶必須正確地處理失敗。 例如,您應該在重試期間使用相同的工作標識符,如此一來,如果先前的作業成功,重試將不會意外建立額外的工作。 如果回應包含任何無法新增的工作,用戶端可以重試要求。 在重試中,只重新提交無法新增的工作,並省略第一次嘗試時成功新增的工作是最有效率的。 從完成到完成的工作最長存留期為 180 天。 如果工作尚未在新增的 180 天內完成,Batch 服務將會終止工作,並在當時處於任何狀態。

addCollection(string, TaskAddParameter[], TaskAddCollectionOptionalParams, ServiceCallback<TaskAddCollectionResult>)
deleteMethod(string, string, ServiceCallback<void>)
deleteMethod(string, string, TaskDeleteMethodOptionalParams)

刪除工作時,也會刪除其所在計算節點上其目錄中的所有檔案(不論保留時間為何)。 針對多重實例工作,刪除工作作業會同步套用至主要工作;子工作及其檔案接著會在背景以異步方式刪除。

deleteMethod(string, string, TaskDeleteMethodOptionalParams, ServiceCallback<void>)
get(string, string, ServiceCallback<CloudTask>)
get(string, string, TaskGetOptionalParams)

針對多重實例工作,affinityId、executionInfo 和 nodeInfo 等資訊會參考主要工作。 使用清單子工作 API 來擷取子工作的相關信息。

get(string, string, TaskGetOptionalParams, ServiceCallback<CloudTask>)
list(string, ServiceCallback<CloudTaskListResult>)
list(string, TaskListOptionalParams)

針對多重實例工作,affinityId、executionInfo 和 nodeInfo 等資訊會參考主要工作。 使用清單子工作 API 來擷取子工作的相關信息。

list(string, TaskListOptionalParams, ServiceCallback<CloudTaskListResult>)
listNext(string, ServiceCallback<CloudTaskListResult>)
listNext(string, TaskListNextOptionalParams)

針對多重實例工作,affinityId、executionInfo 和 nodeInfo 等資訊會參考主要工作。 使用清單子工作 API 來擷取子工作的相關信息。

listNext(string, TaskListNextOptionalParams, ServiceCallback<CloudTaskListResult>)
listSubtasks(string, string, ServiceCallback<CloudTaskListSubtasksResult>)
listSubtasks(string, string, TaskListSubtasksOptionalParams)

如果Task不是多重實例Task,則這會傳回空集合。

listSubtasks(string, string, TaskListSubtasksOptionalParams, ServiceCallback<CloudTaskListSubtasksResult>)
reactivate(string, string, ServiceCallback<void>)
reactivate(string, string, TaskReactivateOptionalParams)

重新啟用可讓工作重新重試,最多達到重試計數上限。 工作的狀態會變更為作用中。 由於工作已不再處於已完成狀態,任何先前的結束代碼或失敗資訊都無法在重新啟用之後再使用。 每次重新啟動工作時,其重試計數會重設為 0。 未完成或先前成功完成的工作將會重新啟動失敗(結束代碼為 0)。 此外,如果作業已完成(或正在終止或刪除),它將會失敗。

reactivate(string, string, TaskReactivateOptionalParams, ServiceCallback<void>)
terminate(string, string, ServiceCallback<void>)
terminate(string, string, TaskTerminateOptionalParams)

當工作終止時,它會移至已完成狀態。 針對多重實例工作,終止工作作業會同步套用至主要工作;子工作接著會在背景以異步方式終止。

terminate(string, string, TaskTerminateOptionalParams, ServiceCallback<void>)
update(string, string, ServiceCallback<void>)
update(string, string, TaskUpdateOptionalParams)

更新指定之工作的屬性。

update(string, string, TaskUpdateOptionalParams, ServiceCallback<void>)

建構函式詳細資料

Task(BatchServiceClientContext)

建立工作。

new Task(client: BatchServiceClientContext)

參數

client
BatchServiceClientContext

服務客戶端的參考。

方法詳細資料

add(string, TaskAddParameter, ServiceCallback<void>)

function add(jobId: string, task: TaskAddParameter, callback: ServiceCallback<void>)

參數

jobId

string

要加入工作之作業的標識碼。

task
TaskAddParameter

要加入的工作。

callback

ServiceCallback<void>

回呼

add(string, TaskAddParameter, TaskAddOptionalParams)

從完成到完成的工作最長存留期為 180 天。 如果工作尚未在新增的 180 天內完成,Batch 服務將會終止工作,並在當時處於任何狀態。

function add(jobId: string, task: TaskAddParameter, options?: TaskAddOptionalParams): Promise<TaskAddResponse>

參數

jobId

string

要加入工作之作業的標識碼。

task
TaskAddParameter

要加入的工作。

options
TaskAddOptionalParams

選擇性參數

傳回

Promise<TaskAddResponse>

承諾<Models.TaskAddResponse>

add(string, TaskAddParameter, TaskAddOptionalParams, ServiceCallback<void>)

function add(jobId: string, task: TaskAddParameter, options: TaskAddOptionalParams, callback: ServiceCallback<void>)

參數

jobId

string

要加入工作之作業的標識碼。

task
TaskAddParameter

要加入的工作。

options
TaskAddOptionalParams

選擇性參數

callback

ServiceCallback<void>

回呼

addCollection(string, TaskAddParameter[], ServiceCallback<TaskAddCollectionResult>)

function addCollection(jobId: string, value: TaskAddParameter[], callback: ServiceCallback<TaskAddCollectionResult>)

參數

jobId

string

要加入Task集合之作業的標識碼。

value

TaskAddParameter[]

要加入之 Tasks 的集合。 工作的最大計數為 100。 這個集合的總串行化大小必須小於 1MB。 如果大於 1MB(例如,如果每個工作都有 100 個的資源檔或環境變數),則要求會失敗,且程式代碼為 'RequestBodyTooLarge',而且應該以較少的工作重試。

addCollection(string, TaskAddParameter[], TaskAddCollectionOptionalParams)

請注意,每個工作都必須有唯一標識符。 Batch 服務可能不會依照此要求中提交工作的順序,傳回每個工作的結果。 如果伺服器在要求期間逾時或連接已關閉,則要求可能已部分或完全處理,或完全未處理。 在這種情況下,用戶應該重新發出要求。 請注意,重新發出要求時,用戶必須正確地處理失敗。 例如,您應該在重試期間使用相同的工作標識符,如此一來,如果先前的作業成功,重試將不會意外建立額外的工作。 如果回應包含任何無法新增的工作,用戶端可以重試要求。 在重試中,只重新提交無法新增的工作,並省略第一次嘗試時成功新增的工作是最有效率的。 從完成到完成的工作最長存留期為 180 天。 如果工作尚未在新增的 180 天內完成,Batch 服務將會終止工作,並在當時處於任何狀態。

function addCollection(jobId: string, value: TaskAddParameter[], options?: TaskAddCollectionOptionalParams): Promise<TaskAddCollectionResponse>

參數

jobId

string

要加入Task集合之作業的標識碼。

value

TaskAddParameter[]

要加入之 Tasks 的集合。 工作的最大計數為 100。 這個集合的總串行化大小必須小於 1MB。 如果大於 1MB(例如,如果每個工作都有 100 個的資源檔或環境變數),則要求會失敗,且程式代碼為 'RequestBodyTooLarge',而且應該以較少的工作重試。

options
TaskAddCollectionOptionalParams

選擇性參數

傳回

承諾<Models.TaskAddCollectionResponse>

addCollection(string, TaskAddParameter[], TaskAddCollectionOptionalParams, ServiceCallback<TaskAddCollectionResult>)

function addCollection(jobId: string, value: TaskAddParameter[], options: TaskAddCollectionOptionalParams, callback: ServiceCallback<TaskAddCollectionResult>)

參數

jobId

string

要加入Task集合之作業的標識碼。

value

TaskAddParameter[]

要加入之 Tasks 的集合。 工作的最大計數為 100。 這個集合的總串行化大小必須小於 1MB。 如果大於 1MB(例如,如果每個工作都有 100 個的資源檔或環境變數),則要求會失敗,且程式代碼為 'RequestBodyTooLarge',而且應該以較少的工作重試。

options
TaskAddCollectionOptionalParams

選擇性參數

deleteMethod(string, string, ServiceCallback<void>)

function deleteMethod(jobId: string, taskId: string, callback: ServiceCallback<void>)

參數

jobId

string

要從中刪除工作的作業標識碼。

taskId

string

要刪除之工作的識別碼。

callback

ServiceCallback<void>

回呼

deleteMethod(string, string, TaskDeleteMethodOptionalParams)

刪除工作時,也會刪除其所在計算節點上其目錄中的所有檔案(不論保留時間為何)。 針對多重實例工作,刪除工作作業會同步套用至主要工作;子工作及其檔案接著會在背景以異步方式刪除。

function deleteMethod(jobId: string, taskId: string, options?: TaskDeleteMethodOptionalParams): Promise<TaskDeleteResponse>

參數

jobId

string

要從中刪除工作的作業標識碼。

taskId

string

要刪除之工作的識別碼。

options
TaskDeleteMethodOptionalParams

選擇性參數

傳回

承諾<模型.TaskDelete回應>

deleteMethod(string, string, TaskDeleteMethodOptionalParams, ServiceCallback<void>)

function deleteMethod(jobId: string, taskId: string, options: TaskDeleteMethodOptionalParams, callback: ServiceCallback<void>)

參數

jobId

string

要從中刪除工作的作業標識碼。

taskId

string

要刪除之工作的識別碼。

options
TaskDeleteMethodOptionalParams

選擇性參數

callback

ServiceCallback<void>

回呼

get(string, string, ServiceCallback<CloudTask>)

function get(jobId: string, taskId: string, callback: ServiceCallback<CloudTask>)

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要取得相關信息之工作的標識碼。

callback

ServiceCallback<CloudTask>

回呼

get(string, string, TaskGetOptionalParams)

針對多重實例工作,affinityId、executionInfo 和 nodeInfo 等資訊會參考主要工作。 使用清單子工作 API 來擷取子工作的相關信息。

function get(jobId: string, taskId: string, options?: TaskGetOptionalParams): Promise<TaskGetResponse>

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要取得相關信息之工作的標識碼。

options
TaskGetOptionalParams

選擇性參數

傳回

Promise<TaskGetResponse>

承諾<Models.TaskGetResponse>

get(string, string, TaskGetOptionalParams, ServiceCallback<CloudTask>)

function get(jobId: string, taskId: string, options: TaskGetOptionalParams, callback: ServiceCallback<CloudTask>)

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要取得相關信息之工作的標識碼。

options
TaskGetOptionalParams

選擇性參數

callback

ServiceCallback<CloudTask>

回呼

list(string, ServiceCallback<CloudTaskListResult>)

function list(jobId: string, callback: ServiceCallback<CloudTaskListResult>)

參數

jobId

string

作業的標識碼。

list(string, TaskListOptionalParams)

針對多重實例工作,affinityId、executionInfo 和 nodeInfo 等資訊會參考主要工作。 使用清單子工作 API 來擷取子工作的相關信息。

function list(jobId: string, options?: TaskListOptionalParams): Promise<TaskListResponse>

參數

jobId

string

作業的標識碼。

options
TaskListOptionalParams

選擇性參數

傳回

Promise<TaskListResponse>

承諾<模型.TaskListResponse>

list(string, TaskListOptionalParams, ServiceCallback<CloudTaskListResult>)

function list(jobId: string, options: TaskListOptionalParams, callback: ServiceCallback<CloudTaskListResult>)

參數

jobId

string

作業的標識碼。

options
TaskListOptionalParams

選擇性參數

listNext(string, ServiceCallback<CloudTaskListResult>)

function listNext(nextPageLink: string, callback: ServiceCallback<CloudTaskListResult>)

參數

nextPageLink

string

上一次成功呼叫 List 作業的 NextLink。

listNext(string, TaskListNextOptionalParams)

針對多重實例工作,affinityId、executionInfo 和 nodeInfo 等資訊會參考主要工作。 使用清單子工作 API 來擷取子工作的相關信息。

function listNext(nextPageLink: string, options?: TaskListNextOptionalParams): Promise<TaskListResponse>

參數

nextPageLink

string

上一次成功呼叫 List 作業的 NextLink。

options
TaskListNextOptionalParams

選擇性參數

傳回

Promise<TaskListResponse>

承諾<模型.TaskListResponse>

listNext(string, TaskListNextOptionalParams, ServiceCallback<CloudTaskListResult>)

function listNext(nextPageLink: string, options: TaskListNextOptionalParams, callback: ServiceCallback<CloudTaskListResult>)

參數

nextPageLink

string

上一次成功呼叫 List 作業的 NextLink。

options
TaskListNextOptionalParams

選擇性參數

listSubtasks(string, string, ServiceCallback<CloudTaskListSubtasksResult>)

function listSubtasks(jobId: string, taskId: string, callback: ServiceCallback<CloudTaskListSubtasksResult>)

參數

jobId

string

作業的標識碼。

taskId

string

工作的標識碼。

listSubtasks(string, string, TaskListSubtasksOptionalParams)

如果Task不是多重實例Task,則這會傳回空集合。

function listSubtasks(jobId: string, taskId: string, options?: TaskListSubtasksOptionalParams): Promise<TaskListSubtasksResponse>

參數

jobId

string

作業的標識碼。

taskId

string

工作的標識碼。

options
TaskListSubtasksOptionalParams

選擇性參數

傳回

Promise<Models.TaskListSubtasks回應>

listSubtasks(string, string, TaskListSubtasksOptionalParams, ServiceCallback<CloudTaskListSubtasksResult>)

function listSubtasks(jobId: string, taskId: string, options: TaskListSubtasksOptionalParams, callback: ServiceCallback<CloudTaskListSubtasksResult>)

參數

jobId

string

作業的標識碼。

taskId

string

工作的標識碼。

options
TaskListSubtasksOptionalParams

選擇性參數

reactivate(string, string, ServiceCallback<void>)

function reactivate(jobId: string, taskId: string, callback: ServiceCallback<void>)

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要重新啟用之工作的識別碼。

callback

ServiceCallback<void>

回呼

reactivate(string, string, TaskReactivateOptionalParams)

重新啟用可讓工作重新重試,最多達到重試計數上限。 工作的狀態會變更為作用中。 由於工作已不再處於已完成狀態,任何先前的結束代碼或失敗資訊都無法在重新啟用之後再使用。 每次重新啟動工作時,其重試計數會重設為 0。 未完成或先前成功完成的工作將會重新啟動失敗(結束代碼為 0)。 此外,如果作業已完成(或正在終止或刪除),它將會失敗。

function reactivate(jobId: string, taskId: string, options?: TaskReactivateOptionalParams): Promise<TaskReactivateResponse>

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要重新啟用之工作的識別碼。

options
TaskReactivateOptionalParams

選擇性參數

傳回

Promise<Models.TaskReactivateResponse>

reactivate(string, string, TaskReactivateOptionalParams, ServiceCallback<void>)

function reactivate(jobId: string, taskId: string, options: TaskReactivateOptionalParams, callback: ServiceCallback<void>)

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要重新啟用之工作的識別碼。

options
TaskReactivateOptionalParams

選擇性參數

callback

ServiceCallback<void>

回呼

terminate(string, string, ServiceCallback<void>)

function terminate(jobId: string, taskId: string, callback: ServiceCallback<void>)

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要終止之工作的標識碼。

callback

ServiceCallback<void>

回呼

terminate(string, string, TaskTerminateOptionalParams)

當工作終止時,它會移至已完成狀態。 針對多重實例工作,終止工作作業會同步套用至主要工作;子工作接著會在背景以異步方式終止。

function terminate(jobId: string, taskId: string, options?: TaskTerminateOptionalParams): Promise<TaskTerminateResponse>

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要終止之工作的標識碼。

options
TaskTerminateOptionalParams

選擇性參數

傳回

承諾<Models.TaskTerminateResponse>

terminate(string, string, TaskTerminateOptionalParams, ServiceCallback<void>)

function terminate(jobId: string, taskId: string, options: TaskTerminateOptionalParams, callback: ServiceCallback<void>)

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要終止之工作的標識碼。

options
TaskTerminateOptionalParams

選擇性參數

callback

ServiceCallback<void>

回呼

update(string, string, ServiceCallback<void>)

function update(jobId: string, taskId: string, callback: ServiceCallback<void>)

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要更新之工作的識別碼。

callback

ServiceCallback<void>

回呼

update(string, string, TaskUpdateOptionalParams)

更新指定之工作的屬性。

function update(jobId: string, taskId: string, options?: TaskUpdateOptionalParams): Promise<TaskUpdateResponse>

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要更新之工作的識別碼。

options
TaskUpdateOptionalParams

選擇性參數

傳回

承諾<模型.TaskUpdateResponse>

update(string, string, TaskUpdateOptionalParams, ServiceCallback<void>)

function update(jobId: string, taskId: string, options: TaskUpdateOptionalParams, callback: ServiceCallback<void>)

參數

jobId

string

包含工作之作業的識別碼。

taskId

string

要更新之工作的識別碼。

options
TaskUpdateOptionalParams

選擇性參數

callback

ServiceCallback<void>

回呼