Web Services - Create Or Update

Servizio:

ML Studio (classic)

Versione API:

2016-05-01-preview

Creare o aggiornare un servizio Web. Questa chiamata sovrascriverà un servizio Web esistente. Si noti che non è presente alcun avviso o conferma. Si tratta di un'operazione non recuperabile. Se la finalità consiste nel creare un nuovo servizio Web, chiamare prima l'operazione Get per verificare che non esista.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse in cui si trova il servizio Web.
subscriptionId	path	True	string	ID sottoscrizione di Azure.
webServiceName	path	True	string	Nome del servizio Web.
api-version	query	True	string	Versione dell'API del provider di risorse Microsoft.MachineLearning da usare.

Corpo della richiesta

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

Nome	Necessario	Tipo	Descrizione
location	True	string	Specifica la posizione della risorsa.
properties	True	WebServiceProperties: WebServicePropertiesForGraph	Contiene il payload della proprietà che descrive il servizio Web.
name		string	Specifica il nome della risorsa.
tags		object	Contiene tag di risorse definiti come coppie chiave/valore.

Risposte

Nome	Tipo	Descrizione
200 OK	WebService	Operazione completata. Questa risposta viene restituita per un'operazione di aggiornamento del servizio Web. Il payload della risposta è identico al payload della risposta restituito dall'operazione GET. La risposta include lo stato di provisioning e l'intestazione Azure-AsyncOperation. Per ottenere lo stato di avanzamento dell'operazione, chiamare l'operazione GET nell'URL nel campo dell'intestazione Azure-AsyncOperation. Per altre informazioni sulle operazioni asincrone, vedere https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"
201 Created	WebService	Creazione riuscita. Questa risposta viene restituita per un'operazione di creazione del servizio Web. La risposta include lo stato di provisioning e l'intestazione Azure-AsyncOperation. Per ottenere lo stato di avanzamento dell'operazione, chiamare l'operazione GET nell'URL nel campo dell'intestazione Azure-AsyncOperation. Per altre informazioni sulle operazioni asincrone, vedere https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"

Definizioni

Nome	Descrizione
AssetItem	Informazioni su un asset associato al servizio Web.
AssetLocation	Descrive la posizione di accesso per un asset del servizio Web.
AssetType	Tipo di asset.
ColumnFormat	Informazioni aggiuntive sul formato per il tipo di dati.
ColumnSpecification	Schema Swagger 2.0 per una colonna all'interno della tabella dati che rappresenta un input o un output del servizio Web. Vedere specifica Swagger: http://swagger.io/specification/
ColumnType	Tipo di dati della colonna.
CommitmentPlan	Informazioni sul piano di impegno di Machine Learning associato al servizio Web.
DiagnosticsConfiguration	Impostazioni di diagnostica per un servizio Web di Azure ML.
DiagnosticsLevel	Specifica la verbosità dell'output di diagnostica. I valori validi sono: Nessuno - disabilita la traccia; Errore: raccoglie solo le tracce di errore (stderr); Tutto : raccoglie tutte le tracce (stdout e stderr).
ExampleRequest	Dati di input di esempio per gli input del servizio.
GraphEdge	Definisce un bordo all'interno del grafico del servizio Web.
GraphNode	Specifica un nodo nel grafico del servizio Web. Il nodo può essere un nodo input, output o asset, quindi solo una delle proprietà id corrispondenti viene popolata in qualsiasi momento.
GraphPackage	Definisce il grafico dei moduli che costituiscono la soluzione di Machine Learning.
GraphParameter	Definisce un parametro globale nel grafico.
GraphParameterLink	Collegamento di associazione per un parametro globale grafico a un nodo nel grafico.
InputPort	Porta di input asset
InputPortType	Tipo di dati porta.
MachineLearningWorkspace	Informazioni sull'area di lavoro di Machine Learning contenente l'esperimento di origine per il servizio Web.
ModeValueInfo	Definizione del parametro annidata.
ModuleAssetParameter	Definizione del parametro per un asset del modulo.
OutputPort	Porta di output asset
OutputPortType	Tipo di dati porta.
ParameterType	Tipo di parametro Graph.
ProvisioningState	Sola lettura: stato di provisioning del servizio Web. I valori validi sono Sconosciuti, Provisioning, Riuscito e Non riuscito.
RealtimeConfiguration	Contiene le opzioni di configurazione disponibili per un endpoint del servizio Web azure ML.
ServiceInputOutputSpecification	Schema swagger 2.0 che descrive gli input o gli output del servizio. Vedere specifica Swagger: http://swagger.io/specification/
StorageAccount	Accedere alle informazioni per un account di archiviazione.
TableSpecification	Schema swagger 2.0 che descrive un singolo input o output del servizio. Vedere specifica Swagger: http://swagger.io/specification/
WebService	Istanza di una risorsa del servizio Web azure ML.
WebServiceKeys	Chiavi di accesso per le chiamate al servizio Web.
WebServicePropertiesForGraph	Proprietà specifiche di un servizio Web basato su Graph.

