Web Services - Create Or Update

Dienst:

ML Studio (classic)

API-Version:

2016-05-01-preview

Erstellen oder Aktualisieren eines Webdiensts. Dieser Aufruf überschreibt einen vorhandenen Webdienst. Beachten Sie, dass keine Warnung oder Bestätigung vorhanden ist. Dies ist ein nicht wiederherstellbarer Vorgang. Wenn Sie beabsichtigen, einen neuen Webdienst zu erstellen, rufen Sie zuerst den Get-Vorgang auf, um zu überprüfen, ob er nicht vorhanden ist.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string	Name der Ressourcengruppe, in der sich der Webdienst befindet.
subscriptionId	path	True	string	Die Azure-Abonnement-ID.
webServiceName	path	True	string	Der Name des Webdiensts.
api-version	query	True	string	Die Version der zu verwendenden Microsoft.MachineLearning-Ressourcenanbieter-API.

Anforderungstext

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

Name	Erforderlich	Typ	Beschreibung
location	True	string	Gibt den Speicherort der Ressource an.
properties	True	WebServiceProperties: WebServicePropertiesForGraph	Enthält die Eigenschaftsnutzlast, die den Webdienst beschreibt.
name		string	Gibt den Namen der Ressource an.
tags		object	Enthält Ressourcentags, die als Schlüssel-Wert-Paare definiert sind.

Antworten

Name	Typ	Beschreibung
200 OK	WebService	Erfolg. Diese Antwort wird für einen Aktualisierungswebdienstvorgang zurückgegeben. Die Antwortnutzlast ist identisch mit der Antwortnutzlast, die vom GET-Vorgang zurückgegeben wird. Die Antwort enthält den Bereitstellungsstatus und den Azure-AsyncOperation-Header. Um den Fortschritt des Vorgangs abzurufen, rufen Sie get-Vorgang für die URL in Azure-AsyncOperation Kopfzeilenfeld auf. Weitere Informationen zu asynchronen Vorgängen finden Sie unter https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"
201 Created	WebService	Erstellt. Diese Antwort wird für einen Webdiensterstellungsvorgang zurückgegeben. Die Antwort enthält den Bereitstellungsstatus und den Azure-AsyncOperation-Header. Um den Fortschritt des Vorgangs abzurufen, rufen Sie get-Vorgang für die URL in Azure-AsyncOperation Kopfzeilenfeld auf. Weitere Informationen zu asynchronen Vorgängen finden Sie unter https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"

Definitionen

Name	Beschreibung
AssetItem	Informationen zu einer Ressource, die dem Webdienst zugeordnet ist.
AssetLocation	Beschreibt den Zugriffsort für eine Webdienstressource.
AssetType	Objekttyp.
ColumnFormat	Zusätzliche Formatinformationen für den Datentyp.
ColumnSpecification	Swagger 2.0-Schema für eine Spalte in der Datentabelle, die eine Webdiensteingabe oder -ausgabe darstellt. Siehe Swagger Spezifikation: http://swagger.io/specification/
ColumnType	Datentyp der Spalte.
CommitmentPlan	Informationen zum Machine Learning-Verpflichtungsplan, der dem Webdienst zugeordnet ist.
DiagnosticsConfiguration	Diagnoseeinstellungen für einen Azure ML-Webdienst.
DiagnosticsLevel	Gibt die Ausführlichkeit der Diagnoseausgabe an. Gültige Werte sind: Keine – deaktiviert die Ablaufverfolgung; Fehler - sammelt nur Fehlerablaufverfolgungen (Stderr); Alle - sammelt alle Ablaufverfolgungen (stdout und stderr).
ExampleRequest	Beispieleingabedaten für die Eingaben des Diensts.
GraphEdge	Definiert einen Rand im Diagramm des Webdiensts.
GraphNode	Gibt einen Knoten im Webdienstdiagramm an. Der Knoten kann entweder ein Eingabe-, Ausgabe- oder Objektknoten sein, sodass jeweils nur eine der entsprechenden ID-Eigenschaften aufgefüllt wird.
GraphPackage	Definiert das Diagramm der Module, die die Machine Learning-Lösung bilden.
GraphParameter	Definiert einen globalen Parameter im Diagramm.
GraphParameterLink	Zuordnungslink für einen globalen Graph-Parameter zu einem Knoten im Diagramm.
InputPort	Ressourceneingabeport
InputPortType	Portdatentyp.
MachineLearningWorkspace	Informationen zum Maschinellen Lernarbeitsbereich, der das Experiment enthält, das quelle für den Webdienst ist.
ModeValueInfo	Definition geschachtelter Parameter.
ModuleAssetParameter	Parameterdefinition für eine Modulressource.
OutputPort	Ressourcenausgabeport
OutputPortType	Portdatentyp.
ParameterType	Graph-Parametertyp.
ProvisioningState	Schreibgeschützt: Der Bereitstellungsstatus des Webdiensts. Gültige Werte sind "Unknown", "Provisioning", "Succeeded" und "Failed".
RealtimeConfiguration	Enthält die verfügbaren Konfigurationsoptionen für einen Azure ML-Webdienstendpunkt.
ServiceInputOutputSpecification	Das Schema swagger 2.0, das die Eingaben oder Ausgaben des Diensts beschreibt. Siehe Swagger Spezifikation: http://swagger.io/specification/
StorageAccount	Zugreifen auf Informationen für ein Speicherkonto.
TableSpecification	Das Swagger 2.0-Schema, das eine einzelne Diensteingabe oder -ausgabe beschreibt. Siehe Swagger Spezifikation: http://swagger.io/specification/
WebService	Instanz einer Azure ML-Webdienstressource.
WebServiceKeys	Zugriffstasten für webdienstaufrufe.
WebServicePropertiesForGraph	Eigenschaften, die für einen Graph-basierten Webdienst spezifisch sind.

