Batch Deployments - List

서비스:: Machine Learning

API 버전:: 2025-12-01

작업 영역의 Batch 유추 배포를 나열합니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/batchEndpoints/{endpointName}/deployments?api-version=2025-12-01

선택적 매개 변수:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/batchEndpoints/{endpointName}/deployments?api-version=2025-12-01&$orderBy={$orderBy}&$top={$top}&$skip={$skip}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpointName	path	True	string	Batch 엔드포인트의 이름입니다.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Azure Machine Learning 작업 영역 이름
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.
$orderBy	query		string	목록의 순서입니다.
$skip	query		string	페이지 매김에 대한 연속 토큰입니다.
$top	query		integer (int32)	목록의 맨 위입니다.

응답

Name	형식	Description
200 OK	BatchDeploymentTrackedResourceArmPaginatedResult	Azure 작업이 성공적으로 완료되었습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

List Workspace Batch Deployment.

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/batchEndpoints/testEndpointName/deployments?api-version=2025-12-01&$orderBy=string&$top=1

샘플 응답

상태 코드:: 200

{
  "nextLink": "https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/batchEndpoints/testEndpointName/deployments?api-version=2025-07-01-preview&$skip=2",
  "value": [
    {
      "name": "string",
      "type": "string",
      "id": "string",
      "identity": {
        "type": "SystemAssigned",
        "principalId": "00000000-1111-2222-3333-444444444444",
        "tenantId": "00000000-1111-2222-3333-444444444444",
        "userAssignedIdentities": {
          "string": {
            "clientId": "00000000-1111-2222-3333-444444444444",
            "principalId": "00000000-1111-2222-3333-444444444444"
          }
        }
      },
      "kind": "string",
      "location": "string",
      "properties": {
        "description": "string",
        "codeConfiguration": {
          "codeId": "string",
          "scoringScript": "string"
        },
        "compute": "string",
        "environmentId": "string",
        "environmentVariables": {
          "string": "string"
        },
        "errorThreshold": 1,
        "loggingLevel": "Info",
        "maxConcurrencyPerInstance": 1,
        "miniBatchSize": 1,
        "model": {
          "assetId": "string",
          "referenceType": "Id"
        },
        "outputAction": "SummaryOnly",
        "outputFileName": "string",
        "properties": {
          "string": "string"
        },
        "provisioningState": "Creating",
        "resources": {
          "instanceCount": 1,
          "instanceType": "string",
          "properties": {
            "string": {
              "a3c13e2e-a213-4cac-9f5a-b49966906ad6": null
            }
          }
        },
        "retrySettings": {
          "maxRetries": 1,
          "timeout": "PT5M"
        }
      },
      "sku": {
        "name": "string",
        "capacity": 1,
        "family": "string",
        "size": "string",
        "tier": "Free"
      },
      "systemData": {
        "createdAt": "2020-01-01T12:34:56.999Z",
        "createdBy": "string",
        "createdByType": "User",
        "lastModifiedAt": "2020-01-01T12:34:56.999Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "User"
      },
      "tags": {}
    }
  ]
}

정의

Name	Description
BatchDeployment	구체적인 추적된 리소스 종류는 특정 속성 형식을 사용하여 이 형식의 별칭을 지정하여 만들 수 있습니다.
BatchDeploymentConfigurationType	일괄 처리 배포에 대한 열거된 속성 형식입니다.
BatchDeploymentProperties	배포당 일괄 처리 추론 설정입니다.
BatchDeploymentTrackedResourceArmPaginatedResult	페이지를 매긴 BatchDeployment 엔터티 목록입니다.
BatchLoggingLevel	일괄 처리 유추에 대한 자세한 정보를 기록합니다. 로깅에 대한 자세한 순서를 늘리는 것은 경고, 정보 및 디버그입니다. 기본값은 Info입니다.
BatchOutputAction	일괄 처리 유추가 출력을 처리하는 방법을 결정하는 열거형
BatchPipelineComponentDeploymentConfiguration	배치 파이프라인 구성 요소 배포에 대한 속성입니다.
BatchRetrySettings	배치 추론 작업에 대한 설정을 다시 시도합니다.
CodeConfiguration	스코어링 코드 자산에 대한 구성입니다.
createdByType	리소스를 만든 ID의 형식입니다.
DataPathAssetReference	데이터 저장소의 경로를 통해 자산에 대한 참조입니다.
DeploymentProvisioningState	DeploymentProvisioningState에 사용할 수 있는 값입니다.
DeploymentResourceConfiguration
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
IdAssetReference	ARM 리소스 ID를 통한 자산에 대한 참조입니다.
ManagedServiceIdentity	관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)
ManagedServiceIdentityType	관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).
OutputPathAssetReference	작업 출력의 경로를 통해 자산에 대한 참조입니다.
ReferenceType	자산에 사용할 참조 방법을 결정하는 열거형입니다.
Sku	SKU를 나타내는 리소스 모델 정의
SkuTier	이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
UserAssignedIdentity	사용자 할당 ID 속성

