AciWebservice 클래스
Azure Container Instances에서 웹 서비스 엔드포인트로 배포된 기계 학습 모델을 나타냅니다.
배포된 서비스는 모델, 스크립트 및 연결된 파일에서 만들어집니다. 결과 웹 서비스는 REST API를 사용하는 부하 분산된 HTTP 엔드포인트입니다. 이 API에 데이터를 보내고 모델에서 반환된 예측을 받을 수 있습니다.
자세한 내용은 Azure Container Instances에 모델 배포를 참조하세요.
Webservice 인스턴스를 초기화합니다.
Webservice 생성자는 제공된 작업 영역과 연결된 Webservice 개체의 클라우드 표현을 검색합니다. 검색된 Webservice 개체의 특정 형식에 해당하는 자식 클래스의 인스턴스를 반환합니다.
생성자
AciWebservice(workspace, name)
매개 변수
Name | Description |
---|---|
workspace
필수
|
검색할 Webservice 개체를 포함하는 작업 영역 개체입니다. |
name
필수
|
검색할 Webservice 개체의 이름입니다. |
설명
권장되는 배포 패턴은 메서드를 사용하여 배포 구성 개체를 deploy_configuration
만든 다음 아래와 같이 클래스의 deploy
메서드와 함께 Model 사용하는 것입니다.
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)
다음을 포함하여 모델을 웹 서비스로 배포하는 방법에는 여러 가지가 있습니다.
deploy
Model 작업 영역에 이미 등록된 모델의 메서드입니다.deploy_from_image
의 메서드입니다 Webservice.deploy_from_model
Webservice 작업 영역에 이미 등록된 모델의 메서드입니다. 이 메서드는 이미지를 만듭니다.deploy
모델을 등록하고 이미지를 만드는 의 Webservice메서드입니다.
웹 서비스 작업에 대한 자세한 내용은
변수 섹션에는 클라우드 AciWebservice 개체의 로컬 표현 특성이 나열됩니다. 이러한 변수는 읽기 전용으로 간주되어야 합니다. 해당 값 변경은 해당 클라우드 개체에 반영되지 않습니다.
변수
Name | Description |
---|---|
enable_app_insights
|
Webservice에 AppInsights 로깅을 사용할 수 있는지 여부입니다. |
cname
|
웹 서비스의 cname입니다. |
container_resource_requirements
|
웹 서비스에 대한 컨테이너 리소스 요구 사항입니다. |
encryption_properties
|
웹 서비스에 대한 암호화 속성입니다. |
vnet_configuration
|
웹 서비스에 대한 가상 네트워크 속성, 구성을 만들고 사용자가 제공해야 합니다. |
azureml.core.webservice.AciWebservice.___location
|
웹 서비스가 배포되는 위치입니다. |
public_ip
|
웹 서비스의 공용 IP 주소입니다. |
azureml.core.webservice.AciWebservice.scoring_uri
|
웹 서비스에 대한 점수 매기기 엔드포인트 |
ssl_enabled
|
웹 서비스에 대해 SSL을 사용할 수 있는지 여부 |
public_fqdn
|
웹 서비스에 대한 공용 FQDN |
environment
|
Webservice를 만드는 데 사용된 Environment 개체입니다. |
azureml.core.webservice.AciWebservice.models
|
웹 서비스에 배포된 모델 목록 |
azureml.core.webservice.AciWebservice.swagger_uri
|
웹 서비스에 대한 swagger 엔드포인트 |
메서드
add_properties |
이 Webservice의 속성 사전에 키 값 쌍을 추가합니다. |
add_tags |
이 Webservice의 태그 사전에 키 값 쌍을 추가합니다. |
deploy_configuration |
AciWebservice를 배포하기 위한 구성 개체를 만듭니다. |
get_token |
현재 사용자로 범위가 지정된 이 웹 서비스에 대한 인증 토큰을 검색합니다. 비고 구현되지 않았습니다. |
remove_tags |
이 Webservice의 태그 사전에서 지정된 키를 제거합니다. |
run |
제공된 입력을 사용하여 이 웹 서비스를 호출합니다. |
serialize |
이 웹 서비스를 JSON 직렬화된 사전으로 변환합니다. |
update |
제공된 속성으로 웹 서비스를 업데이트합니다. None으로 남아 있는 값은 이 웹 서비스에서 변경되지 않은 상태로 유지됩니다. |
add_properties
add_tags
이 Webservice의 태그 사전에 키 값 쌍을 추가합니다.
add_tags(tags)
매개 변수
Name | Description |
---|---|
tags
필수
|
추가할 태그의 사전입니다. |
예외
형식 | Description |
---|---|
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
|
이 웹 서비스에 할당할 CPU 코어 수입니다. 10진수일 수 있습니다. 기본값은 0.1입니다. Default value: None
|
memory_gb
|
이 웹 서비스에 할당할 메모리 양(GB)입니다. 10진수일 수 있습니다. 기본값은 0.5입니다. Default value: None
|
tags
|
이 Webservice에 제공할 키 값 태그의 사전입니다. Default value: None
|
properties
|
이 Webservice를 제공할 키 값 속성의 사전입니다. 배포 후에는 이러한 속성을 변경할 수 없지만 새 키 값 쌍을 추가할 수 있습니다. Default value: None
|
description
|
이 웹 서비스를 제공하는 설명입니다. Default value: None
|
___location
|
이 웹 서비스를 배포할 Azure 지역입니다. 지정하지 않으면 작업 영역 위치가 사용됩니다. 사용 가능한 지역에 대한 자세한 내용은 지역별 제품을 참조하세요. Default value: None
|
auth_enabled
|
이 웹 서비스에 대한 인증을 사용하도록 설정할지 여부입니다. 기본값은 False입니다. Default value: None
|
ssl_enabled
|
이 웹 서비스에 대해 SSL을 사용하도록 설정할지 여부입니다. 기본값은 False입니다. Default value: None
|
enable_app_insights
|
이 웹 서비스에 AppInsights를 사용하도록 설정할지 여부입니다. 기본값은 False입니다. Default value: None
|
ssl_cert_pem_file
|
SSL을 사용하는 경우 필요한 인증서 파일입니다. Default value: None
|
ssl_key_pem_file
|
SSL을 사용하는 경우 필요한 키 파일입니다. Default value: None
|
ssl_cname
|
SSL을 사용하는 경우의 cname입니다. Default value: None
|
dns_name_label
|
점수 매기기 엔드포인트의 DNS 이름 레이블입니다. 지정하지 않으면 점수 매기기 엔드포인트에 대해 고유한 DNS 이름 레이블이 생성됩니다. Default value: None
|
primary_key
|
이 웹 서비스에 사용할 기본 인증 키입니다. Default value: None
|
secondary_key
|
이 웹 서비스에 사용할 보조 인증 키입니다. Default value: None
|
collect_model_data
|
Webservice에 대한 모델 데이터 수집을 사용하도록 설정할지 여부입니다. Default value: None
|
cmk_vault_base_url
|
고객 관리형 키 자격 증명 모음 기본 URL Default value: None
|
cmk_key_name
|
고객 관리형 키 이름입니다. Default value: None
|
cmk_key_version
|
고객 관리형 키 버전입니다. Default value: None
|
vnet_name
|
가상 네트워크 이름입니다. Default value: None
|
subnet_name
|
가상 네트워크 내의 서브넷 이름입니다. Default value: None
|
반환
형식 | Description |
---|---|
Webservice 개체를 배포할 때 사용할 구성 개체입니다. |
예외
형식 | Description |
---|---|
get_token
remove_tags
run
제공된 입력을 사용하여 이 웹 서비스를 호출합니다.
run(input_data)
매개 변수
Name | Description |
---|---|
input_data
필수
|
<xref:varies>
웹 서비스를 호출할 입력입니다. |
반환
형식 | Description |
---|---|
웹 서비스를 호출한 결과입니다. |
예외
형식 | Description |
---|---|
serialize
update
제공된 속성으로 웹 서비스를 업데이트합니다.
None으로 남아 있는 값은 이 웹 서비스에서 변경되지 않은 상태로 유지됩니다.
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
|
웹 서비스에 배포할 새 이미지입니다. Default value: None
|
tags
|
이 Webservice에 제공할 키 값 태그의 사전입니다. 기존 태그를 대체합니다. Default value: None
|
properties
|
기존 속성 사전에 추가할 키 값 속성의 사전입니다. Default value: None
|
description
|
이 웹 서비스를 제공하는 설명입니다. Default value: None
|
auth_enabled
|
이 웹 서비스에 대한 인증을 사용하거나 사용하지 않도록 설정합니다. Default value: None
|
ssl_enabled
|
이 웹 서비스에 대해 SSL을 사용하도록 설정할지 여부입니다. Default value: None
|
ssl_cert_pem_file
|
SSL을 사용하는 경우 필요한 인증서 파일입니다. Default value: None
|
ssl_key_pem_file
|
SSL을 사용하는 경우 필요한 키 파일입니다. Default value: None
|
ssl_cname
|
SSL을 사용하는 경우의 cname입니다. Default value: None
|
enable_app_insights
|
이 웹 서비스에 AppInsights를 사용하도록 설정할지 여부입니다. Default value: None
|
models
|
업데이트된 서비스에 패키지할 모델 개체 목록입니다. Default value: None
|
inference_config
|
필요한 모델 배포 속성을 제공하는 데 사용되는 InferenceConfig 개체입니다. Default value: None
|
반환
형식 | Description |
---|---|