你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Web Services - Create Or Update

服务:

ML Studio (classic)

API 版本:

2016-05-01-preview

创建或更新 Web 服务。 此调用将覆盖现有 Web 服务。 请注意，没有警告或确认。 这是不可恢复的操作。 如果打算创建新的 Web 服务，请先调用 Get 操作以验证它是否存在。

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

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string	Web 服务所在的资源组的名称。
subscriptionId	path	True	string	Azure 订阅 ID。
webServiceName	path	True	string	Web 服务的名称。
api-version	query	True	string	要使用的 Microsoft.MachineLearning 资源提供程序 API 的版本。

请求正文

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

名称	必需	类型	说明
location	True	string	指定资源的位置。
properties	True	WebServiceProperties: WebServicePropertiesForGraph	包含描述 Web 服务的属性有效负载。
name		string	指定资源的名称。
tags		object	包含定义为键/值对的资源标记。

响应

名称	类型	说明
200 OK	WebService	成功。 对于更新 Web 服务操作，返回此响应。 响应有效负载与 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	Created. 为创建 Web 服务操作返回此响应。 响应包括预配状态和 Azure-AsyncOperation 标头。 若要获取操作的进度，请对 Azure-AsyncOperation 标头字段中的 URL 调用 GET 操作。 有关异步操作的详细信息，请参阅 https://msdn.microsoft.com/en-us/library/mt742920.aspx。 Media Types: "application/json", "text/json"

定义