AssetItem

Objekt

Informationen zu einer Ressource, die dem Webdienst zugeordnet ist.

Name	Typ	Beschreibung
id	string	Objekt-ID.
inputPorts	<string,  InputPort>	Informationen zu den Eingabeports der Ressource.
locationInfo	AssetLocation	Zugreifen auf Informationen für das Objekt.
metadata	object	Wenn es sich bei der Ressource um ein benutzerdefiniertes Modul handelt, enthält dies die Metadaten des Moduls.
name	string	Der Anzeigename der Ressource.
outputPorts	<string,  OutputPort>	Informationen zu den Ausgabeports der Ressource.
parameters	ModuleAssetParameter[]	Wenn es sich bei der Ressource um ein benutzerdefiniertes Modul handelt, enthält dies die Parameter des Moduls.
type	AssetType	Objekttyp.

AssetLocation

Objekt

Beschreibt den Zugriffsort für eine Webdienstressource.

Name	Typ	Beschreibung
credentials	string	Zugriffsanmeldeinformationen für das Objekt(sofern zutreffend) (z. B. durch Speicherkontoverbindungszeichenfolge + BLOB-URI angegebene Ressource)
uri	string (url)	Der URI, von dem aus auf die Ressource zugegriffen werden kann (z. B. aml://abc für Systemressourcen oder https://xyz für Benutzerressourcen

AssetType

Enumeration

Objekttyp.

Wert	Beschreibung
Module
Resource

ColumnFormat

Enumeration

Zusätzliche Formatinformationen für den Datentyp.

Wert	Beschreibung
Byte
Char
Complex128
Complex64
Date-time
Date-timeOffset
Double
Duration
Float
Int16
Int32
Int64
Int8
Uint16
Uint32
Uint64
Uint8

ColumnSpecification

Objekt

Swagger 2.0-Schema für eine Spalte in der Datentabelle, die eine Webdiensteingabe oder -ausgabe darstellt. Siehe Swagger Spezifikation: http://swagger.io/specification/

Name	Typ	Beschreibung
enum	object[]	Wenn der Datentyp kategorisiert ist, stellt dies die Liste der akzeptierten Kategorien bereit.
format	ColumnFormat	Zusätzliche Formatinformationen für den Datentyp.
type	ColumnType	Datentyp der Spalte.
x-ms-isnullable	boolean	Flag, das angibt, ob der Typ NULL-Werte unterstützt oder nicht.
x-ms-isordered	boolean	Flag, das angibt, ob die Kategorien als sortierter Satz behandelt werden oder nicht, wenn es sich um eine kategorisierte Spalte handelt.

ColumnType

Enumeration

Datentyp der Spalte.

Wert	Beschreibung
Boolean
Integer
Number
String

CommitmentPlan

Objekt

Informationen zum Machine Learning-Verpflichtungsplan, der dem Webdienst zugeordnet ist.

Name	Typ	Beschreibung
id	string	Gibt die Azure Resource Manager-ID des Verpflichtungsplans an, der dem Webdienst zugeordnet ist.

DiagnosticsConfiguration

Objekt

Diagnoseeinstellungen für einen Azure ML-Webdienst.

Name	Typ	Beschreibung
expiry	string (date-time)	Gibt das Datum und die Uhrzeit an, zu dem die Protokollierung beendet wird. Wenn NULL, ist die Diagnoseauflistung nicht zeitlich begrenzt.
level	DiagnosticsLevel	Gibt die Ausführlichkeit der Diagnoseausgabe an. Gültige Werte sind: Keine – deaktiviert die Ablaufverfolgung; Fehler - sammelt nur Fehlerablaufverfolgungen (Stderr); Alle - sammelt alle Ablaufverfolgungen (stdout und stderr).

DiagnosticsLevel

Enumeration

Gibt die Ausführlichkeit der Diagnoseausgabe an. Gültige Werte sind: Keine – deaktiviert die Ablaufverfolgung; Fehler - sammelt nur Fehlerablaufverfolgungen (Stderr); Alle - sammelt alle Ablaufverfolgungen (stdout und stderr).

Wert	Beschreibung
All
Error
None

ExampleRequest

Objekt

Beispieleingabedaten für die Eingaben des Diensts.

Name	Typ	Beschreibung
globalParameters	object	Beispieleingabedaten für die globalen Parameter des Webdiensts
inputs	object	Beispieleingabedaten für die Eingaben des Webdiensts, die als Eingabename angegeben werden, um eine Matrixzuordnung für Eingabewerte zu verwenden.

GraphEdge

Objekt

Definiert einen Rand im Diagramm des Webdiensts.

Name	Typ	Beschreibung
sourceNodeId	string	Der Bezeichner des Quelldiagrammknotens.
sourcePortId	string	Der Bezeichner des Port des Quellknotens, von dem der Edge eine Verbindung herstellt.
targetNodeId	string	Der Bezeichner des Zieldiagrammknotens.
targetPortId	string	Der Bezeichner des Port des Zielknotens, mit dem sich der Edge verbindet.

GraphNode

Objekt

Gibt einen Knoten im Webdienstdiagramm an. Der Knoten kann entweder ein Eingabe-, Ausgabe- oder Objektknoten sein, sodass jeweils nur eine der entsprechenden ID-Eigenschaften aufgefüllt wird.

Name	Typ	Beschreibung
assetId	string	Die ID der Ressource, die durch diesen Knoten dargestellt wird.
inputId	string	Die ID des eingabeelements, das durch diesen Knoten dargestellt wird.
outputId	string	Die ID des Ausgabeelements, das durch diesen Knoten dargestellt wird.
parameters	object	Falls zutreffend, Parameter des Knotens. Globale Diagrammparameter werden diesen zugeordnet, wobei Werte zur Laufzeit festgelegt sind.

GraphPackage

Objekt

Definiert das Diagramm der Module, die die Machine Learning-Lösung bilden.

Name	Typ	Beschreibung
edges	GraphEdge[]	Die Liste der Kanten, die das Diagramm bilden.
graphParameters	<string,  GraphParameter>	Die Sammlung globaler Parameter für das Diagramm, die als globaler Parametername für die GraphParameter-Zuordnung angegeben wird. Jeder Parameter enthält hier eine Übereinstimmung mit 1:1 mit der globalen Parameterwertezuordnung, die auf der Ebene "WebServiceProperties" deklariert ist.
nodes	<string,  GraphNode>	Die Gruppe von Knoten, die das Diagramm bilden, bereitgestellt als nodeId zu GraphNode-Zuordnung

GraphParameter

Objekt

Definiert einen globalen Parameter im Diagramm.

Name	Typ	Beschreibung
description	string	Beschreibung dieses Diagrammparameters.
links	GraphParameterLink[]	Zuordnungslinks für diesen Parameter zu Knoten im Diagramm.
type	ParameterType	Graph-Parametertyp.

GraphParameterLink

Objekt

Zuordnungslink für einen globalen Graph-Parameter zu einem Knoten im Diagramm.

Name	Typ	Beschreibung
nodeId	string	Der Bezeichner des Diagrammknotens
parameterKey	string	Der Bezeichner des Knotenparameters, dem der globale Parameter zugeordnet ist.

InputPort

Objekt

Ressourceneingabeport

Name	Typ	Standardwert	Beschreibung
type	InputPortType	Dataset	Portdatentyp.

InputPortType

Enumeration

Portdatentyp.

Wert	Beschreibung
Dataset

MachineLearningWorkspace

Objekt

Informationen zum Maschinellen Lernarbeitsbereich, der das Experiment enthält, das quelle für den Webdienst ist.

Name	Typ	Beschreibung
id	string	Gibt die Arbeitsbereichs-ID des maschinellen Lernarbeitsbereichs an, der dem Webdienst zugeordnet ist.

ModeValueInfo

Objekt

Definition geschachtelter Parameter.

Name	Typ	Beschreibung
interfaceString	string	Der Schnittstellenzeichenfolgenname für den geschachtelten Parameter.
parameters	ModuleAssetParameter[]	Die Definition des Parameters.

ModuleAssetParameter

Objekt

Parameterdefinition für eine Modulressource.

Name	Typ	Beschreibung
modeValuesInfo	<string,  ModeValueInfo>	Definitionen für geschachtelte Schnittstellenparameter, wenn dies ein komplexer Modulparameter ist.
name	string	Parametername.
parameterType	string	Parametertyp.

OutputPort

Objekt

Ressourcenausgabeport

Name	Typ	Standardwert	Beschreibung
type	OutputPortType	Dataset	Portdatentyp.

OutputPortType

Enumeration

Portdatentyp.

Wert	Beschreibung
Dataset

ParameterType

Enumeration

Graph-Parametertyp.

Wert	Beschreibung
Boolean
ColumnPicker
Credential
DataGatewayName
Double
Enumerated
Float
Int
Mode
ParameterRange
Script
String

ProvisioningState

Enumeration

Schreibgeschützt: Der Bereitstellungsstatus des Webdiensts. Gültige Werte sind "Unknown", "Provisioning", "Succeeded" und "Failed".

Wert	Beschreibung
Failed
Provisioning
Succeeded
Unknown

RealtimeConfiguration

Objekt

Enthält die verfügbaren Konfigurationsoptionen für einen Azure ML-Webdienstendpunkt.

Name	Typ	Beschreibung
maxConcurrentCalls	integer minimum: 4 maximum: 200	Gibt die maximal gleichzeitigen Aufrufe an, die an den Webdienst vorgenommen werden können. Mindestwert: 4, Maximalwert: 200.

ServiceInputOutputSpecification

Objekt

Das Schema swagger 2.0, das die Eingaben oder Ausgaben des Diensts beschreibt. Siehe Swagger Spezifikation: http://swagger.io/specification/

Name	Typ	Standardwert	Beschreibung
description	string		Die Beschreibung des Swagger-Schemas.
properties	<string,  TableSpecification>		Gibt eine Auflistung an, die das Spaltenschema für jede Eingabe oder Ausgabe des Webdiensts enthält. Weitere Informationen finden Sie in der Swagger-Spezifikation.
title	string		Der Titel Ihres Swagger-Schemas.
type	string	object	Der Typ der in swagger beschriebenen Entität. Immer 'objekt'.

StorageAccount

Objekt

Zugreifen auf Informationen für ein Speicherkonto.

Name	Typ	Beschreibung
key	string	Gibt den Schlüssel an, der für den Zugriff auf das Speicherkonto verwendet wird.
name	string	Gibt den Namen des Speicherkontos an.

TableSpecification

Objekt

Das Swagger 2.0-Schema, das eine einzelne Diensteingabe oder -ausgabe beschreibt. Siehe Swagger Spezifikation: http://swagger.io/specification/

Name	Typ	Standardwert	Beschreibung
description	string		Beschreibung des Swagger-Schemas.
format	string		Das Format, wenn 'type' nicht 'object' ist
properties	<string,  ColumnSpecification>		Der Satz von Spalten in der Datentabelle.
title	string		Swagger-Schematitel.
type	string	object	Der Typ der in swagger beschriebenen Entität.

WebService

Objekt

Instanz einer Azure ML-Webdienstressource.

Name	Typ	Beschreibung
id	string	Gibt die Ressourcen-ID an.
location	string	Gibt den Speicherort der Ressource an.
name	string	Gibt den Namen der Ressource an.
properties	WebServiceProperties: WebServicePropertiesForGraph	Enthält die Eigenschaftsnutzlast, die den Webdienst beschreibt.
tags	object	Enthält Ressourcentags, die als Schlüssel-Wert-Paare definiert sind.
type	string	Gibt den Typ der Ressource an.

WebServiceKeys

Objekt

Zugriffstasten für webdienstaufrufe.

Name	Typ	Beschreibung
primary	string	Der primäre Zugriffsschlüssel.
secondary	string	Die sekundäre Zugriffstaste.

WebServicePropertiesForGraph

Objekt

Eigenschaften, die für einen Graph-basierten Webdienst spezifisch sind.

Name	Typ	Beschreibung
assets	<string,  AssetItem>	Enthält benutzerdefinierte Eigenschaften, die Webdienstressourcen beschreiben. Eigenschaften werden als Schlüssel-/Wert-Paare ausgedrückt.
commitmentPlan	CommitmentPlan	Enthält den Verpflichtungsplan, der diesem Webdienst zugeordnet ist. Zur Erstellungszeit festgelegt. Nachdem dieser Wert festgelegt wurde, kann dieser Wert nicht mehr geändert werden. Hinweis: Der Verpflichtungsplan wird nicht von Aufrufen an GET-Vorgänge zurückgegeben.
createdOn	string (date-time)	Schreibgeschützt: Datum und Uhrzeit der Erstellung des Webdiensts.
description	string	Die Beschreibung des Webdiensts.
diagnostics	DiagnosticsConfiguration	Einstellungen, die die Diagnoseablaufverfolgungsauflistung für den Webdienst steuern.
exampleRequest	ExampleRequest	Definiert Beispieleingabedaten für eine oder mehrere Eingaben des Diensts.
exposeSampleData	boolean	Wenn dieser Wert auf "true" festgelegt ist, sind Beispieldaten in der Webdienstdefinition enthalten. Der Standardwert ist „wahr“.
input	ServiceInputOutputSpecification	Enthält das Swagger 2.0-Schema, das eine oder mehrere Eingaben des Webdiensts beschreibt. Weitere Informationen finden Sie in der Swagger-Spezifikation.
keys	WebServiceKeys	Enthält die Webdienstbereitstellungsschlüssel. Wenn Sie keine Bereitstellungsschlüssel angeben, generiert das Azure Machine Learning-System diese für Sie. Hinweis: Die Schlüssel werden nicht von Aufrufen an GET-Vorgänge zurückgegeben.
machineLearningWorkspace	MachineLearningWorkspace	Gibt den Maschinellen Lernarbeitsbereich an, der das Experiment enthält, das die Quelle für den Webdienst ist.
modifiedOn	string (date-time)	Schreibgeschützt: Datum und Uhrzeit der letzten Änderung des Webdiensts.
output	ServiceInputOutputSpecification	Enthält das Swagger 2.0-Schema, das eine oder mehrere Ausgaben des Webdiensts beschreibt. Weitere Informationen finden Sie in der Swagger-Spezifikation.
package	GraphPackage	Die Definition des Diagrammpakets, aus dem dieser Webdienst besteht.
packageType	string: Graph	Gibt den Pakettyp an. Gültige Werte sind Graph (Specifies a web service published through the Machine Learning Studio) and Code (Specifies a web service published using code such as Python). Hinweis: Code wird zurzeit nicht unterstützt.
parameters	object	Der Satz von globalen Parameterwerten, die für den Webdienst definiert sind, der als globaler Parametername zur Standardwertzuordnung angegeben wird. Wenn kein Standardwert angegeben wird, wird der Parameter als erforderlich betrachtet.
provisioningState	ProvisioningState	Schreibgeschützt: Der Bereitstellungsstatus des Webdiensts. Gültige Werte sind "Unknown", "Provisioning", "Succeeded" und "Failed".
readOnly	boolean	Wenn dieser wert auf "true" festgelegt ist, gibt an, dass der Webdienst schreibgeschützt ist und nicht mehr aktualisiert oder gepatcht werden kann, nur entfernt. Der Standardwert ist "false". Hinweis: Nachdem sie auf "true" festgelegt wurde, können Sie den Wert nicht mehr ändern.
realtimeConfiguration	RealtimeConfiguration	Enthält die Konfigurationseinstellungen für den Webdienstendpunkt.
storageAccount	StorageAccount	Gibt das Speicherkonto an, das Azure Machine Learning zum Speichern von Informationen über den Webdienst verwendet. Nur der Name des Speicherkontos wird von Aufrufen an GET-Vorgänge zurückgegeben. Beim Aktualisieren der Speicherkontoinformationen müssen Sie sicherstellen, dass alle erforderlichen Ressourcen im neuen Speicherkonto verfügbar sind oder Aufrufe an Ihren Webdienst fehlschlagen.
swaggerLocation	string	Schreibgeschützt: Enthält den URI der Swagger-Spezifikation, die diesem Webdienst zugeordnet ist.
title	string	Der Titel des Webdiensts.