PoolAddParameter Classe

Un pool nel servizio Azure Batch da aggiungere.

Tutti i parametri obbligatori devono essere popolati per l'invio ad Azure.

Ereditarietà

Model

PoolAddParameter

Costruttore

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)

Parametri

id

str

Necessario

Obbligatorio. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID è senza distinzione tra maiuscole e minuscole , ovvero non è possibile che siano presenti due ID pool all'interno di un account diverso solo in base al caso.

display_name

str

Necessario

Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.

vm_size

str

Necessario

Obbligatorio. Per informazioni sulle dimensioni disponibili delle macchine virtuali per i pool di Servizi cloud (pool creati con cloudServiceConfiguration), vedere Dimensioni per Servizi cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch supporta tutte le dimensioni di macchine virtuali Servizi cloud tranne ExtraSmall, A1V2 e A2V2. Per informazioni sulle dimensioni delle macchine virtuali disponibili per i pool che usano immagini dal marketplace Macchine virtuali (pool creati con virtualMachineConfiguration) vedere Dimensioni per Macchine virtuali (Linux)https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ o Dimensioni per Macchine virtuali (Windows).https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/ Batch supporta tutte le dimensioni di macchine virtuali di Azure tranne STANDARD_A0 e quelle con archiviazione Premium (STANDARD_GS, STANDARD_DS e serie di STANDARD_DSV2).

cloud_service_configuration

CloudServiceConfiguration

Necessario

Configurazione del servizio cloud per il pool. Questa proprietà e virtualMachineConfiguration si escludono a vicenda e una delle proprietà deve essere specificata. Questa proprietà non può essere specificata se l'account Batch è stato creato con la relativa proprietà poolAllocationMode impostata su 'UserSubscription'.

virtual_machine_configuration

VirtualMachineConfiguration

Necessario

Configurazione della macchina virtuale per il pool. Questa proprietà e cloudServiceConfiguration si escludono reciprocamente ed è necessario specificare una delle proprietà.

resize_timeout

<xref:timedelta>

Necessario

Questo timeout si applica solo al ridimensionamento manuale; non ha alcun effetto quando enableAutoScale è impostato su true. Il valore predefinito è 15 minuti. Il valore minimo è di 5 minuti. Se si specifica un valore minore di 5 minuti, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

target_dedicated_nodes

int

Necessario

Numero desiderato di nodi di calcolo dedicati nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.

target_low_priority_nodes

int

Necessario

Numero desiderato di nodi di calcolo con priorità spot/bassa nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.

enable_auto_scale

bool

Necessario

Se le dimensioni del pool devono essere modificate automaticamente nel tempo. Se false, è necessario specificare almeno uno di targetDedicatedNodes e targetLowPriorityNodes. Se true, la proprietà autoScaleFormula è necessaria e il pool viene ridimensionato automaticamente in base alla formula. Il valore predefinito è false.

auto_scale_formula

str

Necessario

Questa proprietà non deve essere specificata se enableAutoScale è impostato su false. È necessario se enableAutoScale è impostato su true. La formula viene controllata per la validità prima della creazione del pool. Se la formula non è valida, il servizio Batch rifiuta la richiesta con informazioni dettagliate sull'errore. Per altre informazioni sulla specifica di questa formula, vedere "Ridimensionare automaticamente i nodi di calcolo in un pool di Azure Batch" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

auto_scale_evaluation_interval

<xref:timedelta>

Necessario

Il valore predefinito è 15 minuti. Il valore minimo e massimo sono rispettivamente 5 minuti e 168 ore. Se si specifica un valore minore di 5 minuti o maggiore di 168 ore, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

enable_inter_node_communication

bool

Necessario

Se il pool consente la comunicazione diretta tra nodi di calcolo. L'abilitazione della comunicazione tra nodi limita le dimensioni massime del pool a causa delle restrizioni di distribuzione nei nodi di calcolo del pool. Ciò può comportare che il pool non raggiunga le dimensioni desiderate. Il valore predefinito è false.

network_configuration

NetworkConfiguration

Necessario

Configurazione di rete per il pool.

start_task

StartTask

Necessario

Attività specificata per l'esecuzione in ogni nodo di calcolo durante l'aggiunta al pool. L'attività viene eseguita quando il nodo di calcolo viene aggiunto al pool o quando viene riavviato il nodo di calcolo.

certificate_references

list[CertificateReference]

Necessario

Per i nodi di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire query per questa posizione. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente ,ad esempio /home/{user-name}/certs) e i certificati vengono inseriti in tale directory. Avviso: questa proprietà è deprecata e verrà rimossa dopo febbraio 2024. Usare invece l'estensione Azure KeyVault .

application_package_references

list[ApplicationPackageReference]

Necessario

Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Le modifiche apportate ai riferimenti al pacchetto influiscono su tutti i nuovi nodi che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool finché non vengono riavviati o ricreati. Sono disponibili un massimo di 10 riferimenti al pacchetto in qualsiasi pool specificato.

application_licenses

list[str]

Necessario

