Image 클래스
Azure Machine Learning 이미지에 대한 추상 부모 클래스를 정의합니다.
이 클래스는 사용되지 않습니다. 대신 Environment 클래스를 사용합니다.
이미지 생성자입니다.
이 클래스는 사용되지 않습니다. 대신 Environment 클래스를 사용합니다.
이미지 생성자는 제공된 작업 영역과 연결된 Image 개체의 클라우드 표현을 검색하는 데 사용됩니다. 검색된 Image 개체의 특정 형식에 해당하는 자식 클래스의 인스턴스를 반환합니다.
생성자
Image(workspace, name=None, id=None, tags=None, properties=None, version=None)매개 변수
| Name | Description |
|---|---|
|
workspace
필수
|
검색할 이미지를 포함하는 작업 영역 개체입니다. |
|
name
|
검색할 이미지의 이름입니다. 있는 경우 최신 버전의 Image를 반환합니다. Default value: None
|
|
id
|
검색할 이미지의 특정 ID입니다. (ID는 "<name>:<version>") 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
|
버전과 이름을 모두 지정하면 특정 버전의 Image가 반환됩니다. Default value: None
|
|
workspace
필수
|
검색할 이미지를 포함하는 작업 영역 개체입니다. |
|
name
필수
|
검색할 이미지의 이름입니다. 최신 버전이 있는 경우 반환됩니다. |
|
id
필수
|
검색할 이미지의 특정 ID입니다. (ID는 "<name>:<version>") |
|
tags
필수
|
제공된 목록을 기준으로 'key' 또는 '[key, value]'를 기준으로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']] |
|
properties
필수
|
제공된 목록을 기준으로 'key' 또는 '[key, value]'를 기준으로 이미지 결과를 필터링합니다. 예: ['key', ['key2', 'key2 value']] |
|
version
필수
|
버전과 이름을 모두 지정하면 특정 버전의 Image가 반환됩니다. |
설명
Image 생성자는 제공된 작업 영역과 연결된 Image 개체의 클라우드 표현을 검색합니다. 검색된 Image 개체의 특정 형식에 해당하는 자식 클래스의 인스턴스를 반환합니다.
Image 개체는 사용자를 ModelWebservice로 배포하는 데 사용됩니다. Image 개체는 일반적으로 모델, 실행 스크립트 및 모델 배포에 필요한 모든 종속성을 포함합니다. Image 클래스에는 Docker 이미지용 ContainerImage와 같은 여러 서브클래스 및 FPGA와 같은 이미지가 있습니다.
ContainerImage Image 클래스에서 상속되는 클래스의 예제는 클래스를 참조하세요.
이미지는 일반적으로 이미지를 사용해야 하는 워크플로에서 사용됩니다. 대부분의 워크플로에서는 대신 클래스를 Environment 사용하여 이미지를 정의해야 합니다. 그런 다음, 메서드와 함께 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)매개 변수
| 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 |
|---|---|
설명
이미지가 라이브 웹 서비스에 배포된 경우 이 메서드가 실패합니다.
deserialize
json 개체를 Image 개체로 변환합니다.
deserialize(workspace, image_payload)매개 변수
| Name | Description |
|---|---|
|
cls
필수
|
클래스 메서드를 나타냅니다. |
|
workspace
필수
|
이미지가 등록된 작업 영역 개체입니다. |
|
image_payload
필수
|
Image 개체로 변환할 JSON 개체입니다. |
반환
| 형식 | Description |
|---|---|
|
제공된 JSON 개체의 이미지 표현입니다. |
설명
제공된 작업 영역이 이미지가 등록된 작업 영역이 아닌 경우 이 메서드는 실패합니다.
image_configuration
이미지 구성 개체를 만들기 위한 추상 메서드입니다.
abstract static image_configuration()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
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 |
|---|---|