PoolAddParameter Kelas

Kumpulan di layanan Azure Batch untuk ditambahkan.

Semua parameter yang diperlukan harus diisi untuk dikirim ke Azure.

Warisan

Model

PoolAddParameter

Konstruktor

PoolAddParameter(*, id: str, vm_size: str, display_name: str = None, cloud_service_configuration=None, virtual_machine_configuration=None, resize_timeout=None, target_dedicated_nodes: int = None, target_low_priority_nodes: int = None, enable_auto_scale: bool = None, auto_scale_formula: str = None, auto_scale_evaluation_interval=None, enable_inter_node_communication: bool = None, network_configuration=None, start_task=None, certificate_references=None, application_package_references=None, application_licenses=None, task_slots_per_node: int = None, task_scheduling_policy=None, user_accounts=None, metadata=None, mount_configuration=None, target_node_communication_mode=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 Kumpulan 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.

vm_size

str

Diperlukan

Wajib diisi. Untuk informasi tentang ukuran komputer virtual yang tersedia untuk kumpulan Cloud Services (kumpulan yang dibuat dengan cloudServiceConfiguration), lihat Ukuran untuk Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch mendukung semua ukuran VM Cloud Services kecuali ExtraSmall, A1V2, dan A2V2. Untuk informasi tentang ukuran VM yang tersedia untuk Kumpulan menggunakan Gambar dari Virtual Machines Marketplace (kumpulan yang dibuat dengan virtualMachineConfiguration) lihat Ukuran untuk Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) atau Ukuran untuk Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch mendukung semua ukuran Azure VM kecuali STANDARD_A0 dan yang memiliki penyimpanan premium (STANDARD_GS, STANDARD_DS, dan seri STANDARD_DSV2).

cloud_service_configuration

CloudServiceConfiguration

Diperlukan

Konfigurasi layanan cloud untuk Kumpulan. Properti ini dan virtualMachineConfiguration saling eksklusif dan salah satu properti harus ditentukan. Properti ini tidak dapat ditentukan jika Akun Batch dibuat dengan properti poolAllocationMode yang diatur ke 'UserSubscription'.

virtual_machine_configuration

VirtualMachineConfiguration

Diperlukan

Konfigurasi komputer virtual untuk Kumpulan. Properti dan cloudServiceConfiguration ini saling eksklusif dan salah satu properti harus ditentukan.

resize_timeout

<xref:timedelta>

Diperlukan

Batas waktu ini hanya berlaku untuk penskalakan manual; tidak berpengaruh ketika enableAutoScale diatur ke true. Nilai defaultnya adalah 15 menit. Nilai minimum adalah 5 menit. Jika Anda menentukan nilai kurang dari 5 menit, layanan Batch mengembalikan kesalahan; jika Anda memanggil REST API secara langsung, kode status HTTP adalah 400 (Permintaan Buruk).

target_dedicated_nodes

int

Diperlukan

Jumlah Simpul Komputasi khusus yang diinginkan di Kumpulan. Properti ini tidak boleh ditentukan jika enableAutoScale diatur ke true. Jika enableAutoScale diatur ke false, maka Anda harus mengatur targetDedicatedNodes, targetLowPriorityNodes, atau keduanya.

target_low_priority_nodes

int

Diperlukan

Jumlah Simpul Komputasi Spot/Prioritas rendah yang diinginkan di Kumpulan. Properti ini tidak boleh ditentukan jika enableAutoScale diatur ke true. Jika enableAutoScale diatur ke false, maka Anda harus mengatur targetDedicatedNodes, targetLowPriorityNodes, atau keduanya.

enable_auto_scale

bool

Diperlukan

Apakah ukuran Kumpulan harus secara otomatis menyesuaikan dari waktu ke waktu. Jika false, setidaknya salah satu targetDedicatedNodes dan targetLowPriorityNodes harus ditentukan. Jika true, properti autoScaleFormula diperlukan dan Kumpulan secara otomatis mengubah ukuran sesuai dengan rumus. Nilai defaultnya adalah false.

auto_scale_formula

str

Diperlukan

