Image 클래스

Azure Machine Learning 이미지의 추상 부모 클래스를 정의합니다.

이 클래스는 사용되지 않습니다. 대신 Environment 클래스를 사용합니다.

이미지 생성자입니다.

이 클래스는 사용되지 않습니다. 대신 Environment 클래스를 사용합니다.

이미지 생성자는 제공된 작업 영역과 연결된 Image 개체의 클라우드 표현을 검색하는 데 사용됩니다. 검색된 Image 개체의 특정 형식에 해당하는 자식 클래스의 instance 반환합니다.

상속
Image

생성자

Image(workspace, name=None, id=None, tags=None, properties=None, version=None)

매개 변수

workspace
Workspace
필수

검색할 이미지가 포함된 Workspace 개체입니다.

name
str
기본값: None

검색할 이미지의 이름입니다. 있는 경우 이미지의 최신 버전을 반환합니다.

id
str
기본값: None

검색할 이미지의 특정 ID입니다. (ID는 "<이름>:<버전>")

tags
list
기본값: None

제공된 목록을 기반으로 'key' 또는 '[key, value]'로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']]

properties
list
기본값: None

제공된 목록을 기반으로 'key' 또는 '[key, value]'로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']]

version
str
기본값: None

버전과 이름이 모두 지정되면 이미지의 특정 버전을 반환합니다.

workspace
Workspace
필수

검색할 이미지를 포함하는 작업 영역 개체

name
str
필수

검색할 이미지의 이름입니다. 최신 버전(있는 경우)을 반환합니다.

id
str
필수

검색할 이미지의 특정 ID입니다. (ID는 ":")

tags
list
필수

제공된 목록을 기반으로 'key' 또는 '[key, value]'로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']]

properties
list
필수

제공된 목록을 기반으로 'key' 또는 '[key, value]'로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']]

version
str
필수

버전과 이름이 모두 지정되면 이미지의 특정 버전을 반환합니다.

설명

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

Image 개체는 사용자의 ModelWebservice로 배포하는 데 사용됩니다. Image 개체는 일반적으로 모델, 실행 스크립트 및 모델 배포에 필요한 모든 종속성을 포함합니다. Image 클래스에는 Docker 이미지용 ContainerImage 및 FPGA와 같은 이미지와 같은 여러 하위 클래스가 있습니다.

Image 클래스에서 상속되는 클래스의 예는 ContainerImage 클래스를 참조하세요.

이미지는 일반적으로 이미지를 사용해야 하는 워크플로에서 사용됩니다. 대부분의 워크플로에서는 대신 Environment 클래스를 사용하여 이미지를 정의해야 합니다. 그런 다음, 환경 개체를 Modeldeploy() 메서드와 함께 사용하여 모델을 웹 서비스로 배포할 수 있습니다. Model package() 메서드를 사용하여 로컬 Docker 설치에 이미지 또는 Dockerfile로 다운로드할 수 있는 이미지를 만들 수도 있습니다.

Azure에서 모델 배포에 대한 개요는 다음 링크를 참조하세요. https://aka.ms/azureml-how-deploy.

메서드

add_properties

이미지에 속성을 추가합니다.

add_tags

이미지에 태그를 추가합니다.

create

제공된 작업 영역에서 이미지를 만듭니다.

delete

해당 작업 영역에서 이미지를 삭제합니다.

deserialize

json 개체를 Image 개체로 변환합니다.

image_configuration

이미지 구성 개체를 만드는 추상 메서드입니다.

list

해당 작업 영역과 연결된 이미지를 나열합니다. 특정 매개 변수로 필터링할 수 있습니다.

remove_tags

이미지에서 태그를 제거합니다.

serialize

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

update

이미지를 업데이트합니다.

update_creation_state

메모리 내 개체의 현재 상태를 새로 고칩니다.

해당 클라우드 개체의 현재 상태에 따라 개체 속성을 전체 업데이트합니다. 생성 상태를 수동으로 끌어오는 데 주로 사용됩니다.

wait_for_creation

이미지 만들기가 완료될 때까지 기다립니다.

이미지 만들기가 터미널 상태에 도달할 때까지 기다립니다. 성공하지 못한 터미널 상태에 도달하면 WebserviceException이 throw됩니다.

add_properties

