JobReleaseTask 類別

  • 參考

作業執行所在的任何計算節點上，要于作業完成時執行的作業發行工作。

作業發行工作會在作業結束時執行，因為下列其中一項：使用者呼叫終止作業 API，或在作業仍在使用中時呼叫刪除作業 API、達到作業的時鐘時間限制式上限，而且作業仍在作用中，或作業的工作管理員工作已完成，且作業設定為在作業管理員完成時終止。 作業發行工作會在工作已執行且作業準備工作執行和完成的每個節點上執行。 如果您在節點執行作業準備工作之後重新製作節點映射，且作業會在該節點上執行的任何進一步工作 (結束，因此作業準備工作不會重新執行) ，則作業發行工作不會在該計算節點上執行。 如果在作業發行工作仍在執行時重新開機節點，當計算節點啟動時，作業釋放工作會再次執行。 在完成所有作業發行工作之前，作業不會標示為完成。 作業發行工作會在背景執行。 它不會佔用排程位置;也就是說，它不會計入集區上指定的 taskSlotsPerNode 限制。

必須填入所有必要的參數，才能傳送至 Azure。

繼承
Model
JobReleaseTask

建構函式

JobReleaseTask(*, command_line: str, id: str = None, container_settings=None, resource_files=None, environment_settings=None, max_wall_clock_time=None, retention_time=None, user_identity=None, **kwargs)

參數

id
str
必要

識別碼可以包含英數位元的任何組合，包括連字號和底線，而且不能包含超過 64 個字元。 如果您未指定此屬性，Batch 服務會指派預設值 'jobrelease'。 作業中的其他工作不能有與作業發行工作相同的識別碼。 如果您嘗試提交具有相同識別碼的工作，Batch 服務會拒絕要求，錯誤碼 TaskIdSameAsJobReleaseTask;如果您直接呼叫 REST API，HTTP 狀態碼為 409 (衝突) 。

command_line
str
必要

必要。 命令列不會在殼層下執行，因此無法利用殼層功能，例如環境變數擴充。 如果您想要利用這類功能，您應該在命令列中叫用殼層，例如在 Windows 中使用 「cmd /c MyCommand」 或 Linux 中的 「/bin/sh -c MyCommand」。 如果命令列參考檔案路徑，它應該使用相對於 Task 工作目錄) 的相對路徑 (，或使用 Batch 提供的環境變數 (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables) 。

container_settings
TaskContainerSettings
必要

作業發行工作執行所在容器的設定。 當指定這個值時，節點) 上Azure Batch目錄根目錄AZ_BATCH_NODE_ROOT_DIR (遞迴地對應到容器，所有 Task 環境變數都會對應至容器，而且工作命令列會在容器中執行。 在AZ_BATCH_NODE_ROOT_DIR外部容器中產生的檔案可能不會反映到主機磁片，這表示 Batch 檔案 API 將無法存取這些檔案。

resource_files
list[ResourceFile]
必要

此專案底下的檔案位於 Task 的工作目錄中。

environment_settings
list[EnvironmentSetting]
必要
max_wall_clock_time
<xref:timedelta>
必要
retention_time
<xref:timedelta>
必要

預設值為 7 天，亦即工作目錄會保留 7 天，除非移除計算節點或刪除作業。

user_identity
UserIdentity
必要

執行作業發行工作的使用者身分識別。 如果省略，工作會以工作唯一的非系統管理使用者身分執行。

方法

as_dict

使用 json.dump 傳回可以是 JSONify 的聽寫。

進階用法可以選擇性地使用回呼作為參數：

索引鍵是 Python 中使用的屬性名稱。 Attr_desc是中繼資料的聽寫。 目前包含具有 msrest 類型的 'type'，以及具有 RestAPI 編碼金鑰的 'key'。 Value 是這個 物件中的目前值。

傳回的字串將用來序列化索引鍵。 如果傳回類型是清單，則會將此視為階層式結果聽寫。

請參閱此檔案中的三個範例：

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

如果您想要 XML 序列化，您可以傳遞 kwargs is_xml=True。
deserialize

使用 RestAPI 語法剖析 str 並傳回模型。
enable_additional_properties_sending
from_dict

使用指定的金鑰擷取器剖析聽寫會傳回模型。

根據預設，請考慮金鑰擷取器 (rest_key_case_insensitive_extractor、attribute_key_case_insensitive_extractor和last_rest_key_case_insensitive_extractor)

is_xml_model
serialize

傳回會從此模型傳送至 Azure 的 JSON。

這是 as_dict (full_restapi_key_transformer別名，keep_readonly=False) 。

如果您想要 XML 序列化，您可以傳遞 kwargs is_xml=True。
validate

以遞迴方式驗證此模型，並傳回 ValidationError 的清單。

as_dict

使用 json.dump 傳回可以是 JSONify 的聽寫。

進階用法可以選擇性地使用回呼作為參數：

索引鍵是 Python 中使用的屬性名稱。 Attr_desc是中繼資料的聽寫。 目前包含具有 msrest 類型的 'type'，以及具有 RestAPI 編碼金鑰的 'key'。 Value 是這個 物件中的目前值。

傳回的字串將用來序列化索引鍵。 如果傳回類型是清單，則會將此視為階層式結果聽寫。

請參閱此檔案中的三個範例：

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

如果您想要 XML 序列化，您可以傳遞 kwargs is_xml=True。

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

參數

key_transformer
<xref:function>

金鑰轉換器函式。

keep_readonly
預設值: True

傳回

與聽寫 JSON 相容的物件

傳回類型

dict

deserialize

使用 RestAPI 語法剖析 str 並傳回模型。

deserialize(data, content_type=None)

參數

data
str
必要

使用 RestAPI 結構的 str。 JSON 預設為 。

content_type
str
預設值: None

JSON 預設會設定 application/xml if XML。

傳回

此模型的實例

例外狀況

DeserializationError if something went wrong

enable_additional_properties_sending 

enable_additional_properties_sending()

from_dict

使用指定的金鑰擷取器剖析聽寫會傳回模型。

根據預設，請考慮金鑰擷取器 (rest_key_case_insensitive_extractor、attribute_key_case_insensitive_extractor和last_rest_key_case_insensitive_extractor) 

from_dict(data, key_extractors=None, content_type=None)

參數

data
dict
必要

使用 RestAPI 結構的聽寫

content_type
str
預設值: None

JSON 預設會設定 application/xml if XML。

key_extractors
預設值: None

傳回

此模型的實例

例外狀況

DeserializationError if something went wrong

is_xml_model 

is_xml_model()

serialize

傳回會從此模型傳送至 Azure 的 JSON。

這是 as_dict (full_restapi_key_transformer別名，keep_readonly=False) 。

如果您想要 XML 序列化，您可以傳遞 kwargs is_xml=True。

serialize(keep_readonly=False, **kwargs)

參數

keep_readonly
bool
預設值: False

如果您想要序列化唯讀屬性

傳回

與聽寫 JSON 相容的物件

傳回類型

dict

validate

以遞迴方式驗證此模型，並傳回 ValidationError 的清單。

validate()

傳回

驗證錯誤清單

傳回類型

list