名称	说明
AssetItem	有关与 Web 服务关联的资产的信息。
AssetLocation	描述 Web 服务资产的访问位置。
AssetType	资产的类型。
ColumnFormat	数据类型的其他格式信息。
ColumnSpecification	表示 Web 服务输入或输出的数据表中的列的 Swagger 2.0 架构。 请参阅 Swagger 规范： http://swagger.io/specification/
ColumnType	列的数据类型。
CommitmentPlan	有关与 Web 服务关联的机器学习承诺计划的信息。
DiagnosticsConfiguration	Azure ML Web 服务的诊断设置。
DiagnosticsLevel	指定诊断输出的详细程度。 有效值为：None - 禁用跟踪;Error - 仅收集错误 (stderr) 跟踪;全部 - 收集 stdout 和 stderr) (的所有跟踪。
ExampleRequest	服务输入 () 的示例输入数据。
GraphEdge	定义 Web 服务图中的边缘。
GraphNode	指定 Web 服务图中的节点。 节点可以是输入、输出或资产节点，因此在任何给定时间仅填充一个相应的 ID 属性。
GraphPackage	定义组成机器学习解决方案的模块图。
GraphParameter	在图中定义全局参数。
GraphParameterLink	图形全局参数的关联链接到图形中的节点。
InputPort	资产输入端口
InputPortType	端口数据类型。
MachineLearningWorkspace	有关机器学习工作区的信息，其中包含 Web 服务的源试验。
ModeValueInfo	嵌套参数定义。
ModuleAssetParameter	模块资产的参数定义。
OutputPort	资产输出端口
OutputPortType	端口数据类型。
ParameterType	图形参数的类型。
ProvisioningState	只读：Web 服务的预配状态。 有效值为 Unknown、Provisioning、Succeeded 和 Failed。
RealtimeConfiguration	保留 Azure ML Web 服务终结点的可用配置选项。
ServiceInputOutputSpecification	描述服务的输入和输出的 swagger 2.0 架构。 请参阅 Swagger 规范： http://swagger.io/specification/
StorageAccount	存储帐户的访问信息。
TableSpecification	描述单个服务输入或输出的 swagger 2.0 架构。 请参阅 Swagger 规范： http://swagger.io/specification/
WebService	Azure ML Web 服务资源的实例。
WebServiceKeys	Web 服务调用的访问密钥。
WebServicePropertiesForGraph	特定于基于 Graph 的 Web 服务的属性。

AssetItem

有关与 Web 服务关联的资产的信息。

名称	类型	说明
id	string	资产的 ID。
inputPorts	<string,  InputPort>	有关资产的输入端口的信息。
locationInfo	AssetLocation	资产的访问信息。
metadata	object	如果资产是自定义模块，则保留模块的元数据。
name	string	资产的友好名称。
outputPorts	<string,  OutputPort>	有关资产输出端口的信息。
parameters	ModuleAssetParameter[]	如果资产是自定义模块，则保留模块的参数。
type	AssetType	资产的类型。

AssetLocation

描述 Web 服务资产的访问位置。

名称	类型	说明
credentials	string	访问资产的凭据（如果适用）， (例如存储帐户指定的资产连接字符串 + blob URI)
uri	string	可从中访问资产的 URI， (例如系统资产或 https://xyz 用户资产的 aml://abc

AssetType

资产的类型。

名称	类型	说明
Module	string
Resource	string

ColumnFormat

数据类型的其他格式信息。

名称	类型	说明
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

表示 Web 服务输入或输出的数据表中的列的 Swagger 2.0 架构。 请参阅 Swagger 规范： http://swagger.io/specification/

名称	类型	说明
enum	object[]	如果数据类型是分类的，则会提供接受类别的列表。
format	ColumnFormat	数据类型的其他格式信息。
type	ColumnType	列的数据类型。
x-ms-isnullable	boolean	指示类型是否支持 null 值的标志。
x-ms-isordered	boolean	指示类别是否被视为有序集（如果这是分类列）的标志。

ColumnType

列的数据类型。

名称	类型	说明
Boolean	string
Integer	string
Number	string
String	string

CommitmentPlan

有关与 Web 服务关联的机器学习承诺计划的信息。

名称	类型	说明
id	string	指定与 Web 服务关联的承诺计划的 Azure 资源管理器 ID。

DiagnosticsConfiguration

Azure ML Web 服务的诊断设置。

名称	类型	说明
expiry	string	指定日志记录将停止的日期和时间。 如果为 null，则诊断收集不受时间限制。
level	DiagnosticsLevel	指定诊断输出的详细程度。 有效值为：无 - 禁用跟踪;错误 - 仅收集 stderr) 跟踪 (错误;All - 收集 stdout 和 stderr) (的所有跟踪。

DiagnosticsLevel

指定诊断输出的详细程度。 有效值为：None - 禁用跟踪;Error - 仅收集错误 (stderr) 跟踪;全部 - 收集 stdout 和 stderr) (的所有跟踪。

名称	类型	说明
All	string
Error	string
None	string

ExampleRequest

服务输入 () 的示例输入数据。

名称	类型	说明
globalParameters	object	Web 服务的全局参数的示例输入数据
inputs	object	Web 服务的输入 (的示例输入数据) 作为输入名称提供给示例输入值矩阵映射。

GraphEdge

定义 Web 服务图中的边缘。

名称	类型	说明
sourceNodeId	string	源图形节点的标识符。
sourcePortId	string	边缘从其连接的源节点端口的标识符。
targetNodeId	string	目标图节点的标识符。
targetPortId	string	边缘连接到的目标节点端口的标识符。

GraphNode

指定 Web 服务图中的节点。 节点可以是输入、输出或资产节点，因此在任何给定时间仅填充一个相应的 ID 属性。

名称	类型	说明
assetId	string	此节点表示的资产的 ID。
inputId	string	此节点表示的输入元素的 ID。
outputId	string	此节点表示的输出元素的 ID。
parameters	object	如果适用，则为节点的参数。 全局图形参数映射到这些参数中，并在运行时设置值。

GraphPackage

定义组成机器学习解决方案的模块图。

名称	类型	说明
edges	GraphEdge[]	组成图形的边缘列表。
graphParameters	<string,  GraphParameter>	图形的全局参数集合，作为 GraphParameter 映射的全局参数名称提供。 此处的每个参数都有一个 1：1 匹配项，该匹配项与在 WebServiceProperties 级别声明的全局参数值映射。
nodes	<string,  GraphNode>	组成图形的节点集，作为 nodeId 提供给 GraphNode 映射

GraphParameter

在图中定义全局参数。

名称	类型	说明
description	string	此图形参数的说明。
links	GraphParameterLink[]	此参数与图中节点的关联链接。
type	ParameterType	图形参数的类型。

GraphParameterLink

图形全局参数的关联链接到图形中的节点。

名称	类型	说明
nodeId	string	图形节点的标识符
parameterKey	string	全局参数映射到的节点参数的标识符。

InputPort

资产输入端口

名称	类型	默认值	说明
type	InputPortType	Dataset	端口数据类型。

InputPortType

端口数据类型。

名称	类型	说明
Dataset	string

MachineLearningWorkspace

有关机器学习工作区的信息，其中包含 Web 服务的源试验。

名称	类型	说明
id	string	指定与 Web 服务关联的机器学习工作区的工作区 ID

ModeValueInfo

嵌套参数定义。

名称	类型	说明
interfaceString	string	嵌套参数的接口字符串名称。
parameters	ModuleAssetParameter[]	参数的定义。

ModuleAssetParameter

模块资产的参数定义。

名称	类型	说明
modeValuesInfo	<string,  ModeValueInfo>	嵌套接口参数的定义（如果这是复杂模块参数）。
name	string	参数名称。
parameterType	string	参数类型。

OutputPort

资产输出端口

名称	类型	默认值	说明
type	OutputPortType	Dataset	端口数据类型。

OutputPortType

端口数据类型。

名称	类型	说明
Dataset	string

ParameterType

图形参数的类型。

名称	类型	说明
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

只读：Web 服务的预配状态。 有效值为 Unknown、Provisioning、Succeeded 和 Failed。

名称	类型	说明
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

保留 Azure ML Web 服务终结点的可用配置选项。

名称	类型	说明
maxConcurrentCalls	integer	指定可以对 Web 服务进行的最大并发调用。 最小值：4，最大值：200。

ServiceInputOutputSpecification

描述服务的输入和输出的 swagger 2.0 架构。 请参阅 Swagger 规范： http://swagger.io/specification/

名称	类型	默认值	说明
description	string		Swagger 架构的说明。
properties	<string,  TableSpecification>		指定包含 Web 服务每个输入或输出的列架构的集合。 有关详细信息，请参阅 Swagger 规范。
title	string		Swagger 架构的标题。
type	string	object	swagger 中所述的实体的类型。 始终为“object”。

StorageAccount

存储帐户的访问信息。

名称	类型	说明
key	string	指定用于访问存储帐户的密钥。
name	string	指定存储帐户的名称。

TableSpecification

描述单个服务输入或输出的 swagger 2.0 架构。 请参阅 Swagger 规范： http://swagger.io/specification/

名称	类型	默认值	说明
description	string		Swagger 架构说明。
format	string		如果“type”不是“object”，则为格式
properties	<string,  ColumnSpecification>		数据表中的列集。
title	string		Swagger 架构标题。
type	string	object	swagger 中描述的实体的类型。

WebService

Azure ML Web 服务资源的实例。

名称	类型	说明
id	string	指定资源 ID。
location	string	指定资源的位置。
name	string	指定资源的名称。
properties	WebServiceProperties: WebServicePropertiesForGraph	包含描述 Web 服务的属性有效负载。
tags	object	包含定义为键/值对的资源标记。
type	string	指定资源的类型。

WebServiceKeys

Web 服务调用的访问密钥。

名称	类型	说明
primary	string	主访问密钥。
secondary	string	辅助访问密钥。

WebServicePropertiesForGraph

特定于基于 Graph 的 Web 服务的属性。

名称	类型	说明
assets	<string,  AssetItem>	包含描述 Web 服务资产的用户定义属性。 属性表示为键/值对。
commitmentPlan	CommitmentPlan	包含与此 Web 服务关联的承诺计划。 在创建时设置。 设置后，无法更改此值。 注意：对 GET 操作的调用不会返回承诺计划。
createdOn	string	只读：创建 Web 服务的日期和时间。
description	string	Web 服务的说明。
diagnostics	DiagnosticsConfiguration	控制 Web 服务的诊断跟踪集合的设置。
exampleRequest	ExampleRequest	定义一个或多个服务输入的示例输入数据。
exposeSampleData	boolean	设置为 true 时，示例数据将包含在 Web 服务的 swagger 定义中。 默认值为 true。
input	ServiceInputOutputSpecification	包含描述一个或多个 Web 服务的输入的 Swagger 2.0 架构。 有关详细信息，请参阅 Swagger 规范。
keys	WebServiceKeys	包含 Web 服务预配密钥。 如果未指定预配密钥，Azure 机器学习系统会为你生成这些密钥。 注意：密钥不会从对 GET 操作的调用返回。
machineLearningWorkspace	MachineLearningWorkspace	指定机器学习工作区，其中包含 Web 服务的源试验。
modifiedOn	string	只读：上次修改 Web 服务的日期和时间。
output	ServiceInputOutputSpecification	包含描述一个或多个 Web 服务的输出的 Swagger 2.0 架构。 有关详细信息，请参阅 Swagger 规范。
package	GraphPackage	组成此 Web 服务的图形包的定义。
packageType	string: Graph	指定包类型。 有效值为 Graph (指定通过机器学习工作室) 发布的 Web 服务，代码 (指定使用 Python) 等代码发布的 Web 服务。 注意：目前不支持代码。
parameters	object	为 Web 服务定义的一组全局参数值，作为全局参数名称提供给默认值映射。 如果未指定默认值，则将 参数视为必需参数。
provisioningState	ProvisioningState	只读：Web 服务的预配状态。 有效值为 Unknown、Provisioning、Succeeded 和 Failed。
readOnly	boolean	如果设置为 true，则表示 Web 服务是只读的，不能再更新或修补，只能删除。 默认值为 false。 注意：设置为 true 后，无法更改其值。
realtimeConfiguration	RealtimeConfiguration	包含 Web 服务终结点的配置设置。
storageAccount	StorageAccount	指定 Azure 机器学习用于存储有关 Web 服务的信息的存储帐户。 对 GET 操作的调用仅返回存储帐户的名称。 更新存储帐户信息时，必须确保所有必需的资产在新存储帐户中可用，否则对 Web 服务的调用将失败。
swaggerLocation	string	只读：包含与此 Web 服务关联的 swagger 规范的 URI。
title	string	Web 服务的标题。