Udostępnij za pośrednictwem


Pool Klasa

Zawiera informacje o puli.

Zmienne są wypełniane tylko przez serwer i będą ignorowane podczas wysyłania żądania.

Dziedziczenie
azure.mgmt.batch.models._models_py3.ProxyResource
Pool

Konstruktor

Pool(*, identity: _models.BatchPoolIdentity | None = None, display_name: str | None = None, vm_size: str | None = None, deployment_configuration: _models.DeploymentConfiguration | None = None, scale_settings: _models.ScaleSettings | None = None, inter_node_communication: str | _models.InterNodeCommunicationState | None = None, network_configuration: _models.NetworkConfiguration | None = None, task_slots_per_node: int = 1, task_scheduling_policy: _models.TaskSchedulingPolicy | None = None, user_accounts: List[_models.UserAccount] | None = None, metadata: List[_models.MetadataItem] | None = None, start_task: _models.StartTask | None = None, certificates: List[_models.CertificateReference] | None = None, application_packages: List[_models.ApplicationPackageReference] | None = None, application_licenses: List[str] | None = None, mount_configuration: List[_models.MountConfiguration] | None = None, target_node_communication_mode: str | _models.NodeCommunicationMode | None = None, resource_tags: Dict[str, str] | None = None, **kwargs: Any)

Keyword-Only Parameters

identity
BatchPoolIdentity

Typ tożsamości używanej dla puli usługi Batch.

display_name
str

Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.

vm_size
str

Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul Cloud Services (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie Cloud Services rozmiary maszyn wirtualnych z wyjątkiem ExtraSmall. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul korzystających z obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą polecenia virtualMachineConfiguration), zobacz Rozmiary dla Virtual Machines (Linux) () lubhttps://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ Rozmiary dla Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i tych z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).

deployment_configuration
DeploymentConfiguration

Użycie polecenia CloudServiceConfiguration określa, że węzły powinny tworzyć przy użyciu usługi Azure Cloud Services (PaaS), podczas gdy funkcja VirtualMachineConfiguration używa usługi Azure Virtual Machines (IaaS).

scale_settings
ScaleSettings

Definiuje żądany rozmiar puli. Może to być wartość "fixedScale", w której określono żądany element targetDedicatedNodes, lub "autoScale", który definiuje formułę, która jest okresowo ponownie obliczana. Jeśli ta właściwość nie zostanie określona, pula będzie mieć stałą skalę z 0 targetDedicatedNodes.

inter_node_communication
str lub InterNodeCommunicationState

Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone". Znane wartości to: "Włączone" i "Wyłączone".

network_configuration
NetworkConfiguration

Konfiguracja sieci dla puli.

task_slots_per_node
int
wartość domyślna: 1

Wartość domyślna to 1. Wartość maksymalna jest mniejsza niż 4 razy mniejsza niż liczba rdzeni vmSize puli lub 256.

task_scheduling_policy
TaskSchedulingPolicy

Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona.

user_accounts
list[UserAccount]

Lista kont użytkowników do utworzenia w każdym węźle w puli.

metadata
list[MetadataItem]

Usługa Batch nie przypisuje żadnego znaczenia do metadanych; jest on przeznaczony wyłącznie do korzystania z kodu użytkownika.

start_task
StartTask

W operacji PATCH (update) tę właściwość można ustawić na pusty obiekt, aby usunąć zadanie uruchamiania z puli.

certificates
list[CertificateReference]

W przypadku węzłów obliczeniowych systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym zadania podrzędnego, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu.

Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault .

application_packages
list[ApplicationPackageReference]

Zmiany odwołań do pakietu aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji.

application_licenses
list[str]

Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem.

mount_configuration
list[MountConfiguration]

Obsługuje to Azure Files, NFS, CIFS/SMB i Blobfuse.

target_node_communication_mode
str lub NodeCommunicationMode

