Batch Account - Get
지정된 Batch 계정에 대한 정보를 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}?api-version=2024-07-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
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-0000-0000000000000). |
api-version
|
query | True |
string |
HTTP 요청과 함께 사용할 API 버전입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
작업이 성공했습니다. 응답에는 Batch 계정 엔터티가 포함됩니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Microsoft Entra OAuth 2.0 인증 코드 흐름
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | Description |
---|---|
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"
}
정의
Name | Description |
---|---|
Authentication |
Batch 계정에 대한 인증 모드입니다. |
Auto |
Batch 서비스에서 자동 스토리지 계정을 관리하는 데 사용할 인증 모드입니다. |
Auto |
Batch 계정과 연결된 자동 스토리지 계정에 대한 정보를 포함합니다. |
Batch |
Azure Batch 계정에 대한 정보를 포함합니다. |
Batch |
구성된 경우 Batch 계정의 ID입니다. 사용자가 Batch 계정 암호화 구성으로 'Microsoft.KeyVault'를 지정하거나 자동 스토리지 인증 모드로 |
Cloud |
Batch 서비스의 오류 응답입니다. |
Cloud |
Batch 서비스의 오류 응답입니다. |
Compute |
컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다. |
Encryption |
Batch 계정 내에서 고객 데이터를 암호화하는 방법을 구성합니다. 기본적으로 계정은 Microsoft 관리형 키를 사용하여 암호화됩니다. 추가 제어를 위해 고객 관리형 키를 대신 사용할 수 있습니다. |
Endpoint |
일치하는 IPRule이 없는 경우의 기본 작업입니다. |
Endpoint |
Batch 엔드포인트에 대한 네트워크 액세스 프로필입니다. |
IPRule |
클라이언트 IP 주소를 필터링하는 규칙입니다. |
IPRule |
클라이언트 IP 주소가 일치하는 경우의 작업입니다. |
Key |
키 원본의 형식입니다. |
Key |
Microsoft.KeyVault의 암호화 KeySource를 사용하는 경우 KeyVault 구성 |
Key |
Batch 계정과 연결된 Azure Key Vault를 식별합니다. |
Network |
각 엔드포인트에 대한 네트워크 규칙 설정을 포함하는 Batch 계정의 네트워크 프로필입니다. |
Pool |
Batch 계정에서 풀을 만들기 위한 할당 모드입니다. |
Private |
프라이빗 엔드포인트 연결의 프라이빗 엔드포인트입니다. |
Private |
프라이빗 링크 리소스에 대한 정보를 포함합니다. |
Private |
프라이빗 엔드포인트 연결의 프로비전 상태입니다. |
Private |
프라이빗 엔드포인트 연결의 프라이빗 링크 서비스 연결 상태입니다. |
Private |
Batch 프라이빗 엔드포인트 연결의 상태입니다. |
Provisioning |
리소스의 프로비전된 상태입니다. |
Public |
Batch 계정의 리소스에서 작동하기 위한 네트워크 액세스 유형입니다. |
Resource |
Batch 계정에 사용되는 ID 유형입니다. |
User |
연결된 사용자 ID 목록입니다. |
Virtual |
Batch 계정에 대한 VM 제품군 및 관련 코어 할당량입니다. |
AuthenticationMode
Batch 계정에 대한 인증 모드입니다.
값 | Description |
---|---|
AAD |
Microsoft Entra ID를 사용하는 인증 모드입니다. |
SharedKey |
공유 키를 사용하는 인증 모드입니다. |
TaskAuthenticationToken |
작업 인증 토큰을 사용하는 인증 모드입니다. |
AutoStorageAuthenticationMode
Batch 서비스에서 자동 스토리지 계정을 관리하는 데 사용할 인증 모드입니다.
값 | Description |
---|---|
BatchAccountManagedIdentity |
Batch 서비스는 Batch 계정에 할당된 관리 ID를 사용하여 자동 스토리지에 대한 요청을 인증합니다. |
StorageKeys |
Batch 서비스는 스토리지 계정 키를 사용하여 자동 스토리지에 대한 요청을 인증합니다. |
AutoStorageProperties
Batch 계정과 연결된 자동 스토리지 계정에 대한 정보를 포함합니다.
Name | 형식 | Default value | Description |
---|---|---|---|
authenticationMode | StorageKeys |
Batch 서비스에서 자동 스토리지 계정을 관리하는 데 사용할 인증 모드입니다. |
|
lastKeySync |
string (date-time) |
스토리지 키가 Batch 계정과 마지막으로 동기화된 UTC 시간입니다. |
|
nodeIdentityReference |
컴퓨팅 노드가 자동 스토리지에 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다. |
||
storageAccountId |
string (arm-id) |
자동 스토리지 계정에 사용할 스토리지 계정의 리소스 ID입니다. |
BatchAccount
Azure Batch 계정에 대한 정보를 포함합니다.
Name | 형식 | Default value | Description |
---|---|---|---|
id |
string |
리소스의 ID입니다. |
|
identity |
Batch 계정의 ID입니다. |
||
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 계정에 대한 Virtual Machine 제품군당 전용 코어 할당량 목록입니다. PoolAllocationMode가 UserSubscription으로 설정된 계정의 경우 이 값이 반환되지 않도록 구독에서 할당량이 관리됩니다. |
||
properties.dedicatedCoreQuotaPerVMFamilyEnforced |
boolean |
이 계정에 대해 Virtual Machine 제품군당 코어 할당량이 적용되는지 여부를 나타내는 값입니다. |
|
properties.encryption |
Batch 계정에 대한 암호화 구성입니다. |
||
properties.keyVaultReference |
Batch 계정과 연결된 Azure Key Vault에 대한 참조입니다. |
||
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 계정의 ID입니다. 사용자가 Batch 계정 암호화 구성으로 'Microsoft.KeyVault'를 지정하거나 자동 스토리지 인증 모드로 ManagedIdentity
선택하는 경우에 사용됩니다.
Name | 형식 | Description |
---|---|---|
principalId |
string |
Batch 계정의 보안 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다. |
tenantId |
string |
Batch 계정과 연결된 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다. |
type |
Batch 계정에 사용되는 ID 유형입니다. |
|
userAssignedIdentities |
<string,
User |
Batch 계정과 연결된 사용자 ID 목록입니다. |
CloudError
Batch 서비스의 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
error |
오류 응답의 본문입니다. |
CloudErrorBody
Batch 서비스의 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다. |
details |
오류에 대한 추가 세부 정보 목록입니다. |
|
message |
string |
사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다. |
target |
string |
특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다. |
ComputeNodeIdentityReference
컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
Name | 형식 | Description |
---|---|---|
resourceId |
string |
사용자 할당 ID의 ARM 리소스 ID입니다. |
EncryptionProperties
Batch 계정 내에서 고객 데이터를 암호화하는 방법을 구성합니다. 기본적으로 계정은 Microsoft 관리형 키를 사용하여 암호화됩니다. 추가 제어를 위해 고객 관리형 키를 대신 사용할 수 있습니다.
Name | 형식 | Description |
---|---|---|
keySource |
키 원본의 형식입니다. |
|
keyVaultProperties |
Microsoft.KeyVault 사용 시 추가 세부 정보 |
EndpointAccessDefaultAction
일치하는 IPRule이 없는 경우의 기본 작업입니다.
값 | Description |
---|---|
Allow |
클라이언트 액세스를 허용합니다. |
Deny |
클라이언트 액세스를 거부합니다. |
EndpointAccessProfile
Batch 엔드포인트에 대한 네트워크 액세스 프로필입니다.
Name | 형식 | Description |
---|---|---|
defaultAction |
일치하는 IPRule이 없는 경우의 기본 작업입니다. |
|
ipRules |
IPRule[] |
클라이언트 IP 주소를 필터링하는 IP 범위의 배열입니다. |
IPRule
클라이언트 IP 주소를 필터링하는 규칙입니다.
Name | 형식 | Description |
---|---|---|
action |
클라이언트 IP 주소가 일치하는 경우의 작업입니다. |
|
value |
string |
필터링할 IP 주소 또는 IP 주소 범위 |
IPRuleAction
클라이언트 IP 주소가 일치하는 경우의 작업입니다.
값 | Description |
---|---|
Allow |
일치하는 클라이언트 IP 주소에 대한 액세스를 허용합니다. |
KeySource
키 원본의 형식입니다.
값 | Description |
---|---|
Microsoft.Batch |
Batch는 계정 데이터를 보호하는 데 사용되는 암호화 키를 만들고 관리합니다. |
Microsoft.KeyVault |
계정 데이터를 보호하는 데 사용되는 암호화 키는 외부 키 자격 증명 모음에 저장됩니다. 이 설정이 설정되면 Batch 계정 ID를 |
KeyVaultProperties
Microsoft.KeyVault의 암호화 KeySource를 사용하는 경우 KeyVault 구성
Name | 형식 | Description |
---|---|---|
keyIdentifier |
string |
버전이 있거나 없는 비밀의 전체 경로입니다. 예제 https://mykeyvault.vault.azure.net/keys/testkey/6e34a81fef704045975661e297a4c053. 또는 https://mykeyvault.vault.azure.net/keys/testkey. 사용 가능하려면 다음 필수 조건을 충족해야 합니다. Batch 계정에 시스템 할당 ID가 있습니다. 계정 ID에 키/가져오기, 키/래핑 해제 및 키/래핑 권한이 부여되었습니다. KeyVault에는 일시 삭제 및 제거 보호가 활성화되어 있습니다. |
KeyVaultReference
Batch 계정과 연결된 Azure Key Vault를 식별합니다.
Name | 형식 | Description |
---|---|---|
id |
string (arm-id) |
Batch 계정과 연결된 Azure Key Vault의 리소스 ID입니다. |
url |
string |
Batch 계정과 연결된 Azure 키 자격 증명 모음의 URL입니다. |
NetworkProfile
각 엔드포인트에 대한 네트워크 규칙 설정을 포함하는 Batch 계정의 네트워크 프로필입니다.
Name | 형식 | Description |
---|---|---|
accountAccess |
batchAccount 엔드포인트에 대한 네트워크 액세스 프로필(Batch 계정 데이터 평면 API). |
|
nodeManagementAccess |
nodeManagement 엔드포인트에 대한 네트워크 액세스 프로필(Batch 풀에 대한 컴퓨팅 노드를 관리하는 Batch 서비스). |
PoolAllocationMode
Batch 계정에서 풀을 만들기 위한 할당 모드입니다.
값 | Description |
---|---|
BatchService |
풀은 Batch 서비스가 소유한 구독에 할당됩니다. |
UserSubscription |
풀은 사용자가 소유한 구독에 할당됩니다. |
PrivateEndpoint
프라이빗 엔드포인트 연결의 프라이빗 엔드포인트입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
프라이빗 엔드포인트의 ARM 리소스 식별자입니다. /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/privateEndpoints/{privateEndpoint}형식입니다. |
PrivateEndpointConnection
프라이빗 링크 리소스에 대한 정보를 포함합니다.
Name | 형식 | Description |
---|---|---|
etag |
string |
동시성 문에 사용되는 리소스의 ETag입니다. |
id |
string |
리소스의 ID입니다. |
name |
string |
리소스의 이름입니다. |
properties.groupIds |
string[] |
프라이빗 엔드포인트 연결의 그룹 ID입니다. |
properties.privateEndpoint |
프라이빗 엔드포인트의 ARM 리소스 식별자입니다. |
|
properties.privateLinkServiceConnectionState |
프라이빗 엔드포인트 연결의 프라이빗 링크 서비스 연결 상태입니다. |
|
properties.provisioningState |
프라이빗 엔드포인트 연결의 프로비전 상태입니다. |
|
tags |
object |
리소스의 태그입니다. |
type |
string |
리소스의 형식입니다. |
PrivateEndpointConnectionProvisioningState
프라이빗 엔드포인트 연결의 프로비전 상태입니다.
값 | Description |
---|---|
Cancelled |
사용자가 연결 만들기를 취소했습니다. |
Creating |
연결이 만들어집니다. |
Deleting |
연결이 삭제되고 있습니다. |
Failed |
사용자가 연결을 업데이트해 달라고 요청했고 연결이 실패했습니다. 업데이트 작업을 다시 시도할 수 있습니다. |
Succeeded |
연결 상태가 최종 상태이며 상태가 승인된 경우 사용할 준비가 된 것입니다. |
Updating |
사용자가 연결 상태를 업데이트해 달라고 요청했지만 업데이트 작업이 아직 완료되지 않았습니다. Batch 계정을 연결할 때 연결을 참조할 수 없습니다. |
PrivateLinkServiceConnectionState
프라이빗 엔드포인트 연결의 프라이빗 링크 서비스 연결 상태입니다.
Name | 형식 | Description |
---|---|---|
actionsRequired |
string |
프라이빗 연결 상태에 필요한 작업 |
description |
string |
프라이빗 연결 상태에 대한 설명 |
status |
Batch 계정의 프라이빗 엔드포인트 연결 상태 |
PrivateLinkServiceConnectionStatus
Batch 프라이빗 엔드포인트 연결의 상태입니다.
값 | Description |
---|---|
Approved |
프라이빗 엔드포인트 연결이 승인되었으며 Batch 계정에 액세스하는 데 사용할 수 있습니다. |
Disconnected |
프라이빗 엔드포인트 연결이 끊어지고 Batch 계정에 액세스하는 데 사용할 수 없습니다. |
Pending |
프라이빗 엔드포인트 연결이 보류 중이며 Batch 계정에 액세스하는 데 사용할 수 없습니다. |
Rejected |
프라이빗 엔드포인트 연결이 거부되어 Batch 계정에 액세스하는 데 사용할 수 없습니다. |
ProvisioningState
리소스의 프로비전된 상태입니다.
값 | Description |
---|---|
Cancelled |
계정에 대한 마지막 작업이 취소됩니다. |
Creating |
계정이 만들어지고 있습니다. |
Deleting |
계정이 삭제되고 있습니다. |
Failed |
계정에 대한 마지막 작업이 실패했습니다. |
Invalid |
계정이 잘못된 상태입니다. |
Succeeded |
계정이 만들어졌으며 사용할 준비가 되었습니다. |
PublicNetworkAccessType
Batch 계정의 리소스에서 작동하기 위한 네트워크 액세스 유형입니다.
값 | Description |
---|---|
Disabled |
공용 연결을 사용하지 않도록 설정하고 프라이빗 엔드포인트 리소스를 통해 Azure Batch 서비스에 대한 프라이빗 연결을 사용하도록 설정합니다. |
Enabled |
공용 DNS를 통해 Azure Batch에 연결할 수 있습니다. |
SecuredByPerimeter |
NSP 구성을 통해 Azure Batch에 대한 연결을 보호합니다. |
ResourceIdentityType
Batch 계정에 사용되는 ID 유형입니다.
값 | Description |
---|---|
None |
Batch 계정에 연결된 ID가 없습니다. 업데이트 계정에서 |
SystemAssigned |
Batch 계정에는 시스템 할당 ID가 있습니다. |
UserAssigned |
Batch 계정에는 사용자 할당 ID가 있습니다. |
UserAssignedIdentities
연결된 사용자 ID 목록입니다.
Name | 형식 | Description |
---|---|---|
clientId |
string |
사용자 할당 ID의 클라이언트 ID입니다. |
principalId |
string |
사용자 할당 ID의 보안 주체 ID입니다. |
VirtualMachineFamilyCoreQuota
Batch 계정에 대한 VM 제품군 및 관련 코어 할당량입니다.
Name | 형식 | Description |
---|---|---|
coreQuota |
integer (int32) |
Batch 계정에 대한 VM 제품군의 핵심 할당량입니다. |
name |
string |
Virtual Machine 패밀리 이름입니다. |