Bagikan melalui

TaskAddParameter Kelas

  • Referensi

Tugas Azure Batch untuk ditambahkan.

Batch akan mencoba kembali Tugas ketika operasi pemulihan dipicu pada Node. Contoh operasi pemulihan termasuk (tetapi tidak terbatas pada) ketika Simpul yang tidak sehat di-boot ulang atau Simpul Komputasi menghilang karena kegagalan host. Percobaan ulang karena operasi pemulihan tidak independen dan tidak dihitung terhadap maxTaskRetryCount. Bahkan jika maxTaskRetryCount adalah 0, coba lagi internal karena operasi pemulihan dapat terjadi. Karena itu, semua Tugas harus idempotensi. Ini berarti Tugas perlu mentolerir terganggu dan dimulai ulang tanpa menyebabkan kerusakan atau data duplikat. Praktik terbaik untuk Tugas yang berjalan lama adalah menggunakan beberapa bentuk titik pemeriksaan.

Semua parameter yang diperlukan harus diisi untuk dikirim ke Azure.

Warisan
Model
TaskAddParameter

Konstruktor

TaskAddParameter(*, id: str, command_line: str, display_name: str = None, container_settings=None, exit_conditions=None, resource_files=None, output_files=None, environment_settings=None, affinity_info=None, constraints=None, required_slots: int = None, user_identity=None, multi_instance_settings=None, depends_on=None, application_package_references=None, authentication_token_settings=None, **kwargs)

Parameter

id
str
Diperlukan

Wajib diisi. ID dapat berisi kombinasi karakter alfanumerik termasuk tanda hubung dan garis bawah, dan tidak boleh berisi lebih dari 64 karakter. ID mempertahankan huruf besar/kecil dan tidak peka huruf besar/kecil (artinya, Anda mungkin tidak memiliki dua ID dalam Pekerjaan yang hanya berbeda menurut kasus).

display_name
str
Diperlukan

Nama tampilan tidak perlu unik dan dapat berisi karakter Unicode hingga panjang maksimum 1024.

command_line
str
Diperlukan

Wajib diisi. Untuk Tugas multi-instans, baris perintah dijalankan sebagai Tugas utama, setelah Tugas utama dan semua subtugas selesai mengeksekusi baris perintah koordinasi. Baris perintah tidak berjalan di bawah shell, dan oleh karena itu tidak dapat memanfaatkan fitur shell seperti ekspansi variabel lingkungan. Jika Anda ingin memanfaatkan fitur tersebut, Anda harus memanggil shell di baris perintah, misalnya menggunakan "cmd /c MyCommand" di Windows atau "/bin/sh -c MyCommand" di Linux. Jika baris perintah mengacu pada jalur file, baris tersebut harus menggunakan jalur relatif (relatif terhadap direktori kerja Tugas), atau menggunakan variabel lingkungan yang disediakan Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

container_settings
TaskContainerSettings
Diperlukan

Pengaturan untuk kontainer tempat Tugas berjalan. Jika Kumpulan yang akan menjalankan Tugas ini memiliki kontainerConfiguration yang ditetapkan, ini juga harus diatur. Jika Kumpulan yang akan menjalankan Tugas ini tidak memiliki kumpulan containerConfiguration, ini tidak boleh diatur. Ketika ini ditentukan, semua direktori secara rekursif di bawah AZ_BATCH_NODE_ROOT_DIR (akar direktori Azure Batch pada simpul) dipetakan ke dalam kontainer, semua variabel lingkungan Tugas dipetakan ke dalam kontainer, dan baris perintah Tugas dijalankan dalam kontainer. File yang diproduksi dalam kontainer di luar AZ_BATCH_NODE_ROOT_DIR mungkin tidak tercermin ke disk host, yang berarti bahwa API file Batch tidak akan dapat mengakses file tersebut.

exit_conditions
ExitConditions
Diperlukan

Bagaimana layanan Batch harus merespons ketika Tugas selesai.

resource_files
list[ResourceFile]
Diperlukan

