Batch Account - List
Ruft Informationen zu den Batchkonten ab, die dem Abonnement zugeordnet sind.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Batch/batchAccounts?api-version=2024-07-01
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
subscription
|
path | True |
string (uuid) |
Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein. |
|
api-version
|
query | True |
string minLength: 1 |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Die Anforderung ist erfolgreich. |
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
BatchAccountList
Beispielanforderung
Beispiel für eine Antwort
{
"value": [
{
"name": "sampleacct",
"type": "Microsoft.Batch/batchAccounts",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
"identity": {
"type": "None"
},
"location": "japaneast",
"properties": {
"accountEndpoint": "sampleacct.japaneast.batch.azure.com",
"activeJobAndJobScheduleQuota": 20,
"autoStorage": {
"lastKeySync": "2016-03-10T23:48:38.9878479Z",
"storageAccountId": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Storage/storageAccounts/samplestorage"
},
"dedicatedCoreQuota": 20,
"lowPriorityCoreQuota": 20,
"poolAllocationMode": "BatchService",
"poolQuota": 20,
"provisioningState": "Succeeded",
"publicNetworkAccess": "Enabled"
}
}
]
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Authentication |
Der Authentifizierungsmodus für das Batchkonto. |
|
Auto |
Der Authentifizierungsmodus, den der Batchdienst zum Verwalten des automatischen Speicherkontos verwendet. |
|
Auto |
Enthält Informationen zum automatischen Speicherkonto, das einem Batchkonto zugeordnet ist. |
|
Batch |
Enthält Informationen zu einem Azure Batch-Konto. |
|
Batch |
Die Identität des Batchkontos, falls konfiguriert. Dies wird verwendet, wenn der Benutzer "Microsoft.KeyVault" als Verschlüsselungskonfiguration des Batchkontos angibt oder wenn |
|
Batch |
Ausgezogene Sammlung von BatchAccount-Einträgen |
|
Cloud |
Eine Fehlerantwort des Batchdiensts. |
|
Cloud |
Eine Fehlerantwort des Batchdiensts. |
|
Compute |
Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet. |
|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
|
Encryption |
Konfiguriert, wie Kundendaten innerhalb des Batchkontos verschlüsselt werden. Standardmäßig werden Konten mit einem von Microsoft verwalteten Schlüssel verschlüsselt. Für zusätzliche Steuerung kann stattdessen ein vom Kunden verwalteter Schlüssel verwendet werden. |
|
Endpoint |
Standardaktion für Endpunktzugriff. Sie gilt nur, wenn publicNetworkAccess aktiviert ist. |
|
Endpoint |
Netzwerkzugriffsprofil für Batchendpunkt. |
| IPRule |
Regel zum Filtern der Client-IP-Adresse. |
|
IPRule |
Die Aktion, wenn die Client-IP-Adresse abgestimmt wird. |
|
Key |
Typ der Schlüsselquelle. |
|
Key |
KeyVault-Konfiguration bei Verwendung einer Verschlüsselungs-KeySource von Microsoft.KeyVault. |
|
Key |
Identifiziert den Azure Key Vault, der einem Batchkonto zugeordnet ist. |
|
Network |
Netzwerkprofil für Batchkonto, das Netzwerkregeleinstellungen für jeden Endpunkt enthält. |
|
Pool |
Der Zuordnungsmodus zum Erstellen von Pools im Batchkonto. |
|
Private |
Der private Endpunkt der privaten Endpunktverbindung. |
|
Private |
Enthält Informationen zu einer privaten Verknüpfungsressource. |
|
Private |
Der Bereitstellungsstatus der privaten Endpunktverbindung. |
|
Private |
Der Verbindungsstatus des privaten Verknüpfungsdiensts der privaten Endpunktverbindung |
|
Private |
Der Status der Privaten Batch-Endpunktverbindung |
|
Provisioning |
Der bereitgestellte Status der Ressource |
|
Public |
Der Netzwerkschnittstellentyp für den Zugriff auf Azure Batch-Dienst- und Batchkontovorgänge. |
|
Resource |
Der Identitätstyp, der für das Batchkonto verwendet wird. |
|
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
|
User |
Die Liste der zugeordneten Benutzeridentitäten. |
|
Virtual |
Eine VM-Familie und das zugehörige Kernkontingent für das Batchkonto. |
AuthenticationMode
Der Authentifizierungsmodus für das Batchkonto.
| Wert | Beschreibung |
|---|---|
| SharedKey |
Der Authentifizierungsmodus mit freigegebenen Schlüsseln. |
| AAD |
Der Authentifizierungsmodus mithilfe der Microsoft Entra-ID. |
| TaskAuthenticationToken |
Der Authentifizierungsmodus mit Aufgabenauthentifizierungstoken. |
AutoStorageAuthenticationMode
Der Authentifizierungsmodus, den der Batchdienst zum Verwalten des automatischen Speicherkontos verwendet.
| Wert | Beschreibung |
|---|---|
| StorageKeys |
Der Batchdienst authentifiziert Anforderungen an den automatischen Speicher mithilfe von Speicherkontoschlüsseln. |
| BatchAccountManagedIdentity |
Der Batchdienst authentifiziert Anforderungen an den automatischen Speicher mithilfe der verwalteten Identität, die dem Batchkonto zugewiesen ist. |
AutoStorageProperties
Enthält Informationen zum automatischen Speicherkonto, das einem Batchkonto zugeordnet ist.
| Name | Typ | Standardwert | Beschreibung |
|---|---|---|---|
| authenticationMode | StorageKeys |
Der Authentifizierungsmodus, den der Batchdienst zum Verwalten des automatischen Speicherkontos verwendet. |
|
| lastKeySync |
string (date-time) |
Die UTC-Zeit, zu der Speicherschlüssel zuletzt mit dem Batchkonto synchronisiert wurden. |
|
| nodeIdentityReference |
Der Verweis auf die vom Benutzer zugewiesene Identität, die Computeknoten für den Zugriff auf den automatischen Speicher verwenden. |
||
| storageAccountId |
string (arm-id) |
Die Ressourcen-ID des Speicherkontos, das für das automatische Speicherkonto verwendet werden soll. |
BatchAccount
Enthält Informationen zu einem Azure Batch-Konto.
| Name | Typ | Standardwert | Beschreibung |
|---|---|---|---|
| id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| identity |
Die Identität des Batchkontos. |
||
| location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
|
| name |
string |
Der Name der Ressource |
|
| properties.accountEndpoint |
string |
Der Kontoendpunkt, der für die Interaktion mit dem Batchdienst verwendet wird. |
|
| properties.activeJobAndJobScheduleQuota |
integer (int32) |
Das aktive Auftrags- und Auftragsplanungskontingent für das Batchkonto. |
|
| properties.allowedAuthenticationModes |
Liste der zulässigen Authentifizierungsmodi für das Batchkonto, das zur Authentifizierung mit der Datenebene verwendet werden kann. Dies wirkt sich nicht auf die Authentifizierung mit der Steuerebene aus. |
||
| properties.autoStorage |
Die Eigenschaften und der Status eines automatischen Speicherkontos, das dem Batchkonto zugeordnet ist. |
||
| properties.dedicatedCoreQuota |
integer (int32) |
Das dedizierte Kernkontingent für das Batchkonto. |
|
| properties.dedicatedCoreQuotaPerVMFamily |
Eine Liste des dedizierten Kernkontingents pro Familie virtueller Computer für das Batchkonto. Bei Konten mit PoolAllocationMode, die auf UserSubscription festgelegt sind, wird das Kontingent für das Abonnement verwaltet, sodass dieser Wert nicht zurückgegeben wird. |
||
| properties.dedicatedCoreQuotaPerVMFamilyEnforced |
boolean |
Ein Wert, der angibt, ob Kernkontingente pro Familie virtueller Computer für dieses Konto erzwungen werden |
|
| properties.encryption |
Die Verschlüsselungskonfiguration für das Batchkonto. |
||
| properties.keyVaultReference |
Ein Verweis auf den Azure Key Vault, der dem Batchkonto zugeordnet ist. |
||
| properties.lowPriorityCoreQuota |
integer (int32) |
Das Spot/Low-Priority-Kernkontingent für das Batchkonto. |
|
| properties.networkProfile |
Netzwerkprofil für Batchkonto, das Netzwerkregeleinstellungen für jeden Endpunkt enthält. |
||
| properties.nodeManagementEndpoint |
string |
Der Endpunkt, der vom Computeknoten zum Herstellen einer Verbindung mit dem Batchknotenverwaltungsdienst verwendet wird. |
|
| properties.poolAllocationMode |
Der Zuordnungsmodus, der zum Erstellen von Pools im Batchkonto verwendet werden soll. |
||
| properties.poolQuota |
integer (int32) |
Das Poolkontingent für das Batchkonto. |
|
| properties.privateEndpointConnections |
Liste der privaten Endpunktverbindungen, die dem Batchkonto zugeordnet sind |
||
| properties.provisioningState |
Der bereitgestellte Status der Ressource |
||
| properties.publicNetworkAccess | Enabled |
Der Netzwerkschnittstellentyp für den Zugriff auf Azure Batch-Dienst- und Batchkontovorgänge. |
|
| systemData |
Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten. |
||
| tags |
object |
Ressourcentags. |
|
| type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
BatchAccountIdentity
Die Identität des Batchkontos, falls konfiguriert. Dies wird verwendet, wenn der Benutzer "Microsoft.KeyVault" als Verschlüsselungskonfiguration des Batchkontos angibt oder wenn ManagedIdentity als Authentifizierungsmodus für den automatischen Speicher ausgewählt wird.
| Name | Typ | Beschreibung |
|---|---|---|
| principalId |
string |
Die Prinzipal-ID des Batchkontos. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt. |
| tenantId |
string |
Die Mandanten-ID, die dem Batchkonto zugeordnet ist. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt. |
| type |
Der Identitätstyp, der für das Batchkonto verwendet wird. |
|
| userAssignedIdentities |
<string,
User |
Die Liste der Benutzeridentitäten, die dem Batchkonto zugeordnet sind. |
BatchAccountListResult
Ausgezogene Sammlung von BatchAccount-Einträgen
| Name | Typ | Beschreibung |
|---|---|---|
| nextLink |
string (uri) |
Der Link zur nächsten Seite von Elementen |
| value |
Die BatchAccount-Einträge auf dieser Seite |
CloudError
Eine Fehlerantwort des Batchdiensts.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Der Textkörper der Fehlerantwort. |
CloudErrorBody
Eine Fehlerantwort des Batchdiensts.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden. |
| details |
Eine Liste mit zusätzlichen Details zum Fehler. |
|
| message |
string |
Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist. |
| target |
string |
Das Ziel des bestimmten Fehlers. Beispielsweise der Name der Eigenschaft im Fehler. |
ComputeNodeIdentityReference
Der Verweis auf eine vom Benutzer zugewiesene Identität, die dem Batchpool zugeordnet ist, den ein Computeknoten verwendet.
| Name | Typ | Beschreibung |
|---|---|---|
| resourceId |
string |
Die ARM-Ressourcen-ID der vom Benutzer zugewiesenen Identität. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
| Wert | Beschreibung |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
EncryptionProperties
Konfiguriert, wie Kundendaten innerhalb des Batchkontos verschlüsselt werden. Standardmäßig werden Konten mit einem von Microsoft verwalteten Schlüssel verschlüsselt. Für zusätzliche Steuerung kann stattdessen ein vom Kunden verwalteter Schlüssel verwendet werden.
| Name | Typ | Beschreibung |
|---|---|---|
| keySource |
Typ der Schlüsselquelle. |
|
| keyVaultProperties |
Weitere Details bei Verwendung von Microsoft.KeyVault |
EndpointAccessDefaultAction
Standardaktion für Endpunktzugriff. Sie gilt nur, wenn publicNetworkAccess aktiviert ist.
| Wert | Beschreibung |
|---|---|
| Allow |
Clientzugriff zulassen. |
| Deny |
Den Clientzugriff verweigern. |
EndpointAccessProfile
Netzwerkzugriffsprofil für Batchendpunkt.
| Name | Typ | Beschreibung |
|---|---|---|
| defaultAction |
Die Standardaktion, wenn keine IPRule-Übereinstimmung vorhanden ist. |
|
| ipRules |
IPRule[] |
Array von IP-Bereichen zum Filtern der Client-IP-Adresse. |
IPRule
Regel zum Filtern der Client-IP-Adresse.
| Name | Typ | Beschreibung |
|---|---|---|
| action |
Aktion, wenn client-IP-Adresse abgeglichen wird. |
|
| value |
string |
Die zu filternde IP-Adresse oder der IP-Adressbereich |
IPRuleAction
Die Aktion, wenn die Client-IP-Adresse abgestimmt wird.
| Wert | Beschreibung |
|---|---|
| Allow |
Zugriff auf die übereinstimmene Client-IP-Adresse zulassen. |
KeySource
Typ der Schlüsselquelle.
| Wert | Beschreibung |
|---|---|
| Microsoft.Batch |
Batch erstellt und verwaltet die Verschlüsselungsschlüssel, die zum Schutz der Kontodaten verwendet werden. |
| Microsoft.KeyVault |
Die Verschlüsselungsschlüssel zum Schutz der Kontodaten werden in einem externen Schlüsseltresor gespeichert. Wenn dies festgelegt ist, muss die Identität des Batchkontos auf |
KeyVaultProperties
KeyVault-Konfiguration bei Verwendung einer Verschlüsselungs-KeySource von Microsoft.KeyVault.
| Name | Typ | Beschreibung |
|---|---|---|
| keyIdentifier |
string |
Vollständiger Pfad zum geheimen Schlüssel mit oder ohne Version. Beispiel: Das Batchkonto verfügt über eine vom System zugewiesene Identität Der Kontoidentität wurde Schlüssel/Abrufen, Schlüssel/Entwrap- und Schlüssel-/Umbruchberechtigungen gewährt. KeyVault verfügt über soft-delete- und Löschschutz aktiviert |
KeyVaultReference
Identifiziert den Azure Key Vault, der einem Batchkonto zugeordnet ist.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string (arm-id) |
Die Ressourcen-ID des Azure Key Vault, der dem Batchkonto zugeordnet ist. |
| url |
string |
Die URL des Azure-Schlüsseltresors, der dem Batchkonto zugeordnet ist. |
NetworkProfile
Netzwerkprofil für Batchkonto, das Netzwerkregeleinstellungen für jeden Endpunkt enthält.
| Name | Typ | Beschreibung |
|---|---|---|
| accountAccess |
Netzwerkzugriffsprofil für batchAccount-Endpunkt (Batchkonto-Datenebene-API). |
|
| nodeManagementAccess |
Netzwerkzugriffsprofil für nodeManagement-Endpunkt (Batchdienst, der Computeknoten für Batchpools verwaltet). |
PoolAllocationMode
Der Zuordnungsmodus zum Erstellen von Pools im Batchkonto.
| Wert | Beschreibung |
|---|---|
| BatchService |
Pools werden in Abonnements zugewiesen, die sich im Besitz des Batchdiensts befinden. |
| UserSubscription |
Pools werden in einem Abonnement zugewiesen, das dem Benutzer gehört. |
PrivateEndpoint
Der private Endpunkt der privaten Endpunktverbindung.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Der ARM-Ressourcenbezeichner des privaten Endpunkts. Dies ist das Format "/subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint}". |
PrivateEndpointConnection
Enthält Informationen zu einer privaten Verknüpfungsressource.
| Name | Typ | Beschreibung |
|---|---|---|
| etag |
string |
Das ETag der Ressource, das für Parallelitätsanweisungen verwendet wird. |
| id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Der Name der Ressource |
| properties.groupIds |
string[] |
Die Gruppen-ID der privaten Endpunktverbindung. |
| properties.privateEndpoint |
Der ARM-Ressourcenbezeichner des privaten Endpunkts. |
|
| properties.privateLinkServiceConnectionState |
Der Verbindungsstatus des privaten Verknüpfungsdiensts der privaten Endpunktverbindung. |
|
| properties.provisioningState |
Der Bereitstellungsstatus der privaten Endpunktverbindung. |
|
| systemData |
Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten. |
|
| tags |
object |
Die Tags der Ressource. |
| type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProvisioningState
Der Bereitstellungsstatus der privaten Endpunktverbindung.
| Wert | Beschreibung |
|---|---|
| Creating |
Die Verbindung wird erstellt. |
| Updating |
Der Benutzer hat angefordert, dass der Verbindungsstatus aktualisiert wird, der Aktualisierungsvorgang wurde jedoch noch nicht abgeschlossen. Sie können beim Herstellen einer Verbindung mit dem Batchkonto nicht auf die Verbindung verweisen. |
| Deleting |
Die Verbindung wird gelöscht. |
| Succeeded |
Der Verbindungsstatus ist abgeschlossen und kann verwendet werden, wenn der Status genehmigt ist. |
| Failed |
Der Benutzer hat angefordert, dass die Verbindung aktualisiert und fehlgeschlagen ist. Sie können den Aktualisierungsvorgang wiederholen. |
| Cancelled |
Der Benutzer hat die Verbindungserstellung abgebrochen. |
PrivateLinkServiceConnectionState
Der Verbindungsstatus des privaten Verknüpfungsdiensts der privaten Endpunktverbindung
| Name | Typ | Beschreibung |
|---|---|---|
| actionsRequired |
string |
Aktion erforderlich für den Status der privaten Verbindung |
| description |
string |
Beschreibung des privaten Verbindungszustands |
| status |
Der Status der Privaten Batch-Endpunktverbindung |
PrivateLinkServiceConnectionStatus
Der Status der Privaten Batch-Endpunktverbindung
| Wert | Beschreibung |
|---|---|
| Approved |
Die private Endpunktverbindung wurde genehmigt und kann für den Zugriff auf das Batchkonto verwendet werden. |
| Pending |
Die private Endpunktverbindung steht aus und kann nicht für den Zugriff auf das Batchkonto verwendet werden. |
| Rejected |
Die private Endpunktverbindung wird abgelehnt und kann nicht für den Zugriff auf das Batchkonto verwendet werden. |
| Disconnected |
Die private Endpunktverbindung ist getrennt und kann nicht für den Zugriff auf das Batchkonto verwendet werden. |
ProvisioningState
Der bereitgestellte Status der Ressource
| Wert | Beschreibung |
|---|---|
| Invalid |
Das Konto befindet sich in einem ungültigen Zustand. |
| Creating |
Das Konto wird erstellt. |
| Deleting |
Das Konto wird gelöscht. |
| Succeeded |
Das Konto wurde erstellt und kann verwendet werden. |
| Failed |
Der letzte Vorgang für das Konto ist fehlgeschlagen. |
| Cancelled |
Der letzte Vorgang für das Konto wird abgebrochen. |
PublicNetworkAccessType
Der Netzwerkschnittstellentyp für den Zugriff auf Azure Batch-Dienst- und Batchkontovorgänge.
| Wert | Beschreibung |
|---|---|
| Enabled |
Ermöglicht die Verbindung mit Azure Batch über öffentliches DNS. |
| Disabled |
Deaktiviert die öffentliche Konnektivität und ermöglicht private Konnektivität mit Azure Batch Service über private Endpunktressource. |
| SecuredByPerimeter |
Sichert die Konnektivität mit Azure Batch über die NSP-Konfiguration. |
ResourceIdentityType
Der Identitätstyp, der für das Batchkonto verwendet wird.
| Wert | Beschreibung |
|---|---|
| SystemAssigned |
Einem Batchkonto ist eine Systemidentität zugewiesen. |
| UserAssigned |
Das Batchkonto hat ihm Benutzeridentitäten zugewiesen. |
| None |
Dem Batchkonto ist keine Identität zugeordnet. Wenn Sie |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
| Name | Typ | Beschreibung |
|---|---|---|
| createdAt |
string (date-time) |
Der Zeitstempel der Ressourcenerstellung (UTC). |
| createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
| createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
| lastModifiedAt |
string (date-time) |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
| lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
| lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
UserAssignedIdentities
Die Liste der zugeordneten Benutzeridentitäten.
| Name | Typ | Beschreibung |
|---|---|---|
| clientId |
string |
Die Client-ID der vom Benutzer zugewiesenen Identität. |
| principalId |
string |
Die Prinzipal-ID der vom Benutzer zugewiesenen Identität. |
VirtualMachineFamilyCoreQuota
Eine VM-Familie und das zugehörige Kernkontingent für das Batchkonto.
| Name | Typ | Beschreibung |
|---|---|---|
| coreQuota |
integer (int32) |
Das Kernkontingent für die VM-Familie für das Batchkonto. |
| name |
string |
Der Familienname des virtuellen Computers. |