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

Web Services - Create Or Update

创建或更新 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

创建。 为创建 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 - 禁用跟踪;错误 - 仅收集错误 (stderr) 跟踪;All - 收集所有跟踪(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 (url)

可从中访问资产的 URI(例如系统资产 aml://abc 或用户资产 https://xyz)

AssetType

资产的类型。

说明
Module
Resource

ColumnFormat

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

说明
Byte
Char
Complex128
Complex64
Date-time
Date-timeOffset
Double
Duration
Float
Int16
Int32
Int64
Int8
Uint16
Uint32
Uint64
Uint8

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
Integer
Number
String

CommitmentPlan

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

名称 类型 说明
id

string

指定与 Web 服务关联的承诺计划的 Azure 资源管理器 ID。

DiagnosticsConfiguration

Azure ML Web 服务的诊断设置。

名称 类型 说明
expiry

string (date-time)

指定日志记录将停止的日期和时间。 如果为 null,则诊断收集没有时间限制。

level

DiagnosticsLevel

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

DiagnosticsLevel

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

说明
All
Error
None

ExampleRequest

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

名称 类型 说明
globalParameters

object

Web 服务的全局参数的示例输入数据

inputs

object

作为输入名称提供给 Web 服务的输入(s)的示例输入数据,用于采样输入值矩阵映射。

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 映射的全局参数名称提供。 此处的每个参数都与 WebServiceProperties 级别声明的全局参数值映射匹配 1:1。

nodes

<string,  GraphNode>

组成图形的节点集,作为 nodeId 提供给 GraphNode 映射

GraphParameter

定义图形中的全局参数。

名称 类型 说明
description

string

此图形参数的说明。

links

GraphParameterLink[]

此参数的关联链接指向图形中的节点。

type

ParameterType

图形参数的类型。

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

名称 类型 说明
nodeId

string

图形节点的标识符

parameterKey

string

全局参数映射到的节点参数的标识符。

InputPort

资产输入端口

名称 类型 默认值 说明
type

InputPortType

Dataset

端口数据类型。

InputPortType

端口数据类型。

说明
Dataset

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

ParameterType

图形参数的类型。

说明
Boolean
ColumnPicker
Credential
DataGatewayName
Double
Enumerated
Float
Int
Mode
ParameterRange
Script
String

ProvisioningState

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

说明
Failed
Provisioning
Succeeded
Unknown

RealtimeConfiguration

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

名称 类型 说明
maxConcurrentCalls

integer

minimum: 4
maximum: 200

指定可对 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 (date-time)

只读:创建 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 (date-time)

只读:上次修改 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 服务的标题。