Batch Account - Update
Aggiornamenti le proprietà di un account Batch esistente.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}?api-version=2024-02-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
account
|
path | True |
string |
Nome dell'account Batch. Regex pattern: |
resource
|
path | True |
string |
Nome del gruppo di risorse che contiene l'account Batch. |
subscription
|
path | True |
string |
ID sottoscrizione di Azure. Si tratta di una stringa in formato GUID (ad esempio 000000000-0000-0000-0000-0000-000000000000) |
api-version
|
query | True |
string |
Versione dell'API da usare con la richiesta HTTP. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
identity |
Batch |
Identità dell'account Batch. |
properties.allowedAuthenticationModes |
Authentication |
Elenco delle modalità di autenticazione consentite per l'account Batch che può essere usato per l'autenticazione con il piano dati. Ciò non influisce sull'autenticazione con il piano di controllo. |
properties.autoStorage |
Auto |
Proprietà correlate all'account di archiviazione automatica. |
properties.encryption |
Encryption |
Configurazione della crittografia per l'account Batch. |
properties.networkProfile |
Network |
Profilo di rete per l'account Batch, che contiene le impostazioni delle regole di rete per ogni endpoint. |
properties.publicNetworkAccess |
Public |
Tipo di accesso alla rete per l'accesso all'account Azure Batch. |
tags |
object |
Tag specificati dall'utente associati all'account. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Batch |
L'operazione è stata completata. La risposta contiene l'entità dell'account Batch. |
Other Status Codes |
Cloud |
Risposta di errore che descrive perché l'operazione non è riuscita. |
Sicurezza
azure_auth
Microsoft Entra flusso di codice di autenticazione OAuth 2.0
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
BatchAccountUpdate
Sample Request
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct?api-version=2024-02-01
{
"properties": {
"autoStorage": {
"storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage"
}
}
}
Sample Response
{
"name": "sampleacct",
"location": "japaneast",
"properties": {
"accountEndpoint": "sampleacct.japaneast.batch.azure.com",
"provisioningState": "Succeeded",
"poolAllocationMode": "BatchService",
"dedicatedCoreQuota": 20,
"lowPriorityCoreQuota": 20,
"poolQuota": 20,
"activeJobAndJobScheduleQuota": 20,
"autoStorage": {
"storageAccountId": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage",
"lastKeySync": "2016-03-10T23:48:38.9878479Z"
},
"publicNetworkAccess": "Enabled"
},
"identity": {
"type": "None"
},
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
"type": "Microsoft.Batch/batchAccounts"
}
Definizioni
Nome | Descrizione |
---|---|
Authentication |
Modalità di autenticazione per l'account Batch. |
Auto |
Modalità di autenticazione che verrà usata dal servizio Batch per gestire l'account di archiviazione automatica. |
Auto |
Proprietà correlate all'account di archiviazione automatica. |
Auto |
Contiene informazioni sull'account di archiviazione automatico associato a un account Batch. |
Batch |
Contiene informazioni su un account Azure Batch. |
Batch |
Identità dell'account Batch, se configurata. Viene usato quando l'utente specifica "Microsoft.KeyVault" come configurazione di crittografia dell'account Batch o quando |
Batch |
Parametri per l'aggiornamento di un account Azure Batch. |
Cloud |
Risposta di errore dal servizio Batch. |
Cloud |
Risposta di errore dal servizio Batch. |
Compute |
Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo. |
Encryption |
Configura la modalità di crittografia dei dati dei clienti all'interno dell'account Batch. Per impostazione predefinita, gli account vengono crittografati usando una chiave gestita da Microsoft. Per un controllo aggiuntivo, è possibile usare invece una chiave gestita dal cliente. |
Endpoint |
Azione predefinita quando non è presente alcuna corrispondenza IPRule. |
Endpoint |
Profilo di accesso di rete per l'endpoint Batch. |
IPRule |
Regola per filtrare l'indirizzo IP client. |
IPRule |
Azione quando viene corrispondente l'indirizzo IP client. |
Key |
Tipo dell'origine della chiave. |
Key |
Configurazione dell'insieme di credenziali delle chiavi quando si usa un keysource di crittografia di Microsoft.KeyVault. |
Key |
Identifica l'insieme di credenziali delle chiavi di Azure associato a un account Batch. |
Network |
Profilo di rete per l'account Batch, che contiene le impostazioni delle regole di rete per ogni endpoint. |
Pool |
Modalità di allocazione per la creazione di pool nell'account Batch. |
Private |
Endpoint privato della connessione dell'endpoint privato. |
Private |
Contiene informazioni su una risorsa di collegamento privato. |
Private |
Stato di provisioning della connessione dell'endpoint privato. |
Private |
Stato di connessione del servizio collegamento privato della connessione dell'endpoint privato |
Private |
Stato della connessione dell'endpoint privato Batch |
Provisioning |
Stato di provisioning della risorsa |
Public |
Tipo di accesso di rete per l'uso delle risorse nell'account Batch. |
Resource |
Tipo di identità usato per l'account Batch. |
User |
Elenco delle identità utente associate. |
Virtual |
Famiglia di macchine virtuali e quota di base associata per l'account Batch. |
AuthenticationMode
Modalità di autenticazione per l'account Batch.
Nome | Tipo | Descrizione |
---|---|---|
AAD |
string |
Modalità di autenticazione tramite Microsoft Entra ID. |
SharedKey |
string |
Modalità di autenticazione tramite chiavi condivise. |
TaskAuthenticationToken |
string |
Modalità di autenticazione che usa i token di autenticazione delle attività. |
AutoStorageAuthenticationMode
Modalità di autenticazione che verrà usata dal servizio Batch per gestire l'account di archiviazione automatica.
Nome | Tipo | Descrizione |
---|---|---|
BatchAccountManagedIdentity |
string |
Il servizio Batch autentica le richieste di archiviazione automatica usando l'identità gestita assegnata all'account Batch. |
StorageKeys |
string |
Il servizio Batch autentica le richieste all'archiviazione automatica usando le chiavi dell'account di archiviazione. |
AutoStorageBaseProperties
Proprietà correlate all'account di archiviazione automatica.
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
authenticationMode |
Auto |
StorageKeys |
Modalità di autenticazione che verrà usata dal servizio Batch per gestire l'account di archiviazione automatica. |
nodeIdentityReference |
Compute |
Riferimento all'identità assegnata dall'utente che i nodi di calcolo useranno per accedere all'archiviazione automatica. |
|
storageAccountId |
string |
ID risorsa dell'account di archiviazione da usare per l'account di archiviazione automatico. |
AutoStorageProperties
Contiene informazioni sull'account di archiviazione automatico associato a un account Batch.
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
authenticationMode |
Auto |
StorageKeys |
Modalità di autenticazione che il servizio Batch userà per gestire l'account di archiviazione automatica. |
lastKeySync |
string |
Ora UTC in cui le chiavi di archiviazione sono state sincronizzate con l'account Batch. |
|
nodeIdentityReference |
Compute |
Riferimento all'identità assegnata dall'utente che i nodi di calcolo useranno per accedere all'archiviazione automatica. |
|
storageAccountId |
string |
ID risorsa dell'account di archiviazione da usare per l'account di archiviazione automatica. |
BatchAccount
Contiene informazioni su un account Azure Batch.
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
id |
string |
ID della risorsa. |
|
identity |
Batch |
Identità dell'account Batch. |
|
location |
string |
Il percorso della risorsa. |
|
name |
string |
Nome della risorsa. |
|
properties.accountEndpoint |
string |
Endpoint dell'account usato per interagire con il servizio Batch. |
|
properties.activeJobAndJobScheduleQuota |
integer |
Quota di pianificazione del processo e del processo attiva per l'account Batch. |
|
properties.allowedAuthenticationModes |
Authentication |
Elenco delle modalità di autenticazione consentite per l'account Batch che può essere usato per l'autenticazione con il piano dati. Ciò non influisce sull'autenticazione con il piano di controllo. |
|
properties.autoStorage |
Auto |
Proprietà e stato di qualsiasi account di archiviazione automatica associato all'account Batch. |
|
properties.dedicatedCoreQuota |
integer |
Quota core dedicata per l'account Batch. |
|
properties.dedicatedCoreQuotaPerVMFamily |
Virtual |
Elenco della quota di core dedicata per ogni famiglia di macchine virtuali per l'account Batch. Per gli account con PoolAllocationMode impostato su UserSubscription, la quota viene gestita nella sottoscrizione in modo che questo valore non venga restituito. |
|
properties.dedicatedCoreQuotaPerVMFamilyEnforced |
boolean |
Valore che indica se le quote di core per ogni famiglia di macchine virtuali vengono applicate per questo account |
|
properties.encryption |
Encryption |
Configurazione della crittografia per l'account Batch. |
|
properties.keyVaultReference |
Key |
Riferimento all'insieme di credenziali delle chiavi di Azure associato all'account Batch. |
|
properties.lowPriorityCoreQuota |
integer |
Quota di core spot/bassa priorità per l'account Batch. |
|
properties.networkProfile |
Network |
Profilo di rete per l'account Batch, che contiene le impostazioni delle regole di rete per ogni endpoint. |
|
properties.nodeManagementEndpoint |
string |
Endpoint usato dal nodo di calcolo per connettersi al servizio di gestione dei nodi Batch. |
|
properties.poolAllocationMode |
Pool |
Modalità di allocazione da usare per la creazione di pool nell'account Batch. |
|
properties.poolQuota |
integer |
Quota del pool per l'account Batch. |
|
properties.privateEndpointConnections |
Private |
Elenco di connessioni di endpoint privato associate all'account Batch |
|
properties.provisioningState |
Provisioning |
Stato di provisioning della risorsa |
|
properties.publicNetworkAccess |
Public |
Enabled |
Tipo di interfaccia di rete per l'accesso alle operazioni del servizio e dell'account Batch Azure Batch. |
tags |
object |
Tag della risorsa. |
|
type |
string |
Tipo di risorsa. |
BatchAccountIdentity
Identità dell'account Batch, se configurata. Viene usato quando l'utente specifica "Microsoft.KeyVault" come configurazione di crittografia dell'account Batch o quando ManagedIdentity
viene selezionato come modalità di autenticazione dell'archiviazione automatica.
Nome | Tipo | Descrizione |
---|---|---|
principalId |
string |
ID principale dell'account Batch. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema. |
tenantId |
string |
ID tenant associato all'account Batch. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema. |
type |
Resource |
Tipo di identità usato per l'account Batch. |
userAssignedIdentities |
object |
Elenco di identità utente associate all'account Batch. |
BatchAccountUpdateParameters
Parametri per l'aggiornamento di un account Azure Batch.
Nome | Tipo | Valore predefinito | Descrizione |
---|---|---|---|
identity |
Batch |
Identità dell'account Batch. |
|
properties.allowedAuthenticationModes |
Authentication |
Elenco delle modalità di autenticazione consentite per l'account Batch che può essere usato per l'autenticazione con il piano dati. Ciò non influisce sull'autenticazione con il piano di controllo. |
|
properties.autoStorage |
Auto |
Proprietà correlate all'account di archiviazione automatica. |
|
properties.encryption |
Encryption |
Configurazione della crittografia per l'account Batch. |
|
properties.networkProfile |
Network |
Profilo di rete per l'account Batch, che contiene le impostazioni delle regole di rete per ogni endpoint. |
|
properties.publicNetworkAccess |
Public |
Enabled |
Tipo di accesso alla rete per l'accesso Azure Batch account. |
tags |
object |
Tag specificati dall'utente associati all'account. |
CloudError
Risposta di errore dal servizio Batch.
Nome | Tipo | Descrizione |
---|---|---|
error |
Cloud |
Corpo della risposta di errore. |
CloudErrorBody
Risposta di errore dal servizio Batch.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Identificatore dell'errore. I codici sono invarianti e devono essere usati a livello di codice. |
details |
Cloud |
Elenco di dettagli aggiuntivi sull'errore. |
message |
string |
Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente. |
target |
string |
Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in caso di errore. |
ComputeNodeIdentityReference
Riferimento a un'identità assegnata dall'utente associata al pool di Batch che verrà usato da un nodo di calcolo.
Nome | Tipo | Descrizione |
---|---|---|
resourceId |
string |
ID risorsa ARM dell'identità assegnata dall'utente. |
EncryptionProperties
Configura la modalità di crittografia dei dati dei clienti all'interno dell'account Batch. Per impostazione predefinita, gli account vengono crittografati usando una chiave gestita da Microsoft. Per un controllo aggiuntivo, è possibile usare invece una chiave gestita dal cliente.
Nome | Tipo | Descrizione |
---|---|---|
keySource |
Key |
Tipo dell'origine della chiave. |
keyVaultProperties |
Key |
Dettagli aggiuntivi quando si usa Microsoft.KeyVault |
EndpointAccessDefaultAction
Azione predefinita quando non è presente alcuna corrispondenza IPRule.
Nome | Tipo | Descrizione |
---|---|---|
Allow |
string |
Consenti l'accesso client. |
Deny |
string |
Negare l'accesso client. |
EndpointAccessProfile
Profilo di accesso di rete per l'endpoint Batch.
Nome | Tipo | Descrizione |
---|---|---|
defaultAction |
Endpoint |
Azione predefinita quando non è presente alcuna corrispondenza IPRule. |
ipRules |
IPRule[] |
Matrice di intervalli IP per filtrare l'indirizzo IP client. |
IPRule
Regola per filtrare l'indirizzo IP client.
Nome | Tipo | Descrizione |
---|---|---|
action |
IPRule |
Azione quando viene corrispondente l'indirizzo IP client. |
value |
string |
Indirizzo IP o intervallo di indirizzi IP da filtrare |
IPRuleAction
Azione quando viene corrispondente l'indirizzo IP client.
Nome | Tipo | Descrizione |
---|---|---|
Allow |
string |
Consenti l'accesso per l'indirizzo IP client corrispondente. |
KeySource
Tipo dell'origine della chiave.
Nome | Tipo | Descrizione |
---|---|---|
Microsoft.Batch |
string |
Batch crea e gestisce le chiavi di crittografia usate per proteggere i dati dell'account. |
Microsoft.KeyVault |
string |
Le chiavi di crittografia usate per proteggere i dati dell'account vengono archiviate in un insieme di credenziali delle chiavi esterno. Se questa impostazione è impostata, l'identità dell'account Batch deve essere impostata su |
KeyVaultProperties
Configurazione dell'insieme di credenziali delle chiavi quando si usa un keysource di crittografia di Microsoft.KeyVault.
Nome | Tipo | Descrizione |
---|---|---|
keyIdentifier |
string |
Percorso completo del segreto con o senza versione. Ad esempio, https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. o https://mykeyvault.vault.azure.net/keys/testkey. Per essere utilizzabile, è necessario soddisfare i prerequisiti seguenti: L'account Batch ha un'identità assegnata dal sistema L'identità dell'account è stata concessa a Key/Get, Key/Unwrap e Key/Wrapping autorizzazioni The KeyVault ha la protezione di eliminazione temporanea e eliminazione abilitata |
KeyVaultReference
Identifica l'insieme di credenziali delle chiavi di Azure associato a un account Batch.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa dell'istanza di Azure Key Vault associata all'account Batch. |
url |
string |
URL dell'istanza di Azure Key Vault associata all'account Batch. |
NetworkProfile
Profilo di rete per l'account Batch, che contiene le impostazioni delle regole di rete per ogni endpoint.
Nome | Tipo | Descrizione |
---|---|---|
accountAccess |
Endpoint |
Profilo di accesso alla rete per l'endpoint batchAccount (API del piano dati dell'account Batch). |
nodeManagementAccess |
Endpoint |
Profilo di accesso alla rete per l'endpoint nodeManagement (servizio Batch che gestisce i nodi di calcolo per i pool di Batch). |
PoolAllocationMode
Modalità di allocazione per la creazione di pool nell'account Batch.
Nome | Tipo | Descrizione |
---|---|---|
BatchService |
string |
I pool verranno allocati nelle sottoscrizioni di proprietà del servizio Batch. |
UserSubscription |
string |
I pool verranno allocati in una sottoscrizione di proprietà dell'utente. |
PrivateEndpoint
Endpoint privato della connessione dell'endpoint privato.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
Identificatore di risorsa ARM dell'endpoint privato. Si tratta del modulo /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint}. |
PrivateEndpointConnection
Contiene informazioni su una risorsa di collegamento privato.
Nome | Tipo | Descrizione |
---|---|---|
etag |
string |
ETag della risorsa usata per le istruzioni di concorrenza. |
id |
string |
ID della risorsa. |
name |
string |
Nome della risorsa. |
properties.groupIds |
string[] |
ID gruppo della connessione dell'endpoint privato. |
properties.privateEndpoint |
Private |
Identificatore di risorsa ARM dell'endpoint privato. |
properties.privateLinkServiceConnectionState |
Private |
Stato di connessione del servizio collegamento privato della connessione dell'endpoint privato. |
properties.provisioningState |
Private |
Stato di provisioning della connessione dell'endpoint privato. |
type |
string |
Tipo di risorsa. |
PrivateEndpointConnectionProvisioningState
Stato di provisioning della connessione dell'endpoint privato.
Nome | Tipo | Descrizione |
---|---|---|
Cancelled |
string |
L'utente ha annullato la creazione della connessione. |
Creating |
string |
La connessione sta creando. |
Deleting |
string |
La connessione viene eliminata. |
Failed |
string |
L'utente ha richiesto che la connessione venga aggiornata e non è riuscita. È possibile ripetere l'operazione di aggiornamento. |
Succeeded |
string |
Lo stato della connessione è finale ed è pronto per l'uso se Lo stato è approvato. |
Updating |
string |
L'utente ha richiesto che lo stato della connessione venga aggiornato, ma l'operazione di aggiornamento non è ancora stata completata. Non è possibile fare riferimento alla connessione quando si connette l'account Batch. |
PrivateLinkServiceConnectionState
Stato di connessione del servizio collegamento privato della connessione dell'endpoint privato
Nome | Tipo | Descrizione |
---|---|---|
actionsRequired |
string |
Azione necessaria per lo stato di connessione privata |
description |
string |
Descrizione dello stato della connessione privata |
status |
Private |
Stato della connessione dell'endpoint privato dell'account Batch |
PrivateLinkServiceConnectionStatus
Stato della connessione dell'endpoint privato Batch
Nome | Tipo | Descrizione |
---|---|---|
Approved |
string |
La connessione dell'endpoint privato è approvata e può essere usata per accedere all'account Batch |
Disconnected |
string |
La connessione dell'endpoint privato viene disconnessa e non può essere usata per accedere all'account Batch |
Pending |
string |
La connessione dell'endpoint privato è in sospeso e non può essere usata per accedere all'account Batch |
Rejected |
string |
La connessione dell'endpoint privato viene rifiutata e non può essere usata per accedere all'account Batch |
ProvisioningState
Stato di provisioning della risorsa
Nome | Tipo | Descrizione |
---|---|---|
Cancelled |
string |
L'ultima operazione per l'account viene annullata. |
Creating |
string |
L'account viene creato. |
Deleting |
string |
L'account viene eliminato. |
Failed |
string |
L'ultima operazione per l'account non è riuscita. |
Invalid |
string |
L'account si trova in uno stato non valido. |
Succeeded |
string |
L'account è stato creato e è pronto per l'uso. |
PublicNetworkAccessType
Tipo di accesso di rete per l'uso delle risorse nell'account Batch.
Nome | Tipo | Descrizione |
---|---|---|
Disabled |
string |
Disabilita la connettività pubblica e consente la connettività privata per Azure Batch servizio tramite la risorsa dell'endpoint privato. |
Enabled |
string |
Consente la connettività per Azure Batch tramite DNS pubblico. |
ResourceIdentityType
Tipo di identità usato per l'account Batch.
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
All'account Batch non è associata alcuna identità. L'impostazione |
SystemAssigned |
string |
L'account Batch ha un'identità assegnata dal sistema. |
UserAssigned |
string |
L'account Batch ha identità assegnate dall'utente. |
UserAssignedIdentities
Elenco delle identità utente associate.
Nome | Tipo | Descrizione |
---|---|---|
clientId |
string |
ID client dell'identità assegnata dall'utente. |
principalId |
string |
ID principale dell'identità assegnata dall'utente. |
VirtualMachineFamilyCoreQuota
Famiglia di macchine virtuali e quota di base associata per l'account Batch.
Nome | Tipo | Descrizione |
---|---|---|
coreQuota |
integer |
Quota di base per la famiglia di macchine virtuali per l'account Batch. |
name |
string |
Nome della famiglia di macchine virtuali. |