你当前正在访问 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”(必需)
名字 描述 价值
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”(必需)
名字 描述 价值
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”(必需)
名字 描述 价值
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

名字 描述 价值