Untuk Tugas multi-instans, file sumber daya hanya akan diunduh ke Simpul Komputasi tempat Tugas utama dijalankan. Ada ukuran maksimum untuk daftar file sumber daya. Ketika ukuran maksimum terlampaui, permintaan akan gagal dan kode kesalahan respons akan menjadi RequestEntityTooLarge. Jika ini terjadi, pengumpulan ResourceFiles harus dikurangi ukurannya. Ini dapat dicapai menggunakan file .zip, Paket Aplikasi, atau Kontainer Docker.

output_files
list[OutputFile]
Diperlukan

Untuk Tugas multi-instans, file hanya akan diunggah dari Simpul Komputasi tempat Tugas utama dijalankan.

environment_settings
list[EnvironmentSetting]
Diperlukan
affinity_info
AffinityInformation
Diperlukan

Petunjuk lokalitas yang dapat digunakan oleh layanan Batch untuk memilih Simpul Komputasi untuk memulai Tugas baru.

constraints
TaskConstraints
Diperlukan

Batasan eksekusi yang berlaku untuk Tugas ini. Jika Anda tidak menentukan batasan, maxTaskRetryCount adalah maxTaskRetryCount yang ditentukan untuk Pekerjaan, maxWallClockTime tidak terbatas, dan retentionTime adalah 7 hari.

required_slots
int
Diperlukan

Jumlah slot penjadwalan yang diperlukan Tugas untuk dijalankan. Defaultnya adalah 1. Tugas hanya dapat dijadwalkan untuk dijalankan pada simpul komputasi jika simpul memiliki slot penjadwalan gratis yang cukup tersedia. Untuk Tugas multi-instans, ini harus 1.

user_identity
UserIdentity
Diperlukan

Identitas pengguna tempat Tugas berjalan. Jika dihilangkan, Tugas berjalan sebagai pengguna non-administratif yang unik untuk Tugas.

multi_instance_settings
MultiInstanceSettings
Diperlukan

Objek yang menunjukkan bahwa Tugas adalah Tugas multi-instans, dan berisi informasi tentang cara menjalankan Tugas multi-instans.

depends_on
TaskDependencies
Diperlukan

Tugas yang bergantung pada Tugas ini. Tugas ini tidak akan dijadwalkan sampai semua Tugas yang bergantung padanya berhasil diselesaikan. Jika salah satu Tugas tersebut gagal dan menghabiskan jumlah coba lagi, Tugas ini tidak akan pernah dijadwalkan. Jika Pekerjaan tidak memiliki usesTaskDependencies yang diatur ke true, dan elemen ini ada, permintaan gagal dengan kode kesalahan TaskDependenciesNotSpecifiedOnJob.

application_package_references
list[ApplicationPackageReference]
Diperlukan

Paket aplikasi diunduh dan disebarkan ke direktori bersama, bukan direktori kerja Tugas. Oleh karena itu, jika paket yang direferensikan sudah ada di Node, dan sudah diperbarui, maka paket tersebut tidak diunduh ulang; salinan yang ada pada Simpul Komputasi digunakan. Jika Paket yang direferensikan tidak dapat diinstal, misalnya karena paket telah dihapus atau karena pengunduhan gagal, Tugas gagal.

authentication_token_settings
AuthenticationTokenSettings
Diperlukan

Pengaturan untuk token autentikasi yang dapat digunakan Tugas untuk melakukan operasi layanan Batch. Jika properti ini diatur, layanan Batch menyediakan Tugas dengan token autentikasi yang dapat digunakan untuk mengautentikasi operasi layanan Batch tanpa memerlukan kunci akses Akun. Token disediakan melalui variabel lingkungan AZ_BATCH_AUTHENTICATION_TOKEN. Operasi yang dapat dilakukan Tugas menggunakan token bergantung pada pengaturan. Misalnya, Tugas dapat meminta izin Pekerjaan untuk menambahkan Tugas lain ke Pekerjaan, atau memeriksa status Pekerjaan atau Tugas lain di bawah Pekerjaan.

Metode

as_dict

Mengembalikan dict yang dapat berupa JSONify menggunakan json.dump.

