Batch Account - Get
Získá informace o zadaném účtu Batch.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}?api-version=2025-06-01
Parametry identifikátoru URI
| Name | V | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-zA-Z0-9]+$ |
Název pro batch účet, který musí být v rámci regionu jedinečný. Dávkové názvy účtů musí mít délku mezi 3 a 24 znaky a musí používat pouze čísla a malá písmena. Toto jméno se používá jako součást DNS jména, které slouží k přístupu k dávkové službě v regionu, kde je účet vytvořen. Například: |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Název skupiny prostředků. Název nerozlišuje malá a velká písmena. |
|
subscription
|
path | True |
string (uuid) |
ID cílového předplatného. Hodnota musí být UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Verze rozhraní API, která se má použít pro tuto operaci. |
Odpovědi
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Operace Azure byla úspěšně dokončena. |
|
| Other Status Codes |
Neočekávaná chybová odpověď |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2.
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
| Name | Description |
|---|---|
| user_impersonation | zosobnění uživatelského účtu |
Příklady
|
Batch |
|
Private |
BatchAccountGet
Ukázkový požadavek
Ukázková odpověď
{
"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"
}
}
PrivateBatchAccountGet
Ukázkový požadavek
Ukázková odpověď
{
"name": "sampleacct",
"type": "Microsoft.Batch/batchAccounts",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
"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,
"privateEndpointConnections": [
{
"name": "testprivateEndpointConnection.24d6b4b5-e65c-4330-bbe9-3a290d62f8e0",
"type": "Microsoft.Batch/batchAccounts/privateEndpointConnections",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/privateEndpointConnections/testprivateEndpointConnection.24d6b4b5-e65c-4330-bbe9-3a290d62f8e0",
"properties": {
"privateEndpoint": {
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Network/privateEndpoints/testprivateEndpoint"
},
"privateLinkServiceConnectionState": {
"description": "Approved by xyz.abc@company.com",
"status": "Approved"
}
}
}
],
"provisioningState": "Succeeded",
"publicNetworkAccess": "Disabled"
}
}
Definice
| Name | Description |
|---|---|
|
Authentication |
Režim ověřování pro účet Batch. |
|
Auto |
Režim ověřování, který bude služba Batch používat ke správě účtu automatického úložiště. |
|
Auto |
Obsahuje informace o účtu automatického úložiště přidruženého k účtu Batch. |
|
Batch |
Obsahuje informace o účtu Azure Batch. |
|
Batch |
Identita účtu Batch, pokud je nakonfigurovaná. Používá se, když uživatel jako konfiguraci šifrování účtu Batch zadá Microsoft.KeyVault nebo když |
|
Cloud |
Odpověď na chybu ze služby Batch |
|
Cloud |
Odpověď na chybu ze služby Batch |
|
Compute |
Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel. |
|
created |
Typ identity, která prostředek vytvořila. |
|
Encryption |
Konfiguruje způsob šifrování zákaznických dat v rámci účtu Batch. Ve výchozím nastavení se účty šifrují pomocí spravovaného klíče Microsoftu. Pro další kontrolu je možné použít klíč spravovaný zákazníkem. |
|
Endpoint |
Výchozí akce pro přístup ke koncovému bodu Dá se použít jenom v případě, že je povolená funkce PublicNetworkAccess. |
|
Endpoint |
Profil síťového přístupu pro koncový bod Batch. |
| IPRule |
Pravidlo pro filtrování IP adresy klienta |
|
IPRule |
Akce, kdy je IP adresa klienta spárována. |
|
Key |
Typ zdroje klíče. |
|
Key |
Konfigurace služby KeyVault při použití šifrovacího zdroje klíčů Microsoft.KeyVault |
|
Key |
Identifikuje trezor klíčů Azure přidružený k účtu Batch. |
|
Network |
Profil sítě pro účet Batch, který obsahuje nastavení pravidel sítě pro každý koncový bod. |
|
Pool |
Režim přidělování pro vytváření fondů v účtu Batch. |
|
Private |
Privátní koncový bod připojení privátního koncového bodu. |
|
Private |
Obsahuje informace o prostředku privátního propojení. |
|
Private |
Stav zřizování připojení privátního koncového bodu. |
|
Private |
Stav připojení služby Private Link připojení privátního koncového bodu |
|
Private |
Stav připojení privátního koncového bodu služby Batch |
|
Provisioning |
Zřízený stav prostředku |
|
Public |
Typ síťového rozhraní pro přístup ke službě Azure Batch a operacím účtu Batch. |
|
Resource |
Typ identity používané pro účet Batch. |
|
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
|
User |
Seznam přidružených identit uživatelů |
|
Virtual |
Řada virtuálních počítačů a přidružená kvóta jader pro účet Batch |
AuthenticationMode
Režim ověřování pro účet Batch.
| Hodnota | Description |
|---|---|
| SharedKey |
Režim ověřování pomocí sdílených klíčů. |
| AAD |
Režim ověřování pomocí MICROSOFT Entra ID. |
| TaskAuthenticationToken |
Režim ověřování pomocí ověřovacích tokenů úloh. |
AutoStorageAuthenticationMode
Režim ověřování, který bude služba Batch používat ke správě účtu automatického úložiště.
| Hodnota | Description |
|---|---|
| StorageKeys |
Služba Batch ověří požadavky na automatické úložiště pomocí klíčů účtu úložiště. |
| BatchAccountManagedIdentity |
Služba Batch ověří požadavky na automatické úložiště pomocí spravované identity přiřazené k účtu Batch. |
AutoStorageProperties
Obsahuje informace o účtu automatického úložiště přidruženého k účtu Batch.
| Name | Typ | Default value | Description |
|---|---|---|---|
| authenticationMode | StorageKeys |
Režim ověřování, který bude služba Batch používat ke správě účtu automatického úložiště. |
|
| lastKeySync |
string (date-time) |
Čas UTC, kdy byly klíče úložiště naposledy synchronizovány s účtem Batch. |
|
| nodeIdentityReference |
Odkaz na identitu přiřazenou uživatelem, kterou výpočetní uzly použijí pro přístup k automatickému úložišti. |
||
| storageAccountId |
string (arm-id) |
ID prostředku účtu úložiště, který se má použít pro účet automatického úložiště. |
BatchAccount
Obsahuje informace o účtu Azure Batch.
| Name | Typ | Default value | Description |
|---|---|---|---|
| id |
string (arm-id) |
Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| identity |
Identita účtu Batch. |
||
| location |
string |
Geografická poloha, kde se prostředek nachází |
|
| name |
string |
Název prostředku |
|
| properties.accountEndpoint |
string |
Koncový bod účtu používaný k interakci se službou Batch. |
|
| properties.activeJobAndJobScheduleQuota |
integer (int32) |
Aktivní kvóta úlohy a plánu úloh pro účet Batch. |
|
| properties.allowedAuthenticationModes |
Seznam povolených režimů ověřování pro účet Batch, který se dá použít k ověření v rovině dat. To nemá vliv na ověřování v řídicí rovině. |
||
| properties.autoStorage |
Vlastnosti a stav libovolného účtu automatického úložiště přidruženého k účtu Batch. |
||
| properties.dedicatedCoreQuota |
integer (int32) |
Kvóta vyhrazeného jádra pro účet Batch. |
|
| properties.dedicatedCoreQuotaPerVMFamily |
Seznam kvóty vyhrazených jader pro řadu virtuálních počítačů pro účet Batch. U účtů s parametrem PoolAllocationMode nastaveným na UserSubscription se kvóta spravuje v předplatném, takže tato hodnota se nevrátí. |
||
| properties.dedicatedCoreQuotaPerVMFamilyEnforced |
boolean |
Hodnota označující, jestli se pro tento účet vynucují kvóty jader na řadu virtuálních počítačů |
|
| properties.encryption |
Konfigurace šifrování pro účet Batch. |
||
| properties.keyVaultReference |
Odkaz na trezor klíčů Azure přidružený k účtu Batch. |
||
| properties.lowPriorityCoreQuota |
integer (int32) |
Kvóta jader spotového/nízké priority pro účet Batch. |
|
| properties.networkProfile |
Profil sítě pro účet Batch, který obsahuje nastavení pravidel sítě pro každý koncový bod. |
||
| properties.nodeManagementEndpoint |
string |
Koncový bod používaný výpočetním uzlem pro připojení ke službě pro správu uzlů Batch. |
|
| properties.poolAllocationMode |
Režim přidělování, který se použije k vytváření fondů v účtu Batch. |
||
| properties.poolQuota |
integer (int32) |
Kvóta fondu pro účet Batch. |
|
| properties.privateEndpointConnections |
Seznam připojení privátních koncových bodů přidružených k účtu Batch |
||
| properties.provisioningState |
Zřízený stav prostředku |
||
| properties.publicNetworkAccess | Enabled |
Typ síťového rozhraní pro přístup ke službě Azure Batch a operacím účtu Batch. |
|
| systemData |
Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil. |
||
| tags |
object |
Značky prostředků |
|
| type |
string |
Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts" |
BatchAccountIdentity
Identita účtu Batch, pokud je nakonfigurovaná. Používá se, když uživatel jako konfiguraci šifrování účtu Batch zadá Microsoft.KeyVault nebo když ManagedIdentity vybere režim ověřování automatického úložiště.
| Name | Typ | Description |
|---|---|---|
| principalId |
string |
ID objektu zabezpečení účtu Batch. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem. |
| tenantId |
string |
ID tenanta přidruženého k účtu Batch. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem. |
| type |
Typ identity používané pro účet Batch. |
|
| userAssignedIdentities |
<string,
User |
Seznam identit uživatelů přidružených k účtu Batch. |
CloudError
Odpověď na chybu ze služby Batch
| Name | Typ | Description |
|---|---|---|
| error |
Text odpovědi na chybu. |
CloudErrorBody
Odpověď na chybu ze služby Batch
| Name | Typ | Description |
|---|---|---|
| code |
string |
Identifikátor chyby. Kódy jsou invariantní a mají být využity programově. |
| details |
Seznam dalších podrobností o chybě |
|
| message |
string |
Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní. |
| target |
string |
Cíl konkrétní chyby. Například název vlastnosti v chybě. |
ComputeNodeIdentityReference
Odkaz na identitu přiřazenou uživatelem přidruženou k fondu Batch, který bude používat výpočetní uzel.
| Name | Typ | Description |
|---|---|---|
| resourceId |
string |
ID prostředku ARM identity přiřazené uživatelem. |
createdByType
Typ identity, která prostředek vytvořila.
| Hodnota | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
EncryptionProperties
Konfiguruje způsob šifrování zákaznických dat v rámci účtu Batch. Ve výchozím nastavení se účty šifrují pomocí spravovaného klíče Microsoftu. Pro další kontrolu je možné použít klíč spravovaný zákazníkem.
| Name | Typ | Description |
|---|---|---|
| keySource |
Typ zdroje klíče. |
|
| keyVaultProperties |
Další podrobnosti při používání služby Microsoft.KeyVault |
EndpointAccessDefaultAction
Výchozí akce pro přístup ke koncovému bodu Dá se použít jenom v případě, že je povolená funkce PublicNetworkAccess.
| Hodnota | Description |
|---|---|
| Allow |
Povolit klientský přístup. |
| Deny |
Odepřít klientský přístup. |
EndpointAccessProfile
Profil síťového přístupu pro koncový bod Batch.
| Name | Typ | Description |
|---|---|---|
| defaultAction |
Výchozí akce, pokud se neshoduje žádný protokol IPRule. |
|
| ipRules |
IPRule[] |
Pole rozsahů IP adres pro filtrování IP adres klienta |
IPRule
Pravidlo pro filtrování IP adresy klienta
| Name | Typ | Description |
|---|---|---|
| action |
Akce při porovnávání IP adresy klienta |
|
| value |
string |
Ip adresa nebo rozsah IP adres pro filtrování |
IPRuleAction
Akce, kdy je IP adresa klienta spárována.
| Hodnota | Description |
|---|---|
| Allow |
Povolte přístup pro odpovídající IP adresu klienta. |
KeySource
Typ zdroje klíče.
| Hodnota | Description |
|---|---|
| Microsoft.Batch |
Služba Batch vytvoří a spravuje šifrovací klíče použité k ochraně dat účtu. |
| Microsoft.KeyVault |
Šifrovací klíče používané k ochraně dat účtu se ukládají do externího trezoru klíčů. Pokud je tato hodnota nastavená, musí být identita účtu Batch nastavená na |
KeyVaultProperties
Konfigurace služby KeyVault při použití šifrovacího zdroje klíčů Microsoft.KeyVault
| Name | Typ | Description |
|---|---|---|
| keyIdentifier |
string |
Úplná cesta k tajnému kódu s verzí nebo bez. Příklad Účet Batch má identitu přiřazenou systémem. Identita účtu má udělený klíč/ získání, klíč/ rozbalení a oprávnění k zalamování klíčů. Služba KeyVault má povolenou ochranu proti obnovitelnému odstranění a vymazání. |
KeyVaultReference
Identifikuje trezor klíčů Azure přidružený k účtu Batch.
| Name | Typ | Description |
|---|---|---|
| id |
string (arm-id) |
ID prostředku trezoru klíčů Azure přidruženého k účtu Batch. |
| url |
string |
Adresa URL trezoru klíčů Azure přidruženého k účtu Batch. |
NetworkProfile
Profil sítě pro účet Batch, který obsahuje nastavení pravidel sítě pro každý koncový bod.
| Name | Typ | Description |
|---|---|---|
| accountAccess |
Profil přístupu k síti pro koncový bod batchAccount (rozhraní API roviny dat účtu Batch) |
|
| nodeManagementAccess |
Profil přístupu k síti pro koncový bod nodeManagement (služba Batch spravující výpočetní uzly pro fondy Batch) |
PoolAllocationMode
Režim přidělování pro vytváření fondů v účtu Batch.
| Hodnota | Description |
|---|---|
| BatchService |
Fondy budou přiděleny v předplatných vlastněných službou Batch. |
| UserSubscription |
Fondy budou přiděleny v předplatném vlastněné uživatelem. |
PrivateEndpoint
Privátní koncový bod připojení privátního koncového bodu.
| Name | Typ | Description |
|---|---|---|
| id |
string |
Identifikátor prostředku ARM privátního koncového bodu. Toto je formulář /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint}. |
PrivateEndpointConnection
Obsahuje informace o prostředku privátního propojení.
| Name | Typ | Description |
|---|---|---|
| etag |
string |
ETag prostředku, který se používá pro příkazy souběžnosti. |
| id |
string (arm-id) |
Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Název prostředku |
| properties.groupIds |
string[] |
ID skupiny připojení privátního koncového bodu. |
| properties.privateEndpoint |
Identifikátor prostředku ARM privátního koncového bodu. |
|
| properties.privateLinkServiceConnectionState |
Stav připojení služby Private Link pro připojení privátního koncového bodu. |
|
| properties.provisioningState |
Stav zřizování připojení privátního koncového bodu. |
|
| systemData |
Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil. |
|
| tags |
object |
Značky prostředku. |
| type |
string |
Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProvisioningState
Stav zřizování připojení privátního koncového bodu.
| Hodnota | Description |
|---|---|
| Creating |
Připojení se vytváří. |
| Updating |
Uživatel požádal o aktualizaci stavu připojení, ale operace aktualizace ještě nebyla dokončena. Při připojování účtu Batch nemusí odkazovat na připojení. |
| Deleting |
Připojení se odstraňuje. |
| Succeeded |
Stav připojení je konečný a je připravený k použití, pokud je stav schválen. |
| Failed |
Uživatel požádal o aktualizaci připojení a připojení se nezdařilo. Operaci aktualizace můžete opakovat. |
| Cancelled |
Uživatel zrušil vytvoření připojení. |
PrivateLinkServiceConnectionState
Stav připojení služby Private Link připojení privátního koncového bodu
| Name | Typ | Description |
|---|---|---|
| actionsRequired |
string |
Požadovaná akce ve stavu privátního připojení |
| description |
string |
Popis stavu privátního připojení |
| status |
Stav připojení privátního koncového bodu služby Batch |
PrivateLinkServiceConnectionStatus
Stav připojení privátního koncového bodu služby Batch
| Hodnota | Description |
|---|---|
| Approved |
Připojení privátního koncového bodu je schválené a dá se použít pro přístup k účtu Batch. |
| Pending |
Připojení privátního koncového bodu čeká na vyřízení a nejde ho použít pro přístup k účtu Batch. |
| Rejected |
Připojení privátního koncového bodu je odmítnuto a nelze ho použít pro přístup k účtu Batch. |
| Disconnected |
Připojení privátního koncového bodu je odpojené a nelze ho použít pro přístup k účtu Batch. |
ProvisioningState
Zřízený stav prostředku
| Hodnota | Description |
|---|---|
| Invalid |
Účet je v neplatném stavu. |
| Creating |
Účet se vytváří. |
| Deleting |
Účet se odstraňuje. |
| Succeeded |
Účet byl vytvořen a je připravený k použití. |
| Failed |
Poslední operace pro účet se nezdařila. |
| Cancelled |
Poslední operace účtu se zruší. |
PublicNetworkAccessType
Typ síťového rozhraní pro přístup ke službě Azure Batch a operacím účtu Batch.
| Hodnota | Description |
|---|---|
| Enabled |
Umožňuje připojení ke službě Azure Batch prostřednictvím veřejného DNS. |
| Disabled |
Zakáže veřejné připojení a umožňuje privátní připojení ke službě Azure Batch prostřednictvím prostředku privátního koncového bodu. |
| SecuredByPerimeter |
Zabezpečuje připojení ke službě Azure Batch prostřednictvím konfigurace NSP. |
ResourceIdentityType
Typ identity používané pro účet Batch.
| Hodnota | Description |
|---|---|
| SystemAssigned |
Účet Batch má přiřazenou identitu systému. |
| UserAssigned |
Účet Batch má přiřazené identity uživatelem. |
| None |
Účet Batch nemá přidruženou žádnou identitu. Nastavení |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Časové razítko vytvoření prostředku (UTC). |
| createdBy |
string |
Identita, která prostředek vytvořila. |
| createdByType |
Typ identity, která prostředek vytvořila. |
|
| lastModifiedAt |
string (date-time) |
Časové razítko poslední změny zdroje (UTC) |
| lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
| lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |
UserAssignedIdentities
Seznam přidružených identit uživatelů
| Name | Typ | Description |
|---|---|---|
| clientId |
string |
ID klienta identity přiřazené uživatelem. |
| principalId |
string |
ID objektu zabezpečení identity přiřazené uživatelem. |
VirtualMachineFamilyCoreQuota
Řada virtuálních počítačů a přidružená kvóta jader pro účet Batch
| Name | Typ | Description |
|---|---|---|
| coreQuota |
integer (int32) |
Kvóta jader pro řadu virtuálních počítačů pro účet Batch. |
| name |
string |
Název rodiny virtuálních počítačů. |