다음을 통해 공유

AciWebservice 클래스

  • 참조

Azure Container Instances에서 웹 서비스 엔드포인트로 배포된 기계 학습 모델을 나타냅니다.

배포되는 서비스는 모델, 스크립트, 연결된 파일에서 만들어집니다. 결과 웹 서비스는 REST API를 사용하여 부하가 분산된 HTTP 엔드포인트입니다. 이 API로 데이터를 보내고 모델에서 반환된 예측을 받을 수 있습니다.

자세한 내용은 Azure Container Instances에 모델 배포를 참조하세요.

Webservice instance 초기화합니다.

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

상속
Webservice
AciWebservice

생성자

AciWebservice(workspace, name)

매개 변수

Name Description
workspace
필수
Workspace

검색할 Webservice 개체를 포함하는 작업 영역 개체입니다.
name
필수
str

검색할 Webservice 개체의 이름입니다.

설명

권장 배포 패턴은 아래와 같이 deploy_configuration 메서드를 사용하여 배포 구성 개체를 만든 다음, Model 클래스의 deploy 메서드와 함께 사용하는 것입니다.


   from azureml.core.model import InferenceConfig
   from azureml.core.webservice import AciWebservice


   service_name = 'my-custom-env-service'

   inference_config = InferenceConfig(entry_script='score.py', environment=environment)
   aci_config = AciWebservice.deploy_configuration(cpu_cores=1, memory_gb=1)

   service = Model.deploy(workspace=ws,
                          name=service_name,
                          models=[model],
                          inference_config=inference_config,
                          deployment_config=aci_config,
                          overwrite=True)
   service.wait_for_deployment(show_output=True)

다음과 같은 여러 가지 방법으로 모델을 Webservice로 배포할 수 있습니다.

  • 작업 영역에 이미 등록된 모델에 대한 Model의 deploy 메서드입니다.

  • Webservice의 deploy_from_image 메서드입니다.

  • 작업 영역에 이미 등록된 모델에 대한 Webservice의 deploy_from_model 메서드입니다. 이 메서드는 이미지를 만듭니다.

  • 모델을 등록하고 이미지를 만드는 Webservice의 deploy 메서드입니다.

Webservice 작업에 대한 자세한 내용은 다음을 참조하세요.

변수 섹션에는 클라우드 AciWebservice 개체의 로컬 표현 특성이 나열됩니다. 이러한 변수는 읽기 전용으로 간주되어야 합니다. 이러한 값을 변경해도 해당 클라우드 개체에 반영되지 않습니다.

변수

Name Description
enable_app_insights
bool

Webservice에 AppInsights 로깅을 사용할지 여부를 나타냅니다.
cname
str

Webservice의 cname입니다.
container_resource_requirements
ContainerResourceRequirements

Webservice의 컨테이너 리소스 요구 사항입니다.
encryption_properties
EncryptionProperties

Webservice의 암호화 속성입니다.
vnet_configuration
VnetConfiguration

Webservice에 대한 가상 네트워크 속성, 구성은 사용자가 만들고 제공해야 합니다.
azureml.core.webservice.AciWebservice.location
str

Webservice가 배포되는 위치입니다.
public_ip
str

Webservice의 공용 IP 주소입니다.
azureml.core.webservice.AciWebservice.scoring_uri
str

Webservice에 대한 채점 엔드포인트
ssl_enabled
bool

Webservice에 SSL을 사용할 수 있는지 여부
public_fqdn
str

Webservice에 대한 공용 FQDN
environment
Environment

Webservice를 만드는 데 사용된 환경 개체
azureml.core.webservice.AciWebservice.models
list[Model]

Webservice에 배포된 모델 목록
azureml.core.webservice.AciWebservice.swagger_uri
str

Webservice에 대한 Swagger 엔드포인트

메서드

add_properties

이 Webservice의 속성 사전에 키 값 쌍을 추가합니다.
add_tags

이 Webservice의 태그 사전에 키 값 쌍을 추가합니다.
deploy_configuration

AciWebservice 배포를 위한 구성 개체를 만듭니다.
get_token

Webservice의 인증 토큰을 검색합니다. 범위는 현재 사용자입니다.

참고

구현되지 않았습니다.
remove_tags

이 Webservice의 태그 사전에서 지정된 키를 제거합니다.
run

제공된 입력을 사용하여 이 Webservice를 호출합니다.
serialize

이 Webservice를 JSON 직렬화 사전으로 변환합니다.
update

제공된 속성으로 Webservice를 업데이트합니다.

None으로 남아 있는 값은 이 Webservice에서 변경되지 않고 유지됩니다.

add_properties

이 Webservice의 속성 사전에 키 값 쌍을 추가합니다.

add_properties(properties)

매개 변수

Name Description
properties
필수
dict[str, str]

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

add_tags

이 Webservice의 태그 사전에 키 값 쌍을 추가합니다.

add_tags(tags)

매개 변수

Name Description
tags
필수
dict[str, str]

추가할 태그의 사전입니다.

예외

형식 Description
WebserviceException

deploy_configuration

AciWebservice 배포를 위한 구성 개체를 만듭니다.

static deploy_configuration(cpu_cores=None, memory_gb=None, tags=None, properties=None, description=None, location=None, auth_enabled=None, ssl_enabled=None, enable_app_insights=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, ssl_cname=None, dns_name_label=None, primary_key=None, secondary_key=None, collect_model_data=None, cmk_vault_base_url=None, cmk_key_name=None, cmk_key_version=None, vnet_name=None, subnet_name=None)

매개 변수

Name Description
cpu_cores
float