Jeśli pominięto, wartością domyślną jest Wartość domyślna. Znane wartości to: "Default", "Classic" i "Simplified".

resource_tags
dict[str, str]

Tagi zdefiniowane przez użytkownika do skojarzenia z pulą Azure Batch. Po określeniu te tagi są propagowane do zasobów platformy Azure skojarzonych z pulą. Tę właściwość można określić tylko wtedy, gdy konto usługi Batch zostało utworzone za pomocą właściwości poolAllocationMode ustawionej na wartość "UserSubscription".

Zmienne

id
str

Identyfikator zasobu.

name
str

Nazwa zasobu.

type
str

Typ zasobu.

etag
str

Element ETag zasobu używany na potrzeby instrukcji współbieżności.

identity
BatchPoolIdentity

Typ tożsamości używanej dla puli usługi Batch.

display_name
str

Nazwa wyświetlana nie musi być unikatowa i może zawierać znaki Unicode o maksymalnej długości 1024.

last_modified
datetime

Jest to ostatni raz, w którym dane na poziomie puli, takie jak targetDedicatedNodes lub autoScaleSettings, uległy zmianie. Nie uwzględnia on zmian na poziomie węzła, takich jak zmiana stanu węzła obliczeniowego.

creation_time
datetime

Czas utworzenia puli.

provisioning_state
str lub PoolProvisioningState

Bieżący stan puli. Znane wartości to: "Succeeded" (Powodzenie) i "Deleting" (Usuwanie).

provisioning_state_transition_time
datetime

Czas, w którym pula weszła w jej bieżący stan.

allocation_state
str lub AllocationState

Określa, czy pula zmienia rozmiar. Znane wartości to: "Steady", "Resizing" i "Stopping".

allocation_state_transition_time
datetime

Czas, w którym pula weszła w jej bieżący stan alokacji.

vm_size
str

Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul Cloud Services (pul utworzonych za pomocą funkcji cloudServiceConfiguration), zobacz Rozmiary dla Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Usługa Batch obsługuje wszystkie Cloud Services rozmiary maszyn wirtualnych z wyjątkiem ExtraSmall. Aby uzyskać informacje o dostępnych rozmiarach maszyn wirtualnych dla pul korzystających z obrazów z witryny Virtual Machines Marketplace (pule utworzone za pomocą polecenia virtualMachineConfiguration), zobacz Rozmiary dla Virtual Machines (Linux) () lubhttps://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ Rozmiary dla Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Usługa Batch obsługuje wszystkie rozmiary maszyn wirtualnych platformy Azure z wyjątkiem STANDARD_A0 i tych z magazynem w warstwie Premium (STANDARD_GS, STANDARD_DS i serii STANDARD_DSV2).

deployment_configuration
DeploymentConfiguration

Użycie polecenia CloudServiceConfiguration określa, że węzły powinny tworzyć przy użyciu usługi Azure Cloud Services (PaaS), podczas gdy funkcja VirtualMachineConfiguration używa usługi Azure Virtual Machines (IaaS).

current_dedicated_nodes
int

Liczba dedykowanych węzłów obliczeniowych obecnie w puli.

current_low_priority_nodes
int

Liczba węzłów obliczeniowych typu spot/o niskim priorytcie obecnie w puli.

scale_settings
ScaleSettings

Definiuje żądany rozmiar puli. Może to być wartość "fixedScale", w której określono żądany element targetDedicatedNodes, lub "autoScale", który definiuje formułę, która jest okresowo ponownie obliczana. Jeśli ta właściwość nie zostanie określona, pula będzie mieć stałą skalę z 0 targetDedicatedNodes.

auto_scale_run
AutoScaleRun

Ta właściwość jest ustawiana tylko wtedy, gdy pula jest automatycznie skalowana, tj. są używane autoScaleSettings.

inter_node_communication
str lub InterNodeCommunicationState

