Batch Account - Get
Pobiera informacje o określonym koncie usługi Batch.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}?api-version=2024-02-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
account
|
path | True |
string |
Nazwa konta usługi Batch. Regex pattern: |
resource
|
path | True |
string |
Nazwa grupy zasobów zawierającej konto usługi Batch. |
subscription
|
path | True |
string |
Identyfikator subskrypcji platformy Azure. Jest to ciąg w formacie GUID (np. 00000000-0000-0000-0000-0000-000000000000) |
api-version
|
query | True |
string |
Wersja interfejsu API, która ma być używana z żądaniem HTTP. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Batch |
Operacja zakończyła się pomyślnie. Odpowiedź zawiera jednostkę konta usługi Batch. |
Other Status Codes |
Cloud |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
przepływ kodu uwierzytelniania OAuth 2.0 Microsoft Entra
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
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"
}
Definicje
Nazwa | Opis |
---|---|
Authentication |
Tryb uwierzytelniania dla konta usługi Batch. |
Auto |
Tryb uwierzytelniania używany przez usługę Batch do zarządzania kontem magazynu automatycznego. |
Auto |
Zawiera informacje o koncie automatycznego magazynu skojarzonego z kontem usługi Batch. |
Batch |
Zawiera informacje o koncie Azure Batch. |
Batch |
Tożsamość konta usługi Batch, jeśli została skonfigurowana. Jest to używane, gdy użytkownik określa wartość "Microsoft.KeyVault" jako konfigurację szyfrowania konta usługi Batch lub gdy |
Cloud |
Odpowiedź na błąd z usługi Batch. |
Cloud |
Odpowiedź na błąd z usługi Batch. |
Compute |
Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy. |
Encryption |
Konfiguruje sposób szyfrowania danych klienta wewnątrz konta usługi Batch. Domyślnie konta są szyfrowane przy użyciu klucza zarządzanego przez firmę Microsoft. Aby uzyskać dodatkową kontrolę, można zamiast tego użyć klucza zarządzanego przez klienta. |
Endpoint |
Domyślna akcja, gdy nie jest dopasowana reguła IPRule. |
Endpoint |
Profil dostępu do sieci dla punktu końcowego usługi Batch. |
IPRule |
Reguła filtrowania adresu IP klienta. |
IPRule |
Akcja w przypadku dopasowania adresu IP klienta. |
Key |
Typ źródła klucza. |
Key |
Konfiguracja usługi KeyVault podczas korzystania z szyfrowania KeySource usługi Microsoft.KeyVault. |
Key |
Identyfikuje magazyn kluczy platformy Azure skojarzony z kontem usługi Batch. |
Network |
Profil sieciowy dla konta usługi Batch, który zawiera ustawienia reguły sieci dla każdego punktu końcowego. |
Pool |
Tryb alokacji do tworzenia pul na koncie usługi Batch. |
Private |
Prywatny punkt końcowy połączenia prywatnego punktu końcowego. |
Private |
Zawiera informacje o zasobie łącza prywatnego. |
Private |
Stan aprowizacji połączenia prywatnego punktu końcowego. |
Private |
Stan połączenia usługi łącza prywatnego połączenia z prywatnym punktem końcowym |
Private |
Stan połączenia prywatnego punktu końcowego usługi Batch |
Provisioning |
Stan aprowizacji zasobu |
Public |
Typ dostępu do sieci dla operacji na zasobach na koncie usługi Batch. |
Resource |
Typ tożsamości używanej dla konta usługi Batch. |
User |
Lista skojarzonych tożsamości użytkowników. |
Virtual |
Rodzina maszyn wirtualnych i skojarzony z nim limit przydziału rdzeni dla konta usługi Batch. |
AuthenticationMode
Tryb uwierzytelniania dla konta usługi Batch.
Nazwa | Typ | Opis |
---|---|---|
AAD |
string |
Tryb uwierzytelniania przy użyciu Tożsamość Microsoft Entra. |
SharedKey |
string |
Tryb uwierzytelniania przy użyciu kluczy udostępnionych. |
TaskAuthenticationToken |
string |
Tryb uwierzytelniania przy użyciu tokenów uwierzytelniania zadań. |
AutoStorageAuthenticationMode
Tryb uwierzytelniania używany przez usługę Batch do zarządzania kontem magazynu automatycznego.
Nazwa | Typ | Opis |
---|---|---|
BatchAccountManagedIdentity |
string |
Usługa Batch uwierzytelni żądania automatycznego magazynu przy użyciu tożsamości zarządzanej przypisanej do konta usługi Batch. |
StorageKeys |
string |
Usługa Batch będzie uwierzytelniać żądania automatycznego magazynu przy użyciu kluczy konta magazynu. |
AutoStorageProperties
Zawiera informacje o koncie automatycznego magazynu skojarzonego z kontem usługi Batch.
Nazwa | Typ | Wartość domyślna | Opis |
---|---|---|---|
authenticationMode |
Auto |
StorageKeys |
Tryb uwierzytelniania używany przez usługę Batch do zarządzania kontem magazynu automatycznego. |
lastKeySync |
string |
Czas UTC, w którym klucze magazynu zostały ostatnio zsynchronizowane z kontem usługi Batch. |
|
nodeIdentityReference |
Compute |
Odwołanie do tożsamości przypisanej przez użytkownika, której węzły obliczeniowe będą używać do uzyskiwania dostępu do automatycznego magazynu. |
|
storageAccountId |
string |
Identyfikator zasobu konta magazynu, który ma być używany dla konta magazynu automatycznego. |
BatchAccount
Zawiera informacje o koncie Azure Batch.
Nazwa | Typ | Wartość domyślna | Opis |
---|---|---|---|
id |
string |
Identyfikator zasobu. |
|
identity |
Batch |
Tożsamość konta usługi Batch. |
|
location |
string |
Lokalizacja zasobu. |
|
name |
string |
Nazwa zasobu. |
|
properties.accountEndpoint |
string |
Punkt końcowy konta używany do interakcji z usługą Batch. |
|
properties.activeJobAndJobScheduleQuota |
integer |
Aktywny limit przydziału harmonogramu zadań i zadania dla konta usługi Batch. |
|
properties.allowedAuthenticationModes |
Authentication |
Lista dozwolonych trybów uwierzytelniania dla konta usługi Batch, których można użyć do uwierzytelniania za pomocą płaszczyzny danych. Nie ma to wpływu na uwierzytelnianie za pomocą płaszczyzny sterowania. |
|
properties.autoStorage |
Auto |
Właściwości i stan dowolnego konta magazynu automatycznego skojarzonego z kontem usługi Batch. |
|
properties.dedicatedCoreQuota |
integer |
Dedykowany limit przydziału rdzeni dla konta usługi Batch. |
|
properties.dedicatedCoreQuotaPerVMFamily |
Virtual |
Lista dedykowanego limitu przydziału rdzeni dla rodziny maszyn wirtualnych dla konta usługi Batch. W przypadku kont z ustawieniem PoolAllocationMode na wartość UserSubscription limit przydziału jest zarządzany w ramach subskrypcji, więc ta wartość nie jest zwracana. |
|
properties.dedicatedCoreQuotaPerVMFamilyEnforced |
boolean |
Wartość wskazująca, czy limity przydziału rdzeni dla rodziny maszyn wirtualnych są wymuszane dla tego konta |
|
properties.encryption |
Encryption |
Konfiguracja szyfrowania dla konta usługi Batch. |
|
properties.keyVaultReference |
Key |
Odwołanie do magazynu kluczy platformy Azure skojarzonego z kontem usługi Batch. |
|
properties.lowPriorityCoreQuota |
integer |
Limit przydziału rdzeni typu spot/low-priority dla konta usługi Batch. |
|
properties.networkProfile |
Network |
Profil sieciowy dla konta usługi Batch, który zawiera ustawienia reguły sieci dla każdego punktu końcowego. |
|
properties.nodeManagementEndpoint |
string |
Punkt końcowy używany przez węzeł obliczeniowy do nawiązywania połączenia z usługą zarządzania węzłami usługi Batch. |
|
properties.poolAllocationMode |
Pool |
Tryb alokacji na potrzeby tworzenia pul w ramach konta usługi Batch. |
|
properties.poolQuota |
integer |
Limit przydziału puli dla konta usługi Batch. |
|
properties.privateEndpointConnections |
Private |
Lista połączeń prywatnego punktu końcowego skojarzonych z kontem usługi Batch |
|
properties.provisioningState |
Provisioning |
Stan aprowizacji zasobu |
|
properties.publicNetworkAccess |
Public |
Enabled |
Typ interfejsu sieciowego na potrzeby uzyskiwania dostępu do Azure Batch usług i operacji konta usługi Batch. |
tags |
object |
Tagi zasobu. |
|
type |
string |
Typ zasobu. |
BatchAccountIdentity
Tożsamość konta usługi Batch, jeśli została skonfigurowana. Jest to używane, gdy użytkownik określa wartość "Microsoft.KeyVault" jako konfigurację szyfrowania konta usługi Batch lub gdy ManagedIdentity
jest wybierany jako tryb uwierzytelniania automatycznego magazynu.
Nazwa | Typ | Opis |
---|---|---|
principalId |
string |
Identyfikator podmiotu zabezpieczeń konta usługi Batch. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system. |
tenantId |
string |
Identyfikator dzierżawy skojarzony z kontem usługi Batch. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system. |
type |
Resource |
Typ tożsamości używany dla konta usługi Batch. |
userAssignedIdentities |
object |
Lista tożsamości użytkowników skojarzonych z kontem usługi Batch. |
CloudError
Odpowiedź na błąd z usługi Batch.
Nazwa | Typ | Opis |
---|---|---|
error |
Cloud |
Treść odpowiedzi o błędzie. |
CloudErrorBody
Odpowiedź na błąd z usługi Batch.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Identyfikator błędu. Kody są niezmienne i mają być używane programowo. |
details |
Cloud |
Lista dodatkowych szczegółów dotyczących błędu. |
message |
string |
Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika. |
target |
string |
Element docelowy określonego błędu. Na przykład nazwa właściwości w błędzie. |
ComputeNodeIdentityReference
Odwołanie do tożsamości przypisanej przez użytkownika skojarzonej z pulą usługi Batch, która będzie używana przez węzeł obliczeniowy.
Nazwa | Typ | Opis |
---|---|---|
resourceId |
string |
Identyfikator zasobu usługi ARM tożsamości przypisanej przez użytkownika. |
EncryptionProperties
Konfiguruje sposób szyfrowania danych klienta wewnątrz konta usługi Batch. Domyślnie konta są szyfrowane przy użyciu klucza zarządzanego przez firmę Microsoft. Aby uzyskać dodatkową kontrolę, można zamiast tego użyć klucza zarządzanego przez klienta.
Nazwa | Typ | Opis |
---|---|---|
keySource |
Key |
Typ źródła klucza. |
keyVaultProperties |
Key |
Dodatkowe szczegóły dotyczące korzystania z usługi Microsoft.KeyVault |
EndpointAccessDefaultAction
Domyślna akcja, gdy nie jest dopasowana reguła IPRule.
Nazwa | Typ | Opis |
---|---|---|
Allow |
string |
Zezwalaj na dostęp klienta. |
Deny |
string |
Odmowa dostępu klienta. |
EndpointAccessProfile
Profil dostępu do sieci dla punktu końcowego usługi Batch.
Nazwa | Typ | Opis |
---|---|---|
defaultAction |
Endpoint |
Domyślna akcja, gdy nie jest dopasowana reguła IPRule. |
ipRules |
IPRule[] |
Tablica zakresów adresów IP do filtrowania adresu IP klienta. |
IPRule
Reguła filtrowania adresu IP klienta.
Nazwa | Typ | Opis |
---|---|---|
action |
IPRule |
Akcja w przypadku dopasowania adresu IP klienta. |
value |
string |
Adres IP lub zakres adresów IP do filtrowania |
IPRuleAction
Akcja w przypadku dopasowania adresu IP klienta.
Nazwa | Typ | Opis |
---|---|---|
Allow |
string |
Zezwalaj na dostęp dla dopasowanego adresu IP klienta. |
KeySource
Typ źródła klucza.
Nazwa | Typ | Opis |
---|---|---|
Microsoft.Batch |
string |
Usługa Batch tworzy klucze szyfrowania używane do ochrony danych konta i zarządza nimi. |
Microsoft.KeyVault |
string |
Klucze szyfrowania używane do ochrony danych konta są przechowywane w zewnętrznym magazynie kluczy. Jeśli jest to ustawione, tożsamość konta usługi Batch musi być ustawiona na |
KeyVaultProperties
Konfiguracja usługi KeyVault podczas korzystania z szyfrowania KeySource usługi Microsoft.KeyVault.
Nazwa | Typ | Opis |
---|---|---|
keyIdentifier |
string |
Pełna ścieżka do wpisu tajnego z wersją lub bez tej wersji. Przykład https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. lub https://mykeyvault.vault.azure.net/keys/testkey. Aby można było korzystać z następujących wymagań wstępnych, należy spełnić następujące wymagania wstępne: Konto usługi Batch ma tożsamość przypisaną przez system Tożsamość konta została udzielona: Klucz/Pobieranie, Klucz/Odpakowywanie i Zawijanie klucza/Opakowywanie uprawnienia KeyVault ma włączone usuwanie nietrwałe i ochronę przed przeczyszczaniem |
KeyVaultReference
Identyfikuje magazyn kluczy platformy Azure skojarzony z kontem usługi Batch.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu usługi Azure Key Vault skojarzonego z kontem usługi Batch. |
url |
string |
Adres URL usługi Azure Key Vault skojarzonego z kontem usługi Batch. |
NetworkProfile
Profil sieciowy dla konta usługi Batch, który zawiera ustawienia reguły sieci dla każdego punktu końcowego.
Nazwa | Typ | Opis |
---|---|---|
accountAccess |
Endpoint |
Profil dostępu do sieci dla punktu końcowego usługi BatchAccount (interfejs API płaszczyzny danych konta usługi Batch). |
nodeManagementAccess |
Endpoint |
Profil dostępu do sieci dla punktu końcowego nodeManagement (usługa Batch zarządzająca węzłami obliczeniowymi dla pul usługi Batch). |
PoolAllocationMode
Tryb alokacji do tworzenia pul na koncie usługi Batch.
Nazwa | Typ | Opis |
---|---|---|
BatchService |
string |
Pule zostaną przydzielone w subskrypcjach należących do usługi Batch. |
UserSubscription |
string |
Pule zostaną przydzielone w subskrypcji należącej do użytkownika. |
PrivateEndpoint
Prywatny punkt końcowy połączenia prywatnego punktu końcowego.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu usługi ARM prywatnego punktu końcowego. Jest to formularz /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint}. |
PrivateEndpointConnection
Zawiera informacje o zasobie łącza prywatnego.
Nazwa | Typ | Opis |
---|---|---|
etag |
string |
Element ETag zasobu używany do instrukcji współbieżności. |
id |
string |
Identyfikator zasobu. |
name |
string |
Nazwa zasobu. |
properties.groupIds |
string[] |
Identyfikator grupy połączenia prywatnego punktu końcowego. |
properties.privateEndpoint |
Private |
Identyfikator zasobu usługi ARM prywatnego punktu końcowego. |
properties.privateLinkServiceConnectionState |
Private |
Stan połączenia usługi private link połączenia z prywatnym punktem końcowym. |
properties.provisioningState |
Private |
Stan aprowizacji połączenia prywatnego punktu końcowego. |
type |
string |
Typ zasobu. |
PrivateEndpointConnectionProvisioningState
Stan aprowizacji połączenia prywatnego punktu końcowego.
Nazwa | Typ | Opis |
---|---|---|
Cancelled |
string |
Użytkownik anulował tworzenie połączenia. |
Creating |
string |
Trwa tworzenie połączenia. |
Deleting |
string |
Połączenie jest usuwane. |
Failed |
string |
Użytkownik zażądał, aby połączenie zostało zaktualizowane i nie powiodło się. Możesz ponowić próbę wykonania operacji aktualizacji. |
Succeeded |
string |
Stan połączenia jest końcowy i jest gotowy do użycia, jeśli stan to Zatwierdzone. |
Updating |
string |
Użytkownik zażądał zaktualizowania stanu połączenia, ale operacja aktualizacji nie została jeszcze ukończona. Nie można odwoływać się do połączenia podczas nawiązywania połączenia z kontem usługi Batch. |
PrivateLinkServiceConnectionState
Stan połączenia usługi łącza prywatnego połączenia z prywatnym punktem końcowym
Nazwa | Typ | Opis |
---|---|---|
actionsRequired |
string |
Akcja wymagana w stanie połączenia prywatnego |
description |
string |
Opis stanu połączenia prywatnego |
status |
Private |
Stan połączenia prywatnego punktu końcowego konta usługi Batch |
PrivateLinkServiceConnectionStatus
Stan połączenia prywatnego punktu końcowego usługi Batch
Nazwa | Typ | Opis |
---|---|---|
Approved |
string |
Połączenie prywatnego punktu końcowego jest zatwierdzone i może służyć do uzyskiwania dostępu do konta usługi Batch |
Disconnected |
string |
Połączenie prywatnego punktu końcowego jest rozłączone i nie można go użyć do uzyskiwania dostępu do konta usługi Batch |
Pending |
string |
Połączenie prywatnego punktu końcowego oczekuje i nie może być używane do uzyskiwania dostępu do konta usługi Batch |
Rejected |
string |
Połączenie prywatnego punktu końcowego jest odrzucane i nie można go użyć do uzyskiwania dostępu do konta usługi Batch |
ProvisioningState
Stan aprowizacji zasobu
Nazwa | Typ | Opis |
---|---|---|
Cancelled |
string |
Ostatnia operacja konta została anulowana. |
Creating |
string |
Konto jest tworzone. |
Deleting |
string |
Konto jest usuwane. |
Failed |
string |
Ostatnia operacja dla konta nie powiodła się. |
Invalid |
string |
Konto jest w nieprawidłowym stanie. |
Succeeded |
string |
Konto zostało utworzone i jest gotowe do użycia. |
PublicNetworkAccessType
Typ dostępu do sieci dla operacji na zasobach na koncie usługi Batch.
Nazwa | Typ | Opis |
---|---|---|
Disabled |
string |
Wyłącza łączność publiczną i umożliwia łączność prywatną z usługą Azure Batch za pośrednictwem zasobu prywatnego punktu końcowego. |
Enabled |
string |
Umożliwia łączność z Azure Batch za pośrednictwem publicznego systemu DNS. |
ResourceIdentityType
Typ tożsamości używanej dla konta usługi Batch.
Nazwa | Typ | Opis |
---|---|---|
None |
string |
Konto usługi Batch nie ma skojarzonej tożsamości. Ustawienie |
SystemAssigned |
string |
Konto usługi Batch ma tożsamość przypisaną przez system. |
UserAssigned |
string |
Konto usługi Batch ma przypisane przez użytkownika tożsamości. |
UserAssignedIdentities
Lista skojarzonych tożsamości użytkowników.
Nazwa | Typ | Opis |
---|---|---|
clientId |
string |
Identyfikator klienta tożsamości przypisanej przez użytkownika. |
principalId |
string |
Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez użytkownika. |
VirtualMachineFamilyCoreQuota
Rodzina maszyn wirtualnych i skojarzony z nim limit przydziału rdzeni dla konta usługi Batch.
Nazwa | Typ | Opis |
---|---|---|
coreQuota |
integer |
Limit przydziału rdzeni dla rodziny maszyn wirtualnych dla konta usługi Batch. |
name |
string |
Nazwa rodziny maszyn wirtualnych. |