AssetItem

Informazioni su un asset associato al servizio Web.

Nome	Tipo	Descrizione
id	string	ID dell'asset.
inputPorts	<string,  InputPort>	Informazioni sulle porte di input dell'asset.
locationInfo	AssetLocation	Accedere alle informazioni per l'asset.
metadata	object	Se l'asset è un modulo personalizzato, contiene i metadati del modulo.
name	string	Nome descrittivo dell'asset.
outputPorts	<string,  OutputPort>	Informazioni sulle porte di output dell'asset.
parameters	ModuleAssetParameter[]	Se l'asset è un modulo personalizzato, contiene i parametri del modulo.
type	AssetType	Tipo di asset.

AssetLocation

Descrive la posizione di accesso per un asset del servizio Web.

Nome	Tipo	Descrizione
credentials	string	Accedere alle credenziali per l'asset, se applicabile(ad esempio, l'asset specificato dall'account di archiviazione stringa di connessione + URI BLOB)
uri	string	URI da cui è accessibile l'asset, ad esempio aml://abc per gli asset di sistema o https://xyz per gli asset utente

AssetType

Tipo di asset.

Nome	Tipo	Descrizione
Module	string
Resource	string

ColumnFormat

Informazioni aggiuntive sul formato per il tipo di dati.

Nome	Tipo	Descrizione
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

Schema Swagger 2.0 per una colonna all'interno della tabella dati che rappresenta un input o un output del servizio Web. Vedere specifica Swagger: http://swagger.io/specification/

Nome	Tipo	Descrizione
enum	object[]	Se il tipo di dati è categorico, questo fornisce l'elenco delle categorie accettate.
format	ColumnFormat	Informazioni aggiuntive sul formato per il tipo di dati.
type	ColumnType	Tipo di dati della colonna.
x-ms-isnullable	boolean	Flag che indica se il tipo supporta valori Null o meno.
x-ms-isordered	boolean	Flag che indica se le categorie vengono considerate come un set ordinato o meno, se si tratta di una colonna categorica.

ColumnType

Tipo di dati della colonna.

Nome	Tipo	Descrizione
Boolean	string
Integer	string
Number	string
String	string

CommitmentPlan

Informazioni sul piano di impegno di Machine Learning associato al servizio Web.

Nome	Tipo	Descrizione
id	string	Specifica l'ID Resource Manager di Azure del piano di impegno associato al servizio Web.

DiagnosticsConfiguration

Impostazioni di diagnostica per un servizio Web di Azure ML.

Nome	Tipo	Descrizione
expiry	string	Specifica la data e l'ora in cui la registrazione verrà interrotta. Se Null, la raccolta diagnostica non è limitata al tempo.
level	DiagnosticsLevel	Specifica la verbosità dell'output di diagnostica. I valori validi sono: Nessuno - disabilita la traccia; Errore: raccoglie solo le tracce di errore (stderr); Tutto : raccoglie tutte le tracce (stdout e stderr).

DiagnosticsLevel

Specifica la verbosità dell'output di diagnostica. I valori validi sono: Nessuno - disabilita la traccia; Errore: raccoglie solo le tracce di errore (stderr); Tutto : raccoglie tutte le tracce (stdout e stderr).

Nome	Tipo	Descrizione
All	string
Error	string
None	string

ExampleRequest

Dati di input di esempio per gli input del servizio.

Nome	Tipo	Descrizione
globalParameters	object	Dati di input di esempio per i parametri globali del servizio Web
inputs	object	Dati di input di esempio per gli input del servizio Web specificati come nome di input per la mappa matrice dei valori di input di esempio.

GraphEdge

Definisce un bordo all'interno del grafico del servizio Web.

Nome	Tipo	Descrizione
sourceNodeId	string	Identificatore del nodo del grafico di origine.
sourcePortId	string	Identificatore della porta del nodo di origine da cui si connette il bordo.
targetNodeId	string	Identificatore del nodo del grafico di destinazione.
targetPortId	string	Identificatore della porta del nodo di destinazione in cui si connette il bordo.

GraphNode

Specifica un nodo nel grafico del servizio Web. Il nodo può essere un nodo input, output o asset, quindi solo una delle proprietà id corrispondenti viene popolata in qualsiasi momento.