L'elenco delle licenze dell'applicazione deve essere un subset di licenze dell'applicazione di servizio Batch disponibili. Se viene richiesta una licenza che non è supportata, la creazione del pool avrà esito negativo.

task_slots_per_node

int

Necessario

Numero di slot di attività che possono essere usati per eseguire attività simultanee in un singolo nodo di calcolo nel pool. Il valore predefinito è 1. Il valore massimo è minore di 4 volte il numero di core della vmSize del pool o 256.

task_scheduling_policy

TaskSchedulingPolicy

Necessario

Modalità di distribuzione delle attività tra nodi di calcolo in un pool. Se non specificato, il valore predefinito è distribuito.

user_accounts

list[UserAccount]

Necessario

metadata

list[MetadataItem]

Necessario

Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.

mount_configuration

list[MountConfiguration]

Necessario

Montare l'archiviazione usando fileshare, NFS, CIFS o BLOBfuse based file system.

target_node_communication_mode

str oppure NodeCommunicationMode

Necessario

Modalità di comunicazione del nodo desiderata per il pool. Se omesso, il valore predefinito è Default. I valori possibili includono: 'default', 'classic', 'semplificato'

Metodi

as_dict	Restituire un valore dict che può essere JSONify usando json.dump. L'utilizzo avanzato potrebbe facoltativamente usare un callback come parametro: La chiave è il nome dell'attributo usato in Python. Attr_desc è un dict di metadati. Attualmente contiene 'type' con il tipo msrest e 'key' con la chiave con codifica RestAPI. Il valore è il valore corrente in questo oggetto. La stringa restituita verrà usata per serializzare la chiave. Se il tipo restituito è un elenco, viene considerato un risultato gerarchico. Vedere i tre esempi in questo file: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer Se si vuole la serializzazione XML, è possibile passare i kwargs is_xml=True.
deserialize	Analizzare uno str usando la sintassi RestAPI e restituire un modello.
enable_additional_properties_sending
from_dict	Analizzare un dict usando un estrattore chiave specificato restituisce un modello. Per impostazione predefinita, considerare gli estrattori di chiavi (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor e last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	Restituire il codice JSON inviato ad Azure da questo modello. Si tratta di un alias per as_dict(full_restapi_key_transformer, keep_readonly=False).This is an alias to as_dict(full_restapi_key_transformer, keep_readonly=False).This is an alias to as_dict(full_restapi_key_transformer, keep_readonly=False). Se si vuole la serializzazione XML, è possibile passare i kwargs is_xml=True.
validate	Convalidare questo modello in modo ricorsivo e restituire un elenco di ValidationError.

as_dict

Restituire un valore dict che può essere JSONify usando json.dump.

L'utilizzo avanzato potrebbe facoltativamente usare un callback come parametro:

La chiave è il nome dell'attributo usato in Python. Attr_desc è un dict di metadati. Attualmente contiene 'type' con il tipo msrest e 'key' con la chiave con codifica RestAPI. Il valore è il valore corrente in questo oggetto.

La stringa restituita verrà usata per serializzare la chiave. Se il tipo restituito è un elenco, viene considerato un risultato gerarchico.

Vedere i tre esempi in questo file:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

Se si vuole la serializzazione XML, è possibile passare i kwargs is_xml=True.

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

Parametri

key_transformer

<xref:function>

Funzione di trasformatore chiave.

keep_readonly

valore predefinito: True

Restituisce

Oggetto compatibile con JSON dict

Tipo restituito

dict

deserialize

Analizzare uno str usando la sintassi RestAPI e restituire un modello.

deserialize(data, content_type=None)

Parametri

data

str

Necessario

Str usando la struttura RestAPI. JSON per impostazione predefinita.

content_type

str

valore predefinito: None

JSON per impostazione predefinita, impostare application/xml se XML.

Restituisce

Istanza di questo modello

Eccezioni

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Analizzare un dict usando un estrattore chiave specificato restituisce un modello.

Per impostazione predefinita, considerare gli estrattori di chiavi (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor e last_rest_key_case_insensitive_extractor)

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

Parametri

data

dict

Necessario

Dict using RestAPI structure

content_type

str

valore predefinito: None

JSON per impostazione predefinita, impostare application/xml se XML.

key_extractors

valore predefinito: None

Restituisce

Istanza di questo modello

Eccezioni

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Restituire il codice JSON inviato ad Azure da questo modello.

Si tratta di un alias per as_dict(full_restapi_key_transformer, keep_readonly=False).This is an alias to as_dict(full_restapi_key_transformer, keep_readonly=False).This is an alias to as_dict(full_restapi_key_transformer, keep_readonly=False).

Se si vuole la serializzazione XML, è possibile passare i kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Parametri

keep_readonly

bool

valore predefinito: False

Se si vuole serializzare gli attributi readonly

Restituisce

Oggetto compatibile con JSON dict

Tipo restituito

dict

validate

Convalidare questo modello in modo ricorsivo e restituire un elenco di ValidationError.

validate()

Restituisce

Elenco di errori di convalida

Tipo restituito

list