Web Services - Create Or Update

Service:

ML Studio (classic)

API Version:

2016-05-01-preview

웹 서비스를 만들거나 업데이트합니다. 이 호출은 기존 웹 서비스를 덮어씁 수 있습니다. 경고나 확인은 없습니다. 복구할 수 없는 작업입니다. 새 웹 서비스를 만들려는 경우 먼저 가져오기 작업을 호출하여 존재하지 않는지 확인합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/webServices/{webServiceName}?api-version=2016-05-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	웹 서비스가 있는 리소스 그룹의 이름입니다.
subscriptionId	path	True	string	Azure 구독 ID입니다.
webServiceName	path	True	string	웹 서비스의 이름입니다.
api-version	query	True	string	사용할 Microsoft.MachineLearning 리소스 공급자 API의 버전입니다.

요청 본문

Media Types: "application/json", "text/json"

Name	필수	형식	Description
location	True	string	리소스의 위치를 지정합니다.
properties	True	WebServiceProperties: WebServicePropertiesForGraph	웹 서비스를 설명하는 속성 페이로드를 포함합니다.
name		string	리소스의 이름을 지정합니다.
tags		object	키/값 쌍으로 정의된 리소스 태그를 포함합니다.

응답

Name	형식	Description
200 OK	WebService	성공. 이 응답은 업데이트 웹 서비스 작업에 대해 반환됩니다. 응답 페이로드는 GET 작업에서 반환되는 응답 페이로드와 동일합니다. 응답에는 프로비전 상태 및 Azure-AsyncOperation 헤더가 포함됩니다. 작업의 진행률을 가져오려면 Azure-AsyncOperation 헤더 필드의 URL에서 GET 작업을 호출합니다. 비동기 작업에 대한 자세한 내용은 를 참조하세요 https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"
201 Created	WebService	만들어졌습니다. 이 응답은 웹 서비스 만들기 작업에 대해 반환됩니다. 응답에는 프로비전 상태 및 Azure-AsyncOperation 헤더가 포함됩니다. 작업의 진행률을 가져오려면 Azure-AsyncOperation 헤더 필드의 URL에서 GET 작업을 호출합니다. 비동기 작업에 대한 자세한 내용은 를 참조하세요 https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"

정의

Name	Description
AssetItem	웹 서비스와 연결된 자산에 대한 정보입니다.
AssetLocation	웹 서비스 자산의 액세스 위치를 설명합니다.
AssetType	자산의 유형입니다.
ColumnFormat	데이터 형식에 대한 추가 형식 정보입니다.
ColumnSpecification	웹 서비스 입력 또는 출력을 나타내는 데이터 테이블 내의 열에 대한 Swagger 2.0 스키마입니다. Swagger 사양을 참조하세요. http://swagger.io/specification/
ColumnType	열의 데이터 형식입니다.
CommitmentPlan	웹 서비스와 연결된 기계 학습 약정 계획에 대한 정보입니다.
DiagnosticsConfiguration	Azure ML 웹 서비스에 대한 진단 설정입니다.
DiagnosticsLevel	진단 출력의 세부 정보를 지정합니다. 유효한 값은 없음 - 추적을 사용하지 않도록 설정합니다. 오류 - 오류(stderr) 추적만 수집합니다. All - 모든 추적(stdout 및 stderr)을 수집합니다.
ExampleRequest	서비스의 입력에 대한 샘플 입력 데이터입니다.
GraphEdge	웹 서비스의 그래프 내에서 에지를 정의합니다.
GraphNode	웹 서비스 그래프의 노드를 지정합니다. 노드는 입력, 출력 또는 자산 노드일 수 있으므로 지정된 시간에 해당 ID 속성 중 하나만 채워집니다.
GraphPackage	기계 학습 솔루션을 구성하는 모듈의 그래프를 정의합니다.
GraphParameter	그래프에서 전역 매개 변수를 정의합니다.
GraphParameterLink	그래프의 노드에 대한 그래프 전역 매개 변수에 대한 연결 링크입니다.
InputPort	자산 입력 포트
InputPortType	포트 데이터 형식입니다.
MachineLearningWorkspace	웹 서비스의 원본인 실험을 포함하는 기계 학습 작업 영역에 대한 정보입니다.
ModeValueInfo	중첩된 매개 변수 정의입니다.
ModuleAssetParameter	모듈 자산에 대한 매개 변수 정의입니다.
OutputPort	자산 출력 포트
OutputPortType	포트 데이터 형식입니다.
ParameterType	그래프 매개 변수의 형식입니다.
ProvisioningState	읽기 전용: 웹 서비스의 프로비전 상태입니다. 유효한 값은 알 수 없음, 프로비전, 성공 및 실패입니다.
RealtimeConfiguration	Azure ML 웹 서비스 엔드포인트에 사용 가능한 구성 옵션을 보유합니다.
ServiceInputOutputSpecification	서비스의 입력 또는 출력을 설명하는 swagger 2.0 스키마입니다. Swagger 사양을 참조하세요. http://swagger.io/specification/
StorageAccount	스토리지 계정에 대한 액세스 정보입니다.
TableSpecification	단일 서비스 입력 또는 출력을 설명하는 swagger 2.0 스키마입니다. Swagger 사양을 참조하세요. http://swagger.io/specification/
WebService	Azure ML 웹 서비스 리소스의 인스턴스입니다.
WebServiceKeys	웹 서비스 호출에 대한 액세스 키입니다.
WebServicePropertiesForGraph	그래프 기반 웹 서비스와 관련된 속성입니다.

