Batch Account - Get
Ruft Informationen zum angegebenen Batch-Konto ab.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}?api-version=2024-02-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
account
|
path | True |
string |
Der Name des Batch-Kontos. Regex pattern: |
resource
|
path | True |
string |
Der Name der Ressourcengruppe, die das Batch-Konto enthält. |
subscription
|
path | True |
string |
Die Azure-Abonnement-ID. Dies ist eine GUID-formatierte Zeichenfolge (z. B. 000000000-0000-0000-000000000000000000000) |
api-version
|
query | True |
string |
Die API-Version, die mit der HTTP-Anforderung verwendet werden soll. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Batch |
Der Vorgang wurde durchgeführt. Die Antwort enthält die Batch-Kontoentität. |
Other Status Codes |
Cloud |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Microsoft Entra OAuth 2.0-Authentifizierungscodeflow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
Batch |
Private |
BatchAccountGet
Sample Request
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"
}
PrivateBatchAccountGet
Sample Request
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": "Disabled",
"privateEndpointConnections": [
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/privateEndpointConnections/testprivateEndpointConnection.24d6b4b5-e65c-4330-bbe9-3a290d62f8e0",
"name": "testprivateEndpointConnection.24d6b4b5-e65c-4330-bbe9-3a290d62f8e0",
"type": "Microsoft.Batch/batchAccounts/privateEndpointConnections",
"properties": {
"privateEndpoint": {
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Network/privateEndpoints/testprivateEndpoint"
},
"privateLinkServiceConnectionState": {
"status": "Approved",
"description": "Approved by xyz.abc@company.com"
}
}
}
]
},
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
"type": "Microsoft.Batch/batchAccounts"
}
Definitionen
Name | Beschreibung |
---|---|
Authentication |
Der Authentifizierungsmodus für das Batch-Konto. |
Auto |
Der Authentifizierungsmodus, den der Batch-Dienst zum Verwalten des Kontos für den automatischen Speicher verwendet. |
Auto |
Enthält Informationen zum Autospeicherkonto, das einem Batch-Konto zugeordnet ist. |
Batch |
Enthält Informationen zu einem Azure Batch-Konto. |
Batch |
Die Identität des Batch-Kontos, sofern konfiguriert. Dies wird verwendet, wenn der Benutzer "Microsoft.KeyVault" als Verschlüsselungskonfiguration für das Batch-Konto angibt oder wenn |
Cloud |
Eine Fehlerantwort des Batch-Diensts. |
Cloud |
Eine Fehlerantwort des Batch-Diensts. |
Compute |
Der Verweis auf eine benutzerseitig zugewiesene Identität, die dem Batch-Pool zugeordnet ist, den ein Computeknoten verwendet. |
Encryption |
Konfiguriert, wie Kundendaten innerhalb des Batch-Kontos verschlüsselt werden. Standardmäßig werden Konten mit einem von Microsoft verwalteten Schlüssel verschlüsselt. Für zusätzliche Steuerung kann stattdessen ein kundenseitig verwalteter Schlüssel verwendet werden. |
Endpoint |
Die Standardaktion, wenn keine IPRule übereinstimmt. |
Endpoint |
Netzwerkzugriffsprofil für Batch-Endpunkt. |
IPRule |
Regel zum Filtern der Client-IP-Adresse. |
IPRule |
Aktion, wenn die Client-IP-Adresse abgeglichen wird. |
Key |
Typ der Schlüsselquelle. |
Key |
KeyVault-Konfiguration bei Verwendung einer Verschlüsselungs-KeySource von Microsoft.KeyVault. |
Key |
Identifiziert den Azure-Schlüsseltresor, der einem Batch-Konto zugeordnet ist. |
Network |
Netzwerkprofil für das Batch-Konto, das Netzwerkregeleinstellungen für jeden Endpunkt enthält. |
Pool |
Der Zuordnungsmodus zum Erstellen von Pools im Batch-Konto. |
Private |
Der private Endpunkt der Verbindung mit dem privaten Endpunkt. |
Private |
Enthält Informationen zu einer Private Link-Ressource. |
Private |
Der Bereitstellungsstatus der Privaten Endpunktverbindung. |
Private |
Der Verbindungsstatus des Private Link-Diensts der Verbindung mit dem privaten Endpunkt |
Private |
Die status der Privaten Batch-Endpunktverbindung |
Provisioning |
Der bereitgestellte Zustand der Ressource |
Public |
Der Netzwerkzugriffstyp für den Betrieb mit den Ressourcen im Batch-Konto. |
Resource |
Der Identitätstyp, der für das Batch-Konto verwendet wird. |
User |
Die Liste der zugeordneten Benutzeridentitäten. |
Virtual |
Eine VM-Familie und das zugehörige Kernkontingent für das Batch-Konto. |
AuthenticationMode
Der Authentifizierungsmodus für das Batch-Konto.
Name | Typ | Beschreibung |
---|---|---|
AAD |
string |
Der Authentifizierungsmodus mit Microsoft Entra ID. |
SharedKey |
string |
Der Authentifizierungsmodus mit freigegebenen Schlüsseln. |
TaskAuthenticationToken |
string |
Der Authentifizierungsmodus mit Aufgabenauthentifizierungstoken. |
AutoStorageAuthenticationMode
Der Authentifizierungsmodus, den der Batch-Dienst zum Verwalten des Kontos für den automatischen Speicher verwendet.
Name | Typ | Beschreibung |
---|---|---|
BatchAccountManagedIdentity |
string |
Der Batch-Dienst authentifiziert Anforderungen an die automatische Speicherung mithilfe der verwalteten Identität, die dem Batch-Konto zugewiesen ist. |
StorageKeys |
string |
Der Batch-Dienst authentifiziert Anforderungen an die automatische Speicherung mithilfe von Speicherkontoschlüsseln. |
AutoStorageProperties
Enthält Informationen zum Autospeicherkonto, das einem Batch-Konto zugeordnet ist.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
authenticationMode |
Auto |
StorageKeys |
Der Authentifizierungsmodus, den der Batch-Dienst zum Verwalten des Kontos für die automatische Speicherung verwendet. |
lastKeySync |
string |
Die UTC-Zeit, zu der Speicherschlüssel zuletzt mit dem Batch-Konto synchronisiert wurden. |
|
nodeIdentityReference |
Compute |
Der Verweis auf die vom Benutzer zugewiesene Identität, die Computeknoten für den Zugriff auf den automatischen Speicher verwenden. |
|
storageAccountId |
string |
Die Ressourcen-ID des Speicherkontos, das für das Konto für die automatische Speicherung verwendet werden soll. |
BatchAccount
Enthält Informationen zu einem Azure Batch-Konto.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
id |
string |
Die ID der Ressource. |
|
identity |
Batch |
Die Identität des Batch-Kontos. |
|
location |
string |
Der Speicherort der Ressource. |
|
name |
string |
Der Name der Ressource. |
|
properties.accountEndpoint |
string |
Der Kontoendpunkt, der für die Interaktion mit dem Batch-Dienst verwendet wird. |
|
properties.activeJobAndJobScheduleQuota |
integer |
Das aktive Auftrags- und Auftragszeitplankontingent für das Batch-Konto. |
|
properties.allowedAuthenticationModes |
Authentication |
Liste der zulässigen Authentifizierungsmodi für das Batch-Konto, das für die Authentifizierung bei der Datenebene verwendet werden kann. Dies wirkt sich nicht auf die Authentifizierung mit der Steuerungsebene aus. |
|
properties.autoStorage |
Auto |
Die Eigenschaften und status jedes Autospeicherkontos, das dem Batch-Konto zugeordnet ist. |
|
properties.dedicatedCoreQuota |
integer |
Das dedizierte Kernkontingent für das Batch-Konto. |
|
properties.dedicatedCoreQuotaPerVMFamily |
Virtual |
Eine Liste des dedizierten Kernkontingents pro VM-Familie für das Batch-Konto. Für Konten, für die PoolAllocationMode auf UserSubscription festgelegt ist, 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 VM-Familie für dieses Konto erzwungen werden. |
|
properties.encryption |
Encryption |
Die Verschlüsselungskonfiguration für das Batch-Konto. |
|
properties.keyVaultReference |
Key |
Ein Verweis auf den Azure-Schlüsseltresor, der dem Batch-Konto zugeordnet ist. |
|
properties.lowPriorityCoreQuota |
integer |
Das Spot-/Kernkontingent mit niedriger Priorität für das Batch-Konto. |
|
properties.networkProfile |
Network |
Netzwerkprofil für das Batch-Konto, das Netzwerkregeleinstellungen für jeden Endpunkt enthält. |
|
properties.nodeManagementEndpoint |
string |
Der Endpunkt, der vom Computeknoten zum Herstellen einer Verbindung mit dem Batch-Knotenverwaltungsdienst verwendet wird. |
|
properties.poolAllocationMode |
Pool |
Der Zuordnungsmodus, der beim Erstellen von Pools im Batch-Konto verwendet werden soll. |
|
properties.poolQuota |
integer |
Das Poolkontingent für das Batch-Konto. |
|
properties.privateEndpointConnections |
Private |
Liste der privaten Endpunktverbindungen, die dem Batch-Konto zugeordnet sind |
|
properties.provisioningState |
Provisioning |
Der bereitgestellte Zustand der Ressource |
|
properties.publicNetworkAccess |
Public |
Enabled |
Der Netzwerkschnittstellentyp für den Zugriff auf Azure Batch-Dienst- und Batch-Kontovorgänge. |
tags |
object |
Die Tags der Ressource. |
|
type |
string |
Der Typ der Ressource. |
BatchAccountIdentity
Die Identität des Batch-Kontos, sofern konfiguriert. Dies wird verwendet, wenn der Benutzer "Microsoft.KeyVault" als Verschlüsselungskonfiguration für das Batch-Konto angibt oder wenn ManagedIdentity
als Authentifizierungsmodus für die automatische Speicherung ausgewählt ist.
Name | Typ | Beschreibung |
---|---|---|
principalId |
string |
Die Prinzipal-ID des Batch-Kontos. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt. |
tenantId |
string |
Die Mandanten-ID, die dem Batch-Konto zugeordnet ist. Diese Eigenschaft wird nur für eine systemseitig zugewiesene Identität bereitgestellt. |
type |
Resource |
Der Identitätstyp, der für das Batch-Konto verwendet wird. |
userAssignedIdentities |
object |
Die Liste der Benutzeridentitäten, die dem Batch-Konto zugeordnet sind. |
CloudError
Eine Fehlerantwort des Batch-Diensts.
Name | Typ | Beschreibung |
---|---|---|
error |
Cloud |
Der Text der Fehlerantwort. |
CloudErrorBody
Eine Fehlerantwort des Batch-Diensts.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollten programmgesteuert verwendet werden. |
details |
Cloud |
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 sein soll. |
target |
string |
Das Ziel des jeweiligen Fehlers. Beispiel: Der Name der -Eigenschaft im Fehler. |
ComputeNodeIdentityReference
Der Verweis auf eine benutzerseitig zugewiesene Identität, die dem Batch-Pool zugeordnet ist, den ein Computeknoten verwendet.
Name | Typ | Beschreibung |
---|---|---|
resourceId |
string |
Die ARM-Ressourcen-ID der benutzerseitig zugewiesenen Identität. |
EncryptionProperties
Konfiguriert, wie Kundendaten innerhalb des Batch-Kontos verschlüsselt werden. Standardmäßig werden Konten mit einem von Microsoft verwalteten Schlüssel verschlüsselt. Für zusätzliche Steuerung kann stattdessen ein kundenseitig verwalteter Schlüssel verwendet werden.
Name | Typ | Beschreibung |
---|---|---|
keySource |
Key |
Typ der Schlüsselquelle. |
keyVaultProperties |
Key |
Zusätzliche Details bei Verwendung von Microsoft.KeyVault |
EndpointAccessDefaultAction
Die Standardaktion, wenn keine IPRule übereinstimmt.
Name | Typ | Beschreibung |
---|---|---|
Allow |
string |
Clientzugriff zulassen. |
Deny |
string |
Verweigern des Clientzugriffs. |
EndpointAccessProfile
Netzwerkzugriffsprofil für Batch-Endpunkt.
Name | Typ | Beschreibung |
---|---|---|
defaultAction |
Endpoint |
Die Standardaktion, wenn keine IPRule übereinstimmt. |
ipRules |
IPRule[] |
Array von IP-Bereichen zum Filtern der Client-IP-Adresse. |
IPRule
Regel zum Filtern der Client-IP-Adresse.
Name | Typ | Beschreibung |
---|---|---|
action |
IPRule |
Aktion, wenn die Client-IP-Adresse abgeglichen wird. |
value |
string |
Die zu filternde IP-Adresse oder der IP-Adressbereich |
IPRuleAction
Aktion, wenn die Client-IP-Adresse abgeglichen wird.
Name | Typ | Beschreibung |
---|---|---|
Allow |
string |
Lassen Sie den Zugriff für die übereinstimmene Client-IP-Adresse zu. |
KeySource
Typ der Schlüsselquelle.
Name | Typ | Beschreibung |
---|---|---|
Microsoft.Batch |
string |
Batch erstellt und verwaltet die Verschlüsselungsschlüssel, die zum Schutz der Kontodaten verwendet werden. |
Microsoft.KeyVault |
string |
Die Zum Schutz der Kontodaten verwendeten Verschlüsselungsschlüssel werden in einem externen Schlüsseltresor gespeichert. Wenn dies festgelegt ist, muss die Identität des Batch-Kontos auf |
KeyVaultProperties
KeyVault-Konfiguration bei Verwendung einer Verschlüsselungs-KeySource von Microsoft.KeyVault.
Name | Typ | Beschreibung |
---|---|---|
keyIdentifier |
string |
Vollständiger Pfad zum Geheimnis mit oder ohne Version. Beispiel: https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. oder https://mykeyvault.vault.azure.net/keys/testkey. Um verwendbar zu sein, müssen die folgenden Voraussetzungen erfüllt sein: Das Batch-Konto verfügt über eine systemseitig zugewiesene Identität Die Kontoidentität wurde den Berechtigungen Schlüssel/Abrufen, Schlüssel/Auspacken und Schlüssel/Umschließen gewährt. Der KeyVault hat vorläufiges Löschen und Löschen des Schutzes aktiviert. |
KeyVaultReference
Identifiziert den Azure-Schlüsseltresor, der einem Batch-Konto zugeordnet ist.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Die Ressourcen-ID des Azure-Schlüsseltresors, der dem Batch-Konto zugeordnet ist. |
url |
string |
Die URL des Azure-Schlüsseltresors, der dem Batch-Konto zugeordnet ist. |
NetworkProfile
Netzwerkprofil für das Batch-Konto, das Netzwerkregeleinstellungen für jeden Endpunkt enthält.
Name | Typ | Beschreibung |
---|---|---|
accountAccess |
Endpoint |
Netzwerkzugriffsprofil für batchAccount-Endpunkt (Datenebenen-API für Batch-Konten). |
nodeManagementAccess |
Endpoint |
Netzwerkzugriffsprofil für nodeManagement-Endpunkt (Batch-Dienst zur Verwaltung von Computeknoten für Batch-Pools). |
PoolAllocationMode
Der Zuordnungsmodus zum Erstellen von Pools im Batch-Konto.
Name | Typ | Beschreibung |
---|---|---|
BatchService |
string |
Pools werden in Abonnements zugeordnet, die dem Batch-Dienst gehören. |
UserSubscription |
string |
Pools werden in einem Abonnement zugeordnet, das dem Benutzer gehört. |
PrivateEndpoint
Der private Endpunkt der Verbindung mit dem privaten Endpunkt.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Der ARM-Ressourcenbezeichner des privaten Endpunkts. Dies hat das Format /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint}. |
PrivateEndpointConnection
Enthält Informationen zu einer Private Link-Ressource.
Name | Typ | Beschreibung |
---|---|---|
etag |
string |
Das ETag der Ressource, die für Parallelitätsanweisungen verwendet wird. |
id |
string |
Die ID der Ressource. |
name |
string |
Der Name der Ressource. |
properties.groupIds |
string[] |
Die Gruppen-ID der Verbindung mit dem privaten Endpunkt. |
properties.privateEndpoint |
Private |
Der ARM-Ressourcenbezeichner des privaten Endpunkts. |
properties.privateLinkServiceConnectionState |
Private |
Der Private Link-Dienstverbindungsstatus der Verbindung mit dem privaten Endpunkt. |
properties.provisioningState |
Private |
Der Bereitstellungsstatus der Verbindung mit dem privaten Endpunkt. |
type |
string |
Der Typ der Ressource. |
PrivateEndpointConnectionProvisioningState
Der Bereitstellungsstatus der Privaten Endpunktverbindung.
Name | Typ | Beschreibung |
---|---|---|
Cancelled |
string |
Der Benutzer hat die Verbindungserstellung abgebrochen. |
Creating |
string |
Die Verbindung wird erstellt. |
Deleting |
string |
Die Verbindung wird gelöscht. |
Failed |
string |
Der Benutzer hat die Aktualisierung der Verbindung angefordert, und es ist ein Fehler aufgetreten. Sie können den Aktualisierungsvorgang wiederholen. |
Succeeded |
string |
Die Verbindung status ist endgültig und kann verwendet werden, wenn Der Status Genehmigt ist. |
Updating |
string |
Der Benutzer hat angefordert, dass die Verbindung aktualisiert status, aber der Aktualisierungsvorgang ist noch nicht abgeschlossen. Sie dürfen beim Herstellen einer Verbindung mit dem Batch-Konto nicht auf die Verbindung verweisen. |
PrivateLinkServiceConnectionState
Der Verbindungsstatus des Private Link-Diensts der Verbindung mit dem privaten Endpunkt
Name | Typ | Beschreibung |
---|---|---|
actionsRequired |
string |
Aktion erforderlich für den privaten Verbindungszustand |
description |
string |
Beschreibung des privaten Verbindungszustands |
status |
Private |
Die status für die Verbindung des privaten Endpunkts des Batch-Kontos |
PrivateLinkServiceConnectionStatus
Die status der Privaten Batch-Endpunktverbindung
Name | Typ | Beschreibung |
---|---|---|
Approved |
string |
Die Verbindung des privaten Endpunkts ist genehmigt und kann für den Zugriff auf das Batch-Konto verwendet werden. |
Disconnected |
string |
Die Verbindung mit dem privaten Endpunkt ist getrennt und kann nicht für den Zugriff auf das Batch-Konto verwendet werden. |
Pending |
string |
Die Verbindung des privaten Endpunkts steht aus und kann nicht für den Zugriff auf das Batch-Konto verwendet werden. |
Rejected |
string |
Die Verbindung mit dem privaten Endpunkt wird abgelehnt und kann nicht für den Zugriff auf das Batch-Konto verwendet werden. |
ProvisioningState
Der bereitgestellte Zustand der Ressource
Name | Typ | Beschreibung |
---|---|---|
Cancelled |
string |
Der letzte Vorgang für das Konto wird abgebrochen. |
Creating |
string |
Das Konto wird erstellt. |
Deleting |
string |
Das Konto wird gelöscht. |
Failed |
string |
Der letzte Vorgang für das Konto ist fehlgeschlagen. |
Invalid |
string |
Das Konto befindet sich in einem ungültigen Zustand. |
Succeeded |
string |
Das Konto wurde erstellt und kann verwendet werden. |
PublicNetworkAccessType
Der Netzwerkzugriffstyp für den Betrieb mit den Ressourcen im Batch-Konto.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
Deaktiviert die öffentliche Konnektivität und aktiviert private Konnektivität mit Azure Batch Service über eine private Endpunktressource. |
Enabled |
string |
Ermöglicht die Konnektivität mit Azure Batch über öffentliches DNS. |
ResourceIdentityType
Der Identitätstyp, der für das Batch-Konto verwendet wird.
Name | Typ | Beschreibung |
---|---|---|
None |
string |
Batch-Konto ist keine Identität zugeordnet. Durch festlegen |
SystemAssigned |
string |
Batch-Konto verfügt über eine systemseitig zugewiesene Identität. |
UserAssigned |
string |
Batch-Konto verfügt über benutzerseitig zugewiesene Identitäten. |
UserAssignedIdentities
Die Liste der zugeordneten Benutzeridentitäten.
Name | Typ | Beschreibung |
---|---|---|
clientId |
string |
Die Client-ID der benutzerseitig zugewiesenen Identität. |
principalId |
string |
Die Prinzipal-ID der benutzerseitig zugewiesenen Identität. |
VirtualMachineFamilyCoreQuota
Eine VM-Familie und das zugehörige Kernkontingent für das Batch-Konto.
Name | Typ | Beschreibung |
---|---|---|
coreQuota |
integer |
Das Kernkontingent für die VM-Familie für das Batch-Konto. |
name |
string |
Der Name der Vm-Familie. |