Dela via


Web Services - Create Or Update

Skapa eller uppdatera en webbtjänst. Det här anropet skriver över en befintlig webbtjänst. Observera att det inte finns någon varning eller bekräftelse. Det här är en icke-återställningsbar åtgärd. Om avsikten är att skapa en ny webbtjänst anropar du åtgärden Hämta först för att kontrollera att den inte finns.

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen där webbtjänsten finns.

subscriptionId
path True

string

Azure-prenumerations-ID:t.

webServiceName
path True

string

Namnet på webbtjänsten.

api-version
query True

string

Den version av resursprovider-API:et Microsoft.MachineLearning som ska användas.

Begärandetext

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

Name Obligatorisk Typ Description
location True

string

Anger resursens plats.

properties True WebServiceProperties:

WebServicePropertiesForGraph

Innehåller den egenskapsnyttolast som beskriver webbtjänsten.

name

string

Anger namnet på resursen.

tags

object

Innehåller resurstaggar som definierats som nyckel/värde-par.

Svar

Name Typ Description
200 OK

WebService

Framgång. Det här svaret returneras för en uppdateringswebbtjänståtgärd. Svarsnyttolasten är identisk med svarsnyttolasten som returneras av GET-åtgärden. Svaret innehåller etableringstillståndet och Azure-AsyncOperation-huvudet. Om du vill hämta förloppet för åtgärden anropar du GET-åtgärden på URL:en i Azure-AsyncOperation rubrikfält. Mer information om asynkrona åtgärder finns i https://msdn.microsoft.com/en-us/library/mt742920.aspx.

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

201 Created

WebService

Skapad. Det här svaret returneras för en åtgärd för att skapa webbtjänst. Svaret innehåller etableringstillståndet och Azure-AsyncOperation-huvudet. Om du vill hämta förloppet för åtgärden anropar du GET-åtgärden på URL:en i Azure-AsyncOperation rubrikfält. Mer information om asynkrona åtgärder finns i https://msdn.microsoft.com/en-us/library/mt742920.aspx.

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

Definitioner

Name Description
AssetItem

Information om en tillgång som är associerad med webbtjänsten.

AssetLocation

Beskriver åtkomstplatsen för en webbtjänsttillgång.

AssetType

Tillgångstyp.

ColumnFormat

Ytterligare formatinformation för datatypen.

ColumnSpecification

Swagger 2.0-schema för en kolumn i datatabellen som representerar en in- eller utdata för webbtjänsten. Se Swagger-specifikation: http://swagger.io/specification/

ColumnType

Datatyp för kolumnen.

CommitmentPlan

Information om åtagandeplanen för maskininlärning som är associerad med webbtjänsten.

DiagnosticsConfiguration

Diagnostikinställningar för en Azure ML-webbtjänst.

DiagnosticsLevel

Anger verbositeten för diagnostikutdata. Giltiga värden är: Ingen – inaktiverar spårning; Fel – samlar endast in felspårningar (stderr). Alla – samlar in alla spårningar (stdout och stderr).

ExampleRequest

Exempel på indata för tjänstens indata.

GraphEdge

Definierar en gräns i webbtjänstens graf.

GraphNode

Anger en nod i webbtjänstdiagrammet. Noden kan antingen vara en indata-, utdata- eller tillgångsnod, så endast en av motsvarande ID-egenskaper fylls i vid en viss tidpunkt.

GraphPackage

Definierar grafen över moduler som utgör maskininlärningslösningen.

GraphParameter

Definierar en global parameter i diagrammet.

GraphParameterLink

Associationlänk för en global grafparameter till en nod i diagrammet.

InputPort

Tillgångsindataport

InputPortType

Portdatatyp.

MachineLearningWorkspace

Information om den maskininlärningsarbetsyta som innehåller experimentet som är källa för webbtjänsten.

ModeValueInfo

Kapslad parameterdefinition.

ModuleAssetParameter

Parameterdefinition för en modultillgång.

OutputPort

Utdataport för tillgångar

OutputPortType

Portdatatyp.

ParameterType

Diagramparameterns typ.

ProvisioningState

Skrivskyddad: Etableringstillståndet för webbtjänsten. Giltiga värden är Okänd, Etablering, Lyckades och Misslyckades.

RealtimeConfiguration

Innehåller de tillgängliga konfigurationsalternativen för en Azure ML-webbtjänstslutpunkt.

ServiceInputOutputSpecification

Swagger 2.0-schemat som beskriver tjänstens indata eller utdata. Se Swagger-specifikation: http://swagger.io/specification/

