VirtualMachineConfiguration Klasa

Konfiguracja węzłów obliczeniowych w puli na podstawie infrastruktury usługi Azure Virtual Machines.

Aby wysyłać na platformę Azure wszystkie wymagane parametry, należy wypełnić wszystkie wymagane parametry.

Dziedziczenie
VirtualMachineConfiguration

Konstruktor

VirtualMachineConfiguration(*, image_reference, node_agent_sku_id: str, windows_configuration=None, data_disks=None, license_type: str = None, container_configuration=None, disk_encryption_configuration=None, node_placement_configuration=None, extensions=None, os_disk=None, **kwargs)

Parametry

image_reference
ImageReference
Wymagane

Wymagane. Odwołanie do obrazu witryny Azure Virtual Machines Marketplace lub niestandardowego obrazu maszyny wirtualnej do użycia.

node_agent_sku_id
str
Wymagane

Wymagane. Agent węzła obliczeniowego usługi Batch to program uruchamiany w każdym węźle obliczeniowym w puli i udostępnia interfejs poleceń i sterowania między węzłem obliczeniowym a usługą Batch. Istnieją różne implementacje agenta węzła obliczeniowego nazywanego jednostkami SKU dla różnych systemów operacyjnych. Należy określić jednostkę SKU agenta węzła obliczeniowego zgodną z wybranym odwołaniem do obrazu. Aby uzyskać listę obsługiwanych jednostek SKU agenta węzła obliczeniowego wraz z listą zweryfikowanych odwołań do obrazów, zobacz operację "Lista obsługiwanych jednostek SKU agenta węzła obliczeniowego".

windows_configuration
WindowsConfiguration
Wymagane

Ustawienia systemu operacyjnego Windows na maszynie wirtualnej. Nie można określić tej właściwości, jeśli właściwość imageReference określa obraz systemu operacyjnego Linux.

data_disks
list[DataDisk]
Wymagane

Tę właściwość należy określić, jeśli węzły obliczeniowe w puli muszą mieć dołączone puste dyski danych. Nie można tego zaktualizować. Każdy węzeł obliczeniowy pobiera własny dysk (dysk nie jest udziałem plików). Nie można dołączyć istniejących dysków, każdy dołączony dysk jest pusty. Po usunięciu węzła obliczeniowego z puli dysk i wszystkie skojarzone z nim dane również zostaną usunięte. Dysk nie jest sformatowany po dołączeniu, należy go sformatować przed użyciem — aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux i https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.

license_type
str
Wymagane

Dotyczy to tylko obrazów, które zawierają system operacyjny Windows i powinny być używane tylko w przypadku przechowywania prawidłowych licencji lokalnych dla węzłów obliczeniowych, które zostaną wdrożone. Jeśli pominięto, nie zastosowano rabatu na licencjonowanie lokalne. Wartości to: Windows_Server — licencja lokalna jest przeznaczona dla systemu Windows Server. Windows_Client — licencja lokalna jest przeznaczona dla klienta systemu Windows.

container_configuration
ContainerConfiguration
Wymagane

Konfiguracja kontenera dla puli. Jeśli zostanie określona, konfiguracja jest wykonywana w każdym węźle obliczeniowym w puli, aby umożliwić uruchamianie zadań w kontenerach. Wszystkie zwykłe zadania i zadania menedżera zadań są uruchamiane w tej puli, muszą określić właściwość containerSettings, a wszystkie inne zadania mogą je określić.

disk_encryption_configuration
DiskEncryptionConfiguration
Wymagane

Konfiguracja szyfrowania dysku dla puli. Jeśli to określone, szyfrowanie jest wykonywane w każdym węźle w puli podczas aprowizacji węzła.

node_placement_configuration
NodePlacementConfiguration
Wymagane

Konfiguracja umieszczania węzłów dla puli. Ta konfiguracja określi reguły dotyczące fizycznego przydzielania węzłów w puli.

extensions
list[VMExtension]
Wymagane

Jeśli zostanie określony, rozszerzenia wymienione w tej konfiguracji zostaną zainstalowane w każdym węźle.

os_disk
OSDisk
Wymagane