Nome	Tipo	Descrizione
assetId	string	ID dell'asset rappresentato da questo nodo.
inputId	string	ID dell'elemento di input rappresentato da questo nodo.
outputId	string	ID dell'elemento di output rappresentato da questo nodo.
parameters	object	Se applicabile, i parametri del nodo. I parametri del grafico globale vengono mappati in questi elementi, con valori impostati in fase di esecuzione.

GraphPackage

Definisce il grafico dei moduli che costituiscono la soluzione di Machine Learning.

Nome	Tipo	Descrizione
edges	GraphEdge[]	Elenco di bordi che costituiscono il grafico.
graphParameters	<string,  GraphParameter>	Raccolta di parametri globali per il grafico, dato come nome di parametro globale alla mappa GraphParameter. Ogni parametro include una corrispondenza 1:1 con i valori dei parametri globali dichiarati a livello WebServiceProperties.
nodes	<string,  GraphNode>	Set di nodi che compongono il grafico, fornito come mapping nodeId to GraphNode

GraphParameter

Definisce un parametro globale nel grafico.

Nome	Tipo	Descrizione
description	string	Descrizione di questo parametro del grafico.
links	GraphParameterLink[]	Collegamenti di associazione per questo parametro ai nodi nel grafico.
type	ParameterType	Tipo di parametro Graph.

GraphParameterLink

Collegamento di associazione per un parametro globale grafico a un nodo nel grafico.

Nome	Tipo	Descrizione
nodeId	string	Identificatore del nodo del grafico
parameterKey	string	Identificatore del parametro del nodo a cui viene eseguito il mapping del parametro globale.

InputPort

Porta di input asset

Nome	Tipo	Valore predefinito	Descrizione
type	InputPortType	Dataset	Tipo di dati porta.

InputPortType

Tipo di dati porta.

Nome	Tipo	Descrizione
Dataset	string

MachineLearningWorkspace

Informazioni sull'area di lavoro di Machine Learning contenente l'esperimento di origine per il servizio Web.

Nome	Tipo	Descrizione
id	string	Specifica l'ID dell'area di lavoro di Machine Learning associata al servizio Web

ModeValueInfo

Definizione del parametro annidata.

Nome	Tipo	Descrizione
interfaceString	string	Nome della stringa di interfaccia per il parametro annidato.
parameters	ModuleAssetParameter[]	Definizione del parametro.

ModuleAssetParameter

Definizione del parametro per un asset del modulo.

Nome	Tipo	Descrizione
modeValuesInfo	<string,  ModeValueInfo>	Definizioni per i parametri dell'interfaccia annidata se si tratta di un parametro di modulo complesso.
name	string	Nome del parametro.
parameterType	string	Tipo di parametro.

OutputPort

Porta di output asset

Nome	Tipo	Valore predefinito	Descrizione
type	OutputPortType	Dataset	Tipo di dati porta.

OutputPortType

Tipo di dati porta.

Nome	Tipo	Descrizione
Dataset	string

ParameterType

Tipo di parametro Graph.

Nome	Tipo	Descrizione
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

Sola lettura: stato di provisioning del servizio Web. I valori validi sono Sconosciuti, Provisioning, Riuscito e Non riuscito.

Nome	Tipo	Descrizione
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

Contiene le opzioni di configurazione disponibili per un endpoint del servizio Web azure ML.

Nome	Tipo	Descrizione
maxConcurrentCalls	integer	Specifica le chiamate simultanee massime che possono essere effettuate al servizio Web. Valore minimo: 4, Valore massimo: 200.

ServiceInputOutputSpecification

Schema swagger 2.0 che descrive gli input o gli output del servizio. Vedere specifica Swagger: http://swagger.io/specification/

Nome	Tipo	Valore predefinito	Descrizione
description	string		Descrizione dello schema Swagger.
properties	<string,  TableSpecification>		Specifica una raccolta contenente lo schema di colonna per ogni input o output del servizio Web. Per altre informazioni, vedere la specifica Swagger.
title	string		Titolo dello schema Swagger.
type	string	object	Tipo dell'entità descritta in swagger. Sempre 'oggetto'.

StorageAccount

Accedere alle informazioni per un account di archiviazione.

Nome	Tipo	Descrizione
key	string	Specifica la chiave usata per accedere all'account di archiviazione.
name	string	Specifica il nome dell'account di archiviazione.

TableSpecification

Schema swagger 2.0 che descrive un singolo input o output del servizio. Vedere specifica Swagger: http://swagger.io/specification/