Penggunaan tingkat lanjut mungkin secara opsional menggunakan panggilan balik sebagai parameter:

Kunci adalah nama atribut yang digunakan dalam Python. Attr_desc adalah dict metadata. Saat ini berisi 'jenis' dengan jenis msrest dan 'kunci' dengan kunci yang dikodekan RestAPI. Nilai adalah nilai saat ini dalam objek ini.

String yang dikembalikan akan digunakan untuk menserialisasikan kunci. Jika jenis pengembalian adalah daftar, ini dianggap sebagai dict hasil hierarkis.

Lihat tiga contoh dalam file ini:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Jika Anda menginginkan serialisasi XML, Anda dapat meneruskan kwargs is_xml=True.
deserialize

Uraikan str menggunakan sintaks RestAPI dan kembalikan model.
enable_additional_properties_sending
from_dict

Mengurai dict menggunakan ekstraktor kunci yang diberikan mengembalikan model.

Secara default, pertimbangkan ekstraktor kunci (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor, dan last_rest_key_case_insensitive_extractor)
is_xml_model
serialize

Kembalikan JSON yang akan dikirim ke azure dari model ini.

Ini adalah alias untuk as_dict(full_restapi_key_transformer, keep_readonly=False).

Jika Anda menginginkan serialisasi XML, Anda dapat meneruskan kwargs is_xml=True.
validate

Validasi model ini secara rekursif dan kembalikan daftar ValidationError.

as_dict

Mengembalikan dict yang dapat berupa JSONify menggunakan json.dump.

Penggunaan tingkat lanjut mungkin secara opsional menggunakan panggilan balik sebagai parameter:

Kunci adalah nama atribut yang digunakan dalam Python. Attr_desc adalah dict metadata. Saat ini berisi 'jenis' dengan jenis msrest dan 'kunci' dengan kunci yang dikodekan RestAPI. Nilai adalah nilai saat ini dalam objek ini.

String yang dikembalikan akan digunakan untuk menserialisasikan kunci. Jika jenis pengembalian adalah daftar, ini dianggap sebagai dict hasil hierarkis.

Lihat tiga contoh dalam file ini:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Jika Anda menginginkan serialisasi XML, Anda dapat meneruskan kwargs is_xml=True.

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

Parameter

key_transformer
<xref:function>

Fungsi transformator kunci.

keep_readonly
nilai default: True

Mengembalikan

Objek yang kompatibel dengan JSON dict

Tipe hasil

dict

deserialize

Uraikan str menggunakan sintaks RestAPI dan kembalikan model.

deserialize(data, content_type=None)

Parameter

data
str
Diperlukan

Str menggunakan struktur RestAPI. JSON secara default.

content_type
str
nilai default: None

JSON secara default, atur aplikasi/xml jika XML.

Mengembalikan

Contoh model ini

Pengecualian

DeserializationError if something went wrong

enable_additional_properties_sending 

enable_additional_properties_sending()

from_dict

Mengurai dict menggunakan ekstraktor kunci yang diberikan mengembalikan model.

Secara default, pertimbangkan ekstraktor kunci (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor, dan last_rest_key_case_insensitive_extractor)

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

Parameter

data
dict
Diperlukan

Dict menggunakan struktur RestAPI

content_type
str
nilai default: None

JSON secara default, atur aplikasi/xml jika XML.

key_extractors
nilai default: None

Mengembalikan

Contoh model ini

Pengecualian

DeserializationError if something went wrong

is_xml_model 

is_xml_model()

serialize

Kembalikan JSON yang akan dikirim ke azure dari model ini.

Ini adalah alias untuk as_dict(full_restapi_key_transformer, keep_readonly=False).

Jika Anda menginginkan serialisasi XML, Anda dapat meneruskan kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Parameter

keep_readonly
bool
nilai default: False

Jika Anda ingin menserialisasikan atribut readonly

Mengembalikan

Objek yang kompatibel dengan JSON dict

Tipe hasil

dict

validate

Validasi model ini secara rekursif dan kembalikan daftar ValidationError.

validate()

Mengembalikan

Daftar kesalahan validasi

Tipe hasil

list