Online Deployments - List

서비스:: Machine Learning

API 버전:: 2025-12-01

추론 엔드포인트 배포를 나열합니다.

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

선택적 매개 변수:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpointName	path	True	string	온라인 엔드포인트 이름입니다.
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	OnlineDeploymentTrackedResourceArmPaginatedResult	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 Online Deployments.

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/onlineEndpoints/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/onlineEndpoints/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",
        "appInsightsEnabled": false,
        "codeConfiguration": {
          "codeId": "string",
          "scoringScript": "string"
        },
        "containerResourceRequirements": {
          "containerResourceLimits": {
            "cpu": "\"1\"",
            "gpu": "\"1\"",
            "memory": "\"2Gi\""
          },
          "containerResourceRequests": {
            "cpu": "\"1\"",
            "gpu": "\"1\"",
            "memory": "\"2Gi\""
          }
        },
        "endpointComputeType": "Kubernetes",
        "environmentId": "string",
        "environmentVariables": {
          "string": "string"
        },
        "instanceType": "string",
        "livenessProbe": {
          "failureThreshold": 1,
          "initialDelay": "PT5M",
          "period": "PT5M",
          "successThreshold": 1,
          "timeout": "PT5M"
        },
        "model": "string",
        "modelMountPath": "string",
        "properties": {
          "string": "string"
        },
        "provisioningState": "Creating",
        "requestSettings": {
          "maxConcurrentRequestsPerInstance": 1,
          "maxQueueWait": "PT5M",
          "requestTimeout": "PT5M"
        },
        "scaleSettings": {
          "scaleType": "Default"
        }
      },
      "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
CodeConfiguration	스코어링 코드 자산에 대한 구성입니다.
Collection
ContainerResourceRequirements	온라인 배포 내의 각 컨테이너 인스턴스에 대한 리소스 요구 사항입니다.
ContainerResourceSettings
createdByType	리소스를 만든 ID의 형식입니다.
DataCollectionMode	데이터 수집을 사용하거나 사용하지 않도록 설정합니다.
DataCollector
DefaultScaleSettings
DeploymentProvisioningState	DeploymentProvisioningState에 사용할 수 있는 값입니다.
EgressPublicNetworkAccessType	배포의 송신에 대해 PublicNetworkAccess가 사용 또는 사용 안 함인지 여부를 결정하는 열거형입니다.
EndpointComputeType	엔드포인트 컴퓨팅 유형을 결정하는 열거형입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
KubernetesOnlineDeployment	KubernetesOnlineDeployment와 관련된 속성입니다.
ManagedOnlineDeployment	ManagedOnlineDeployment와 관련된 속성입니다.
ManagedServiceIdentity	관리 서비스 ID(시스템 할당 및/또는 사용자 할당 ID)
ManagedServiceIdentityType	관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우).
OnlineDeployment	구체적인 추적된 리소스 종류는 특정 속성 형식을 사용하여 이 형식의 별칭을 지정하여 만들 수 있습니다.
OnlineDeploymentTrackedResourceArmPaginatedResult	페이지를 매긴 OnlineDeployment 엔터티 목록입니다.
OnlineRequestSettings	온라인 배포 점수 매기기 요청 구성
ProbeSettings	배포 컨테이너 활동성/준비 상태 프로브 구성.
RequestLogging
RollingRateType	모델 데이터가 Blob Storage에 수집되는 경우 단일 Blob 파일에서 모든 데이터를 로깅하지 않도록 데이터를 다른 경로로 롤백해야 합니다. 롤링 속도가 시간인 경우 모든 데이터가 Blob 경로 /yyyy/MM/dd/HH/에 수집됩니다. 날짜인 경우 모든 데이터가 Blob 경로 /yyyy/MM/dd/에서 수집됩니다. 롤링 경로의 다른 이점은 모델 모니터링 UI가 데이터의 시간 범위를 매우 빠르게 선택할 수 있다는 것입니다.
ScaleType
Sku	SKU를 나타내는 리소스 모델 정의
SkuTier	이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
TargetUtilizationScaleSettings
UserAssignedIdentity	사용자 할당 ID 속성

CodeConfiguration

Object

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

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

Collection

Object