Nome	Tipo	Valore predefinito	Descrizione
description	string		Descrizione dello schema Swagger.
format	string		Il formato, se 'type' non è 'object'
properties	<string,  ColumnSpecification>		Set di colonne all'interno della tabella dati.
title	string		Titolo dello schema Swagger.
type	string	object	Tipo dell'entità descritta in swagger.

WebService

Istanza di una risorsa del servizio Web azure ML.

Nome	Tipo	Descrizione
id	string	Specifica l'ID risorsa.
location	string	Specifica la posizione della risorsa.
name	string	Specifica il nome della risorsa.
properties	WebServiceProperties: WebServicePropertiesForGraph	Contiene il payload della proprietà che descrive il servizio Web.
tags	object	Contiene tag di risorse definiti come coppie chiave/valore.
type	string	Specifica il tipo della risorsa.

WebServiceKeys

Chiavi di accesso per le chiamate al servizio Web.

Nome	Tipo	Descrizione
primary	string	Chiave di accesso primaria.
secondary	string	Chiave di accesso secondaria.

WebServicePropertiesForGraph

Proprietà specifiche di un servizio Web basato su Graph.

Nome	Tipo	Descrizione
assets	<string,  AssetItem>	Contiene proprietà definite dall'utente che descrivono gli asset del servizio Web. Le proprietà vengono espresse come coppie Chiave/Valore.
commitmentPlan	CommitmentPlan	Contiene il piano di impegno associato a questo servizio Web. Impostare in fase di creazione. Una volta impostato, questo valore non può essere modificato. Nota: il piano di impegno non viene restituito dalle chiamate alle operazioni GET.
createdOn	string	Sola lettura: data e ora della creazione del servizio Web.
description	string	Descrizione del servizio Web.
diagnostics	DiagnosticsConfiguration	Impostazioni che controllano la raccolta di tracce di diagnostica per il servizio Web.
exampleRequest	ExampleRequest	Definisce i dati di input di esempio per uno o più degli input del servizio.
exposeSampleData	boolean	Se impostato su true, i dati di esempio vengono inclusi nella definizione di swagger del servizio Web. Il valore predefinito è true.
input	ServiceInputOutputSpecification	Contiene lo schema Swagger 2.0 che descrive uno o più degli input del servizio Web. Per altre informazioni, vedere la specifica Swagger.
keys	WebServiceKeys	Contiene le chiavi di provisioning del servizio Web. Se non si specificano le chiavi di provisioning, il sistema di Azure Machine Learning li genera. Nota: le chiavi non vengono restituite dalle chiamate alle operazioni GET.
machineLearningWorkspace	MachineLearningWorkspace	Specifica l'area di lavoro di Machine Learning contenente l'esperimento di origine per il servizio Web.
modifiedOn	string	Sola lettura: data e ora dell'ultima modifica del servizio Web.
output	ServiceInputOutputSpecification	Contiene lo schema Swagger 2.0 che descrive uno o più output del servizio Web. Per altre informazioni, vedere la specifica Swagger.
package	GraphPackage	Definizione del pacchetto grafico che costituiscono questo servizio Web.
packageType	string: Graph	Specifica il tipo di pacchetto. I valori validi sono Graph (specifica un servizio Web pubblicato tramite Machine Learning Studio) e Codice (Specifica un servizio Web pubblicato usando codice come Python). Nota: il codice non è supportato in questo momento.
parameters	object	Set di valori di parametri globali definiti per il servizio Web, dato come nome di parametro globale per la mappa dei valori predefinita. Se non viene specificato alcun valore predefinito, il parametro viene considerato obbligatorio.
provisioningState	ProvisioningState	Sola lettura: stato di provisioning del servizio Web. I valori validi sono Sconosciuti, Provisioning, Riuscito e Non riuscito.
readOnly	boolean	Se impostato su true, indica che il servizio Web è di sola lettura e non può più essere aggiornato o sottoposto a patch, solo rimosso. Il valore predefinito è false. Nota: una volta impostato su true, non è possibile modificarne il valore.
realtimeConfiguration	RealtimeConfiguration	Contiene le impostazioni di configurazione per l'endpoint del servizio Web.
storageAccount	StorageAccount	Specifica l'account di archiviazione usato da Azure Machine Learning per archiviare informazioni sul servizio Web. Viene restituito solo il nome dell'account di archiviazione dalle chiamate alle operazioni GET. Quando si aggiornano le informazioni sull'account di archiviazione, è necessario assicurarsi che tutte le risorse necessarie siano disponibili nel nuovo account di archiviazione o le chiamate al servizio Web avranno esito negativo.
swaggerLocation	string	Sola lettura: contiene l'URI della specifica swagger associata a questo servizio Web.
title	string	Titolo del servizio Web.