ComputeInstance 클래스
Azure Machine Learning에서 클라우드 기반의 최적화된 ML 개발 환경을 관리합니다.
Azure Machine Learning 컴퓨팅 인스턴스는 기계 학습 개발 워크플로에 최적화된 클라우드에서 완전히 구성되고 관리되는 개발 환경입니다. ComputeInstance는 일반적으로 개발 환경을 생성하는 데 사용되거나 개발 및 테스트용 학습 및 유추를 위한 컴퓨팅 대상으로 사용됩니다. ComputeInstance를 사용하면 완전히 통합된 Notebook 환경으로 작업 영역에서 모델을 작성, 학습 및 배포할 수 있습니다. 자세한 내용은 What is an Azure Machine Learning compute instance?(Azure Machine Learning 컴퓨팅 인스턴스란?)를 참조하세요.
클래스 ComputeTarget 생성자입니다.
제공된 작업 영역과 연결된 Compute 개체의 클라우드 표현을 검색합니다. 검색된 Compute 개체의 특정 형식에 해당하는 자식 클래스의 instance 반환합니다.
- 상속
-
ComputeInstance
생성자
ComputeInstance(workspace, name)
매개 변수
Name | Description |
---|---|
workspace
필수
|
검색할 Compute 개체를 포함하는 작업 영역 개체입니다. |
name
필수
|
검색할 Compute 개체의 이름입니다. |
메서드
delete |
연결된 작업 영역에서 ComputeInstance 개체를 제거합니다. |
deserialize |
JSON 개체를 ComputeInstance 개체로 변환합니다. 제공된 작업 영역이 ComputeInstance와 연결된 작업 영역이 아닐 경우 이 작업이 실패합니다. |
detach |
ComputeInstance 개체에는 분리가 지원되지 않습니다. 대신 delete를 사용하세요. |
get |
ComputeInstance 개체를 반환합니다. |
get_active_runs |
이 컴퓨팅에 대한 실행 생성기를 반환합니다. |
get_docs_url |
이 클래스에 대한 설명서의 URL입니다. |
get_status |
ComputeInstance에 대한 현재 세부 상태를 검색합니다. |
provisioning_configuration |
ComputeInstance 대상을 프로비전하기 위한 구성 개체를 생성합니다. |
refresh_state |
개체의 속성에 대한 현재 위치 업데이트를 수행합니다. 이 메서드는 해당 클라우드 개체의 현재 상태에 따라 속성을 업데이트합니다. 이는 주로 컴퓨팅 상태의 수동 폴링에 유용합니다. |
restart |
ComputeInstance를 다시 시작합니다. |
serialize |
이 ComputeInstance 개체를 JSON 직렬화된 사전으로 변환합니다. |
start |
ComputeInstance를 시작합니다. |
stop |
ComputeInstance를 중지합니다. |
supported_vmsizes |
영역에서 지원되는 VM 크기를 나열합니다. |
wait_for_completion |
ComputeInstance가 프로비전을 완료할 때까지 기다립니다. |
delete
연결된 작업 영역에서 ComputeInstance 개체를 제거합니다.
delete(wait_for_completion=False, show_output=False)
매개 변수
Name | Description |
---|---|
wait_for_completion
|
Default value: False
|
show_output
|
Default value: False
|
예외
형식 | Description |
---|---|
설명
이 개체가 Azure ML을 통해 생성된 경우 해당 클라우드 기반 개체도 삭제됩니다. 이 개체가 외부에서 생성되었고 작업 영역에만 연결된 경우 예외가 발생하며 아무것도 변경되지 않습니다.
deserialize
JSON 개체를 ComputeInstance 개체로 변환합니다.
제공된 작업 영역이 ComputeInstance와 연결된 작업 영역이 아닐 경우 이 작업이 실패합니다.
static deserialize(workspace, object_dict)
매개 변수
Name | Description |
---|---|
workspace
필수
|
ComputeInstance 개체가 연결된 작업 영역 개체입니다. |
object_dict
필수
|
ComputeInstance 개체로 변환할 JSON 개체입니다. |
반환
형식 | Description |
---|---|
제공된 JSON 개체의 ComputeInstance 표현입니다. |
예외
형식 | Description |
---|---|
detach
get
ComputeInstance 개체를 반환합니다.
get()
반환
형식 | Description |
---|---|
제공된 JSON 개체의 ComputeInstance 표현입니다. |
예외
형식 | Description |
---|---|
get_active_runs
이 컴퓨팅에 대한 실행 생성기를 반환합니다.
get_active_runs(type=None, tags=None, properties=None, status=None)
매개 변수
Name | Description |
---|---|
type
|
제공된 형식으로 실행의 반환된 생성기를 필터링합니다. 실행 유형을 생성하려면 다음을 참조하세요. add_type_provider Default value: None
|
tags
|
"tag" 또는 {"tag": "value"}로 실행을 필터링합니다. Default value: None
|
properties
|
"property" 또는 {"property": "value"}로 실행을 필터링합니다. Default value: None
|
status
|
실행 상태는 "Running(실행 중)" 또는 "Queued(대기 중)"일 수 있습니다. Default value: None
|
반환
형식 | Description |
---|---|
<xref:builtin.generator>
|
azureml._restclient.models.RunDto의 생성기입니다. |
예외
형식 | Description |
---|---|
get_docs_url
이 클래스에 대한 설명서의 URL입니다.
get_docs_url()
반환
형식 | Description |
---|---|
url |
예외
형식 | Description |
---|---|
get_status
ComputeInstance에 대한 현재 세부 상태를 검색합니다.
get_status()
반환
형식 | Description |
---|---|
컴퓨팅에 대한 자세한 상태 개체입니다. |
예외
형식 | Description |
---|---|
provisioning_configuration
ComputeInstance 대상을 프로비전하기 위한 구성 개체를 생성합니다.
static provisioning_configuration(vm_size='', ssh_public_access=False, admin_user_ssh_public_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, assigned_user_object_id=None, assigned_user_tenant_id=None)
매개 변수
Name | Description |
---|---|
vm_size
필수
|
에이전트 VM의 크기입니다. 자세한 내용은 다음에서 확인할 수 있습니다. https://aka.ms/azureml-vm-details 이전 링크에 자세히 설명된 것처럼 모든 영역에서 모든 크기를 사용할 수 있는 것은 아닙니다. 기본값은 Standard_NC6입니다. |
ssh_public_access
|
공용 SSH 포트의 상태를 나타냅니다. 가능한 값은 다음과 같습니다.
Default value: False
|
admin_user_ssh_public_key
|
관리자 사용자 계정의 SSH 공개 키입니다. Default value: None
|
vnet_resourcegroup_name
|
가상 네트워크가 있는 리소스 그룹의 이름입니다. Default value: None
|
vnet_name
|
가상 네트워크의 이름입니다. Default value: None
|
subnet_name
|
VNet 내부 서브넷의 이름입니다. Default value: None
|
tags
|
컴퓨팅 개체와 연결할 키 값 태그의 선택적 사전입니다. Default value: None
|
description
|
컴퓨팅 개체에 대한 선택적 설명입니다. Default value: None
|
assigned_user_object_id
|
할당된 사용자의 AAD 개체 ID입니다(미리 보기). Default value: None
|
assigned_user_tenant_id
|
할당된 사용자의 AAD 테넌트 ID입니다(미리 보기). Default value: None
|
반환
형식 | Description |
---|---|
컴퓨팅 개체를 생성할 때 사용할 구성 개체입니다. |
예외
형식 | Description |
---|---|
refresh_state
개체의 속성에 대한 현재 위치 업데이트를 수행합니다.
이 메서드는 해당 클라우드 개체의 현재 상태에 따라 속성을 업데이트합니다. 이는 주로 컴퓨팅 상태의 수동 폴링에 유용합니다.
refresh_state()
예외
형식 | Description |
---|---|
restart
ComputeInstance를 다시 시작합니다.
restart(wait_for_completion=False, show_output=False)
매개 변수
Name | Description |
---|---|
wait_for_completion
|
상태 업데이트를 기다리는 부울입니다. 기본값은 False입니다. Default value: False
|
show_output
|
자세한 출력을 제공하는 부울입니다. 기본값은 False입니다. Default value: False
|
반환
형식 | Description |
---|---|
None |
예외
형식 | Description |
---|---|
azureml.exceptions.ComputeTargetException:
|
serialize
이 ComputeInstance 개체를 JSON 직렬화된 사전으로 변환합니다.
serialize()
반환
형식 | Description |
---|---|
이 ComputeInstance 개체의 JSON 표현입니다. |
예외
형식 | Description |
---|---|
start
ComputeInstance를 시작합니다.
start(wait_for_completion=False, show_output=False)
매개 변수
Name | Description |
---|---|
wait_for_completion
|
상태 업데이트를 기다릴지 여부입니다. 기본값은 False입니다. Default value: False
|
show_output
|
자세한 출력을 제공할지 여부입니다. 기본값은 False입니다. Default value: False
|
반환
형식 | Description |
---|---|
None |
예외
형식 | Description |
---|---|
stop
ComputeInstance를 중지합니다.
stop(wait_for_completion=False, show_output=False)
매개 변수
Name | Description |
---|---|
wait_for_completion
|
상태 업데이트를 기다릴지 여부입니다. 기본값은 False입니다. Default value: False
|
show_output
|
자세한 출력을 제공할지 여부입니다. 기본값은 False입니다. Default value: False
|
반환
형식 | Description |
---|---|
None |
예외
형식 | Description |
---|---|
supported_vmsizes
영역에서 지원되는 VM 크기를 나열합니다.
static supported_vmsizes(workspace, location=None)
매개 변수
Name | Description |
---|---|
workspace
필수
|
작업 영역입니다. |
location
|
인스턴스의 위치입니다. 지정하지 않으면 기본값으로 작업 영역 위치가 사용됩니다. Default value: None
|
반환
형식 | Description |
---|---|
VM, VCPU 및 RAM 이름이 있는 영역에서 지원되는 VM 크기 목록입니다. |
예외
형식 | Description |
---|---|
wait_for_completion
ComputeInstance가 프로비전을 완료할 때까지 기다립니다.
wait_for_completion(show_output=False, is_delete_operation=False)
매개 변수
Name | Description |
---|---|
show_output
|
자세한 출력을 제공할지 여부입니다. 기본값은 False입니다. Default value: False
|
is_delete_operation
|
작업이 삭제를 위한 것인지 여부를 나타냅니다. Default value: False
|
예외
형식 | Description |
---|---|