ComputeInstance 클래스

Azure Machine Learning에서 클라우드 기반의 최적화된 ML 개발 환경을 관리합니다.

Azure Machine Learning 컴퓨팅 인스턴스는 기계 학습 개발 워크플로에 최적화된 클라우드의 완전히 구성되고 관리되는 개발 환경입니다. ComputeInstance는 일반적으로 개발 환경을 만들거나 개발 및 테스트를 위한 학습 및 유추를 위한 컴퓨팅 대상으로 사용됩니다. ComputeInstance를 사용하면 작업 영역의 완전히 통합된 Notebook 환경에서 모델을 작성, 학습 및 배포할 수 있습니다. 자세한 내용은 Azure Machine Learning 컴퓨팅 인스턴스란?을 참조하세요.

클래스 ComputeTarget 생성자입니다.

제공된 작업 영역과 연결된 Compute 개체의 클라우드 표현을 검색합니다. 검색된 Compute 개체의 특정 형식에 해당하는 자식 클래스의 인스턴스를 반환합니다.

생성자

ComputeInstance(workspace, name)

매개 변수

Name	Description
workspace 필수	Workspace 검색할 Compute 개체를 포함하는 작업 영역 개체입니다.
name 필수	str 검색할 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 크기를 나열합니다.
update_sso_settings	컴퓨팅 인스턴스의 Single Sign-On 설정을 업데이트합니다.
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
ComputeTargetException

설명

이 개체가 Azure ML을 통해 만들어진 경우 해당 클라우드 기반 개체도 삭제됩니다. 이 개체가 외부에서 만들어지고 작업 영역에만 연결된 경우 예외가 발생하며 아무것도 변경되지 않습니다.

deserialize

JSON 개체를 ComputeInstance 개체로 변환합니다.

제공된 작업 영역이 ComputeInstance와 연결된 작업 영역이 아니면 실패합니다.

static deserialize(workspace, object_dict)

매개 변수

Name	Description
workspace 필수	Workspace ComputeInstance 개체가 연결된 작업 영역 개체입니다.
object_dict 필수	dict ComputeInstance 개체로 변환할 JSON 개체입니다.

반환

형식	Description
ComputeInstance	제공된 JSON 개체의 ComputeInstance 표현입니다.

예외

형식	Description
ComputeTargetException

detach

ComputeInstance 개체에는 분리가 지원되지 않습니다. delete를 대신 사용하세요.

detach()

예외

형식	Description
ComputeTargetException	작업이 지원되지 않습니다.

get

ComputeInstance 개체를 반환합니다.

get()

반환

형식	Description
ComputeInstance	제공된 JSON 개체의 ComputeInstance 표현입니다.

예외

형식	Description
ComputeTargetException

get_active_runs

이 컴퓨팅에 대한 실행 생성기를 반환합니다.

get_active_runs(type=None, tags=None, properties=None, status=None)

매개 변수

Name	Description
type	str 반환된 실행 생성기를 제공된 형식별로 필터링합니다. 실행 형식 만들기를 참조 add_type_provider 하세요. Default value: None
tags	str 또는 dict 필터는 "tag" 또는 {"tag": "value"}로 실행됩니다. Default value: None
properties	str 또는 dict 필터 실행은 "property" 또는 {"property": "value"} Default value: None
status	str 실행 상태는 "실행 중" 또는 "큐에 대기 중"일 수 있습니다. Default value: None

반환

형식	Description
<xref:builtin.generator>	azureml._restclient.models.RunDto 생성기

get_docs_url

이 클래스에 대한 설명서의 URL입니다.

get_docs_url()

반환

형식	Description
str	유알엘 (URL)

get_status

ComputeInstance에 대한 현재 세부 상태를 검색합니다.

get_status()

반환

형식	Description
ComputeInstanceStatus	컴퓨팅에 대한 자세한 상태 개체

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 필수	str 에이전트 VM의 크기입니다. 자세한 내용은 https://aka.ms/azureml-vm-details. 이전 링크에 설명된 대로 모든 지역에서 모든 크기를 사용할 수 있는 것은 아닙니다. 기본값은 Standard_NC6.
ssh_public_access	bool 공용 SSH 포트의 상태를 나타냅니다. 가능한 값은 다음과 같습니다. False - 공용 SSH 포트가 닫힙니다. True - 공용 SSH 포트가 열려 있습니다. Default value: False
admin_user_ssh_public_key	str 관리자 사용자 계정의 SSH 공개 키입니다. Default value: None
vnet_resourcegroup_name	str 가상 네트워크가 있는 리소스 그룹의 이름입니다. Default value: None
vnet_name	str 가상 네트워크의 이름입니다. Default value: None
subnet_name	str vnet 내의 서브넷 이름입니다. Default value: None
tags	dict[str, str] 컴퓨팅 개체와 연결할 키 값 태그의 선택적 사전입니다. Default value: None
description	str 컴퓨팅 개체에 대한 선택적 설명입니다. Default value: None
assigned_user_object_id	str 할당된 사용자의 AAD 개체 ID(미리 보기)입니다. Default value: None
assigned_user_tenant_id	str 할당된 사용자의 AAD 테넌트 ID(미리 보기)입니다. Default value: None