Name	형식	Default value	Description
clientId	string		Blob Storage에 대한 로깅을 수집하는 데 사용되는 msi 클라이언트 ID입니다. null인 경우 백 엔드는 인증할 등록된 엔드포인트 ID를 선택합니다.
dataCollectionMode	DataCollectionMode	Disabled	데이터 수집을 사용하거나 사용하지 않도록 설정합니다.
dataId	string		데이터 자산 arm 리소스 ID입니다. 클라이언트 쪽에서는 데이터 자산이 Blob Storage를 가리키도록 하고 백 엔드는 Blob Storage에 데이터를 수집합니다.
samplingRate	number (double)	1	컬렉션에 대한 샘플링 속도입니다. 샘플링 속도 1.0은 기본적으로 100% 데이터를 수집한다는 것을 의미합니다.

ContainerResourceRequirements

Object

온라인 배포 내의 각 컨테이너 인스턴스에 대한 리소스 요구 사항입니다.

Name	형식	Description
containerResourceLimits	ContainerResourceSettings	컨테이너 리소스 제한 정보:
containerResourceRequests	ContainerResourceSettings	컨테이너 리소스 요청 정보:

ContainerResourceSettings

Object

Name	형식	Description
cpu	string	컨테이너에 대한 vCPU 요청/제한 수입니다. 추가 정보: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/
gpu	string	컨테이너에 대한 Nvidia GPU 카드 요청/제한 수입니다. 추가 정보: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/
memory	string	컨테이너에 대한 메모리 크기 요청/제한입니다. 추가 정보: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/

createdByType

열거형

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

값	Description
User
Application
ManagedIdentity
Key

DataCollectionMode

열거형

데이터 수집을 사용하거나 사용하지 않도록 설정합니다.

값	Description
Enabled
Disabled

DataCollector

Object

Name	형식	Default value	Description
collections	<string, Collection>		[필수] 컬렉션 구성입니다. 각 컬렉션에는 모델 데이터를 수집하기 위한 자체 구성이 있으며 컬렉션 이름은 임의의 문자열일 수 있습니다. 모델 데이터 수집기는 페이로드 로깅 또는 사용자 지정 로깅 또는 둘 다에 사용할 수 있습니다. 컬렉션 요청 및 응답은 페이로드 로깅을 위해 예약되고, 다른 요청은 사용자 지정 로깅용입니다.
requestLogging	RequestLogging		mdc에 대한 요청 로깅 구성에는 모든 컬렉션에 대한 고급 로깅 설정이 포함됩니다. 선택 사항입니다.
rollingRate	RollingRateType	Hour	모델 데이터가 Blob Storage에 수집되는 경우 단일 Blob 파일에서 모든 데이터를 로깅하지 않도록 데이터를 다른 경로로 롤백해야 합니다. 롤링 속도가 시간인 경우 모든 데이터가 Blob 경로 /yyyy/MM/dd/HH/에 수집됩니다. 날짜인 경우 모든 데이터가 Blob 경로 /yyyy/MM/dd/에서 수집됩니다. 롤링 경로의 다른 이점은 모델 모니터링 UI가 데이터의 시간 범위를 매우 빠르게 선택할 수 있다는 것입니다.

DefaultScaleSettings

Object

Name	형식	Description
scaleType	string: Default	[필수] 배포 크기 조정 알고리즘의 유형

DeploymentProvisioningState

열거형

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

값	Description
Creating
Deleting
Scaling
Updating
Succeeded
Failed
Canceled

EgressPublicNetworkAccessType

열거형

배포의 송신에 대해 PublicNetworkAccess가 사용 또는 사용 안 함인지 여부를 결정하는 열거형입니다.

값	Description
Enabled
Disabled

EndpointComputeType

열거형

엔드포인트 컴퓨팅 유형을 결정하는 열거형입니다.

값	Description
Managed
Kubernetes
AzureMLCompute

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	오류 개체입니다.

KubernetesOnlineDeployment

Object

KubernetesOnlineDeployment와 관련된 속성입니다.

