PoolAddParameter Classe
Un pool nel servizio Azure Batch da aggiungere.
Tutti i parametri obbligatori devono essere popolati per l'invio ad Azure.
- Ereditarietà
-
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
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
Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.
- vm_size
- str
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
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
Configurazione della macchina virtuale per il pool. Questa proprietà e cloudServiceConfiguration si escludono reciprocamente ed è necessario specificare una delle proprietà.
- resize_timeout
- <xref:timedelta>
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
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
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
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
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>
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
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.
- start_task
- StartTask
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]
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]
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.
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
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
Modalità di distribuzione delle attività tra nodi di calcolo in un pool. Se non specificato, il valore predefinito è distribuito.
- user_accounts
- list[UserAccount]
- metadata
- list[MetadataItem]
Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.
- mount_configuration
- list[MountConfiguration]
Montare l'archiviazione usando fileshare, NFS, CIFS o BLOBfuse based file system.
- target_node_communication_mode
- str oppure NodeCommunicationMode
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:
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
Restituisce
Oggetto compatibile con JSON dict
Tipo restituito
deserialize
Analizzare uno str usando la sintassi RestAPI e restituire un modello.
deserialize(data, content_type=None)Parametri
- content_type
- str
JSON per impostazione predefinita, impostare application/xml se XML.
Restituisce
Istanza di questo modello
Eccezioni
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
- content_type
- str
JSON per impostazione predefinita, impostare application/xml se XML.
- key_extractors
Restituisce
Istanza di questo modello
Eccezioni
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
Restituisce
Oggetto compatibile con JSON dict
Tipo restituito
validate
Convalidare questo modello in modo ricorsivo e restituire un elenco di ValidationError.
validate()Restituisce
Elenco di errori di convalida
Tipo restituito
Azure SDK for Python
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per