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