Name	형식	Default value	Description
appInsightsEnabled	boolean	False	true이면 Application Insights 로깅을 사용하도록 설정합니다.
codeConfiguration	CodeConfiguration		엔드포인트 배포에 대한 코드 구성입니다.
containerResourceRequirements	ContainerResourceRequirements		컨테이너(cpu 및 메모리)에 대한 리소스 요구 사항입니다.
dataCollector	DataCollector		mdc 구성은 null일 때 mdc를 사용하지 않도록 설정합니다.
description	string		엔드포인트 배포에 대한 설명입니다.
egressPublicNetworkAccess	EgressPublicNetworkAccessType	Enabled	배포의 송신에 대해 PublicNetworkAccess가 사용 또는 사용 안 함인지 여부를 결정하는 열거형입니다.
endpointComputeType	string: Kubernetes		[필수] 엔드포인트의 컴퓨팅 형식입니다.
environmentId	string		엔드포인트 배포에 대한 환경 사양의 ARM 리소스 ID 또는 AssetId입니다.
environmentVariables	object		배포에 대한 환경 변수 구성입니다.
instanceType	string	Standard_F4s_v2	컴퓨팅 인스턴스 유형입니다. 기본값: Standard_F4s_v2.
livenessProbe	ProbeSettings		활동성 프로브는 컨테이너의 상태를 정기적으로 모니터링합니다.
model	string		모델의 URI 경로입니다.
modelMountPath	string		사용자 지정 컨테이너에 모델을 탑재할 경로입니다.
properties	object		속성 사전입니다. 속성을 추가할 수 있지만 제거하거나 변경할 수는 없습니다.
provisioningState	DeploymentProvisioningState		엔드포인트 배포에 대한 프로비저닝 상태입니다.
readinessProbe	ProbeSettings		준비 상태 프로브는 컨테이너가 트래픽을 처리할 준비가 되었는지 확인합니다. 속성 및 기본값은 활동성 프로브와 동일합니다.
requestSettings	OnlineRequestSettings		배포에 대한 요청 설정입니다.
scaleSettings	OnlineScaleSettings: DefaultScaleSettings TargetUtilizationScaleSettings		배포에 대한 크기 조정 설정입니다. null이거나 제공되지 않은 경우 KubernetesOnlineDeployment의 경우 TargetUtilizationScaleSettings로, ManagedOnlineDeployment의 경우 DefaultScaleSettings로 기본 설정됩니다.
startupProbe	ProbeSettings		시작 프로브는 컨테이너 내의 애플리케이션이 성공적으로 시작되었는지 확인합니다.

ManagedOnlineDeployment

Object

ManagedOnlineDeployment와 관련된 속성입니다.

Name	형식	Default value	Description
appInsightsEnabled	boolean	False	true이면 Application Insights 로깅을 사용하도록 설정합니다.
codeConfiguration	CodeConfiguration		엔드포인트 배포에 대한 코드 구성입니다.
dataCollector	DataCollector		mdc 구성은 null일 때 mdc를 사용하지 않도록 설정합니다.
description	string		엔드포인트 배포에 대한 설명입니다.
egressPublicNetworkAccess	EgressPublicNetworkAccessType	Enabled	배포의 송신에 대해 PublicNetworkAccess가 사용 또는 사용 안 함인지 여부를 결정하는 열거형입니다.
endpointComputeType	string: Managed		[필수] 엔드포인트의 컴퓨팅 형식입니다.
environmentId	string		엔드포인트 배포에 대한 환경 사양의 ARM 리소스 ID 또는 AssetId입니다.
environmentVariables	object		배포에 대한 환경 변수 구성입니다.
instanceType	string	Standard_F4s_v2	컴퓨팅 인스턴스 유형입니다. 기본값: Standard_F4s_v2.
livenessProbe	ProbeSettings		활동성 프로브는 컨테이너의 상태를 정기적으로 모니터링합니다.
model	string		모델의 URI 경로입니다.
modelMountPath	string		사용자 지정 컨테이너에 모델을 탑재할 경로입니다.
properties	object		속성 사전입니다. 속성을 추가할 수 있지만 제거하거나 변경할 수는 없습니다.
provisioningState	DeploymentProvisioningState		엔드포인트 배포에 대한 프로비저닝 상태입니다.
readinessProbe	ProbeSettings		준비 상태 프로브는 컨테이너가 트래픽을 처리할 준비가 되었는지 확인합니다. 속성 및 기본값은 활동성 프로브와 동일합니다.
requestSettings	OnlineRequestSettings		배포에 대한 요청 설정입니다.
scaleSettings	OnlineScaleSettings: DefaultScaleSettings TargetUtilizationScaleSettings		배포에 대한 크기 조정 설정입니다. null이거나 제공되지 않은 경우 KubernetesOnlineDeployment의 경우 TargetUtilizationScaleSettings로, ManagedOnlineDeployment의 경우 DefaultScaleSettings로 기본 설정됩니다.
startupProbe	ProbeSettings		시작 프로브는 컨테이너 내의 애플리케이션이 성공적으로 시작되었는지 확인합니다.

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