CloudPool Classe
Un pool nel servizio Azure Batch.
Le variabili vengono popolate solo dal server e verranno ignorate durante l'invio di una richiesta.
- Ereditarietà
-
CloudPool
Costruttore
CloudPool(*, id: str = None, display_name: str = None, url: str = None, e_tag: str = None, last_modified=None, creation_time=None, state=None, state_transition_time=None, allocation_state=None, allocation_state_transition_time=None, vm_size: str = None, cloud_service_configuration=None, virtual_machine_configuration=None, resize_timeout=None, resize_errors=None, current_dedicated_nodes: int = None, current_low_priority_nodes: int = 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, auto_scale_run=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, stats=None, mount_configuration=None, identity=None, target_node_communication_mode=None, **kwargs)Parametri
- id
- str
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 potrebbe non avere due ID all'interno di un account che differisce 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.
- url
- str
- e_tag
- str
Si tratta di una stringa opaca. È possibile usarlo per rilevare se il pool è cambiato tra le richieste. In particolare, è possibile passare L'ETag durante l'aggiornamento di un pool per specificare che le modifiche devono essere effettive solo se nessuno altro ha modificato il pool nel frattempo.
- last_modified
- datetime
Questa è l'ultima volta in cui i dati a livello di pool, ad esempio le impostazioni targetDedicatedNodes o enableAutoscale, sono state modificate. Non influisce su modifiche a livello di nodo, ad esempio uno stato di modifica del nodo di calcolo.
- creation_time
- datetime
- state_transition_time
- datetime
- allocation_state
- str oppure AllocationState
I valori possibili includono: 'steady', 'ridimensionamento', 'arresto'
- allocation_state_transition_time
- datetime
- vm_size
- str
Per informazioni sulle dimensioni disponibili delle macchine virtuali nei pool, vedere Scegliere una dimensione della macchina virtuale per i nodi di calcolo in un pool di Azure Batch (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).
- 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>
Si tratta del timeout per l'operazione di ridimensionamento più recente. Il ridimensionamento iniziale al momento della creazione del pool viene conteggiato come ridimensionamento. Il valore predefinito è di 15 minuti.
- resize_errors
- list[ResizeError]
Questa proprietà viene impostata solo se si sono verificati uno o più errori durante l'ultimo ridimensionamento del pool e solo quando l'allocazione del pool è Steady.
- current_low_priority_nodes
- int
Numero di nodi di calcolo con priorità spot/bassa attualmente nel pool. I nodi di calcolo con priorità spot/bassa sono inclusi in questo conteggio.
- target_low_priority_nodes
- int
Numero desiderato di nodi di calcolo con priorità spot/bassa nel pool.
- 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à viene impostata solo se il pool viene ridimensionato automaticamente, ad esempio enableAutoScale è true.
- auto_scale_evaluation_interval
- <xref:timedelta>
Questa proprietà viene impostata solo se il pool viene ridimensionato automaticamente, ad esempio enableAutoScale è true.
- auto_scale_run
- AutoScaleRun
Risultati ed errori dell'ultima esecuzione della formula di scalabilità automatica. Questa proprietà viene impostata solo se il pool viene ridimensionato automaticamente, ad esempio enableAutoScale è true.
- enable_inter_node_communication
- bool
Se il pool consente la comunicazione diretta tra nodi di calcolo. Ciò impone restrizioni per cui è possibile assegnare nodi di calcolo al pool. Se si specifica questo valore, è possibile ridurre la possibilità di allocare il numero richiesto di nodi di calcolo nel pool.
- start_task
- StartTask
Attività specificata per l'esecuzione in ogni nodo di calcolo durante l'aggiunta al pool.
- 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]
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]
- stats
- PoolStatistics
Statistiche sull'utilizzo e sull'utilizzo delle risorse per l'intera durata del pool. Questa proprietà viene popolata solo se CloudPool è stato recuperato con una clausola di espansione che include l'attributo 'stats'; in caso contrario, è Null. Le statistiche potrebbero non essere immediatamente disponibili. Il servizio Batch esegue l'roll-up periodico delle statistiche. Il ritardo tipico è di circa 30 minuti.
- mount_configuration
- list[MountConfiguration]
Supporta File di Azure, NFS, CIFS/SMB e BLOBfuse.
- identity
- BatchPoolIdentity
Identità del pool Batch, se configurata. Elenco delle identità utente associate al pool batch. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel modulo: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
- 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'
Variabili
- current_node_communication_mode
- str oppure NodeCommunicationMode
Stato corrente della modalità di comunicazione del pool. I valori possibili includono: 'default', 'classic', 'simplified'
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