JobAddParameter Kelas

Pekerjaan Azure Batch untuk ditambahkan.

Semua parameter yang diperlukan harus diisi untuk dikirim ke Azure.

Warisan

Model

JobAddParameter

Konstruktor

JobAddParameter(*, id: str, pool_info, display_name: str = None, priority: int = None, max_parallel_tasks: int = -1, allow_task_preemption: bool = None, constraints=None, job_manager_task=None, job_preparation_task=None, job_release_task=None, common_environment_settings=None, on_all_tasks_complete=None, on_task_failure=None, metadata=None, uses_task_dependencies: bool = None, network_configuration=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 adalah mempertahankan huruf besar/kecil dan tidak peka huruf besar/kecil (artinya, Anda mungkin tidak memiliki dua ID dalam Akun yang hanya berbeda menurut kasus).

display_name

str

Diperlukan

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

priority

int

Diperlukan

Prioritas Pekerjaan. Nilai prioritas dapat berkisar dari -1000 hingga 1000, dengan -1000 menjadi prioritas terendah dan 1000 menjadi prioritas tertinggi. Nilai default adalah 0.

max_parallel_tasks

int

Diperlukan

Jumlah maksimum tugas yang dapat dijalankan secara paralel untuk pekerjaan tersebut. Nilai maxParallelTasks harus -1 atau lebih besar dari 0 jika ditentukan. Jika tidak ditentukan, nilai defaultnya adalah -1, yang berarti tidak ada batasan jumlah tugas yang dapat dijalankan sekaligus. Anda dapat memperbarui maxParallelTasks pekerjaan setelah dibuat menggunakan API pekerjaan pembaruan. Nilai default: -1 .

allow_task_preemption

bool

Diperlukan

Apakah Tugas dalam pekerjaan ini dapat didahulukan oleh pekerjaan prioritas tinggi lainnya. Jika nilai diatur ke True, pekerjaan prioritas tinggi lainnya yang dikirimkan ke sistem akan diutamakan dan akan dapat mengantre ulang tugas dari pekerjaan ini. Anda dapat memperbarui allowTaskPreemption pekerjaan setelah dibuat menggunakan API pekerjaan pembaruan.

constraints

JobConstraints

Diperlukan

Batasan eksekusi untuk Pekerjaan.

job_manager_task

JobManagerTask

Diperlukan

Detail Tugas Manajer Pekerjaan yang akan diluncurkan saat Pekerjaan dimulai. Jika Pekerjaan tidak menentukan Tugas Manajer Pekerjaan, pengguna harus secara eksplisit menambahkan Tugas ke Pekerjaan. Jika Pekerjaan menentukan Tugas Manajer Pekerjaan, layanan Batch membuat Tugas Manajer Pekerjaan saat Pekerjaan dibuat, dan akan mencoba menjadwalkan Tugas Manajer Pekerjaan sebelum menjadwalkan Tugas lain dalam Pekerjaan. Tujuan umum Tugas Manajer Pekerjaan adalah untuk mengontrol dan/atau memantau eksekusi Pekerjaan, misalnya dengan memutuskan Tugas tambahan apa yang akan dijalankan, menentukan kapan pekerjaan selesai, dll. (Namun, Tugas Manajer Pekerjaan tidak dibatasi untuk aktivitas ini - ini adalah Tugas yang sepenuhnya lengkap dalam sistem dan melakukan tindakan apa pun yang diperlukan untuk Pekerjaan.) Misalnya, Tugas Manajer Pekerjaan mungkin mengunduh file yang ditentukan sebagai parameter, menganalisis konten file tersebut dan mengirimkan Tugas tambahan berdasarkan konten tersebut.

job_preparation_task

JobPreparationTask

Diperlukan

Tugas Persiapan Pekerjaan. Jika Pekerjaan memiliki Tugas Persiapan Pekerjaan, layanan Batch akan menjalankan Tugas Persiapan Pekerjaan pada Simpul sebelum memulai Tugas Pekerjaan tersebut pada Simpul Komputasi tersebut.

job_release_task

JobReleaseTask

Diperlukan

Tugas Pelepasan Pekerjaan. Tugas Pelepasan Pekerjaan tidak dapat ditentukan tanpa juga menentukan Tugas Persiapan Pekerjaan untuk Pekerjaan. Layanan Batch menjalankan Tugas Rilis Pekerjaan pada Simpul yang telah menjalankan Tugas Persiapan Pekerjaan. Tujuan utama Tugas Pelepasan Pekerjaan adalah untuk membatalkan perubahan pada Simpul Komputasi yang dibuat oleh Tugas Persiapan Pekerjaan. Contoh aktivitas termasuk menghapus file lokal, atau mematikan layanan yang dimulai sebagai bagian dari persiapan Pekerjaan.

common_environment_settings

list[EnvironmentSetting]

Diperlukan

Tugas Individual dapat mengganti pengaturan lingkungan yang ditentukan di sini dengan menentukan nama pengaturan yang sama dengan nilai yang berbeda.

pool_info

PoolInformation

Diperlukan

Wajib diisi. Kumpulan tempat layanan Batch menjalankan Tugas Pekerjaan.

on_all_tasks_complete

str atau OnAllTasksComplete

Diperlukan

Tindakan yang harus dilakukan layanan Batch ketika semua Tugas dalam Pekerjaan dalam status selesai. Perhatikan bahwa jika Pekerjaan tidak berisi Tugas, maka semua Tugas dianggap selesai. Oleh karena itu, opsi ini paling umum digunakan dengan tugas Manajer Pekerjaan; jika Anda ingin menggunakan penghentian Pekerjaan otomatis tanpa Manajer Pekerjaan, Anda awalnya harus mengatur onAllTasksComplete ke simpul dan memperbarui properti Pekerjaan untuk mengatur onAllTasksComplete untuk mengakhiri pekerjaan setelah Anda selesai menambahkan Tugas. Defaultnya adalah noaction. Nilai yang mungkin termasuk: 'noAction', 'terminateJob'

on_task_failure

str atau OnTaskFailure

Diperlukan

Tindakan yang harus diambil layanan Batch ketika Tugas apa pun dalam Pekerjaan gagal. Tugas dianggap gagal jika mengalami failureInfo. failureInfo diatur jika Tugas selesai dengan kode keluar bukan nol setelah menghabiskan jumlah coba lagi, atau jika ada kesalahan memulai Tugas, misalnya karena kesalahan pengunduhan file sumber daya. Defaultnya adalah noaction. Nilai yang mungkin termasuk: 'noAction', 'performExitOptionsJobAction'

metadata

list[MetadataItem]

Diperlukan

Layanan Batch tidak menetapkan arti apa pun untuk metadata; hanya untuk penggunaan kode pengguna.

uses_task_dependencies

bool

Diperlukan

Apakah Tugas dalam Pekerjaan dapat menentukan dependensi satu sama lain. Defaultnya adalah false (salah).

network_configuration

JobNetworkConfiguration

Diperlukan

Konfigurasi jaringan untuk 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 'type' dengan jenis msrest dan 'key' 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	Mengembalikan 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 'type' dengan jenis msrest dan 'key' 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

Mengembalikan 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