StorageAccount

Åtkomstinformation för ett lagringskonto.

TableSpecification

Swagger 2.0-schemat som beskriver en enda tjänstindata eller utdata. Se Swagger-specifikation: http://swagger.io/specification/

WebService

Instans av en Azure ML-webbtjänstresurs.

WebServiceKeys

Åtkomstnycklar för webbtjänstanrop.

WebServicePropertiesForGraph

Egenskaper som är specifika för en Graph-baserad webbtjänst.

AssetItem

Information om en tillgång som är associerad med webbtjänsten.

Name Typ Description
id

string

Tillgångens ID.

inputPorts

<string,  InputPort>

Information om tillgångens indataportar.

locationInfo

AssetLocation

Åtkomstinformation för tillgången.

metadata

object

Om tillgången är en anpassad modul innehåller den modulens metadata.

name

string

Tillgångens eget namn.

outputPorts

<string,  OutputPort>

Information om tillgångens utdataportar.

parameters

ModuleAssetParameter[]

Om tillgången är en anpassad modul innehåller den modulens parametrar.

type

AssetType

Tillgångstyp.

AssetLocation

Beskriver åtkomstplatsen för en webbtjänsttillgång.

Name Typ Description
credentials

string

Åtkomstautentiseringsuppgifter för tillgången, om tillämpligt (t.ex. tillgång som anges av lagringskontots anslutningssträng + blob-URI)

uri

string (url)