이 Webservice에 할당할 CPU 코어 수입니다. 10진수일 수 있습니다. 기본값은 0.1입니다.

Default value: None
memory_gb
float

이 Webservice에 할당할 메모리 양(GB)입니다. 10진수일 수 있습니다. 기본값은 0.5입니다.

Default value: None
tags
dict[str, str]

이 Webservice에 제공할 키 값 태그의 사전입니다.

Default value: None
properties
dict[str, str]

이 Webservice에 제공할 키 값 속성의 사전입니다. 배포 후에는 이러한 속성을 변경할 수 없지만, 새 키 값 쌍을 추가할 수 있습니다.

Default value: None
description
str

이 Webservice에 제공할 설명입니다.

Default value: None
location
str

이 웹 서비스를 배포할 Azure 지역입니다. 지정하지 않으면 작업 영역 위치가 사용됩니다. 사용 가능한 지역에 대한 자세한 내용은 지역별 제품을 참조하세요.

Default value: None
auth_enabled
bool

이 Webservice에 인증을 사용할지 여부를 나타냅니다. 기본값은 False입니다.

Default value: None
ssl_enabled
bool

이 Webservice에 SSL을 사용할지 여부를 나타냅니다. 기본값은 False입니다.

Default value: None
enable_app_insights
bool

이 Webservice에 AppInsights를 사용할지 여부를 나타냅니다. 기본값은 False입니다.

Default value: None
ssl_cert_pem_file
str

SSL을 사용하는 경우 필요한 인증서 파일입니다.

Default value: None
ssl_key_pem_file
str

SSL을 사용하는 경우 필요한 키 파일입니다.

Default value: None
ssl_cname
str

SSL이 사용하도록 설정된 경우에 대한 cname입니다.

Default value: None
dns_name_label
str

채점 엔드포인트에 대한 DNS 이름 레이블입니다. 지정하지 않으면 채점 엔드포인트에 대해 고유한 DNS 이름 레이블이 생성됩니다.

Default value: None
primary_key
str

이 Webservice에 사용할 기본 인증 키입니다.

Default value: None
secondary_key
str

이 Webservice에 사용할 보조 인증 키입니다.

Default value: None
collect_model_data
bool

Webservice에 모델 데이터 컬렉션을 사용할지 여부를 나타냅니다.

Default value: None
cmk_vault_base_url
str

고객 관리형 키 자격 증명 모음 기준 URL입니다.

Default value: None
cmk_key_name
str

고객 관리형 키 이름입니다.

Default value: None
cmk_key_version
str

고객 관리형 키 버전입니다.

Default value: None
vnet_name
str

가상 네트워크 이름입니다.

Default value: None
subnet_name
str

가상 네트워크 내의 서브넷 이름입니다.

Default value: None

반환

형식 Description
AciServiceDeploymentConfiguration

Webservice 개체를 배포할 때 사용할 구성 개체입니다.

예외

형식 Description
WebserviceException

get_token

Webservice의 인증 토큰을 검색합니다. 범위는 현재 사용자입니다.

참고

구현되지 않았습니다.

get_token()

반환

형식 Description
str, datetime

이 Webservice의 인증 토큰 및 이후에 새로 고쳐야 하는 시기입니다.

예외

형식 Description
azureml.exceptions.NotImplementedError

remove_tags

이 Webservice의 태그 사전에서 지정된 키를 제거합니다.

remove_tags(tags)

매개 변수

Name Description
tags
필수
list[str]

제거할 키 목록입니다.

run

제공된 입력을 사용하여 이 Webservice를 호출합니다.

run(input_data)

매개 변수

Name Description
input_data
필수
<xref:varies>

이 입력을 사용하여 Webservice를 호출합니다.

반환

형식 Description
dict

Webservice 호출 결과입니다.

예외

형식 Description
WebserviceException

serialize

이 Webservice를 JSON 직렬화 사전으로 변환합니다.

serialize()

반환

형식 Description
dict

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

update

제공된 속성으로 Webservice를 업데이트합니다.

None으로 남아 있는 값은 이 Webservice에서 변경되지 않고 유지됩니다.

update(image=None, tags=None, properties=None, description=None, auth_enabled=None, ssl_enabled=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, ssl_cname=None, enable_app_insights=None, models=None, inference_config=None)

매개 변수

Name Description
image
Image

Webservice에 배포할 새 이미지입니다.

Default value: None
tags
dict[str, str]

이 Webservice에 제공할 키 값 태그의 사전입니다. 기존 태그를 대체합니다.

Default value: None
properties
dict[str, str]

기존 속성 사전에 추가할 키 값 속성 사전입니다.

Default value: None
description
str

이 Webservice에 제공할 설명입니다.

Default value: None
auth_enabled
bool

이 Webservice에 대한 인증을 사용하거나 사용하지 않도록 설정합니다.

Default value: None
ssl_enabled
bool

이 Webservice에 SSL을 사용할지 여부를 나타냅니다.

Default value: None
ssl_cert_pem_file
str

SSL을 사용하는 경우 필요한 인증서 파일입니다.

Default value: None
ssl_key_pem_file
str

SSL을 사용하는 경우 필요한 키 파일입니다.

Default value: None
ssl_cname
str

SSL이 사용하도록 설정된 경우에 대한 cname입니다.

Default value: None
enable_app_insights
bool

이 Webservice에 AppInsights를 사용할지 여부를 나타냅니다.

Default value: None
models
list[Model]

업데이트된 서비스에 패키지할 모델 개체 목록입니다.

Default value: None
inference_config
InferenceConfig

필요한 모델 배포 속성을 제공하는 데 사용되는 InferenceConfig 개체입니다.

Default value: None

반환

형식 Description
None