你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Batch Account - Get
获取有关指定 Batch 帐户的信息。
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]+$ |
Batch 帐户的名称。 |
resource
|
path | True |
string |
包含 Batch 帐户的资源组的名称。 |
subscription
|
path | True |
string |
Azure 订阅 ID。 这是 GUID 格式的字符串(例如 000000000-0000-0000-00000-000000000000000) |
api-version
|
query | True |
string |
要用于 HTTP 请求的 API 版本。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
操作成功。 响应包含 Batch 帐户实体。 |
|
Other Status Codes |
描述操作失败的原因的错误响应。 |
安全性
azure_auth
Microsoft Entra OAuth 2.0 身份验证代码流
类型:
oauth2
流向:
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 xyz.abc@company.com"
}
}
}
]
},
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct",
"type": "Microsoft.Batch/batchAccounts"
}
定义
名称 | 说明 |
---|---|
Authentication |
Batch 帐户的身份验证模式。 |
Auto |
Batch 服务用于管理自动存储帐户的身份验证模式。 |
Auto |
包含有关与 Batch 帐户关联的自动存储帐户的信息。 |
Batch |
包含有关 Azure Batch 帐户的信息。 |
Batch |
Batch 帐户的标识(如果已配置)。 当用户将“Microsoft.KeyVault”指定为其 Batch 帐户加密配置或选择 |
Cloud |
Batch 服务的错误响应。 |
Cloud |
Batch 服务的错误响应。 |
Compute |
对与计算节点将使用的 Batch 池关联的用户分配标识的引用。 |
Encryption |
配置客户数据在 Batch 帐户内加密的方式。 默认情况下,帐户使用Microsoft托管密钥进行加密。 对于其他控制,可以改用客户管理的密钥。 |
Endpoint |
未匹配 IPRule 时的默认操作。 |
Endpoint |
Batch 终结点的网络访问配置文件。 |
IPRule |
用于筛选客户端 IP 地址的规则。 |
IPRule |
匹配客户端 IP 地址时的操作。 |
Key |
密钥源的类型。 |
Key |
使用 Microsoft.KeyVault 的加密密钥来源时,KeyVault 配置。 |
Key |
标识与 Batch 帐户关联的 Azure 密钥保管库。 |
Network |
Batch 帐户的网络配置文件,其中包含每个终结点的网络规则设置。 |
Pool |
用于在 Batch 帐户中创建池的分配模式。 |
Private |
专用终结点连接的专用终结点。 |
Private |
包含有关专用链接资源的信息。 |
Private |
专用终结点连接的预配状态。 |
Private |
专用终结点连接的专用链接服务连接状态 |
Private |
Batch 专用终结点连接的状态 |
Provisioning |
资源的预配状态 |
Public |
用于在 Batch 帐户中的资源上运行的网络访问类型。 |
Resource |
用于 Batch 帐户的标识类型。 |
User |
关联的用户标识列表。 |
Virtual |
VM 系列及其 Batch 帐户的相关核心配额。 |
AuthenticationMode
Batch 帐户的身份验证模式。
值 | 说明 |
---|---|
AAD |
使用 Microsoft Entra ID 的身份验证模式。 |
SharedKey |
使用共享密钥的身份验证模式。 |
TaskAuthenticationToken |
使用任务身份验证令牌的身份验证模式。 |
AutoStorageAuthenticationMode
Batch 服务用于管理自动存储帐户的身份验证模式。
值 | 说明 |
---|---|
BatchAccountManagedIdentity |
Batch 服务将使用分配给 Batch 帐户的托管标识对自动存储的请求进行身份验证。 |
StorageKeys |
Batch 服务将使用存储帐户密钥对自动存储的请求进行身份验证。 |
AutoStorageProperties
包含有关与 Batch 帐户关联的自动存储帐户的信息。
名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
authenticationMode | StorageKeys |
Batch 服务用于管理自动存储帐户的身份验证模式。 |
|
lastKeySync |
string (date-time) |
上次与 Batch 帐户同步存储密钥的 UTC 时间。 |
|
nodeIdentityReference |
对用户分配的标识的引用,计算节点将使用该标识来访问自动存储。 |
||
storageAccountId |
string (arm-id) |
要用于自动存储帐户的存储帐户的资源 ID。 |
BatchAccount
包含有关 Azure Batch 帐户的信息。
名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
id |
string |
资源的 ID。 |
|
identity |
Batch 帐户的标识。 |
||
location |
string |
资源的位置。 |
|
name |
string |
资源的名称。 |
|
properties.accountEndpoint |
string |
用于与 Batch 服务交互的帐户终结点。 |
|
properties.activeJobAndJobScheduleQuota |
integer (int32) |
Batch 帐户的活动作业和作业计划配额。 |
|
properties.allowedAuthenticationModes |
可用于向数据平面进行身份验证的 Batch 帐户允许的身份验证模式列表。 这不会影响控制平面的身份验证。 |
||
properties.autoStorage |
与 Batch 帐户关联的任何自动存储帐户的属性和状态。 |
||
properties.dedicatedCoreQuota |
integer (int32) |
Batch 帐户的专用核心配额。 |
|
properties.dedicatedCoreQuotaPerVMFamily |
Batch 帐户的每个虚拟机系列专用核心配额列表。 对于 PoolAllocationMode 设置为 UserSubscription 的帐户,配额在订阅上进行管理,因此不会返回此值。 |
||
properties.dedicatedCoreQuotaPerVMFamilyEnforced |
boolean |
一个值,该值指示是否为此帐户强制实施每个虚拟机系列的核心配额 |
|
properties.encryption |
Batch 帐户的加密配置。 |
||
properties.keyVaultReference |
对与 Batch 帐户关联的 Azure 密钥保管库的引用。 |
||
properties.lowPriorityCoreQuota |
integer (int32) |
Batch 帐户的现成/低优先级核心配额。 |
|
properties.networkProfile |
Batch 帐户的网络配置文件,其中包含每个终结点的网络规则设置。 |
||
properties.nodeManagementEndpoint |
string |
计算节点用于连接到 Batch 节点管理服务的终结点。 |
|
properties.poolAllocationMode |
用于在 Batch 帐户中创建池的分配模式。 |
||
properties.poolQuota |
integer (int32) |
Batch 帐户的池配额。 |
|
properties.privateEndpointConnections |
与 Batch 帐户关联的专用终结点连接列表 |
||
properties.provisioningState |
资源的预配状态 |
||
properties.publicNetworkAccess | Enabled |
用于访问 Azure Batch 服务和 Batch 帐户操作的网络接口类型。 |
|
tags |
object |
资源的标记。 |
|
type |
string |
资源的类型。 |
BatchAccountIdentity
Batch 帐户的标识(如果已配置)。 当用户将“Microsoft.KeyVault”指定为其 Batch 帐户加密配置或选择 ManagedIdentity
作为自动存储身份验证模式时,则使用此方法。
名称 | 类型 | 说明 |
---|---|---|
principalId |
string |
Batch 帐户的主体 ID。 此属性仅针对系统分配的标识提供。 |
tenantId |
string |
与 Batch 帐户关联的租户 ID。 此属性仅针对系统分配的标识提供。 |
type |
用于 Batch 帐户的标识类型。 |
|
userAssignedIdentities |
<string,
User |
与 Batch 帐户关联的用户标识列表。 |
CloudError
Batch 服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
错误响应的正文。 |
CloudErrorBody
Batch 服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误的标识符。 代码是固定的,旨在以编程方式使用。 |
details |
有关错误的其他详细信息的列表。 |
|
message |
string |
描述错误的消息,旨在适合在用户界面中显示。 |
target |
string |
特定错误的目标。 例如,错误属性的名称。 |
ComputeNodeIdentityReference
对与计算节点将使用的 Batch 池关联的用户分配标识的引用。
名称 | 类型 | 说明 |
---|---|---|
resourceId |
string |
用户分配标识的 ARM 资源 ID。 |
EncryptionProperties
配置客户数据在 Batch 帐户内加密的方式。 默认情况下,帐户使用Microsoft托管密钥进行加密。 对于其他控制,可以改用客户管理的密钥。
名称 | 类型 | 说明 |
---|---|---|
keySource |
密钥源的类型。 |
|
keyVaultProperties |
使用 Microsoft.KeyVault 时的更多详细信息 |
EndpointAccessDefaultAction
未匹配 IPRule 时的默认操作。
值 | 说明 |
---|---|
Allow |
允许客户端访问。 |
Deny |
拒绝客户端访问。 |
EndpointAccessProfile
Batch 终结点的网络访问配置文件。
名称 | 类型 | 说明 |
---|---|---|
defaultAction |
未匹配 IPRule 时的默认操作。 |
|
ipRules |
IPRule[] |
要筛选客户端 IP 地址的 IP 范围的数组。 |
IPRule
用于筛选客户端 IP 地址的规则。
名称 | 类型 | 说明 |
---|---|---|
action |
匹配客户端 IP 地址时的操作。 |
|
value |
string |
要筛选的 IP 地址或 IP 地址范围 |
IPRuleAction
匹配客户端 IP 地址时的操作。
值 | 说明 |
---|---|
Allow |
允许访问匹配的客户端 IP 地址。 |
KeySource
密钥源的类型。
值 | 说明 |
---|---|
Microsoft.Batch |
Batch 创建和管理用于保护帐户数据的加密密钥。 |
Microsoft.KeyVault |
用于保护帐户数据的加密密钥存储在外部密钥保管库中。 如果已设置,则必须将 Batch 帐户标识设置为 |
KeyVaultProperties
使用 Microsoft.KeyVault 的加密密钥来源时,KeyVault 配置。
名称 | 类型 | 说明 |
---|---|---|
keyIdentifier |
string |
包含或不使用版本机密的完整路径。 示例 https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053。 或 https://mykeyvault.vault.azure.net/keys/testkey。 若要可用,必须满足以下先决条件: Batch 帐户具有系统分配标识。帐户标识已被授予密钥/获取、密钥/解包和密钥/包装权限。KeyVault 已启用软删除和清除保护 |
KeyVaultReference
标识与 Batch 帐户关联的 Azure 密钥保管库。
名称 | 类型 | 说明 |
---|---|---|
id |
string (arm-id) |
与 Batch 帐户关联的 Azure 密钥保管库的资源 ID。 |
url |
string |
与 Batch 帐户关联的 Azure 密钥保管库的 URL。 |
NetworkProfile
Batch 帐户的网络配置文件,其中包含每个终结点的网络规则设置。
名称 | 类型 | 说明 |
---|---|---|
accountAccess |
batchAccount 终结点的网络访问配置文件(Batch 帐户数据平面 API)。 |
|
nodeManagementAccess |
nodeManagement 终结点的网络访问配置文件(Batch 服务管理 Batch 池的计算节点)。 |
PoolAllocationMode
用于在 Batch 帐户中创建池的分配模式。
值 | 说明 |
---|---|
BatchService |
池将在 Batch 服务拥有的订阅中分配。 |
UserSubscription |
池将在用户拥有的订阅中分配。 |
PrivateEndpoint
专用终结点连接的专用终结点。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
专用终结点的 ARM 资源标识符。 此格式为 /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint}。 |
PrivateEndpointConnection
包含有关专用链接资源的信息。
名称 | 类型 | 说明 |
---|---|---|
etag |
string |
资源的 ETag,用于并发语句。 |
id |
string |
资源的 ID。 |
name |
string |
资源的名称。 |
properties.groupIds |
string[] |
专用终结点连接的组 ID。 |
properties.privateEndpoint |
专用终结点的 ARM 资源标识符。 |
|
properties.privateLinkServiceConnectionState |
专用终结点连接的专用链接服务连接状态。 |
|
properties.provisioningState |
专用终结点连接的预配状态。 |
|
tags |
object |
资源的标记。 |
type |
string |
资源的类型。 |
PrivateEndpointConnectionProvisioningState
专用终结点连接的预配状态。
值 | 说明 |
---|---|
Cancelled |
用户已取消连接创建。 |
Creating |
正在创建连接。 |
Deleting |
正在删除连接。 |
Failed |
用户请求更新连接并失败。 可以重试更新操作。 |
Succeeded |
连接状态为最终状态,如果状态已批准,则可供使用。 |
Updating |
用户已请求更新连接状态,但更新操作尚未完成。 连接 Batch 帐户时,可能无法引用连接。 |
PrivateLinkServiceConnectionState
专用终结点连接的专用链接服务连接状态
名称 | 类型 | 说明 |
---|---|---|
actionsRequired |
string |
专用连接状态所需的操作 |
description |
string |
专用连接状态的说明 |
status |
Batch 帐户的专用终结点连接的状态 |
PrivateLinkServiceConnectionStatus
Batch 专用终结点连接的状态
值 | 说明 |
---|---|
Approved |
专用终结点连接已获批准,可用于访问 Batch 帐户 |
Disconnected |
专用终结点连接已断开连接,不能用于访问 Batch 帐户 |
Pending |
专用终结点连接挂起,不能用于访问 Batch 帐户 |
Rejected |
专用终结点连接被拒绝,不能用于访问 Batch 帐户 |
ProvisioningState
资源的预配状态
值 | 说明 |
---|---|
Cancelled |
取消帐户的最后一个操作。 |
Creating |
正在创建帐户。 |
Deleting |
正在删除该帐户。 |
Failed |
帐户的最后一次操作失败。 |
Invalid |
帐户处于无效状态。 |
Succeeded |
帐户已创建并可供使用。 |
PublicNetworkAccessType
用于在 Batch 帐户中的资源上运行的网络访问类型。
值 | 说明 |
---|---|
Disabled |
禁用公共连接,并通过专用终结点资源启用与 Azure Batch 服务的专用连接。 |
Enabled |
允许通过公共 DNS 连接到 Azure Batch。 |
SecuredByPerimeter |
通过 NSP 配置保护与 Azure Batch 的连接。 |
ResourceIdentityType
用于 Batch 帐户的标识类型。
值 | 说明 |
---|---|
None |
Batch 帐户没有与之关联的标识。 在更新帐户中设置 |
SystemAssigned |
Batch 帐户具有系统分配的标识。 |
UserAssigned |
Batch 帐户具有用户分配的标识。 |
UserAssignedIdentities
关联的用户标识列表。
名称 | 类型 | 说明 |
---|---|---|
clientId |
string |
用户分配标识的客户端 ID。 |
principalId |
string |
用户分配标识的主体 ID。 |
VirtualMachineFamilyCoreQuota
VM 系列及其 Batch 帐户的相关核心配额。
名称 | 类型 | 说明 |
---|---|---|
coreQuota |
integer (int32) |
Batch 帐户的 VM 系列的核心配额。 |
name |
string |
虚拟机系列名称。 |