Nakłada to ograniczenia dotyczące węzłów, które można przypisać do puli. Włączenie tej wartości może zmniejszyć prawdopodobieństwo przydzielenia żądanej liczby węzłów w puli. Jeśli nie zostanie określona, ta wartość jest domyślnie ustawiona na wartość "Wyłączone". Znane wartości to: "Włączone" i "Wyłączone".

network_configuration
NetworkConfiguration

Konfiguracja sieci dla puli.

task_slots_per_node
int

Wartość domyślna to 1. Wartość maksymalna jest mniejsza niż 4 razy mniejsza niż liczba rdzeni vmSize puli lub 256.

task_scheduling_policy
TaskSchedulingPolicy

Jeśli nie zostanie określony, wartość domyślna zostanie rozłożona.

user_accounts
list[UserAccount]

Lista kont użytkowników do utworzenia w każdym węźle w puli.

metadata
list[MetadataItem]

Usługa Batch nie przypisuje żadnego znaczenia do metadanych; jest on przeznaczony wyłącznie do korzystania z kodu użytkownika.

start_task
StartTask

W operacji PATCH (update) tę właściwość można ustawić na pusty obiekt, aby usunąć zadanie uruchamiania z puli.

certificates
list[CertificateReference]

W przypadku węzłów obliczeniowych systemu Windows usługa Batch instaluje certyfikaty w określonym magazynie certyfikatów i lokalizacji. W przypadku węzłów obliczeniowych systemu Linux certyfikaty są przechowywane w katalogu roboczym zadania podrzędnego, a zmienna środowiskowa AZ_BATCH_CERTIFICATES_DIR jest dostarczana do zadania w celu wykonania zapytania o tę lokalizację. W przypadku certyfikatów z widocznością "remoteUser" katalog "certs" jest tworzony w katalogu głównym użytkownika (np. /home/{user-name}/certs) i certyfikaty są umieszczane w tym katalogu.

Ostrzeżenie: Ta właściwość jest przestarzała i zostanie usunięta po lutym 2024 r. Zamiast tego użyj rozszerzenia Azure KeyVault .

application_packages
list[ApplicationPackageReference]

Zmiany odwołań do pakietu aplikacji mają wpływ na wszystkie nowe węzły obliczeniowe łączące pulę, ale nie mają wpływu na węzły obliczeniowe, które znajdują się już w puli, dopóki nie zostaną ponownie uruchomione lub z obrazu. W dowolnej puli istnieje maksymalnie 10 odwołań do pakietu aplikacji.

application_licenses
list[str]

Lista licencji aplikacji musi być podzbiorem dostępnych licencji aplikacji usługi Batch. Jeśli zażądano licencji, która nie jest obsługiwana, tworzenie puli zakończy się niepowodzeniem.

resize_operation_status
ResizeOperationStatus

Opisuje bieżącą operację (jeśli parametr AllocationState puli zmienia rozmiar) lub wcześniej ukończoną operację (jeśli wartość AllocationState jest stała).

mount_configuration
list[MountConfiguration]

Obsługuje to Azure Files, NFS, CIFS/SMB i Blobfuse.

target_node_communication_mode
str lub NodeCommunicationMode

Jeśli pominięto, wartością domyślną jest Wartość domyślna. Znane wartości to: "Default", "Classic" i "Simplified".

current_node_communication_mode
str lub NodeCommunicationMode

Określa, w jaki sposób pula komunikuje się z usługą Batch. Znane wartości to: "Default", "Classic" i "Simplified".

resource_tags
dict[str, str]

Tagi zdefiniowane przez użytkownika do skojarzenia z pulą Azure Batch. Po określeniu te tagi są propagowane do zasobów platformy Azure skojarzonych z pulą. Tę właściwość można określić tylko wtedy, gdy konto usługi Batch zostało utworzone za pomocą właściwości poolAllocationMode ustawionej na wartość "UserSubscription".