你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Microsoft.MachineLearning webServices 2017-01-01
Bicep 资源定义
可以使用目标操作部署 WebServices 资源类型:
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.MachineLearning/webServices 资源,请将以下 Bicep 添加到模板。
resource symbolicname 'Microsoft.MachineLearning/webServices@2017-01-01' = {
location: 'string'
name: 'string'
properties: {
assets: {
{customized property}: {
id: 'string'
inputPorts: {
{customized property}: {
type: 'string'
}
}
locationInfo: {
credentials: 'string'
uri: 'string'
}
metadata: {
{customized property}: 'string'
}
name: 'string'
outputPorts: {
{customized property}: {
type: 'string'
}
}
parameters: [
{
modeValuesInfo: {
{customized property}: {
interfaceString: 'string'
parameters: [
...
]
}
}
name: 'string'
parameterType: 'string'
}
]
type: 'string'
}
}
commitmentPlan: {
id: 'string'
}
description: 'string'
diagnostics: {
expiry: 'string'
level: 'string'
}
exampleRequest: {
globalParameters: {
{customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
}
inputs: {
{customized property}: [
[
any(Azure.Bicep.Types.Concrete.AnyType)
]
]
}
}
exposeSampleData: bool
input: {
description: 'string'
properties: {
{customized property}: {
description: 'string'
format: 'string'
properties: {
{customized property}: {
enum: [
any(Azure.Bicep.Types.Concrete.AnyType)
]
format: 'string'
type: 'string'
x-ms-isnullable: bool
x-ms-isordered: bool
}
}
title: 'string'
type: 'string'
}
}
title: 'string'
type: 'string'
}
keys: {
primary: 'string'
secondary: 'string'
}
machineLearningWorkspace: {
id: 'string'
}
output: {
description: 'string'
properties: {
{customized property}: {
description: 'string'
format: 'string'
properties: {
{customized property}: {
enum: [
any(Azure.Bicep.Types.Concrete.AnyType)
]
format: 'string'
type: 'string'
x-ms-isnullable: bool
x-ms-isordered: bool
}
}
title: 'string'
type: 'string'
}
}
title: 'string'
type: 'string'
}
parameters: {
{customized property}: {
certificateThumbprint: 'string'
value: any(Azure.Bicep.Types.Concrete.AnyType)
}
}
payloadsInBlobStorage: bool
payloadsLocation: {
credentials: 'string'
uri: 'string'
}
readOnly: bool
realtimeConfiguration: {
maxConcurrentCalls: int
}
storageAccount: {
key: 'string'
name: 'string'
}
title: 'string'
packageType: 'string'
// For remaining properties, see WebServiceProperties objects
}
tags: {
{customized property}: 'string'
}
}
WebServiceProperties 对象
设置 packageType 属性以指定对象的类型。
对于 Graph,请使用:
{
package: {
edges: [
{
sourceNodeId: 'string'
sourcePortId: 'string'
targetNodeId: 'string'
targetPortId: 'string'
}
]
graphParameters: {
{customized property}: {
description: 'string'
links: [
{
nodeId: 'string'
parameterKey: 'string'
}
]
type: 'string'
}
}
nodes: {
{customized property}: {
assetId: 'string'
inputId: 'string'
outputId: 'string'
parameters: {
{customized property}: {
certificateThumbprint: 'string'
value: any(Azure.Bicep.Types.Concrete.AnyType)
}
}
}
}
}
packageType: 'Graph'
}
属性值
AssetItem
名字 | 描述 | 价值 |
---|---|---|
id | 资产的 ID。 | 字符串 |
inputPorts | 有关资产的输入端口的信息。 | AssetItemInputPorts |
locationInfo | 访问资产的信息。 | BlobLocation (必需) |
元数据 | 如果资产是自定义模块,则保留模块的元数据。 | AssetItemMetadata |
名字 | 资产的友好名称。 | string (必需) |
outputPorts | 有关资产的输出端口的信息。 | AssetItemOutputPorts |
参数 | 如果资产是自定义模块,则保留模块的参数。 | ModuleAssetParameter[] |
类型 | 资产的类型。 | “Module” “资源”(必需) |
AssetItemInputPorts
名字 | 描述 | 价值 |
---|
AssetItemMetadata
名字 | 描述 | 价值 |
---|
AssetItemOutputPorts
名字 | 描述 | 价值 |
---|
BlobLocation
名字 | 描述 | 价值 |
---|---|---|
凭据 | 如果适用,请访问 Blob 的凭据(例如存储帐户连接字符串 + Blob URI 指定的 Blob) | 字符串 |
uri | 可从中访问 Blob 的 URI。 例如,aml://abc 系统资产或用户资产或有效负载 https://xyz。 | string (必需) |
ColumnSpecification
名字 | 描述 | 价值 |
---|---|---|
枚举 | 如果数据类型是分类的,则提供接受的类别列表。 | any[] |
格式 | 数据类型的其他格式信息。 | “字节” “Char” “Complex128” “Complex64” “Date-time” “Date-timeOffset” “Double” “Duration” “Float” “Int16” “Int32” “Int64” “Int8” “Uint16” “Uint32” “Uint64” “Uint8” |
类型 | 列的数据类型。 | “Boolean” “Integer” “Number” “String”(必需) |
x-ms-isnullable | 指示类型是否支持 null 值的标志。 | bool |
x-ms-isordered | 指示类别是否被视为有序集的标志(如果这是分类列)。 | bool |
CommitmentPlan
名字 | 描述 | 价值 |
---|---|---|
id | 指定与 Web 服务关联的承诺计划的 Azure 资源管理器 ID。 | string (必需) |
DiagnosticsConfiguration
名字 | 描述 | 价值 |
---|---|---|
满期 | 指定日志记录将停止的日期和时间。 如果为 null,则诊断收集没有时间限制。 | 字符串 |
水平 | 指定诊断输出的详细程度。 有效值为:None - 禁用跟踪;错误 - 仅收集错误 (stderr) 跟踪;All - 收集所有跟踪(stdout 和 stderr)。 | “All” “Error” “无”(必需) |
ExampleRequest
名字 | 描述 | 价值 |
---|---|---|
globalParameters | Web 服务的全局参数的示例输入数据 | ExampleRequestGlobalParameters |
输入 | 作为输入名称提供给 Web 服务的输入(s)的示例输入数据,用于采样输入值矩阵映射。 | ExampleRequestInputs |
ExampleRequestGlobalParameters
名字 | 描述 | 价值 |
---|
ExampleRequestInputs
名字 | 描述 | 价值 |
---|
GraphEdge
名字 | 描述 | 价值 |
---|---|---|
sourceNodeId | 源图形节点的标识符。 | 字符串 |
sourcePortId | 边缘从中连接的源节点端口的标识符。 | 字符串 |
targetNodeId | 目标图形节点的标识符。 | 字符串 |
targetPortId | 边缘连接到的目标节点端口的标识符。 | 字符串 |
GraphNode
名字 | 描述 | 价值 |
---|---|---|
assetId | 此节点表示的资产的 ID。 | 字符串 |
inputId | 此节点表示的输入元素的 ID。 | 字符串 |
outputId | 由此节点表示的输出元素的 ID。 | 字符串 |
参数 | 如果适用,则为节点的参数。 全局图形参数映射到这些参数,并在运行时设置值。 | GraphNodeParameters |
GraphNodeParameters
名字 | 描述 | 价值 |
---|
GraphPackage
名字 | 描述 | 价值 |
---|---|---|
边缘 | 组成图形的边缘列表。 | GraphEdge[] |
graphParameters | 图形的全局参数集合,作为 GraphParameter 映射的全局参数名称提供。 此处的每个参数都与 WebServiceProperties 级别声明的全局参数值映射匹配 1:1。 | GraphPackageGraphParameters |
节点 | 组成图形的节点集,作为 nodeId 提供给 GraphNode 映射 | GraphPackageNodes |
GraphPackageGraphParameters
名字 | 描述 | 价值 |
---|
GraphPackageNodes
名字 | 描述 | 价值 |
---|
GraphParameter
名字 | 描述 | 价值 |
---|---|---|
描述 | 此图形参数的说明。 | 字符串 |
链接 | 此参数的关联链接指向图形中的节点。 | GraphParameterLink[] (必需) |
类型 | 图形参数的类型。 | “Boolean” “ColumnPicker” “Credential” “DataGatewayName” “Double” “Enumerated” “Float” “Int” “Mode” “ParameterRange” “Script” “String”(必需) |
GraphParameterLink
名字 | 描述 | 价值 |
---|---|---|
nodeId | 图形节点的标识符 | string (必需) |
parameterKey | 全局参数映射到的节点参数的标识符。 | string (必需) |
InputPort
名字 | 描述 | 价值 |
---|---|---|
类型 | 端口数据类型。 | “Dataset” |
MachineLearningWorkspace
名字 | 描述 | 价值 |
---|---|---|
id | 指定与 Web 服务关联的机器学习工作区的工作区 ID | string (必需) |
Microsoft.MachineLearning/webServices
名字 | 描述 | 价值 |
---|---|---|
位置 | 指定资源的位置。 | string (必需) |
名字 | 资源名称 | string (必需) |
性能 | 包含描述 Web 服务的属性有效负载。 | WebServiceProperties (必需) |
标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
ModeValueInfo
名字 | 描述 | 价值 |
---|---|---|
interfaceString | 嵌套参数的接口字符串名称。 | 字符串 |
参数 | 参数的定义。 | ModuleAssetParameter[] |
ModuleAssetParameter
名字 | 描述 | 价值 |
---|---|---|
modeValuesInfo | 如果这是复杂的模块参数,则为嵌套接口参数的定义。 | ModuleAssetParameterModeValuesInfo |
名字 | 参数名称。 | 字符串 |
parameterType | 参数类型。 | 字符串 |
ModuleAssetParameterModeValuesInfo
名字 | 描述 | 价值 |
---|
OutputPort
名字 | 描述 | 价值 |
---|---|---|
类型 | 端口数据类型。 | “Dataset” |
RealtimeConfiguration
名字 | 描述 | 价值 |
---|---|---|
maxConcurrentCalls | 指定可对 Web 服务进行的最大并发调用。 最小值:4,最大值:200。 | int 约束: 最小值 = 4 最大值 = 200 |
ResourceTags
名字 | 描述 | 价值 |
---|
ServiceInputOutputSpecification
名字 | 描述 | 价值 |
---|---|---|
描述 | Swagger 架构的说明。 | 字符串 |
性能 | 指定一个集合,该集合包含 Web 服务的每个输入或输出的列架构。 有关详细信息,请参阅 Swagger 规范。 | ServiceInputOutputSpecificationProperties(必需) |
标题 | Swagger 架构的标题。 | 字符串 |
类型 | swagger 中介绍的实体的类型。 始终为“object”。 | string (必需) |
ServiceInputOutputSpecificationProperties
名字 | 描述 | 价值 |
---|
StorageAccount
名字 | 描述 | 价值 |
---|---|---|
钥匙 | 指定用于访问存储帐户的密钥。 | 字符串 |
名字 | 指定存储帐户的名称。 | 字符串 |
TableSpecification
名字 | 描述 | 价值 |
---|---|---|
描述 | Swagger 架构说明。 | 字符串 |
格式 | 格式(如果“type”不是“object”) | 字符串 |
性能 | 数据表中的列集。 | TableSpecificationProperties |
标题 | Swagger 架构标题。 | 字符串 |
类型 | swagger 中介绍的实体的类型。 | string (必需) |
TableSpecificationProperties
名字 | 描述 | 价值 |
---|
WebServiceKeys
名字 | 描述 | 价值 |
---|---|---|
主要 | 主访问密钥。 | 字符串 |
二 次 | 辅助访问密钥。 | 字符串 |
WebServiceParameter
名字 | 描述 | 价值 |
---|---|---|
certificateThumbprint | 如果“value”字段中的参数值已加密,则应将证书的指纹放在此处。 | 字符串 |
价值 | 参数值 | 任何 |
WebServiceProperties
名字 | 描述 | 价值 |
---|---|---|
资产 | 包含描述 Web 服务资产的用户定义属性。 属性表示为键/值对。 | WebServicePropertiesAssets |
commitmentPlan | 包含与此 Web 服务关联的承诺计划。 在创建时设置。 设置后,无法更改此值。 注意:承诺计划不会从对 GET 操作的调用返回。 | CommitmentPlan |
描述 | Web 服务的说明。 | 字符串 |
诊断 | 控制 Web 服务的诊断跟踪集合的设置。 | DiagnosticsConfiguration |
exampleRequest | 为一个或多个服务的输入定义示例输入数据。 | ExampleRequest |
exposeSampleData | 设置为 true 时,示例数据包含在 Web 服务的 swagger 定义中。 默认值为 true。 | bool |
输入 | 包含描述一个或多个 Web 服务的输入的 Swagger 2.0 架构。 有关详细信息,请参阅 Swagger 规范。 | ServiceInputOutputSpecification |
钥匙 | 包含 Web 服务预配密钥。 如果未指定预配密钥,Azure 机器学习系统会为你生成它们。 注意:密钥不会从对 GET 操作的调用中返回。 | WebServiceKeys |
machineLearningWorkspace | 指定包含 Web 服务的源的试验的机器学习工作区。 | MachineLearningWorkspace |
输出 | 包含描述一个或多个 Web 服务的输出的 Swagger 2.0 架构。 有关详细信息,请参阅 Swagger 规范。 | ServiceInputOutputSpecification |
packageType | 对于 WebServicePropertiesForGraph,请设置为“Graph”。 | “Graph”(必需) |
参数 | 为 Web 服务定义的全局参数值集,给定为默认值映射的全局参数名称。 如果未指定默认值,则参数被视为必需。 | WebServicePropertiesParameters |
payloadsInBlobStorage | 设置为 true 时,指示有效负载大小大于 3 MB。 否则为 false。 如果有效负载大小超过 3 MB,则有效负载存储在 Blob 中,PayloadsLocation 参数包含 blob 的 URI。 否则,此值将设置为 false,资产、输入、输出、包、参数、ExampleRequest 为内联。 有效负载大小通过添加资产、输入、输出、包、参数和 ExampleRequest 的大小来确定。 | bool |
payloadsLocation | 有效负载 Blob 的 URI。 仅当 payloadsInBlobStorage 参数设置为 true 时,此参数才包含一个值。 否则设置为 null。 | BlobLocation |
readOnly | 如果设置为 true,则表示 Web 服务为只读,且无法再更新或修补,仅删除。 默认值为 false。 注意:设置为 true 后,无法更改其值。 | bool |
realtimeConfiguration | 包含 Web 服务终结点的配置设置。 | RealtimeConfiguration |
storageAccount | 指定 Azure 机器学习用于存储有关 Web 服务的信息的存储帐户。 仅从对 GET 操作的调用中返回存储帐户的名称。 更新存储帐户信息时,必须确保新存储帐户中提供了所有必要的资产,或者对 Web 服务的调用将失败。 | StorageAccount |
标题 | Web 服务的标题。 | 字符串 |
WebServicePropertiesAssets
名字 | 描述 | 价值 |
---|
WebServicePropertiesForGraph
名字 | 描述 | 价值 |
---|---|---|
包 | 组成此 Web 服务的图形包的定义。 | GraphPackage |
packageType | 指定包类型。 有效值为 Graph(指定通过机器学习工作室发布的 Web 服务和代码(指定使用 Python 等代码发布的 Web 服务)。 注意:目前不支持代码。 | “Graph”(必需) |
WebServicePropertiesParameters
名字 | 描述 | 价值 |
---|
ARM 模板资源定义
可以使用目标操作部署 WebServices 资源类型:
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.MachineLearning/webServices 资源,请将以下 JSON 添加到模板。
{
"type": "Microsoft.MachineLearning/webServices",
"apiVersion": "2017-01-01",
"name": "string",
"location": "string",
"properties": {
"assets": {
"{customized property}": {
"id": "string",
"inputPorts": {
"{customized property}": {
"type": "string"
}
},
"locationInfo": {
"credentials": "string",
"uri": "string"
},
"metadata": {
"{customized property}": "string"
},
"name": "string",
"outputPorts": {
"{customized property}": {
"type": "string"
}
},
"parameters": [
{
"modeValuesInfo": {
"{customized property}": {
"interfaceString": "string",
"parameters": [
...
]
}
},
"name": "string",
"parameterType": "string"
}
],
"type": "string"
}
},
"commitmentPlan": {
"id": "string"
},
"description": "string",
"diagnostics": {
"expiry": "string",
"level": "string"
},
"exampleRequest": {
"globalParameters": {
"{customized property}": {}
},
"inputs": {
"{customized property}": [
[ {} ]
]
}
},
"exposeSampleData": "bool",
"input": {
"description": "string",
"properties": {
"{customized property}": {
"description": "string",
"format": "string",
"properties": {
"{customized property}": {
"enum": [ {} ],
"format": "string",
"type": "string",
"x-ms-isnullable": "bool",
"x-ms-isordered": "bool"
}
},
"title": "string",
"type": "string"
}
},
"title": "string",
"type": "string"
},
"keys": {
"primary": "string",
"secondary": "string"
},
"machineLearningWorkspace": {
"id": "string"
},
"output": {
"description": "string",
"properties": {
"{customized property}": {
"description": "string",
"format": "string",
"properties": {
"{customized property}": {
"enum": [ {} ],
"format": "string",
"type": "string",
"x-ms-isnullable": "bool",
"x-ms-isordered": "bool"
}
},
"title": "string",
"type": "string"
}
},
"title": "string",
"type": "string"
},
"parameters": {
"{customized property}": {
"certificateThumbprint": "string",
"value": {}
}
},
"payloadsInBlobStorage": "bool",
"payloadsLocation": {
"credentials": "string",
"uri": "string"
},
"readOnly": "bool",
"realtimeConfiguration": {
"maxConcurrentCalls": "int"
},
"storageAccount": {
"key": "string",
"name": "string"
},
"title": "string",
"packageType": "string"
// For remaining properties, see WebServiceProperties objects
},
"tags": {
"{customized property}": "string"
}
}
WebServiceProperties 对象
设置 packageType 属性以指定对象的类型。
对于 Graph,请使用:
{
"package": {
"edges": [
{
"sourceNodeId": "string",
"sourcePortId": "string",
"targetNodeId": "string",
"targetPortId": "string"
}
],
"graphParameters": {
"{customized property}": {
"description": "string",
"links": [
{
"nodeId": "string",
"parameterKey": "string"
}
],
"type": "string"
}
},
"nodes": {
"{customized property}": {
"assetId": "string",
"inputId": "string",
"outputId": "string",
"parameters": {
"{customized property}": {
"certificateThumbprint": "string",
"value": {}
}
}
}
}
},
"packageType": "Graph"
}
属性值
AssetItem
名字 | 描述 | 价值 |
---|---|---|
id | 资产的 ID。 | 字符串 |
inputPorts | 有关资产的输入端口的信息。 | AssetItemInputPorts |
locationInfo | 访问资产的信息。 | BlobLocation (必需) |
元数据 | 如果资产是自定义模块,则保留模块的元数据。 | AssetItemMetadata |
名字 | 资产的友好名称。 | string (必需) |
outputPorts | 有关资产的输出端口的信息。 | AssetItemOutputPorts |
参数 | 如果资产是自定义模块,则保留模块的参数。 | ModuleAssetParameter[] |
类型 | 资产的类型。 | “Module” “资源”(必需) |
AssetItemInputPorts
名字 | 描述 | 价值 |
---|
AssetItemMetadata
名字 | 描述 | 价值 |
---|
AssetItemOutputPorts
名字 | 描述 | 价值 |
---|
BlobLocation
名字 | 描述 | 价值 |
---|---|---|
凭据 | 如果适用,请访问 Blob 的凭据(例如存储帐户连接字符串 + Blob URI 指定的 Blob) | 字符串 |
uri | 可从中访问 Blob 的 URI。 例如,aml://abc 系统资产或用户资产或有效负载 https://xyz。 | string (必需) |
ColumnSpecification
名字 | 描述 | 价值 |
---|---|---|
枚举 | 如果数据类型是分类的,则提供接受的类别列表。 | any[] |
格式 | 数据类型的其他格式信息。 | “字节” “Char” “Complex128” “Complex64” “Date-time” “Date-timeOffset” “Double” “Duration” “Float” “Int16” “Int32” “Int64” “Int8” “Uint16” “Uint32” “Uint64” “Uint8” |
类型 | 列的数据类型。 | “Boolean” “Integer” “Number” “String”(必需) |
x-ms-isnullable | 指示类型是否支持 null 值的标志。 | bool |
x-ms-isordered | 指示类别是否被视为有序集的标志(如果这是分类列)。 | bool |
CommitmentPlan
名字 | 描述 | 价值 |
---|---|---|
id | 指定与 Web 服务关联的承诺计划的 Azure 资源管理器 ID。 | string (必需) |
DiagnosticsConfiguration
名字 | 描述 | 价值 |
---|---|---|
满期 | 指定日志记录将停止的日期和时间。 如果为 null,则诊断收集没有时间限制。 | 字符串 |
水平 | 指定诊断输出的详细程度。 有效值为:None - 禁用跟踪;错误 - 仅收集错误 (stderr) 跟踪;All - 收集所有跟踪(stdout 和 stderr)。 | “All” “Error” “无”(必需) |
ExampleRequest
名字 | 描述 | 价值 |
---|---|---|
globalParameters | Web 服务的全局参数的示例输入数据 | ExampleRequestGlobalParameters |
输入 | 作为输入名称提供给 Web 服务的输入(s)的示例输入数据,用于采样输入值矩阵映射。 | ExampleRequestInputs |
ExampleRequestGlobalParameters
名字 | 描述 | 价值 |
---|
ExampleRequestInputs
名字 | 描述 | 价值 |
---|
GraphEdge
名字 | 描述 | 价值 |
---|---|---|
sourceNodeId | 源图形节点的标识符。 | 字符串 |
sourcePortId | 边缘从中连接的源节点端口的标识符。 | 字符串 |
targetNodeId | 目标图形节点的标识符。 | 字符串 |
targetPortId | 边缘连接到的目标节点端口的标识符。 | 字符串 |
GraphNode
名字 | 描述 | 价值 |
---|---|---|
assetId | 此节点表示的资产的 ID。 | 字符串 |
inputId | 此节点表示的输入元素的 ID。 | 字符串 |
outputId | 由此节点表示的输出元素的 ID。 | 字符串 |
参数 | 如果适用,则为节点的参数。 全局图形参数映射到这些参数,并在运行时设置值。 | GraphNodeParameters |
GraphNodeParameters
名字 | 描述 | 价值 |
---|
GraphPackage
名字 | 描述 | 价值 |
---|---|---|
边缘 | 组成图形的边缘列表。 | GraphEdge[] |
graphParameters | 图形的全局参数集合,作为 GraphParameter 映射的全局参数名称提供。 此处的每个参数都与 WebServiceProperties 级别声明的全局参数值映射匹配 1:1。 | GraphPackageGraphParameters |
节点 | 组成图形的节点集,作为 nodeId 提供给 GraphNode 映射 | GraphPackageNodes |
GraphPackageGraphParameters
名字 | 描述 | 价值 |
---|
GraphPackageNodes
名字 | 描述 | 价值 |
---|
GraphParameter
名字 | 描述 | 价值 |
---|---|---|
描述 | 此图形参数的说明。 | 字符串 |
链接 | 此参数的关联链接指向图形中的节点。 | GraphParameterLink[] (必需) |
类型 | 图形参数的类型。 | “Boolean” “ColumnPicker” “Credential” “DataGatewayName” “Double” “Enumerated” “Float” “Int” “Mode” “ParameterRange” “Script” “String”(必需) |
GraphParameterLink
名字 | 描述 | 价值 |
---|---|---|
nodeId | 图形节点的标识符 | string (必需) |
parameterKey | 全局参数映射到的节点参数的标识符。 | string (必需) |
InputPort
名字 | 描述 | 价值 |
---|---|---|
类型 | 端口数据类型。 | “Dataset” |
MachineLearningWorkspace
名字 | 描述 | 价值 |
---|---|---|
id | 指定与 Web 服务关联的机器学习工作区的工作区 ID | string (必需) |
Microsoft.MachineLearning/webServices
名字 | 描述 | 价值 |
---|---|---|
apiVersion | API 版本 | '2017-01-01' |
位置 | 指定资源的位置。 | string (必需) |
名字 | 资源名称 | string (必需) |
性能 | 包含描述 Web 服务的属性有效负载。 | WebServiceProperties (必需) |
标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
类型 | 资源类型 | “Microsoft.MachineLearning/webServices” |
ModeValueInfo
名字 | 描述 | 价值 |
---|---|---|
interfaceString | 嵌套参数的接口字符串名称。 | 字符串 |
参数 | 参数的定义。 | ModuleAssetParameter[] |
ModuleAssetParameter
名字 | 描述 | 价值 |
---|---|---|
modeValuesInfo | 如果这是复杂的模块参数,则为嵌套接口参数的定义。 | ModuleAssetParameterModeValuesInfo |
名字 | 参数名称。 | 字符串 |
parameterType | 参数类型。 | 字符串 |
ModuleAssetParameterModeValuesInfo
名字 | 描述 | 价值 |
---|
OutputPort
名字 | 描述 | 价值 |
---|---|---|
类型 | 端口数据类型。 | “Dataset” |
RealtimeConfiguration
名字 | 描述 | 价值 |
---|---|---|
maxConcurrentCalls | 指定可对 Web 服务进行的最大并发调用。 最小值:4,最大值:200。 | int 约束: 最小值 = 4 最大值 = 200 |
ResourceTags
名字 | 描述 | 价值 |
---|
ServiceInputOutputSpecification
名字 | 描述 | 价值 |
---|---|---|
描述 | Swagger 架构的说明。 | 字符串 |
性能 | 指定一个集合,该集合包含 Web 服务的每个输入或输出的列架构。 有关详细信息,请参阅 Swagger 规范。 | ServiceInputOutputSpecificationProperties(必需) |
标题 | Swagger 架构的标题。 | 字符串 |
类型 | swagger 中介绍的实体的类型。 始终为“object”。 | string (必需) |
ServiceInputOutputSpecificationProperties
名字 | 描述 | 价值 |
---|
StorageAccount
名字 | 描述 | 价值 |
---|---|---|
钥匙 | 指定用于访问存储帐户的密钥。 | 字符串 |
名字 | 指定存储帐户的名称。 | 字符串 |
TableSpecification
名字 | 描述 | 价值 |
---|---|---|
描述 | Swagger 架构说明。 | 字符串 |
格式 | 格式(如果“type”不是“object”) | 字符串 |
性能 | 数据表中的列集。 | TableSpecificationProperties |
标题 | Swagger 架构标题。 | 字符串 |
类型 | swagger 中介绍的实体的类型。 | string (必需) |
TableSpecificationProperties
名字 | 描述 | 价值 |
---|
WebServiceKeys
名字 | 描述 | 价值 |
---|---|---|
主要 | 主访问密钥。 | 字符串 |
二 次 | 辅助访问密钥。 | 字符串 |
WebServiceParameter
名字 | 描述 | 价值 |
---|---|---|
certificateThumbprint | 如果“value”字段中的参数值已加密,则应将证书的指纹放在此处。 | 字符串 |
价值 | 参数值 | 任何 |
WebServiceProperties
名字 | 描述 | 价值 |
---|---|---|
资产 | 包含描述 Web 服务资产的用户定义属性。 属性表示为键/值对。 | WebServicePropertiesAssets |
commitmentPlan | 包含与此 Web 服务关联的承诺计划。 在创建时设置。 设置后,无法更改此值。 注意:承诺计划不会从对 GET 操作的调用返回。 | CommitmentPlan |
描述 | Web 服务的说明。 | 字符串 |
诊断 | 控制 Web 服务的诊断跟踪集合的设置。 | DiagnosticsConfiguration |
exampleRequest | 为一个或多个服务的输入定义示例输入数据。 | ExampleRequest |
exposeSampleData | 设置为 true 时,示例数据包含在 Web 服务的 swagger 定义中。 默认值为 true。 | bool |
输入 | 包含描述一个或多个 Web 服务的输入的 Swagger 2.0 架构。 有关详细信息,请参阅 Swagger 规范。 | ServiceInputOutputSpecification |
钥匙 | 包含 Web 服务预配密钥。 如果未指定预配密钥,Azure 机器学习系统会为你生成它们。 注意:密钥不会从对 GET 操作的调用中返回。 | WebServiceKeys |
machineLearningWorkspace | 指定包含 Web 服务的源的试验的机器学习工作区。 | MachineLearningWorkspace |
输出 | 包含描述一个或多个 Web 服务的输出的 Swagger 2.0 架构。 有关详细信息,请参阅 Swagger 规范。 | ServiceInputOutputSpecification |
packageType | 对于 WebServicePropertiesForGraph,请设置为“Graph”。 | “Graph”(必需) |
参数 | 为 Web 服务定义的全局参数值集,给定为默认值映射的全局参数名称。 如果未指定默认值,则参数被视为必需。 | WebServicePropertiesParameters |
payloadsInBlobStorage | 设置为 true 时,指示有效负载大小大于 3 MB。 否则为 false。 如果有效负载大小超过 3 MB,则有效负载存储在 Blob 中,PayloadsLocation 参数包含 blob 的 URI。 否则,此值将设置为 false,资产、输入、输出、包、参数、ExampleRequest 为内联。 有效负载大小通过添加资产、输入、输出、包、参数和 ExampleRequest 的大小来确定。 | bool |
payloadsLocation | 有效负载 Blob 的 URI。 仅当 payloadsInBlobStorage 参数设置为 true 时,此参数才包含一个值。 否则设置为 null。 | BlobLocation |
readOnly | 如果设置为 true,则表示 Web 服务为只读,且无法再更新或修补,仅删除。 默认值为 false。 注意:设置为 true 后,无法更改其值。 | bool |
realtimeConfiguration | 包含 Web 服务终结点的配置设置。 | RealtimeConfiguration |
storageAccount | 指定 Azure 机器学习用于存储有关 Web 服务的信息的存储帐户。 仅从对 GET 操作的调用中返回存储帐户的名称。 更新存储帐户信息时,必须确保新存储帐户中提供了所有必要的资产,或者对 Web 服务的调用将失败。 | StorageAccount |
标题 | Web 服务的标题。 | 字符串 |
WebServicePropertiesAssets
名字 | 描述 | 价值 |
---|
WebServicePropertiesForGraph
名字 | 描述 | 价值 |
---|---|---|
包 | 组成此 Web 服务的图形包的定义。 | GraphPackage |
packageType | 指定包类型。 有效值为 Graph(指定通过机器学习工作室发布的 Web 服务和代码(指定使用 Python 等代码发布的 Web 服务)。 注意:目前不支持代码。 | “Graph”(必需) |
WebServicePropertiesParameters
名字 | 描述 | 价值 |
---|
Terraform (AzAPI 提供程序)资源定义
可以使用目标操作部署 WebServices 资源类型:
- 资源组
有关每个 API 版本中已更改属性的列表,请参阅 更改日志。
资源格式
若要创建 Microsoft.MachineLearning/webServices 资源,请将以下 Terraform 添加到模板。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.MachineLearning/webServices@2017-01-01"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
assets = {
{customized property} = {
id = "string"
inputPorts = {
{customized property} = {
type = "string"
}
}
locationInfo = {
credentials = "string"
uri = "string"
}
metadata = {
{customized property} = "string"
}
name = "string"
outputPorts = {
{customized property} = {
type = "string"
}
}
parameters = [
{
modeValuesInfo = {
{customized property} = {
interfaceString = "string"
parameters = [
...
]
}
}
name = "string"
parameterType = "string"
}
]
type = "string"
}
}
commitmentPlan = {
id = "string"
}
description = "string"
diagnostics = {
expiry = "string"
level = "string"
}
exampleRequest = {
globalParameters = {
{customized property} = ?
}
inputs = {
{customized property} = [
[
?
]
]
}
}
exposeSampleData = bool
input = {
description = "string"
properties = {
{customized property} = {
description = "string"
format = "string"
properties = {
{customized property} = {
enum = [
?
]
format = "string"
type = "string"
x-ms-isnullable = bool
x-ms-isordered = bool
}
}
title = "string"
type = "string"
}
}
title = "string"
type = "string"
}
keys = {
primary = "string"
secondary = "string"
}
machineLearningWorkspace = {
id = "string"
}
output = {
description = "string"
properties = {
{customized property} = {
description = "string"
format = "string"
properties = {
{customized property} = {
enum = [
?
]
format = "string"
type = "string"
x-ms-isnullable = bool
x-ms-isordered = bool
}
}
title = "string"
type = "string"
}
}
title = "string"
type = "string"
}
parameters = {
{customized property} = {
certificateThumbprint = "string"
value = ?
}
}
payloadsInBlobStorage = bool
payloadsLocation = {
credentials = "string"
uri = "string"
}
readOnly = bool
realtimeConfiguration = {
maxConcurrentCalls = int
}
storageAccount = {
key = "string"
name = "string"
}
title = "string"
packageType = "string"
// For remaining properties, see WebServiceProperties objects
}
})
}
WebServiceProperties 对象
设置 packageType 属性以指定对象的类型。
对于 Graph,请使用:
{
package = {
edges = [
{
sourceNodeId = "string"
sourcePortId = "string"
targetNodeId = "string"
targetPortId = "string"
}
]
graphParameters = {
{customized property} = {
description = "string"
links = [
{
nodeId = "string"
parameterKey = "string"
}
]
type = "string"
}
}
nodes = {
{customized property} = {
assetId = "string"
inputId = "string"
outputId = "string"
parameters = {
{customized property} = {
certificateThumbprint = "string"
value = ?
}
}
}
}
}
packageType = "Graph"
}
属性值
AssetItem
名字 | 描述 | 价值 |
---|---|---|
id | 资产的 ID。 | 字符串 |
inputPorts | 有关资产的输入端口的信息。 | AssetItemInputPorts |
locationInfo | 访问资产的信息。 | BlobLocation (必需) |
元数据 | 如果资产是自定义模块,则保留模块的元数据。 | AssetItemMetadata |
名字 | 资产的友好名称。 | string (必需) |
outputPorts | 有关资产的输出端口的信息。 | AssetItemOutputPorts |
参数 | 如果资产是自定义模块,则保留模块的参数。 | ModuleAssetParameter[] |
类型 | 资产的类型。 | “Module” “资源”(必需) |
AssetItemInputPorts
名字 | 描述 | 价值 |
---|
AssetItemMetadata
名字 | 描述 | 价值 |
---|
AssetItemOutputPorts
名字 | 描述 | 价值 |
---|
BlobLocation
名字 | 描述 | 价值 |
---|---|---|
凭据 | 如果适用,请访问 Blob 的凭据(例如存储帐户连接字符串 + Blob URI 指定的 Blob) | 字符串 |
uri | 可从中访问 Blob 的 URI。 例如,aml://abc 系统资产或用户资产或有效负载 https://xyz。 | string (必需) |
ColumnSpecification
名字 | 描述 | 价值 |
---|---|---|
枚举 | 如果数据类型是分类的,则提供接受的类别列表。 | any[] |
格式 | 数据类型的其他格式信息。 | “字节” “Char” “Complex128” “Complex64” “Date-time” “Date-timeOffset” “Double” “Duration” “Float” “Int16” “Int32” “Int64” “Int8” “Uint16” “Uint32” “Uint64” “Uint8” |
类型 | 列的数据类型。 | “Boolean” “Integer” “Number” “String”(必需) |
x-ms-isnullable | 指示类型是否支持 null 值的标志。 | bool |
x-ms-isordered | 指示类别是否被视为有序集的标志(如果这是分类列)。 | bool |
CommitmentPlan
名字 | 描述 | 价值 |
---|---|---|
id | 指定与 Web 服务关联的承诺计划的 Azure 资源管理器 ID。 | string (必需) |
DiagnosticsConfiguration
名字 | 描述 | 价值 |
---|---|---|
满期 | 指定日志记录将停止的日期和时间。 如果为 null,则诊断收集没有时间限制。 | 字符串 |
水平 | 指定诊断输出的详细程度。 有效值为:None - 禁用跟踪;错误 - 仅收集错误 (stderr) 跟踪;All - 收集所有跟踪(stdout 和 stderr)。 | “All” “Error” “无”(必需) |
ExampleRequest
名字 | 描述 | 价值 |
---|---|---|
globalParameters | Web 服务的全局参数的示例输入数据 | ExampleRequestGlobalParameters |
输入 | 作为输入名称提供给 Web 服务的输入(s)的示例输入数据,用于采样输入值矩阵映射。 | ExampleRequestInputs |
ExampleRequestGlobalParameters
名字 | 描述 | 价值 |
---|
ExampleRequestInputs
名字 | 描述 | 价值 |
---|
GraphEdge
名字 | 描述 | 价值 |
---|---|---|
sourceNodeId | 源图形节点的标识符。 | 字符串 |
sourcePortId | 边缘从中连接的源节点端口的标识符。 | 字符串 |
targetNodeId | 目标图形节点的标识符。 | 字符串 |
targetPortId | 边缘连接到的目标节点端口的标识符。 | 字符串 |
GraphNode
名字 | 描述 | 价值 |
---|---|---|
assetId | 此节点表示的资产的 ID。 | 字符串 |
inputId | 此节点表示的输入元素的 ID。 | 字符串 |
outputId | 由此节点表示的输出元素的 ID。 | 字符串 |
参数 | 如果适用,则为节点的参数。 全局图形参数映射到这些参数,并在运行时设置值。 | GraphNodeParameters |
GraphNodeParameters
名字 | 描述 | 价值 |
---|
GraphPackage
名字 | 描述 | 价值 |
---|---|---|
边缘 | 组成图形的边缘列表。 | GraphEdge[] |
graphParameters | 图形的全局参数集合,作为 GraphParameter 映射的全局参数名称提供。 此处的每个参数都与 WebServiceProperties 级别声明的全局参数值映射匹配 1:1。 | GraphPackageGraphParameters |
节点 | 组成图形的节点集,作为 nodeId 提供给 GraphNode 映射 | GraphPackageNodes |
GraphPackageGraphParameters
名字 | 描述 | 价值 |
---|
GraphPackageNodes
名字 | 描述 | 价值 |
---|
GraphParameter
名字 | 描述 | 价值 |
---|---|---|
描述 | 此图形参数的说明。 | 字符串 |
链接 | 此参数的关联链接指向图形中的节点。 | GraphParameterLink[] (必需) |
类型 | 图形参数的类型。 | “Boolean” “ColumnPicker” “Credential” “DataGatewayName” “Double” “Enumerated” “Float” “Int” “Mode” “ParameterRange” “Script” “String”(必需) |
GraphParameterLink
名字 | 描述 | 价值 |
---|---|---|
nodeId | 图形节点的标识符 | string (必需) |
parameterKey | 全局参数映射到的节点参数的标识符。 | string (必需) |
InputPort
名字 | 描述 | 价值 |
---|---|---|
类型 | 端口数据类型。 | “Dataset” |
MachineLearningWorkspace
名字 | 描述 | 价值 |
---|---|---|
id | 指定与 Web 服务关联的机器学习工作区的工作区 ID | string (必需) |
Microsoft.MachineLearning/webServices
名字 | 描述 | 价值 |
---|---|---|
位置 | 指定资源的位置。 | string (必需) |
名字 | 资源名称 | string (必需) |
性能 | 包含描述 Web 服务的属性有效负载。 | WebServiceProperties (必需) |
标签 | 资源标记 | 标记名称和值的字典。 |
类型 | 资源类型 | “Microsoft.MachineLearning/webServices@2017-01-01” |
ModeValueInfo
名字 | 描述 | 价值 |
---|---|---|
interfaceString | 嵌套参数的接口字符串名称。 | 字符串 |
参数 | 参数的定义。 | ModuleAssetParameter[] |
ModuleAssetParameter
名字 | 描述 | 价值 |
---|---|---|
modeValuesInfo | 如果这是复杂的模块参数,则为嵌套接口参数的定义。 | ModuleAssetParameterModeValuesInfo |
名字 | 参数名称。 | 字符串 |
parameterType | 参数类型。 | 字符串 |
ModuleAssetParameterModeValuesInfo
名字 | 描述 | 价值 |
---|
OutputPort
名字 | 描述 | 价值 |
---|---|---|
类型 | 端口数据类型。 | “Dataset” |
RealtimeConfiguration
名字 | 描述 | 价值 |
---|---|---|
maxConcurrentCalls | 指定可对 Web 服务进行的最大并发调用。 最小值:4,最大值:200。 | int 约束: 最小值 = 4 最大值 = 200 |
ResourceTags
名字 | 描述 | 价值 |
---|
ServiceInputOutputSpecification
名字 | 描述 | 价值 |
---|---|---|
描述 | Swagger 架构的说明。 | 字符串 |
性能 | 指定一个集合,该集合包含 Web 服务的每个输入或输出的列架构。 有关详细信息,请参阅 Swagger 规范。 | ServiceInputOutputSpecificationProperties(必需) |
标题 | Swagger 架构的标题。 | 字符串 |
类型 | swagger 中介绍的实体的类型。 始终为“object”。 | string (必需) |
ServiceInputOutputSpecificationProperties
名字 | 描述 | 价值 |
---|
StorageAccount
名字 | 描述 | 价值 |
---|---|---|
钥匙 | 指定用于访问存储帐户的密钥。 | 字符串 |
名字 | 指定存储帐户的名称。 | 字符串 |
TableSpecification
名字 | 描述 | 价值 |
---|---|---|
描述 | Swagger 架构说明。 | 字符串 |
格式 | 格式(如果“type”不是“object”) | 字符串 |
性能 | 数据表中的列集。 | TableSpecificationProperties |
标题 | Swagger 架构标题。 | 字符串 |
类型 | swagger 中介绍的实体的类型。 | string (必需) |
TableSpecificationProperties
名字 | 描述 | 价值 |
---|
WebServiceKeys
名字 | 描述 | 价值 |
---|---|---|
主要 | 主访问密钥。 | 字符串 |
二 次 | 辅助访问密钥。 | 字符串 |
WebServiceParameter
名字 | 描述 | 价值 |
---|---|---|
certificateThumbprint | 如果“value”字段中的参数值已加密,则应将证书的指纹放在此处。 | 字符串 |
价值 | 参数值 | 任何 |
WebServiceProperties
名字 | 描述 | 价值 |
---|---|---|
资产 | 包含描述 Web 服务资产的用户定义属性。 属性表示为键/值对。 | WebServicePropertiesAssets |
commitmentPlan | 包含与此 Web 服务关联的承诺计划。 在创建时设置。 设置后,无法更改此值。 注意:承诺计划不会从对 GET 操作的调用返回。 | CommitmentPlan |
描述 | Web 服务的说明。 | 字符串 |
诊断 | 控制 Web 服务的诊断跟踪集合的设置。 | DiagnosticsConfiguration |
exampleRequest | 为一个或多个服务的输入定义示例输入数据。 | ExampleRequest |
exposeSampleData | 设置为 true 时,示例数据包含在 Web 服务的 swagger 定义中。 默认值为 true。 | bool |
输入 | 包含描述一个或多个 Web 服务的输入的 Swagger 2.0 架构。 有关详细信息,请参阅 Swagger 规范。 | ServiceInputOutputSpecification |
钥匙 | 包含 Web 服务预配密钥。 如果未指定预配密钥,Azure 机器学习系统会为你生成它们。 注意:密钥不会从对 GET 操作的调用中返回。 | WebServiceKeys |
machineLearningWorkspace | 指定包含 Web 服务的源的试验的机器学习工作区。 | MachineLearningWorkspace |
输出 | 包含描述一个或多个 Web 服务的输出的 Swagger 2.0 架构。 有关详细信息,请参阅 Swagger 规范。 | ServiceInputOutputSpecification |
packageType | 对于 WebServicePropertiesForGraph,请设置为“Graph”。 | “Graph”(必需) |
参数 | 为 Web 服务定义的全局参数值集,给定为默认值映射的全局参数名称。 如果未指定默认值,则参数被视为必需。 | WebServicePropertiesParameters |
payloadsInBlobStorage | 设置为 true 时,指示有效负载大小大于 3 MB。 否则为 false。 如果有效负载大小超过 3 MB,则有效负载存储在 Blob 中,PayloadsLocation 参数包含 blob 的 URI。 否则,此值将设置为 false,资产、输入、输出、包、参数、ExampleRequest 为内联。 有效负载大小通过添加资产、输入、输出、包、参数和 ExampleRequest 的大小来确定。 | bool |
payloadsLocation | 有效负载 Blob 的 URI。 仅当 payloadsInBlobStorage 参数设置为 true 时,此参数才包含一个值。 否则设置为 null。 | BlobLocation |
readOnly | 如果设置为 true,则表示 Web 服务为只读,且无法再更新或修补,仅删除。 默认值为 false。 注意:设置为 true 后,无法更改其值。 | bool |
realtimeConfiguration | 包含 Web 服务终结点的配置设置。 | RealtimeConfiguration |
storageAccount | 指定 Azure 机器学习用于存储有关 Web 服务的信息的存储帐户。 仅从对 GET 操作的调用中返回存储帐户的名称。 更新存储帐户信息时,必须确保新存储帐户中提供了所有必要的资产,或者对 Web 服务的调用将失败。 | StorageAccount |
标题 | Web 服务的标题。 | 字符串 |
WebServicePropertiesAssets
名字 | 描述 | 价值 |
---|
WebServicePropertiesForGraph
名字 | 描述 | 价值 |
---|---|---|
包 | 组成此 Web 服务的图形包的定义。 | GraphPackage |
packageType | 指定包类型。 有效值为 Graph(指定通过机器学习工作室发布的 Web 服务和代码(指定使用 Python 等代码发布的 Web 服务)。 注意:目前不支持代码。 | “Graph”(必需) |
WebServicePropertiesParameters
名字 | 描述 | 价值 |
---|