이미지에 속성을 추가합니다.

add_properties(properties)

매개 변수

properties
dict[str, str]
필수

추가할 속성의 사전입니다.

예외

add_tags

이미지에 태그를 추가합니다.

add_tags(tags)

매개 변수

tags
dict[str, str]
필수

추가할 태그 사전입니다.

예외

create

제공된 작업 영역에서 이미지를 만듭니다.

static create(workspace, name, models, image_config)

매개 변수

workspace
<xref:<xref:workspace: azureml.core.workspace.Workspace>>
필수

이 이미지와 연결할 작업 영역입니다.

name
str
필수

이 이미지와 연결할 이름입니다.

models
list[Model]
필수

이 이미지와 함께 패키지할 모델 개체 목록입니다. 빈 목록일 수 있습니다.

image_config
ImageConfig
필수

이 이미지를 구성하는 데 사용할 이미지 구성 개체입니다.

반환

만들어진 이미지 개체입니다.

반환 형식

예외

delete

해당 작업 영역에서 이미지를 삭제합니다.

delete()

예외

설명

이 메서드는 이미지가 라이브 Webservice에 배포된 경우 실패합니다.

deserialize

json 개체를 Image 개체로 변환합니다.

deserialize(workspace, image_payload)

매개 변수

cls
필수

클래스 메서드를 나타냅니다.

workspace
Workspace
필수

이미지가 이 작업 영역 개체 아래에 등록되었습니다.

image_payload
dict
필수

Image 개체로 변환할 JSON 개체입니다.

반환

제공된 JSON 개체의 이미지 표현입니다.

반환 형식

예외

설명

제공된 작업 영역이 이미지가 등록된 작업 영역이 아닌 경우 이 메서드는 실패합니다.

image_configuration

이미지 구성 개체를 만드는 추상 메서드입니다.

abstract static image_configuration()

예외

list

해당 작업 영역과 연결된 이미지를 나열합니다. 특정 매개 변수로 필터링할 수 있습니다.

static list(workspace, image_name=None, model_name=None, model_id=None, tags=None, properties=None)

매개 변수

workspace
Workspace
필수

이미지를 나열할 Workspace 개체입니다.

image_name
str
기본값: None

특정 이미지 이름으로 배포된 이미지만 포함하도록 목록을 필터링합니다.

model_name
str
기본값: None

특정 모델 이름으로 배포된 이미지만 포함하도록 목록을 필터링합니다.

model_id
str
기본값: None

특정 모델 ID로 배포된 이미지만 포함하도록 목록을 필터링합니다.

tags
list
기본값: None

제공된 목록을 기준으로 'key' 또는 '[key, value]'로 필터링합니다. 예: ['key', ['key2', 'key2 value']]

properties
list
기본값: None

제공된 목록을 기준으로 'key' 또는 '[key, value]'로 필터링합니다. 예: ['key', ['key2', 'key2 value']]

반환

제공된 작업 영역에서 필터링된 이미지 목록입니다.

반환 형식

list[<xref:Images>]

예외

remove_tags

이미지에서 태그를 제거합니다.

remove_tags(tags)

매개 변수

tags
list[str]
필수

제거할 태그에 해당하는 키 목록입니다.

예외

serialize

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

serialize()

반환

이 Image 개체의 JSON 표현입니다.

반환 형식

예외

update

이미지를 업데이트합니다.

update(tags)

매개 변수

tags
dict[str, str]
필수

이미지를 업데이트할 태그 사전입니다. 기존 태그를 덮어씁니다.

예외

update_creation_state

메모리 내 개체의 현재 상태를 새로 고칩니다.

해당 클라우드 개체의 현재 상태에 따라 개체 속성을 전체 업데이트합니다. 생성 상태를 수동으로 끌어오는 데 주로 사용됩니다.

update_creation_state()

예외

wait_for_creation

이미지 만들기가 완료될 때까지 기다립니다.

이미지 만들기가 터미널 상태에 도달할 때까지 기다립니다. 성공하지 못한 터미널 상태에 도달하면 WebserviceException이 throw됩니다.

wait_for_creation(show_output=False)

매개 변수

show_output
bool
기본값: False

더 자세한 출력을 인쇄하기 위한 부울 옵션입니다. 기본값은 False입니다.

예외