Image 클래스
Azure Machine Learning 이미지에 대한 추상 부모 클래스를 정의합니다.
이 클래스는 사용되지 않습니다. 대신 Environment 클래스를 사용합니다.
이미지 생성자입니다.
이 클래스는 사용되지 않습니다. 대신 Environment 클래스를 사용합니다.
이미지 생성자는 제공된 작업 영역과 연결된 Image 개체의 클라우드 표현을 검색하는 데 사용됩니다. 검색된 Image 개체의 특정 형식에 해당하는 자식 클래스의 인스턴스를 반환합니다.
- 상속
-
Image
생성자
Image(workspace, name=None, id=None, tags=None, properties=None, version=None)매개 변수
| Name | Description |
|---|---|
|
workspace
필수
|
검색할 이미지가 포함된 Workspace 개체입니다. |
|
name
|
검색할 이미지의 이름입니다. 이미지의 최신 버전을 반환합니다(있는 경우). Default value: None
|
|
id
|
검색할 이미지의 특정 ID입니다. (ID는 “<이름>:<버전>”임) Default value: None
|
|
tags
|
제공된 목록을 기준으로 ‘key’ 또는 ‘[key, value]’로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']] Default value: None
|
|
properties
|
제공된 목록을 기준으로 ‘key’ 또는 ‘[key, value]’로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']] Default value: None
|
|
version
|
버전과 이름이 모두 지정되면 이미지의 특정 버전을 반환합니다. Default value: None
|
|
workspace
필수
|
검색할 이미지를 포함하는 작업 영역 개체입니다. |
|
name
필수
|
검색할 이미지의 이름입니다. 최신 버전이 있는 경우 반환됩니다. |
|
id
필수
|
검색할 이미지의 특정 ID입니다. (ID는 ":") |
|
tags
필수
|
제공된 목록을 기준으로 ‘key’ 또는 ‘[key, value]’로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']] |
|
properties
필수
|
제공된 목록을 기준으로 ‘key’ 또는 ‘[key, value]’로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']] |
|
version
필수
|
버전과 이름이 모두 지정되면 이미지의 특정 버전을 반환합니다. |
설명
이미지 생성자는 제공된 작업 영역과 연결된 이미지 개체의 클라우드 표현을 검색합니다. 검색된 이미지 개체의 특정 형식에 해당하는 자식 클래스의 인스턴스를 반환합니다.
이미지 개체는 사용자의 Model을 Webservice로 배포하는 데 사용됩니다. 이미지 개체는 일반적으로 모델, 실행 스크립트 및 모델 배포에 필요한 모든 종속성을 포함합니다. Image 클래스에는 Docker 이미지의 ContainerImage와 같은 여러 하위 클래스 및 FPGA 같은 이미지가 포함됩니다.
Image 클래스에서 상속되는 클래스의 예제는 ContainerImage 클래스를 참조하세요.
이미지는 일반적으로 이미지를 사용해야 하는 워크플로에서 사용됩니다. 대부분의 워크플로에서는 Environment 클래스를 대신 사용하여 이미지를 정의해야 합니다. 그런 다음, 메서드와 함께 Environment 개체를 Model deploy() 사용하여 모델을 웹 서비스로 배포할 수 있습니다.
Model package() 메서드를 사용하여 로컬 Docker 설치에 이미지 또는 Dockerfile로 다운로드할 수 있는 이미지를 만들 수도 있습니다.
Azure에 모델을 배포하는 방법의 개요는 https://aka.ms/azureml-how-deploy 링크를 참조하세요.
메서드
| add_properties |
이미지에 속성을 추가합니다. |
| add_tags |
이미지에 태그를 추가합니다. |
| create |
제공된 작업 영역에서 이미지를 만듭니다. |
| delete |
해당 작업 영역에서 이미지를 삭제합니다. |
| deserialize |
json 개체를 이미지 개체로 변환합니다. |
| image_configuration |
이미지 구성 개체를 만드는 추상 메서드입니다. |
| list |
해당 작업 영역과 연결된 이미지를 나열합니다. 특정 매개 변수로 필터링할 수 있습니다. |
| remove_tags |
이미지에서 태그를 제거합니다. |
| serialize |
이 이미지 개체를 JSON 직렬화 사전으로 변환합니다. |
| update |
이미지를 업데이트합니다. |
| update_creation_state |
메모리 내 개체의 현재 상태를 새로 고칩니다. 해당 클라우드 개체의 현재 상태에 따라 개체 속성의 내부 업데이트를 수행합니다. 주로 만들기 상태의 수동 폴링에 유용합니다. |
| wait_for_creation |
이미지 만들기가 완료될 때까지 기다립니다. 이미지 만들기가 터미널 상태에 도달할 때까지 기다립니다. 성공하지 못한 터미널 상태에 도달하면 WebserviceException이 throw됩니다. |
add_properties
이미지에 속성을 추가합니다.
add_properties(properties)매개 변수
| Name | Description |
|---|---|
|
properties
필수
|
추가할 속성의 사전입니다. |
예외
| 형식 | Description |
|---|---|
add_tags
이미지에 태그를 추가합니다.
add_tags(tags)매개 변수
| Name | Description |
|---|---|
|
tags
필수
|
추가할 태그 사전입니다. |
예외
| 형식 | Description |
|---|---|
create
제공된 작업 영역에서 이미지를 만듭니다.
static create(workspace, name, models, image_config)매개 변수
| Name | Description |
|---|---|
|
workspace
필수
|
<xref:<xref:workspace: azureml.core.workspace.Workspace>>
이 이미지와 연결할 작업 영역입니다. |
|
name
필수
|
이 이미지와 연결할 이름입니다. |
|
models
필수
|
이 이미지와 함께 패키지할 Model 개체 목록입니다. 빈 목록일 수 있습니다. |
|
image_config
필수
|
이 이미지를 구성하는 데 사용할 이미지 구성 개체입니다. |
반환
| 형식 | Description |
|---|---|
|
만들어진 Image 개체입니다. |
예외
| 형식 | Description |
|---|---|
delete
해당 작업 영역에서 이미지를 삭제합니다.
delete()예외
| 형식 | Description |
|---|---|
설명
이 메서드는 이미지가 라이브 Webservice에 배포된 경우 실패합니다.
deserialize
json 개체를 이미지 개체로 변환합니다.
deserialize(workspace, image_payload)매개 변수
| Name | Description |
|---|---|
|
cls
필수
|
클래스 메서드를 나타냅니다. |
|
workspace
필수
|
이미지가 등록된 작업 영역 개체입니다. |
|
image_payload
필수
|
이미지 개체로 변환할 JSON 개체입니다. |
반환
| 형식 | Description |
|---|---|
|
제공된 JSON 개체의 이미지 표현입니다. |
예외
| 형식 | Description |
|---|---|
설명
제공된 작업 영역이 이미지가 등록된 작업 영역이 아닌 경우 이 메서드는 실패합니다.
image_configuration
이미지 구성 개체를 만드는 추상 메서드입니다.
abstract static image_configuration()예외
| 형식 | Description |
|---|---|
list
해당 작업 영역과 연결된 이미지를 나열합니다. 특정 매개 변수로 필터링할 수 있습니다.
static list(workspace, image_name=None, model_name=None, model_id=None, tags=None, properties=None)매개 변수
| Name | Description |
|---|---|
|
workspace
필수
|
이미지를 나열할 작업 영역 개체입니다. |
|
image_name
|
특정 이미지 이름으로 배포된 이미지만 포함하도록 목록을 필터링합니다. Default value: None
|
|
model_name
|
특정 모델 이름으로 배포된 이미지만 포함하도록 목록을 필터링합니다. Default value: None
|
|
model_id
|
특정 모델 ID로 배포된 이미지만 포함하도록 목록을 필터링합니다. Default value: None
|
|
tags
|
제공된 목록을 기준으로 ‘key’ 또는 ‘[key, value]’로 필터링합니다. 예: ['key', ['key2', 'key2 value']] Default value: None
|
|
properties
|
제공된 목록을 기준으로 ‘key’ 또는 ‘[key, value]’로 필터링합니다. 예: ['key', ['key2', 'key2 value']] Default value: None
|
반환
| 형식 | Description |
|---|---|
|
list[<xref:Images>]
|
제공된 작업 영역에서 필터링된 이미지 목록입니다. |
예외
| 형식 | Description |
|---|---|
remove_tags
이미지에서 태그를 제거합니다.
remove_tags(tags)매개 변수
| Name | Description |
|---|---|
|
tags
필수
|
제거할 태그에 해당하는 키 목록입니다. |
예외
| 형식 | Description |
|---|---|
serialize
이 이미지 개체를 JSON 직렬화 사전으로 변환합니다.
serialize()반환
| 형식 | Description |
|---|---|
|
이 이미지 개체의 JSON 표현입니다. |
예외
| 형식 | Description |
|---|---|
update
이미지를 업데이트합니다.
update(tags)매개 변수
| Name | Description |
|---|---|
|
tags
필수
|
이미지를 업데이트할 태그 사전입니다. 기존 태그를 덮어씁니다. |
예외
| 형식 | Description |
|---|---|
update_creation_state
메모리 내 개체의 현재 상태를 새로 고칩니다.
해당 클라우드 개체의 현재 상태에 따라 개체 속성의 내부 업데이트를 수행합니다. 주로 만들기 상태의 수동 폴링에 유용합니다.
update_creation_state()예외
| 형식 | Description |
|---|---|
wait_for_creation
이미지 만들기가 완료될 때까지 기다립니다.
이미지 만들기가 터미널 상태에 도달할 때까지 기다립니다. 성공하지 못한 터미널 상태에 도달하면 WebserviceException이 throw됩니다.
wait_for_creation(show_output=False)매개 변수
| Name | Description |
|---|---|
|
show_output
|
더 자세한 출력을 출력하는 부울 옵션입니다. 기본값은 False입니다. Default value: False
|
예외
| 형식 | Description |
|---|---|