Properti ini tidak boleh ditentukan jika enableAutoScale diatur ke false. Diperlukan jika enableAutoScale diatur ke true. Rumus diperiksa validitasnya sebelum Kumpulan dibuat. Jika rumus tidak valid, layanan Batch menolak permintaan dengan informasi kesalahan terperinci. Untuk informasi selengkapnya tentang menentukan rumus ini, lihat 'Menskalakan Simpul Komputasi secara otomatis dalam Kumpulan Azure Batch' (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

auto_scale_evaluation_interval

<xref:timedelta>

Diperlukan

Nilai defaultnya adalah 15 menit. Nilai minimum dan maksimum masing-masing adalah 5 menit dan 168 jam. Jika Anda menentukan nilai kurang dari 5 menit atau lebih besar dari 168 jam, layanan Batch mengembalikan kesalahan; jika Anda memanggil REST API secara langsung, kode status HTTP adalah 400 (Permintaan Buruk).

enable_inter_node_communication

bool

Diperlukan

Apakah Kumpulan mengizinkan komunikasi langsung antara Simpul Komputasi. Mengaktifkan komunikasi antar-simpul membatasi ukuran maksimum Kumpulan karena pembatasan penyebaran pada Simpul Komputasi Kumpulan. Ini dapat mengakibatkan Kumpulan tidak mencapai ukuran yang diinginkan. Nilai defaultnya adalah false.

network_configuration

NetworkConfiguration

Diperlukan

Konfigurasi jaringan untuk Kumpulan.

start_task

StartTask

Diperlukan

Tugas yang ditentukan untuk dijalankan pada setiap Simpul Komputasi saat bergabung dengan Kumpulan. Tugas berjalan ketika Simpul Komputasi ditambahkan ke Kumpulan atau ketika Simpul Komputasi dimulai ulang.

certificate_references

list[CertificateReference]

Diperlukan

Untuk Simpul Windows, layanan Batch menginstal Sertifikat ke penyimpanan dan lokasi Sertifikat yang ditentukan. Untuk Simpul Komputasi Linux, Sertifikat disimpan dalam direktori di dalam direktori kerja Tugas dan variabel lingkungan AZ_BATCH_CERTIFICATES_DIR disediakan ke Tugas untuk mengkueri lokasi ini. Untuk Sertifikat dengan visibilitas 'remoteUser', direktori 'certs' dibuat di direktori beranda pengguna (misalnya, /home/{user-name}/certs) dan Sertifikat ditempatkan di direktori tersebut. Peringatan: Properti ini tidak digunakan lagi dan akan dihapus setelah Februari 2024. Silakan gunakan Ekstensi Azure KeyVault sebagai gantinya.

application_package_references

list[ApplicationPackageReference]

Diperlukan

Saat membuat kumpulan, ID aplikasi paket harus sepenuhnya memenuhi syarat (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Perubahan pada referensi Paket memengaruhi semua Simpul baru yang bergabung dengan Kumpulan, tetapi tidak memengaruhi Simpul Komputasi yang sudah ada di Kumpulan hingga di-boot ulang atau digambut ulang. Ada maksimum 10 referensi Paket pada Kumpulan tertentu.

application_licenses

list[str]

Diperlukan

Daftar lisensi aplikasi harus merupakan subset dari lisensi aplikasi layanan Batch yang tersedia. Jika lisensi diminta yang tidak didukung, pembuatan Kumpulan akan gagal.

task_slots_per_node

int

Diperlukan

Jumlah slot tugas yang dapat digunakan untuk menjalankan tugas bersamaan pada satu simpul komputasi dalam kumpulan. Nilai default adalah 1. Nilai maksimum adalah lebih kecil dari 4 kali jumlah inti vmSize kumpulan atau 256.

task_scheduling_policy

TaskSchedulingPolicy

Diperlukan

Bagaimana Tugas didistribusikan di seluruh Simpul Komputasi dalam Kumpulan. Jika tidak ditentukan, defaultnya adalah spread.

user_accounts

list[UserAccount]

Diperlukan

metadata

list[MetadataItem]

Diperlukan

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

mount_configuration

list[MountConfiguration]

Diperlukan

Pasang penyimpanan menggunakan sistem file berbasis Azure fileshare, NFS, CIFS, atau Blobfuse.

target_node_communication_mode

str atau NodeCommunicationMode

Diperlukan

Mode komunikasi simpul yang diinginkan untuk kumpulan. Jika dihilangkan, nilai defaultnya adalah Default. Nilai yang mungkin termasuk: 'default', 'klasik', 'disederhanakan'

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