Web Services - Create Or Update

Tjänst:

ML Studio (classic)

API-version:

2016-05-01-preview

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 först åtgärden Get (Hämta) 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 platsen för resursen.
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	Åtgärden lyckades. Det här svaret returneras för en uppdatering av webbtjänståtgärden. 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 webbtjänståtgärd för att skapa. 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 indata 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 utförligheten för diagnostikutdata. Giltiga värden är: Ingen – inaktiverar spårning; Fel – samlar endast in felspårningar (stderr). Alla – samlar in alla spår (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 arbetsytan för maskininlärning 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 lagringskontot anslutningssträng + blob-URI)
uri	string	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.

Name	Typ	Description
Module	string
Resource	string

ColumnFormat

Ytterligare formatinformation för datatypen.

Name	Typ	Description
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

Swagger 2.0-schema för en kolumn i datatabellen som representerar indata 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.

Name	Typ	Description
Boolean	string
Integer	string
Number	string
String	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	Anger datum och tid då loggningen upphör. Om värdet är null är diagnostiksamlingen inte tidsbegränsade.
level	DiagnosticsLevel	Anger utförligheten i 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 utförligheten för diagnostikutdata. Giltiga värden är: Ingen – inaktiverar spårning; Fel – samlar endast in felspårningar (stderr). Alla – samlar in alla spår (stdout och stderr).

Name	Typ	Description
All	string
Error	string
None	string

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 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 med globala parametrar för grafen, som anges som ett globalt parameternamn för GraphParameter-kartan. Varje parameter här har en 1:1-matchning med den globala parametervärdena som deklareras 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[]	Association länkar för den här parametern till noder i diagrammet.
type	ParameterType	Diagramparameterns typ.

GraphParameterLink

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.

Name	Typ	Description
Dataset	string

MachineLearningWorkspace

Information om arbetsytan för maskininlärning 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änssnittssträngens namn 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 detta ä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.

Name	Typ	Description
Dataset	string

ParameterType

Diagramparameterns typ.

Name	Typ	Description
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

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

Name	Typ	Description
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

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

Name	Typ	Description
maxConcurrentCalls	integer	Anger det högsta antalet 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		Schemarubrik för Swagger.
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 platsen för resursen.
name	string	Anger namnet på resursen.
properties	WebServiceProperties: WebServicePropertiesForGraph	Innehåller egenskapsnyttolasten 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 tidpunkten för skapandet. När värdet har angetts kan det här värdet inte ändras. Obs! Åtagandeplanen returneras inte från anrop till GET-åtgärder.
createdOn	string	Skrivskyddad: Datum och tid när 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 exempel på indata 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 True.
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änstens etableringsnycklar. 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	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 Kod (Anger en webbtjänst som publicerats med hjälp av kod som Python). Obs! Kod stöds inte just nu.
parameters	object	Den uppsättning globala parametervärden som definierats för webbtjänsten, givet 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 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 titel.