Batch Account - Get
Возвращает сведения об указанной учетной записи пакетной службы.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}?api-version=2024-02-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
account
|
path | True |
string |
Имя учетной записи пакетной службы. Regex pattern: |
resource
|
path | True |
string |
Имя группы ресурсов, содержащей учетную запись пакетной службы. |
subscription
|
path | True |
string |
Идентификатор подписки Azure. Это строка в формате GUID (например, 0000000-0000-0000-0000-0000-000000000000000). |
api-version
|
query | True |
string |
Версия API, используемая с HTTP-запросом. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Batch |
Операция выполнена успешно. Ответ содержит сущность учетной записи пакетной службы. |
Other Status Codes |
Cloud |
Ответ об ошибке, описывающий причину сбоя операции. |
Безопасность
azure_auth
Microsoft Entra поток кода проверки подлинности OAuth 2.0
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
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"
}
Определения
Имя | Описание |
---|---|
Authentication |
Режим проверки подлинности для учетной записи пакетной службы. |
Auto |
Режим проверки подлинности, который пакетная служба будет использовать для управления учетной записью автоматического хранения. |
Auto |
Содержит сведения об учетной записи автоматического хранения, связанной с учетной записью пакетной службы. |
Batch |
Содержит сведения об учетной записи пакетная служба Azure. |
Batch |
Удостоверение учетной записи пакетной службы, если настроено. Используется, когда пользователь указывает Microsoft.KeyVault в качестве конфигурации шифрования учетной записи пакетной службы или если |
Cloud |
Ответ об ошибке от пакетной службы. |
Cloud |
Ответ об ошибке от пакетной службы. |
Compute |
Ссылка на назначенное пользователем удостоверение, связанное с пулом пакетной службы, который будет использовать вычислительный узел. |
Encryption |
Настраивает способ шифрования данных клиента в учетной записи пакетной службы. По умолчанию учетные записи шифруются с помощью ключа, управляемого Корпорацией Майкрософт. Для дополнительного управления можно использовать ключ, управляемый клиентом. |
Endpoint |
Действие по умолчанию при отсутствии сопоставления IPRule. |
Endpoint |
Профиль доступа к сети для конечной точки пакетной службы. |
IPRule |
Правило для фильтрации IP-адреса клиента. |
IPRule |
Действие при сопоставлении IP-адреса клиента. |
Key |
Тип источника ключа. |
Key |
Конфигурация KeyVault при использовании keySource шифрования Microsoft.KeyVault. |
Key |
Определяет хранилище ключей Azure, связанное с учетной записью пакетной службы. |
Network |
Сетевой профиль для учетной записи пакетной службы, который содержит параметры правил сети для каждой конечной точки. |
Pool |
Режим выделения для создания пулов в учетной записи пакетной службы. |
Private |
Частная конечная точка подключения к частной конечной точке. |
Private |
Содержит сведения о ресурсе приватного канала. |
Private |
Состояние подготовки подключения к частной конечной точке. |
Private |
Состояние подключения службы приватного канала для подключения к частной конечной точке |
Private |
Состояние подключения к частной конечной точке пакетной службы |
Provisioning |
Подготовленное состояние ресурса |
Public |
Тип сетевого доступа для работы с ресурсами в учетной записи пакетной службы. |
Resource |
Тип удостоверения, используемого для учетной записи пакетной службы. |
User |
Список связанных удостоверений пользователей. |
Virtual |
Семейство виртуальных машин и связанная с ним квота ядра для учетной записи пакетной службы. |
AuthenticationMode
Режим проверки подлинности для учетной записи пакетной службы.
Имя | Тип | Описание |
---|---|---|
AAD |
string |
Режим проверки подлинности с использованием Microsoft Entra ID. |
SharedKey |
string |
Режим проверки подлинности с использованием общих ключей. |
TaskAuthenticationToken |
string |
Режим проверки подлинности с использованием маркеров проверки подлинности задачи. |
AutoStorageAuthenticationMode
Режим проверки подлинности, который пакетная служба будет использовать для управления учетной записью автоматического хранения.
Имя | Тип | Описание |
---|---|---|
BatchAccountManagedIdentity |
string |
Пакетная служба будет проверять подлинность запросов к автоматическому хранилищу с помощью управляемого удостоверения, назначенного учетной записи пакетной службы. |
StorageKeys |
string |
Пакетная служба будет проверять подлинность запросов к автоматическому хранению с помощью ключей учетной записи хранения. |
AutoStorageProperties
Содержит сведения об учетной записи автоматического хранения, связанной с учетной записью пакетной службы.
Имя | Тип | Значение по умолчанию | Описание |
---|---|---|---|
authenticationMode |
Auto |
StorageKeys |
Режим проверки подлинности, который пакетная служба будет использовать для управления учетной записью автоматического хранения. |
lastKeySync |
string |
Время в формате UTC, в которое ключи хранилища были синхронизированы с учетной записью пакетной службы. |
|
nodeIdentityReference |
Compute |
Ссылка на назначенное пользователем удостоверение, которое вычислительные узлы будут использовать для доступа к автоматическому хранилищу. |
|
storageAccountId |
string |
Идентификатор ресурса учетной записи хранения, которая будет использоваться для учетной записи автоматического хранения. |
BatchAccount
Содержит сведения об учетной записи пакетная служба Azure.
Имя | Тип | Значение по умолчанию | Описание |
---|---|---|---|
id |
string |
Идентификатор ресурса. |
|
identity |
Batch |
Удостоверение учетной записи пакетной службы. |
|
location |
string |
Расположение ресурса. |
|
name |
string |
Имя ресурса. |
|
properties.accountEndpoint |
string |
Конечная точка учетной записи, используемая для взаимодействия с пакетной службой. |
|
properties.activeJobAndJobScheduleQuota |
integer |
Квота активного задания и расписания заданий для учетной записи пакетной службы. |
|
properties.allowedAuthenticationModes |
Authentication |
Список разрешенных режимов проверки подлинности для учетной записи пакетной службы, которые можно использовать для проверки подлинности в плоскости данных. Это не влияет на проверку подлинности на уровне управления. |
|
properties.autoStorage |
Auto |
Свойства и состояние любой учетной записи автоматического хранения, связанной с учетной записью пакетной службы. |
|
properties.dedicatedCoreQuota |
integer |
Выделенная квота на ядра для учетной записи пакетной службы. |
|
properties.dedicatedCoreQuotaPerVMFamily |
Virtual |
Список выделенной квоты ядер на семейство виртуальных машин для учетной записи пакетной службы. Для учетных записей с параметром PoolAllocationMode, для параметра UserSubscription квота управляется в подписке, поэтому это значение не возвращается. |
|
properties.dedicatedCoreQuotaPerVMFamilyEnforced |
boolean |
Значение, указывающее, применяются ли квоты на ядра для семейства виртуальных машин для этой учетной записи. |
|
properties.encryption |
Encryption |
Конфигурация шифрования для учетной записи пакетной службы. |
|
properties.keyVaultReference |
Key |
Ссылка на хранилище ключей Azure, связанное с учетной записью пакетной службы. |
|
properties.lowPriorityCoreQuota |
integer |
Квота точечных и низкоприоритетных ядер для учетной записи пакетной службы. |
|
properties.networkProfile |
Network |
Сетевой профиль для учетной записи пакетной службы, который содержит параметры правил сети для каждой конечной точки. |
|
properties.nodeManagementEndpoint |
string |
Конечная точка, используемая вычислительным узлом для подключения к службе управления узлами пакетной службы. |
|
properties.poolAllocationMode |
Pool |
режим выделения для создания пулов в учетной записи пакетной службы. |
|
properties.poolQuota |
integer |
Квота пула для учетной записи пакетной службы. |
|
properties.privateEndpointConnections |
Private |
Список подключений к частной конечной точке, связанных с учетной записью пакетной службы |
|
properties.provisioningState |
Provisioning |
Подготовленное состояние ресурса |
|
properties.publicNetworkAccess |
Public |
Enabled |
Тип сетевого интерфейса для доступа к пакетная служба Azure службам и операциям учетной записи пакетной службы. |
tags |
object |
Теги ресурса. |
|
type |
string |
Тип ресурса. |
BatchAccountIdentity
Удостоверение учетной записи пакетной службы, если настроено. Используется, когда пользователь указывает Microsoft.KeyVault в качестве конфигурации шифрования учетной записи пакетной службы или если ManagedIdentity
выбран режим проверки подлинности автоматического хранения.
Имя | Тип | Описание |
---|---|---|
principalId |
string |
Идентификатор субъекта учетной записи пакетной службы. Это свойство предоставляется только для удостоверения, назначаемого системой. |
tenantId |
string |
Идентификатор клиента, связанный с учетной записью пакетной службы. Это свойство предоставляется только для удостоверения, назначаемого системой. |
type |
Resource |
Тип удостоверения, используемого для учетной записи пакетной службы. |
userAssignedIdentities |
object |
Список удостоверений пользователей, связанных с учетной записью пакетной службы. |
CloudError
Ответ об ошибке от пакетной службы.
Имя | Тип | Описание |
---|---|---|
error |
Cloud |
Текст ответа об ошибке. |
CloudErrorBody
Ответ об ошибке от пакетной службы.
Имя | Тип | Описание |
---|---|---|
code |
string |
Идентификатор ошибки. Коды инвариантны и предназначены для программного использования. |
details |
Cloud |
Список дополнительных сведений об ошибке. |
message |
string |
Сообщение с описанием ошибки, предназначенное для отображения в пользовательском интерфейсе. |
target |
string |
Целевой объект конкретной ошибки. Например, имя свойства в ошибке. |
ComputeNodeIdentityReference
Ссылка на назначенное пользователем удостоверение, связанное с пулом пакетной службы, который будет использовать вычислительный узел.
Имя | Тип | Описание |
---|---|---|
resourceId |
string |
Идентификатор ресурса ARM для удостоверения, назначаемого пользователем. |
EncryptionProperties
Настраивает способ шифрования данных клиента в учетной записи пакетной службы. По умолчанию учетные записи шифруются с помощью ключа, управляемого Корпорацией Майкрософт. Для дополнительного управления можно использовать ключ, управляемый клиентом.
Имя | Тип | Описание |
---|---|---|
keySource |
Key |
Тип источника ключа. |
keyVaultProperties |
Key |
Дополнительные сведения об использовании Microsoft.KeyVault |
EndpointAccessDefaultAction
Действие по умолчанию при отсутствии сопоставления IPRule.
Имя | Тип | Описание |
---|---|---|
Allow |
string |
Разрешить клиентский доступ. |
Deny |
string |
Запретить доступ клиента. |
EndpointAccessProfile
Профиль доступа к сети для конечной точки пакетной службы.
Имя | Тип | Описание |
---|---|---|
defaultAction |
Endpoint |
Действие по умолчанию при отсутствии сопоставления IPRule. |
ipRules |
IPRule[] |
Массив диапазонов IP-адресов для фильтрации IP-адресов клиента. |
IPRule
Правило для фильтрации IP-адреса клиента.
Имя | Тип | Описание |
---|---|---|
action |
IPRule |
Действие при сопоставлении IP-адреса клиента. |
value |
string |
IP-адрес или диапазон IP-адресов для фильтрации |
IPRuleAction
Действие при сопоставлении IP-адреса клиента.
Имя | Тип | Описание |
---|---|---|
Allow |
string |
Разрешите доступ для соответствующего IP-адреса клиента. |
KeySource
Тип источника ключа.
Имя | Тип | Описание |
---|---|---|
Microsoft.Batch |
string |
Пакетная служба создает ключи шифрования, используемые для защиты данных учетной записи, и управляет ими. |
Microsoft.KeyVault |
string |
Ключи шифрования, используемые для защиты данных учетной записи, хранятся во внешнем хранилище ключей. Если этот параметр задан, для удостоверения учетной записи пакетной службы должно быть задано значение |
KeyVaultProperties
Конфигурация KeyVault при использовании keySource шифрования Microsoft.KeyVault.
Имя | Тип | Описание |
---|---|---|
keyIdentifier |
string |
Полный путь к секрету с версией или без нее. Пример https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. или https://mykeyvault.vault.azure.net/keys/testkey. Чтобы обеспечить возможность использования, необходимо выполнить следующие предварительные требования: Учетная запись пакетной службы имеет удостоверение, назначаемое системой. Удостоверение учетной записи было предоставлено разрешение Key/Get, Key/Unwrap и Key/Wrap( Хранилище ключей имеет обратимое удаление и защиту от очистки) |
KeyVaultReference
Определяет хранилище ключей Azure, связанное с учетной записью пакетной службы.
Имя | Тип | Описание |
---|---|---|
id |
string |
идентификатор ресурса хранилища ключей Azure, связанный с учетной записью пакетной службы. |
url |
string |
URL-адрес хранилища ключей Azure, связанный с учетной записью пакетной службы. |
NetworkProfile
Сетевой профиль для учетной записи пакетной службы, который содержит параметры правил сети для каждой конечной точки.
Имя | Тип | Описание |
---|---|---|
accountAccess |
Endpoint |
Профиль сетевого доступа для конечной точки batchAccount (API плоскости данных учетной записи пакетной службы). |
nodeManagementAccess |
Endpoint |
Профиль доступа к сети для конечной точки nodeManagement (пакетная служба, управляющая вычислительными узлами для пулов пакетной службы). |
PoolAllocationMode
Режим выделения для создания пулов в учетной записи пакетной службы.
Имя | Тип | Описание |
---|---|---|
BatchService |
string |
Пулы будут выделены в подписках, принадлежащих пакетной службе. |
UserSubscription |
string |
Пулы будут выделены в подписке, принадлежащей пользователю. |
PrivateEndpoint
Частная конечная точка подключения к частной конечной точке.
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса ARM частной конечной точки. Это форма /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint}. |
PrivateEndpointConnection
Содержит сведения о ресурсе приватного канала.
Имя | Тип | Описание |
---|---|---|
etag |
string |
ETag ресурса, используемого для операторов параллелизма. |
id |
string |
Идентификатор ресурса. |
name |
string |
Имя ресурса. |
properties.groupIds |
string[] |
Идентификатор группы подключения к частной конечной точке. |
properties.privateEndpoint |
Private |
Идентификатор ресурса ARM частной конечной точки. |
properties.privateLinkServiceConnectionState |
Private |
Состояние подключения службы приватного канала для подключения к частной конечной точке. |
properties.provisioningState |
Private |
Состояние подготовки подключения к частной конечной точке. |
type |
string |
Тип ресурса. |
PrivateEndpointConnectionProvisioningState
Состояние подготовки подключения к частной конечной точке.
Имя | Тип | Описание |
---|---|---|
Cancelled |
string |
Пользователь отменил создание подключения. |
Creating |
string |
Соединение создается. |
Deleting |
string |
Подключение удаляется. |
Failed |
string |
Пользователь запросил обновление подключения, и оно завершилось сбоем. Вы можете повторить операцию обновления. |
Succeeded |
string |
Состояние подключения является окончательным и готово к использованию, если состояние — Утверждено. |
Updating |
string |
Пользователь запросил обновление состояния подключения, но операция обновления еще не завершена. При подключении учетной записи пакетной службы нельзя ссылать на подключение. |
PrivateLinkServiceConnectionState
Состояние подключения службы приватного канала для подключения к частной конечной точке
Имя | Тип | Описание |
---|---|---|
actionsRequired |
string |
Действие, необходимое для состояния частного подключения |
description |
string |
Описание состояния частного подключения |
status |
Private |
Состояние подключения к частной конечной точке учетной записи пакетной службы |
PrivateLinkServiceConnectionStatus
Состояние подключения к частной конечной точке пакетной службы
Имя | Тип | Описание |
---|---|---|
Approved |
string |
Подключение к частной конечной точке утверждено и может использоваться для доступа к учетной записи пакетной службы. |
Disconnected |
string |
Подключение к частной конечной точке отключено и не может использоваться для доступа к учетной записи пакетной службы. |
Pending |
string |
Подключение к частной конечной точке находится в состоянии ожидания и не может использоваться для доступа к учетной записи пакетной службы |
Rejected |
string |
Подключение к частной конечной точке отклонено и не может использоваться для доступа к учетной записи пакетной службы. |
ProvisioningState
Подготовленное состояние ресурса
Имя | Тип | Описание |
---|---|---|
Cancelled |
string |
Последняя операция для учетной записи отменяется. |
Creating |
string |
Создается учетная запись. |
Deleting |
string |
Учетная запись удаляется. |
Failed |
string |
Последняя операция для учетной записи завершается сбоем. |
Invalid |
string |
Учетная запись находится в недопустимом состоянии. |
Succeeded |
string |
Учетная запись создана и готова к использованию. |
PublicNetworkAccessType
Тип сетевого доступа для работы с ресурсами в учетной записи пакетной службы.
Имя | Тип | Описание |
---|---|---|
Disabled |
string |
Отключает общедоступное подключение и включает частное подключение к службе пакетная служба Azure через ресурс частной конечной точки. |
Enabled |
string |
Обеспечивает подключение к пакетная служба Azure через общедоступную службу DNS. |
ResourceIdentityType
Тип удостоверения, используемого для учетной записи пакетной службы.
Имя | Тип | Описание |
---|---|---|
None |
string |
Учетная запись пакетной службы не связана с ней. Настройка |
SystemAssigned |
string |
Учетная запись пакетной службы имеет назначенное системой удостоверение. |
UserAssigned |
string |
Учетная запись пакетной службы имеет удостоверения, назначенные пользователем. |
UserAssignedIdentities
Список связанных удостоверений пользователей.
Имя | Тип | Описание |
---|---|---|
clientId |
string |
Идентификатор клиента удостоверения, назначаемого пользователем. |
principalId |
string |
Идентификатор субъекта удостоверения, назначаемого пользователем. |
VirtualMachineFamilyCoreQuota
Семейство виртуальных машин и связанная с ним квота ядра для учетной записи пакетной службы.
Имя | Тип | Описание |
---|---|---|
coreQuota |
integer |
Квота ядра для семейства виртуальных машин для учетной записи пакетной службы. |
name |
string |
Имя семейства виртуальных машин. |