BatchDeployment

Object

구체적인 추적된 리소스 종류는 특정 속성 형식을 사용하여 이 형식의 별칭을 지정하여 만들 수 있습니다.

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)
kind	string	포털/도구/등에서 동일한 형식의 리소스에 대해 다른 UX 환경을 렌더링하는 데 사용되는 메타데이터입니다.
location	string	리소스가 있는 지리적 위치
name	string	리소스의 이름
properties	BatchDeploymentProperties	[필수] 엔터티의 추가 특성입니다.
sku	Sku	자동 크기 조정을 위한 ARM 계약에 필요한 SKU 세부 정보입니다.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스 태그.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

BatchDeploymentConfigurationType

열거형

일괄 처리 배포에 대한 열거된 속성 형식입니다.

값	Description
Model
PipelineComponent

BatchDeploymentProperties

Object

배포당 일괄 처리 추론 설정입니다.

Name	형식	Default value	Description
codeConfiguration	CodeConfiguration		엔드포인트 배포에 대한 코드 구성입니다.
compute	string		일괄 처리 유추 작업의 컴퓨팅 대상입니다.
deploymentConfiguration	BatchDeploymentConfiguration: BatchPipelineComponentDeploymentConfiguration		다양한 배포 유형과 관련된 속성입니다.
description	string		엔드포인트 배포에 대한 설명입니다.
environmentId	string		엔드포인트 배포에 대한 환경 사양의 ARM 리소스 ID 또는 AssetId입니다.
environmentVariables	object		배포에 대한 환경 변수 구성입니다.
errorThreshold	integer (int32)	-1	오류 임계값, 전체 입력에 대한 오류 수가 이 값을 초과하면 배치 유추가 중단됩니다. 범위는 [-1, int입니다. MaxValue]. FileDataset의 경우 이 값은 파일 오류 수입니다. TabularDataset의 경우 이 값은 레코드 오류의 수입니다. -1(하한)로 설정하면 일괄 처리 유추 중 모든 오류가 무시됩니다.
loggingLevel	BatchLoggingLevel	Info	일괄 처리 유추에 대한 자세한 정보를 기록합니다. 로깅에 대한 자세한 순서를 늘리는 것은 경고, 정보 및 디버그입니다. 기본값은 Info입니다.
maxConcurrencyPerInstance	integer (int32)	1	인스턴스당 최대 병렬 처리 수를 나타냅니다.
miniBatchSize	integer (int64)	10	각 일괄 처리 호출에 전달된 미니 일괄 처리의 크기입니다. FileDataset의 경우 미니 일괄 처리당 파일 수입니다. TabularDataset의 경우 미니 일괄 처리당 레코드 크기(바이트)입니다.
model	AssetReferenceBase: DataPathAssetReference IdAssetReference OutputPathAssetReference		엔드포인트 배포에 대한 모델 자산에 대한 참조입니다.
outputAction	BatchOutputAction	AppendRow	일괄 처리 유추가 출력을 처리하는 방법을 결정하는 열거형
outputFileName	string	predictions.csv	append_row 출력 작업에 대한 사용자 지정된 출력 파일 이름입니다.
properties	object		속성 사전입니다. 속성을 추가할 수 있지만 제거하거나 변경할 수는 없습니다.
provisioningState	DeploymentProvisioningState		엔드포인트 배포에 대한 프로비저닝 상태입니다.
resources	DeploymentResourceConfiguration		작업에 대한 컴퓨팅 구성을 나타냅니다. 제공되지 않으면 기본적으로 ResourceConfiguration에 정의된 기본값으로 설정됩니다.
retrySettings	BatchRetrySettings		일괄 처리 유추 작업에 대한 다시 시도 설정입니다. 제공되지 않으면 기본적으로 BatchRetrySettings에 정의된 기본값으로 설정됩니다.

BatchDeploymentTrackedResourceArmPaginatedResult

Object

페이지를 매긴 BatchDeployment 엔터티 목록입니다.

Name	형식	Description
nextLink	string (uri)	항목의 다음 페이지에 대한 링크
value	BatchDeployment[]	이 페이지의 배치 배치 항목들

BatchLoggingLevel

열거형

일괄 처리 유추에 대한 자세한 정보를 기록합니다. 로깅에 대한 자세한 순서를 늘리는 것은 경고, 정보 및 디버그입니다. 기본값은 Info입니다.

값	Description
Info
Warning
Debug

BatchOutputAction

열거형

일괄 처리 유추가 출력을 처리하는 방법을 결정하는 열거형

값	Description
SummaryOnly
AppendRow