AssetItem

웹 서비스와 연결된 자산에 대한 정보입니다.

Name	형식	Description
id	string	자산의 ID입니다.
inputPorts	<string,  InputPort>	자산의 입력 포트에 대한 정보입니다.
locationInfo	AssetLocation	자산에 대한 액세스 정보입니다.
metadata	object	자산이 사용자 지정 모듈인 경우 모듈의 메타데이터를 보유합니다.
name	string	자산의 식별 이름입니다.
outputPorts	<string,  OutputPort>	자산의 출력 포트에 대한 정보입니다.
parameters	ModuleAssetParameter[]	자산이 사용자 지정 모듈인 경우 모듈의 매개 변수를 보유합니다.
type	AssetType	자산의 유형입니다.

AssetLocation

웹 서비스 자산의 액세스 위치를 설명합니다.

Name	형식	Description
credentials	string	해당하는 경우 자산에 대한 자격 증명에 액세스합니다(예: 스토리지 계정에서 지정한 자산연결 문자열 + Blob URI)
uri	string	자산에 액세스할 수 있는 URI(예: 시스템 자산 또는 https://xyz 사용자 자산에 대한 aml://abc)

AssetType

자산의 유형입니다.

Name	형식	Description
Module	string
Resource	string

ColumnFormat

데이터 형식에 대한 추가 형식 정보입니다.

Name	형식	Description
Byte	string
Char	string
Complex128	string
Complex64	string
Date-time	string
Date-timeOffset	string
Double	string
Duration	string
Float	string
Int16	string
Int32	string
Int64	string
Int8	string
Uint16	string
Uint32	string
Uint64	string
Uint8	string

ColumnSpecification

웹 서비스 입력 또는 출력을 나타내는 데이터 테이블 내의 열에 대한 Swagger 2.0 스키마입니다. Swagger 사양을 참조하세요. http://swagger.io/specification/

Name	형식	Description
enum	object[]	데이터 형식이 범주인 경우 허용되는 범주 목록을 제공합니다.
format	ColumnFormat	데이터 형식에 대한 추가 형식 정보입니다.
type	ColumnType	열의 데이터 형식입니다.
x-ms-isnullable	boolean	형식이 null 값을 지원하는지 여부를 나타내는 플래그입니다.
x-ms-isordered	boolean	범주 열인 경우 범주가 정렬된 집합으로 처리되는지 여부를 나타내는 플래그입니다.

ColumnType

열의 데이터 형식입니다.

Name	형식	Description
Boolean	string
Integer	string
Number	string
String	string

CommitmentPlan

웹 서비스와 연결된 기계 학습 약정 계획에 대한 정보입니다.

Name	형식	Description
id	string	웹 서비스와 연결된 약정 플랜의 Azure Resource Manager ID를 지정합니다.

DiagnosticsConfiguration

Azure ML 웹 서비스에 대한 진단 설정입니다.

Name	형식	Description
expiry	string	로깅이 중단되는 날짜와 시간을 지정합니다. null인 경우 진단 수집은 시간이 제한되지 않습니다.
level	DiagnosticsLevel	진단 출력의 세부 정보를 지정합니다. 유효한 값은 없음 - 추적을 사용하지 않도록 설정합니다. 오류 - 오류(stderr) 추적만 수집합니다. All - 모든 추적(stdout 및 stderr)을 수집합니다.

DiagnosticsLevel

진단 출력의 세부 정보를 지정합니다. 유효한 값은 없음 - 추적을 사용하지 않도록 설정합니다. 오류 - 오류(stderr) 추적만 수집합니다. All - 모든 추적(stdout 및 stderr)을 수집합니다.

Name	형식	Description
All	string
Error	string
None	string

ExampleRequest

서비스의 입력에 대한 샘플 입력 데이터입니다.

Name	형식	Description
globalParameters	object	웹 서비스의 전역 매개 변수에 대한 샘플 입력 데이터
inputs	object	샘플 입력 값 행렬 맵에 대한 입력 이름으로 지정된 웹 서비스의 입력에 대한 샘플 입력 데이터입니다.

GraphEdge

웹 서비스의 그래프 내에서 에지를 정의합니다.

Name	형식	Description
sourceNodeId	string	원본 그래프 노드의 식별자입니다.
sourcePortId	string	에지가 연결하는 원본 노드 포트의 식별자입니다.
targetNodeId	string	대상 그래프 노드의 식별자입니다.
targetPortId	string	에지가 연결되는 대상 노드 포트의 식별자입니다.

GraphNode

웹 서비스 그래프의 노드를 지정합니다. 노드는 입력, 출력 또는 자산 노드일 수 있으므로 지정된 시간에 해당 ID 속성 중 하나만 채워집니다.

Name	형식	Description
assetId	string	이 노드가 나타내는 자산의 ID입니다.
inputId	string	이 노드가 나타내는 입력 요소의 ID입니다.
outputId	string	이 노드가 나타내는 출력 요소의 ID입니다.
parameters	object	해당하는 경우 노드의 매개 변수입니다. 전역 그래프 매개 변수는 런타임에 설정된 값을 사용하여 이러한 매개 변수에 매핑됩니다.

GraphPackage

기계 학습 솔루션을 구성하는 모듈의 그래프를 정의합니다.

Name	형식	Description
edges	GraphEdge[]	그래프를 구성하는 에지 목록입니다.
graphParameters	<string,  GraphParameter>	GraphParameter 맵에 전역 매개 변수 이름으로 지정된 그래프에 대한 전역 매개 변수의 컬렉션입니다. 여기에 있는 각 매개 변수는 WebServiceProperties 수준에서 선언된 전역 매개 변수 값 맵과 1:1 일치합니다.
nodes	<string,  GraphNode>	GraphNode 맵에 nodeId로 제공되는 그래프를 구성하는 노드 집합

GraphParameter

그래프에서 전역 매개 변수를 정의합니다.

Name	형식	Description
description	string	이 그래프 매개 변수에 대한 설명입니다.
links	GraphParameterLink[]	이 매개 변수에 대한 연결 링크를 그래프의 노드에 연결합니다.
type	ParameterType	그래프 매개 변수의 형식입니다.

GraphParameterLink

그래프의 노드에 대한 그래프 전역 매개 변수에 대한 연결 링크입니다.

Name	형식	Description
nodeId	string	그래프 노드의 식별자
parameterKey	string	전역 매개 변수가 매핑되는 노드 매개 변수의 식별자입니다.

InputPort

자산 입력 포트

Name	형식	기본값	Description
type	InputPortType	Dataset	포트 데이터 형식입니다.

InputPortType

포트 데이터 형식입니다.

Name	형식	Description
Dataset	string

MachineLearningWorkspace

웹 서비스의 원본인 실험을 포함하는 기계 학습 작업 영역에 대한 정보입니다.

Name	형식	Description
id	string	웹 서비스와 연결된 기계 학습 작업 영역의 작업 영역 ID를 지정합니다.

ModeValueInfo

중첩된 매개 변수 정의입니다.

Name	형식	Description
interfaceString	string	중첩된 매개 변수의 인터페이스 문자열 이름입니다.
parameters	ModuleAssetParameter[]	매개 변수의 정의입니다.

ModuleAssetParameter

모듈 자산에 대한 매개 변수 정의입니다.

Name	형식	Description
modeValuesInfo	<string,  ModeValueInfo>	복잡한 모듈 매개 변수인 경우 중첩된 인터페이스 매개 변수에 대한 정의입니다.
name	string	매개 변수 이름입니다.
parameterType	string	매개 변수 유형입니다.

OutputPort

자산 출력 포트

Name	형식	기본값	Description
type	OutputPortType	Dataset	포트 데이터 형식입니다.

OutputPortType

포트 데이터 형식입니다.

Name	형식	Description
Dataset	string

ParameterType

그래프 매개 변수의 형식입니다.

Name	형식	Description
Boolean	string
ColumnPicker	string
Credential	string
DataGatewayName	string
Double	string
Enumerated	string
Float	string
Int	string
Mode	string
ParameterRange	string
Script	string
String	string

ProvisioningState

읽기 전용: 웹 서비스의 프로비전 상태입니다. 유효한 값은 알 수 없음, 프로비전, 성공 및 실패입니다.

Name	형식	Description
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

Azure ML 웹 서비스 엔드포인트에 사용 가능한 구성 옵션을 보유합니다.

Name	형식	Description
maxConcurrentCalls	integer	웹 서비스에 대해 수행할 수 있는 최대 동시 호출을 지정합니다. 최소값: 4, 최대값: 200.

ServiceInputOutputSpecification

서비스의 입력 또는 출력을 설명하는 swagger 2.0 스키마입니다. Swagger 사양을 참조하세요. http://swagger.io/specification/

Name	형식	기본값	Description
description	string		Swagger 스키마에 대한 설명입니다.
properties	<string,  TableSpecification>		웹 서비스의 각 입력 또는 출력에 대한 열 스키마가 포함된 컬렉션을 지정합니다. 자세한 내용은 Swagger 사양을 참조하세요.
title	string		Swagger 스키마의 제목입니다.
type	string	object	swagger에 설명된 엔터티의 형식입니다. 항상 'object'입니다.

StorageAccount

스토리지 계정에 대한 액세스 정보입니다.

Name	형식	Description
key	string	스토리지 계정에 액세스하는 데 사용되는 키를 지정합니다.
name	string	저장소 계정의 이름을 지정합니다.

TableSpecification

단일 서비스 입력 또는 출력을 설명하는 swagger 2.0 스키마입니다. Swagger 사양을 참조하세요. http://swagger.io/specification/

Name	형식	기본값	Description
description	string		Swagger 스키마 설명입니다.
format	string		'type'이 'object'가 아닌 경우 형식입니다.
properties	<string,  ColumnSpecification>		데이터 테이블 내의 열 집합입니다.
title	string		Swagger 스키마 제목입니다.
type	string	object	swagger에 설명된 엔터티의 형식입니다.

WebService

Azure ML 웹 서비스 리소스의 인스턴스입니다.

Name	형식	Description
id	string	리소스 ID를 지정합니다.
location	string	리소스의 위치를 지정합니다.
name	string	리소스의 이름을 지정합니다.
properties	WebServiceProperties: WebServicePropertiesForGraph	웹 서비스를 설명하는 속성 페이로드를 포함합니다.
tags	object	키/값 쌍으로 정의된 리소스 태그를 포함합니다.
type	string	리소스의 종류를 지정합니다.

WebServiceKeys

웹 서비스 호출에 대한 액세스 키입니다.

Name	형식	Description
primary	string	기본 액세스 키입니다.
secondary	string	보조 액세스 키입니다.

WebServicePropertiesForGraph

그래프 기반 웹 서비스와 관련된 속성입니다.

Name	형식	Description
assets	<string,  AssetItem>	웹 서비스 자산을 설명하는 사용자 정의 속성을 포함합니다. 속성은 키/값 쌍으로 표현됩니다.
commitmentPlan	CommitmentPlan	이 웹 서비스와 연결된 약정 계획을 포함합니다. 생성 시 설정합니다. 설정되면 이 값을 변경할 수 없습니다. 참고: 약정 계획은 GET 작업에 대한 호출에서 반환되지 않습니다.
createdOn	string	읽기 전용: 웹 서비스를 만든 날짜 및 시간입니다.
description	string	웹 서비스에 대한 설명입니다.
diagnostics	DiagnosticsConfiguration	웹 서비스에 대한 진단 추적 컬렉션을 제어하는 설정입니다.
exampleRequest	ExampleRequest	하나 이상의 서비스 입력에 대한 샘플 입력 데이터를 정의합니다.
exposeSampleData	boolean	true로 설정하면 샘플 데이터가 웹 서비스의 swagger 정의에 포함됩니다. 기본값은 true입니다.
input	ServiceInputOutputSpecification	웹 서비스의 입력 중 하나 이상을 설명하는 Swagger 2.0 스키마를 포함합니다. 자세한 내용은 Swagger 사양을 참조하세요.
keys	WebServiceKeys	웹 서비스 프로비저닝 키를 포함합니다. 프로비저닝 키를 지정하지 않으면 Azure Machine Learning 시스템에서 해당 키를 생성합니다. 참고: GET 작업에 대한 호출에서 키가 반환되지 않습니다.
machineLearningWorkspace	MachineLearningWorkspace	웹 서비스의 원본인 실험이 포함된 Machine Learning 작업 영역을 지정합니다.
modifiedOn	string	읽기 전용: 웹 서비스가 마지막으로 수정된 날짜 및 시간입니다.
output	ServiceInputOutputSpecification	하나 이상의 웹 서비스 출력을 설명하는 Swagger 2.0 스키마를 포함합니다. 자세한 내용은 Swagger 사양을 참조하세요.
package	GraphPackage	이 웹 서비스를 구성하는 그래프 패키지의 정의입니다.
packageType	string: Graph	패키지 유형을 지정합니다. 유효한 값은 Graph(Machine Learning Studio를 통해 게시된 웹 서비스 지정) 및 코드(Python과 같은 코드를 사용하여 게시된 웹 서비스를 지정합니다)입니다. 참고: 현재 코드는 지원되지 않습니다.
parameters	object	기본값 맵에 전역 매개 변수 이름으로 지정된 웹 서비스에 대해 정의된 전역 매개 변수 값 집합입니다. 기본값을 지정하지 않으면 매개 변수가 필요한 것으로 간주됩니다.
provisioningState	ProvisioningState	읽기 전용: 웹 서비스의 프로비전 상태입니다. 유효한 값은 알 수 없음, 프로비전, 성공 및 실패입니다.
readOnly	boolean	true로 설정하면 웹 서비스가 읽기 전용이며 더 이상 업데이트하거나 패치할 수 없으며 제거만 됨을 나타냅니다. 기본값은 false입니다. 참고: true로 설정하면 해당 값을 변경할 수 없습니다.
realtimeConfiguration	RealtimeConfiguration	웹 서비스 엔드포인트에 대한 구성 설정을 포함합니다.
storageAccount	StorageAccount	Azure Machine Learning에서 웹 서비스에 대한 정보를 저장하는 데 사용하는 스토리지 계정을 지정합니다. GET 작업에 대한 호출에서 스토리지 계정의 이름만 반환됩니다. 스토리지 계정 정보를 업데이트할 때 새 스토리지 계정에서 필요한 모든 자산을 사용할 수 있는지 또는 웹 서비스에 대한 호출이 실패하는지 확인해야 합니다.
swaggerLocation	string	읽기 전용: 이 웹 서비스와 연결된 swagger 사양의 URI를 포함합니다.
title	string	웹 서비스의 제목입니다.