Ustawienia dysku systemu operacyjnego maszyny wirtualnej.

Metody

as_dict

Zwróć dykt, który może być JSONify przy użyciu pliku json.dump.

Użycie zaawansowane może opcjonalnie używać wywołania zwrotnego jako parametru:

Klucz to nazwa atrybutu używana w języku Python. Attr_desc to dykt metadanych. Obecnie zawiera ciąg "type" z typem msrest i kluczem zakodowanym w interfejsie RESTAPI. Wartość jest bieżącą wartością w tym obiekcie.

Zwrócony ciąg będzie używany do serializacji klucza. Jeśli zwracany typ jest listą, jest to uważane za hierarchiczne dykt wyniku.

Zobacz trzy przykłady w tym pliku:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Jeśli chcesz serializacji XML, możesz przekazać kwargs is_xml=True.

deserialize

Analizowanie ciągu przy użyciu składni restAPI i zwracanie modelu.

enable_additional_properties_sending
from_dict

Przeanalizuj dykt przy użyciu danego wyodrębniającego klucz zwraca model.

Domyślnie należy wziąć pod uwagę wyodrębniacze kluczy (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor i last_rest_key_case_insensitive_extractor)

is_xml_model
serialize

Zwróć kod JSON, który zostanie wysłany na platformę Azure z tego modelu.

Jest to alias as_dict(full_restapi_key_transformer, keep_readonly=False).

Jeśli chcesz serializacji XML, możesz przekazać kwargs is_xml=True.

validate

Zweryfikuj ten model cyklicznie i zwróć listę wartości ValidationError.

as_dict

Zwróć dykt, który może być JSONify przy użyciu pliku json.dump.

Użycie zaawansowane może opcjonalnie używać wywołania zwrotnego jako parametru:

Klucz to nazwa atrybutu używana w języku Python. Attr_desc to dykt metadanych. Obecnie zawiera ciąg "type" z typem msrest i kluczem zakodowanym w interfejsie RESTAPI. Wartość jest bieżącą wartością w tym obiekcie.

Zwrócony ciąg będzie używany do serializacji klucza. Jeśli zwracany typ jest listą, jest to uważane za hierarchiczne dykt wyniku.

Zobacz trzy przykłady w tym pliku:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Jeśli chcesz serializacji XML, możesz przekazać kwargs is_xml=True.

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

Parametry

key_transformer
<xref:function>

Funkcja przekształcania klucza.

keep_readonly
wartość domyślna: True

Zwraca

Obiekt zgodny z JSON w formacie JSON

Typ zwracany

deserialize

Analizowanie ciągu przy użyciu składni restAPI i zwracanie modelu.

deserialize(data, content_type=None)

Parametry

data
str
Wymagane

Str używający struktury RestAPI. Domyślnie kod JSON.

content_type
str
wartość domyślna: None

Domyślnie w formacie JSON ustaw wartość application/xml, jeśli plik XML.

Zwraca

Wystąpienie tego modelu

Wyjątki

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Przeanalizuj dykt przy użyciu danego wyodrębniającego klucz zwraca model.

Domyślnie należy wziąć pod uwagę wyodrębniacze kluczy (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor i last_rest_key_case_insensitive_extractor)

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

Parametry

data
dict
Wymagane

Dykt używający struktury RESTAPI

content_type
str
wartość domyślna: None

Domyślnie w formacie JSON ustaw wartość application/xml, jeśli plik XML.

key_extractors
wartość domyślna: None

Zwraca

Wystąpienie tego modelu

Wyjątki

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Zwróć kod JSON, który zostanie wysłany na platformę Azure z tego modelu.

Jest to alias as_dict(full_restapi_key_transformer, keep_readonly=False).

Jeśli chcesz serializacji XML, możesz przekazać kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Parametry

keep_readonly
bool
wartość domyślna: False

Jeśli chcesz serializować atrybuty readonly

Zwraca

Obiekt zgodny z JSON w formacie JSON

Typ zwracany

validate

Zweryfikuj ten model cyklicznie i zwróć listę wartości ValidationError.

validate()

Zwraca

Lista błędów weryfikacji

Typ zwracany