BatchPipelineComponentDeploymentConfiguration

Object

배치 파이프라인 구성 요소 배포에 대한 속성입니다.

Name	형식	Description
componentId	IdAssetReference	실행할 구성 요소의 ARM ID입니다.
deploymentConfigurationType	string: PipelineComponent	[필수] 배포 유형
description	string	작업에 적용할 설명입니다.
settings	object	파이프라인 작업에 대한 런타임 설정입니다.
tags	object	작업에 적용할 태그입니다.

BatchRetrySettings

Object

배치 추론 작업에 대한 설정을 다시 시도합니다.

Name	형식	Default value	Description
maxRetries	integer (int32)	3	미니 일괄 처리에 대한 최대 재시도 횟수
timeout	string (duration)	PT30S	ISO 8601 형식의 미니 일괄 처리에 대한 호출 시간 제한입니다.

CodeConfiguration

Object

스코어링 코드 자산에 대한 구성입니다.

Name	형식	Description
codeId	string	코드 자산의 ARM 리소스 ID입니다.
scoringScript	string minLength: 1 pattern: [a-zA-Z0-9_]	[필수] 시작할 때 실행할 스크립트입니다. eg. "score.py"

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

DataPathAssetReference

Object

데이터 저장소의 경로를 통해 자산에 대한 참조입니다.

Name	형식	Description
datastoreId	string	자산이 있는 데이터 저장소의 ARM 리소스 ID입니다.
path	string	데이터 저장소의 파일/디렉터리의 경로입니다.
referenceType	string: DataPath	[필수] 자산 참조의 형식을 지정합니다.

DeploymentProvisioningState

열거형

DeploymentProvisioningState에 사용할 수 있는 값입니다.

값	Description
Creating
Deleting
Scaling
Updating
Succeeded
Failed
Canceled

DeploymentResourceConfiguration

Object

Name	형식	Default value	Description
instanceCount	integer (int32)	1	컴퓨팅 대상에서 사용하는 인스턴스 또는 노드의 선택적 수입니다.
instanceType	string		컴퓨팅 대상에서 지원하는 VM의 선택적 형식입니다.
properties			추가 속성 모음.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

IdAssetReference

Object

ARM 리소스 ID를 통한 자산에 대한 참조입니다.

Name	형식	Description
assetId	string minLength: 1 pattern: [a-zA-Z0-9_]	[필수] 자산의 ARM 리소스 ID입니다.
referenceType	string: Id	[필수] 자산 참조의 형식을 지정합니다.

ManagedServiceIdentity

Object

관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)

Name	형식	Description
principalId	string (uuid)	시스템 할당 ID의 서비스 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
tenantId	string (uuid)	시스템 할당 ID의 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
type	ManagedServiceIdentityType	관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned ID 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.

ManagedServiceIdentityType

열거형

관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).

값	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

OutputPathAssetReference

Object

작업 출력의 경로를 통해 자산에 대한 참조입니다.

Name	형식	Description
jobId	string	작업의 ARM 리소스 ID입니다.
path	string	작업 출력에 있는 파일/디렉터리의 경로입니다.
referenceType	string: OutputPath	[필수] 자산 참조의 형식을 지정합니다.

ReferenceType

열거형

자산에 사용할 참조 방법을 결정하는 열거형입니다.

값	Description
Id
DataPath
OutputPath

Sku

Object

SKU를 나타내는 리소스 모델 정의

Name	형식	Description
capacity	integer (int32)	SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다.
family	string	서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다.
name	string	SKU의 이름입니다. 예 - P3. 일반적으로 letter+number 코드입니다.
size	string	SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다.
tier	SkuTier	이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다.

SkuTier

열거형

이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다.

값	Description
Free
Basic
Standard
Premium

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

UserAssignedIdentity

Object

사용자 할당 ID 속성

Name	형식	Description
clientId	string (uuid)	할당된 ID의 클라이언트 ID입니다.
principalId	string (uuid)	할당된 ID의 보안 주체 ID입니다.

다음을 통해 공유

Batch Deployments - List

URI 매개 변수

응답

보안

azure_auth

범위

예제

List Workspace Batch Deployment.

샘플 요청

샘플 응답

정의

BatchDeployment

BatchDeploymentConfigurationType

BatchDeploymentProperties

BatchDeploymentTrackedResourceArmPaginatedResult

BatchLoggingLevel

BatchOutputAction

BatchPipelineComponentDeploymentConfiguration

BatchRetrySettings

CodeConfiguration

createdByType

DataPathAssetReference

DeploymentProvisioningState

DeploymentResourceConfiguration

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IdAssetReference

ManagedServiceIdentity

ManagedServiceIdentityType

OutputPathAssetReference

ReferenceType

Sku

SkuTier

systemData

UserAssignedIdentity