반환

형식	Description
ComputeInstanceProvisioningConfiguration	Compute 개체를 만들 때 사용할 구성 개체입니다.

예외

형식	Description
ComputeTargetException

refresh_state

개체의 속성에 대한 현재 위치 업데이트를 수행합니다.

이 메서드는 해당 클라우드 개체의 현재 상태에 따라 속성을 업데이트합니다. 이는 컴퓨팅 상태의 수동 폴링에 주로 유용합니다.

refresh_state()

restart

ComputeInstance를 다시 시작합니다.

restart(wait_for_completion=False, show_output=False)

매개 변수

Name	Description
wait_for_completion	bool 상태 업데이트를 기다리는 부울입니다. 기본값은 False입니다. Default value: False
show_output	bool 자세한 출력을 제공하는 부울입니다. 기본값은 False입니다. Default value: False

반환

형식	Description
None	없음

예외

형식	Description
azureml.exceptions.ComputeTargetException:

serialize

이 ComputeInstance 개체를 JSON 직렬화된 사전으로 변환합니다.

serialize()

반환

형식	Description
dict	이 ComputeInstance 개체의 JSON 표현입니다.

start

ComputeInstance를 시작합니다.

start(wait_for_completion=False, show_output=False)

매개 변수

Name	Description
wait_for_completion	bool 상태 업데이트를 기다릴지 여부입니다. 기본값은 False입니다. Default value: False
show_output	bool 자세한 출력을 제공할지 여부입니다. 기본값은 False입니다. Default value: False

반환

형식	Description
None	없음

예외

형식	Description
ComputeTargetException

stop

ComputeInstance를 중지합니다.

stop(wait_for_completion=False, show_output=False)

매개 변수

Name	Description
wait_for_completion	bool 상태 업데이트를 기다릴지 여부입니다. 기본값은 False입니다. Default value: False
show_output	bool 자세한 출력을 제공할지 여부입니다. 기본값은 False입니다. Default value: False

반환

형식	Description
None	없음

예외

형식	Description
ComputeTargetException

supported_vmsizes

지역에서 지원되는 VM 크기를 나열합니다.

static supported_vmsizes(workspace, ___location=None)

매개 변수

Name	Description
workspace 필수	Workspace 작업 영역입니다.
___location	str 인스턴스의 위치입니다. 지정하지 않으면 기본값은 작업 영역 위치입니다. Default value: None

반환

형식	Description
list	VM, VCPU 및 RAM의 이름을 가진 지역에서 지원되는 VM 크기 목록입니다.

update_sso_settings

컴퓨팅 인스턴스의 Single Sign-On 설정을 업데이트합니다.

update_sso_settings(value)

매개 변수

Name	Description
value 필수	bool sso 설정의 값

반환

형식	Description
bool	업데이트가 성공했는지 여부

wait_for_completion

ComputeInstance가 프로비전이 완료되기를 기다립니다.

wait_for_completion(show_output=False, is_delete_operation=False)

매개 변수

Name	Description
show_output	bool 자세한 출력을 제공할지 여부입니다. 기본값은 False입니다. Default value: False
is_delete_operation	bool 작업이 삭제를 위한 것인지 여부를 나타냅니다. Default value: False

예외

형식	Description
ComputeTargetException

다음을 통해 공유

ComputeInstance 클래스

생성자

매개 변수

메서드

delete

매개 변수

예외

설명

deserialize

매개 변수

반환

예외

detach

예외

get

반환

예외

get_active_runs

매개 변수

반환

get_docs_url

반환

get_status

반환

provisioning_configuration

매개 변수

반환

예외

refresh_state

restart

매개 변수

반환

예외

serialize

반환

start

매개 변수

반환

예외

stop

매개 변수

반환

예외

supported_vmsizes

매개 변수

반환

update_sso_settings

매개 변수

반환

wait_for_completion

매개 변수

예외

피드백