Den URI där tillgången är tillgänglig från (t.ex. aml://abc för systemtillgångar eller https://xyz för användartillgångar

AssetType

Tillgångstyp.

Värde Description
Module
Resource

ColumnFormat

Ytterligare formatinformation för datatypen.

Värde Description
Byte
Char
Complex64
Complex128
Date-time
Date-timeOffset
Double
Duration
Float
Int8
Int16
Int32
Int64
Uint8
Uint16
Uint32
Uint64

ColumnSpecification

Swagger 2.0-schema för en kolumn i datatabellen som representerar en in- eller utdata för webbtjänsten. Se Swagger-specifikation: http://swagger.io/specification/

Name Typ Description
enum

object[]

Om datatypen är kategorisk visas listan över godkända kategorier.

format

ColumnFormat

Ytterligare formatinformation för datatypen.

type

ColumnType

Datatyp för kolumnen.

x-ms-isnullable

boolean

Flagga som anger om typen stöder null-värden eller inte.

x-ms-isordered

boolean

Flagga som anger om kategorierna behandlas som en ordnad uppsättning eller inte, om detta är en kategorisk kolumn.

ColumnType

Datatyp för kolumnen.

Värde Description
Boolean
Integer
Number
String

CommitmentPlan

Information om åtagandeplanen för maskininlärning som är associerad med webbtjänsten.

Name Typ Description
id

string

Anger Azure Resource Manager-ID för åtagandeplanen som är associerad med webbtjänsten.

DiagnosticsConfiguration

Diagnostikinställningar för en Azure ML-webbtjänst.

Name Typ Description
expiry

string (date-time)

Anger datum och tid när loggningen upphör. Om värdet är null är diagnostiksamlingen inte tidsbegränsade.

level

DiagnosticsLevel

Anger verbositeten för diagnostikutdata. Giltiga värden är: Ingen – inaktiverar spårning; Fel – samlar endast in felspårningar (stderr). Alla – samlar in alla spårningar (stdout och stderr).

DiagnosticsLevel

Anger verbositeten för diagnostikutdata. Giltiga värden är: Ingen – inaktiverar spårning; Fel – samlar endast in felspårningar (stderr). Alla – samlar in alla spårningar (stdout och stderr).

Värde Description
None
Error
All

ExampleRequest

Exempel på indata för tjänstens indata.

Name Typ Description
globalParameters

object

Exempel på indata för webbtjänstens globala parametrar

inputs

object

Exempel på indata för webbtjänstens indata som anges som ett indatanamn för matriskartan för indatavärden.

GraphEdge

Definierar en gräns i webbtjänstens graf.

Name Typ Description
sourceNodeId

string

Källdiagramnodens identifierare.

sourcePortId

string

Identifieraren för källnodens port som gränsen ansluter från.

targetNodeId

string

Måldiagramnodens identifierare.

targetPortId

string

Identifieraren för målnodens port som gränsen ansluter till.

GraphNode

Anger en nod i webbtjänstdiagrammet. Noden kan antingen vara en indata-, utdata- eller tillgångsnod, så endast en av motsvarande ID-egenskaper fylls i vid en viss tidpunkt.

Name Typ Description
assetId

string

ID:t för tillgången som representeras av den här noden.

inputId

string

ID:t för indataelementet som representeras av den här noden.

outputId

string

ID:t för utdataelementet som representeras av den här noden.

parameters

object

Om tillämpligt, parametrar för noden. Globala grafparametrar mappas till dessa, med värden som anges vid körning.

GraphPackage

Definierar grafen över moduler som utgör maskininlärningslösningen.

Name Typ Description
edges

GraphEdge[]

Listan över kanter som utgör grafen.

graphParameters

<string,  GraphParameter>

Samlingen globala parametrar för grafen, som anges som ett globalt parameternamn till GraphParameter-kartan. Varje parameter här har en 1:1-matchning med den globala parametervärdenskartan deklarerad på nivån WebServiceProperties.

nodes

<string,  GraphNode>

Den uppsättning noder som utgör grafen, som tillhandahålls som ett nodeId till GraphNode-karta

GraphParameter

Definierar en global parameter i diagrammet.

Name Typ Description
description

string

Beskrivning av den här grafparametern.

links

GraphParameterLink[]

Associationlänkar för den här parametern till noder i diagrammet.

type

ParameterType

Diagramparameterns typ.

Associationlänk för en global grafparameter till en nod i diagrammet.

Name Typ Description
nodeId

string

Grafnodens identifierare

parameterKey

string

Identifieraren för den nodparameter som den globala parametern mappar till.

InputPort

Tillgångsindataport

Name Typ Standardvärde Description
type

InputPortType

Dataset

Portdatatyp.

InputPortType

Portdatatyp.

Värde Description
Dataset

MachineLearningWorkspace

Information om den maskininlärningsarbetsyta som innehåller experimentet som är källa för webbtjänsten.

Name Typ Description
id

string

Anger arbetsytans ID för den maskininlärningsarbetsyta som är associerad med webbtjänsten

ModeValueInfo

Kapslad parameterdefinition.

Name Typ Description
interfaceString

string

Gränssnittets strängnamn för den kapslade parametern.

parameters

ModuleAssetParameter[]

Definitionen av parametern.

ModuleAssetParameter

Parameterdefinition för en modultillgång.

Name Typ Description
modeValuesInfo

<string,  ModeValueInfo>

Definitioner för kapslade gränssnittsparametrar om det här är en komplex modulparameter.

name

string

Parameternamn.

parameterType

string

Parametertyp.

OutputPort

Utdataport för tillgångar

Name Typ Standardvärde Description
type

OutputPortType

Dataset

Portdatatyp.

OutputPortType

Portdatatyp.

Värde Description
Dataset

ParameterType

Diagramparameterns typ.

Värde Description
String
Int
Float
Enumerated
Script
Mode
Credential
Boolean
Double
ColumnPicker
ParameterRange
DataGatewayName

ProvisioningState

Skrivskyddad: Etableringstillståndet för webbtjänsten. Giltiga värden är Okänd, Etablering, Lyckades och Misslyckades.

Värde Description
Unknown
Provisioning
Succeeded
Failed

RealtimeConfiguration

Innehåller de tillgängliga konfigurationsalternativen för en Azure ML-webbtjänstslutpunkt.

Name Typ Description
maxConcurrentCalls

integer

minimum: 4
maximum: 200

Anger de maximala samtidiga anrop som kan göras till webbtjänsten. Minsta värde: 4, Maxvärde: 200.

ServiceInputOutputSpecification

Swagger 2.0-schemat som beskriver tjänstens indata eller utdata. Se Swagger-specifikation: http://swagger.io/specification/

Name Typ Standardvärde Description
description

string

Beskrivningen av Swagger-schemat.

properties

<string,  TableSpecification>

Anger en samling som innehåller kolumnschemat för varje indata eller utdata för webbtjänsten. Mer information finns i Swagger-specifikationen.

title

string

Rubriken på ditt Swagger-schema.

type

string

object

Typen av entitet som beskrivs i swagger. Alltid "objekt".

StorageAccount

Åtkomstinformation för ett lagringskonto.

Name Typ Description
key

string

Anger den nyckel som används för att komma åt lagringskontot.

name

string

Anger namnet på lagringskontot.

TableSpecification

Swagger 2.0-schemat som beskriver en enda tjänstindata eller utdata. Se Swagger-specifikation: http://swagger.io/specification/

Name Typ Standardvärde Description
description

string

Beskrivning av Swagger-schema.

format

string

Formatet, om "typ" inte är "objekt"

properties

<string,  ColumnSpecification>

Uppsättningen kolumner i datatabellen.

title

string

Swagger-schemarubrik.

type

string

object

Typen av entitet som beskrivs i swagger.

WebService

Instans av en Azure ML-webbtjänstresurs.

Name Typ Description
id

string

Anger resurs-ID:t.

location

string

Anger resursens plats.

name

string

Anger namnet på resursen.

properties WebServiceProperties:

WebServicePropertiesForGraph

Innehåller den egenskapsnyttolast som beskriver webbtjänsten.

tags

object

Innehåller resurstaggar som definierats som nyckel/värde-par.

type

string

Anger resurstypen.

WebServiceKeys

Åtkomstnycklar för webbtjänstanrop.

Name Typ Description
primary

string

Den primära åtkomstnyckeln.

secondary

string

Den sekundära åtkomstnyckeln.

WebServicePropertiesForGraph

Egenskaper som är specifika för en Graph-baserad webbtjänst.

Name Typ Description
assets

<string,  AssetItem>

Innehåller användardefinierade egenskaper som beskriver webbtjänsttillgångar. Egenskaper uttrycks som nyckel/värde-par.

commitmentPlan

CommitmentPlan

Innehåller den åtagandeplan som är associerad med den här webbtjänsten. Ange vid skapandetillfället. När värdet har angetts kan det inte ändras. Obs! Åtagandeplanen returneras inte från anrop till GET-åtgärder.

createdOn

string (date-time)

Skrivskyddad: Datum och tid då webbtjänsten skapades.

description

string

Beskrivningen av webbtjänsten.

diagnostics

DiagnosticsConfiguration

Inställningar som styr insamlingen av diagnostikspårningar för webbtjänsten.

exampleRequest

ExampleRequest

Definierar exempeldata för en eller flera av tjänstens indata.

exposeSampleData

boolean

När värdet är true ingår exempeldata i webbtjänstens swagger-definition. Standardvärdet är sant.

input

ServiceInputOutputSpecification

Innehåller Swagger 2.0-schemat som beskriver en eller flera av webbtjänstens indata. Mer information finns i Swagger-specifikationen.

keys

WebServiceKeys

Innehåller webbtjänstetableringsnycklarna. Om du inte anger etableringsnycklar genererar Azure Machine Learning-systemet dem åt dig. Obs! Nycklarna returneras inte från anrop till GET-åtgärder.

machineLearningWorkspace

MachineLearningWorkspace

Anger den Machine Learning-arbetsyta som innehåller experimentet som är källa för webbtjänsten.

modifiedOn

string (date-time)

Skrivskyddad: Datum och tid då webbtjänsten senast ändrades.

output

ServiceInputOutputSpecification

Innehåller Swagger 2.0-schemat som beskriver en eller flera av webbtjänstens utdata. Mer information finns i Swagger-specifikationen.

package

GraphPackage

Definitionen av grafpaketet som utgör den här webbtjänsten.

packageType string:

Graph

Anger pakettypen. Giltiga värden är Graph (Anger en webbtjänst som publicerats via Machine Learning Studio) och Code (Anger en webbtjänst som publicerats med hjälp av kod som Python). Obs! Kod stöds inte just nu.

parameters

object

Uppsättningen med globala parametrar som definierats för webbtjänsten, som anges som ett globalt parameternamn till standardvärdekartan. Om inget standardvärde anges anses parametern vara obligatorisk.

provisioningState

ProvisioningState

Skrivskyddad: Etableringstillståndet för webbtjänsten. Giltiga värden är Okänd, Etablering, Lyckades och Misslyckades.

readOnly

boolean

När värdet är true anger det att webbtjänsten är skrivskyddad och inte längre kan uppdateras eller korrigeras, endast tas bort. Standardvärdet är falskt. Obs! När värdet är inställt på true kan du inte ändra dess värde.

realtimeConfiguration

RealtimeConfiguration

Innehåller konfigurationsinställningarna för webbtjänstslutpunkten.

storageAccount

StorageAccount

Anger det lagringskonto som Azure Machine Learning använder för att lagra information om webbtjänsten. Endast namnet på lagringskontot returneras från anrop till GET-åtgärder. När du uppdaterar lagringskontoinformationen måste du se till att alla nödvändiga tillgångar är tillgängliga i det nya lagringskontot eller att anrop till webbtjänsten misslyckas.

swaggerLocation

string

Skrivskyddad: Innehåller URI:n för swagger-specifikationen som är associerad med den här webbtjänsten.

title

string

Webbtjänstens rubrik.