Web Services - Create Or Update

Usługa:

ML Studio (classic)

Wersja interfejsu API:

2016-05-01-preview

Tworzenie lub aktualizowanie usługi internetowej. To wywołanie spowoduje zastąpienie istniejącej usługi internetowej. Należy pamiętać, że nie ma ostrzeżenia ani potwierdzenia. Jest to operacja niemożliwa do odzyskania. Jeśli twoim zamiarem jest utworzenie nowej usługi internetowej, najpierw wywołaj operację Pobierz, aby sprawdzić, czy nie istnieje.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów, w której znajduje się usługa internetowa.
subscriptionId	path	True	string	Identyfikator subskrypcji platformy Azure.
webServiceName	path	True	string	Nazwa usługi internetowej.
api-version	query	True	string	Wersja interfejsu API dostawcy zasobów Microsoft.MachineLearning do użycia.

Treść żądania

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

Nazwa	Wymagane	Typ	Opis
location	True	string	Określa lokalizację zasobu.
properties	True	WebServiceProperties: WebServicePropertiesForGraph	Zawiera ładunek właściwości opisujący usługę internetową.
name		string	Określa nazwę zasobu.
tags		object	Zawiera tagi zasobów zdefiniowane jako pary klucz/wartość.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	WebService	Sukces. Ta odpowiedź jest zwracana dla operacji aktualizacji usługi internetowej. Ładunek odpowiedzi jest identyczny z ładunkiem odpowiedzi zwracanym przez operację GET. Odpowiedź zawiera stan aprowizacji i nagłówek Azure-AsyncOperation. Aby uzyskać postęp operacji, wywołaj operację GET na adresie URL w polu nagłówka Azure-AsyncOperation. Aby uzyskać więcej informacji na temat operacji asynchronicznych, zobacz https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"
201 Created	WebService	Utworzono. Ta odpowiedź jest zwracana dla operacji tworzenia usługi internetowej. Odpowiedź zawiera stan aprowizacji i nagłówek Azure-AsyncOperation. Aby uzyskać postęp operacji, wywołaj operację GET na adresie URL w polu nagłówka Azure-AsyncOperation. Aby uzyskać więcej informacji na temat operacji asynchronicznych, zobacz https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"

Definicje

Nazwa	Opis
AssetItem	Informacje o zasobie skojarzonym z usługą internetową.
AssetLocation	Opisuje lokalizację dostępu dla zasobu usługi internetowej.
AssetType	Typ zasobu.
ColumnFormat	Dodatkowe informacje o formacie dla typu danych.
ColumnSpecification	Schemat programu Swagger 2.0 dla kolumny w tabeli danych reprezentujący dane wejściowe lub wyjściowe usługi internetowej. Zobacz Specyfikacja struktury Swagger: http://swagger.io/specification/
ColumnType	Typ danych kolumny.
CommitmentPlan	Informacje o planie zobowiązania uczenia maszynowego skojarzonego z usługą internetową.
DiagnosticsConfiguration	Ustawienia diagnostyczne dla usługi internetowej usługi Azure ML.
DiagnosticsLevel	Określa szczegółowość danych wyjściowych diagnostyki. Prawidłowe wartości to: Brak — wyłącza śledzenie; Błąd — zbiera tylko ślady błędów (stderr); Wszystkie — zbiera wszystkie ślady (stdout i stderr).
ExampleRequest	Przykładowe dane wejściowe dla danych wejściowych usługi.
GraphEdge	Definiuje krawędź w obrębie grafu usługi internetowej.
GraphNode	Określa węzeł w grafie usługi internetowej. Węzeł może być węzłem wejściowym, wyjściowym lub węzłem zasobu, więc tylko jedna z odpowiednich właściwości identyfikatora jest wypełniana w dowolnym momencie.
GraphPackage	Definiuje graf modułów tworzących rozwiązanie uczenia maszynowego.
GraphParameter	Definiuje parametr globalny na grafie.
GraphParameterLink	Link skojarzenia dla parametru globalnego grafu do węzła na grafie.
InputPort	Port wejściowy zasobu
InputPortType	Typ danych portów.
MachineLearningWorkspace	Informacje o obszarze roboczym uczenia maszynowego zawierającego eksperyment, który jest źródłem usługi internetowej.
ModeValueInfo	Definicja zagnieżdżonego parametru.
ModuleAssetParameter	Definicja parametru elementu zawartości modułu.
OutputPort	Port wyjściowy zasobu
OutputPortType	Typ danych portów.
ParameterType	Typ parametru grafu.
ProvisioningState	Tylko do odczytu: stan aprowizacji usługi internetowej. Prawidłowe wartości to Nieznane, Aprowizowanie, Powodzenie i Niepowodzenie.
RealtimeConfiguration	Przechowuje dostępne opcje konfiguracji punktu końcowego usługi internetowej usługi Azure ML.
ServiceInputOutputSpecification	Schemat struktury Swagger 2.0 opisujący dane wejściowe lub wyjściowe usługi. Zobacz Specyfikacja struktury Swagger: http://swagger.io/specification/
StorageAccount	Uzyskaj dostęp do informacji o koncie magazynu.
TableSpecification	Schemat struktury Swagger 2.0 opisujący pojedyncze dane wejściowe lub wyjściowe usługi. Zobacz Specyfikacja struktury Swagger: http://swagger.io/specification/
WebService	Wystąpienie zasobu usługi internetowej usługi Azure ML.
WebServiceKeys	Klucze dostępu dla wywołań usługi internetowej.
WebServicePropertiesForGraph	Właściwości specyficzne dla usługi internetowej opartej na programie Graph.

AssetItem

Objekt

Informacje o zasobie skojarzonym z usługą internetową.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
inputPorts	<string,  InputPort>	Informacje o portach wejściowych zasobu.
locationInfo	AssetLocation	Uzyskaj dostęp do informacji o zasobie.
metadata	object	Jeśli zasób jest modułem niestandardowym, przechowuje metadane modułu.
name	string	Przyjazna nazwa zasobu.
outputPorts	<string,  OutputPort>	Informacje o portach wyjściowych zasobu.
parameters	ModuleAssetParameter[]	Jeśli zasób jest modułem niestandardowym, zawiera on parametry modułu.
type	AssetType	Typ zasobu.

AssetLocation

Objekt

Opisuje lokalizację dostępu dla zasobu usługi internetowej.

Nazwa	Typ	Opis
credentials	string	Poświadczenia dostępu do zasobu, jeśli ma to zastosowanie (np. zasób określony przez parametry połączenia konta magazynu + identyfikator URI obiektu blob)
uri	string (url)	Identyfikator URI, z którego jest dostępny zasób (np. aml://abc dla zasobów systemowych lub https://xyz dla zasobów użytkowników

AssetType

Wyliczanie

Typ zasobu.

Wartość	Opis
Module
Resource

ColumnFormat

Wyliczanie

Dodatkowe informacje o formacie dla typu danych.

Wartość	Opis
Byte
Char
Complex64
Complex128
Date-time
Date-timeOffset
Double
Duration
Float
Int8
Int16
Int32
Int64
Uint8
Uint16
Uint32
Uint64

ColumnSpecification

Objekt

Schemat programu Swagger 2.0 dla kolumny w tabeli danych reprezentujący dane wejściowe lub wyjściowe usługi internetowej. Zobacz Specyfikacja struktury Swagger: http://swagger.io/specification/

Nazwa	Typ	Opis
enum	object[]	Jeśli typ danych jest kategorialny, zawiera listę akceptowanych kategorii.
format	ColumnFormat	Dodatkowe informacje o formacie dla typu danych.
type	ColumnType	Typ danych kolumny.
x-ms-isnullable	boolean	Flaga wskazująca, czy typ obsługuje wartości null, czy nie.
x-ms-isordered	boolean	Flaga wskazująca, czy kategorie są traktowane jako uporządkowany zestaw, czy nie, jeśli jest to kolumna kategorii.

ColumnType

Wyliczanie

Typ danych kolumny.

Wartość	Opis
Boolean
Integer
Number
String

CommitmentPlan

Objekt

Informacje o planie zobowiązania uczenia maszynowego skojarzonego z usługą internetową.

Nazwa	Typ	Opis
id	string	Określa identyfikator usługi Azure Resource Manager planu zobowiązania skojarzonego z usługą internetową.

DiagnosticsConfiguration

Objekt

Ustawienia diagnostyczne dla usługi internetowej usługi Azure ML.

Nazwa	Typ	Opis
expiry	string (date-time)	Określa datę i godzinę zakończenia rejestrowania. Jeśli wartość null, kolekcja diagnostyczna nie jest ograniczona czasowo.
level	DiagnosticsLevel	Określa szczegółowość danych wyjściowych diagnostyki. Prawidłowe wartości to: Brak — wyłącza śledzenie; Błąd — zbiera tylko ślady błędów (stderr); Wszystkie — zbiera wszystkie ślady (stdout i stderr).

DiagnosticsLevel

Wyliczanie

Określa szczegółowość danych wyjściowych diagnostyki. Prawidłowe wartości to: Brak — wyłącza śledzenie; Błąd — zbiera tylko ślady błędów (stderr); Wszystkie — zbiera wszystkie ślady (stdout i stderr).

Wartość	Opis
None
Error
All

ExampleRequest

Objekt

Przykładowe dane wejściowe dla danych wejściowych usługi.

Nazwa	Typ	Opis
globalParameters	object	Przykładowe dane wejściowe dla parametrów globalnych usługi internetowej
inputs	object	Przykładowe dane wejściowe dla danych wejściowych usługi internetowej podane jako nazwa wejściowa do przykładowej mapy macierzy wartości wejściowych.

GraphEdge

Objekt

Definiuje krawędź w obrębie grafu usługi internetowej.

Nazwa	Typ	Opis
sourceNodeId	string	Identyfikator węzła wykresu źródłowego.
sourcePortId	string	Identyfikator portu węzła źródłowego, z którego łączy się krawędź.
targetNodeId	string	Identyfikator węzła grafu docelowego.
targetPortId	string	Identyfikator portu węzła docelowego, z którego łączy się krawędź.

GraphNode

Objekt

Określa węzeł w grafie usługi internetowej. Węzeł może być węzłem wejściowym, wyjściowym lub węzłem zasobu, więc tylko jedna z odpowiednich właściwości identyfikatora jest wypełniana w dowolnym momencie.

Nazwa	Typ	Opis
assetId	string	Identyfikator zasobu reprezentowanego przez ten węzeł.
inputId	string	Identyfikator elementu wejściowego reprezentowanego przez ten węzeł.
outputId	string	Identyfikator elementu wyjściowego reprezentowanego przez ten węzeł.
parameters	object	Jeśli ma to zastosowanie, parametry węzła. Globalne parametry grafu są mapowania na te wartości ustawione w czasie wykonywania.

GraphPackage

Objekt

Definiuje graf modułów tworzących rozwiązanie uczenia maszynowego.

Nazwa	Typ	Opis
edges	GraphEdge[]	Lista krawędzi tworzących graf.
graphParameters	<string,  GraphParameter>	Kolekcja parametrów globalnych grafu podana jako nazwa parametru globalnego na mapie GraphParameter. Każdy parametr ma tutaj dopasowanie 1:1 z mapą wartości parametrów globalnych zadeklarowaną na poziomie WebServiceProperties.
nodes	<string,  GraphNode>	Zestaw węzłów tworzących graf, podany jako nodeId do mapy GraphNode

GraphParameter

Objekt

Definiuje parametr globalny na grafie.

Nazwa	Typ	Opis
description	string	Opis tego parametru grafu.
links	GraphParameterLink[]	Łącza skojarzenia dla tego parametru do węzłów na grafie.
type	ParameterType	Typ parametru grafu.

GraphParameterLink

Objekt

Link skojarzenia dla parametru globalnego grafu do węzła na grafie.

Nazwa	Typ	Opis
nodeId	string	Identyfikator węzła grafu
parameterKey	string	Identyfikator parametru węzła mapowania parametru globalnego na.

InputPort

Objekt

Port wejściowy zasobu

Nazwa	Typ	Domyślna wartość	Opis
type	InputPortType	Dataset	Typ danych portów.

InputPortType

Wyliczanie

Typ danych portów.

Wartość	Opis
Dataset

MachineLearningWorkspace

Objekt

Informacje o obszarze roboczym uczenia maszynowego zawierającego eksperyment, który jest źródłem usługi internetowej.

Nazwa	Typ	Opis
id	string	Określa identyfikator obszaru roboczego uczenia maszynowego skojarzonego z usługą internetową

ModeValueInfo

Objekt

Definicja zagnieżdżonego parametru.

Nazwa	Typ	Opis
interfaceString	string	Nazwa ciągu interfejsu dla zagnieżdżonego parametru.
parameters	ModuleAssetParameter[]	Definicja parametru.

ModuleAssetParameter

Objekt

Definicja parametru elementu zawartości modułu.

Nazwa	Typ	Opis
modeValuesInfo	<string,  ModeValueInfo>	Definicje parametrów zagnieżdżonego interfejsu, jeśli jest to złożony parametr modułu.
name	string	Nazwa parametru.
parameterType	string	Typ parametru.

OutputPort

Objekt

Port wyjściowy zasobu

Nazwa	Typ	Domyślna wartość	Opis
type	OutputPortType	Dataset	Typ danych portów.

OutputPortType

Wyliczanie

Typ danych portów.

Wartość	Opis
Dataset

ParameterType

Wyliczanie

Typ parametru grafu.

Wartość	Opis
String
Int
Float
Enumerated
Script
Mode
Credential
Boolean
Double
ColumnPicker
ParameterRange
DataGatewayName

ProvisioningState

Wyliczanie

Tylko do odczytu: stan aprowizacji usługi internetowej. Prawidłowe wartości to Nieznane, Aprowizowanie, Powodzenie i Niepowodzenie.

Wartość	Opis
Unknown
Provisioning
Succeeded
Failed

RealtimeConfiguration

Objekt

Przechowuje dostępne opcje konfiguracji punktu końcowego usługi internetowej usługi Azure ML.

Nazwa	Typ	Opis
maxConcurrentCalls	integer minimum: 4 maximum: 200	Określa maksymalne współbieżne wywołania, które można wykonać w usłudze internetowej. Wartość minimalna: 4, Wartość maksymalna: 200.

ServiceInputOutputSpecification

Objekt

Schemat struktury Swagger 2.0 opisujący dane wejściowe lub wyjściowe usługi. Zobacz Specyfikacja struktury Swagger: http://swagger.io/specification/

Nazwa	Typ	Domyślna wartość	Opis
description	string		Opis schematu struktury Swagger.
properties	<string,  TableSpecification>		Określa kolekcję zawierającą schemat kolumny dla poszczególnych danych wejściowych lub wyjściowych usługi internetowej. Aby uzyskać więcej informacji, zobacz specyfikację struktury Swagger.
title	string		Tytuł schematu struktury Swagger.
type	string	object	Typ jednostki opisanej w programie Swagger. Zawsze "obiekt".

StorageAccount

Objekt

Uzyskaj dostęp do informacji o koncie magazynu.

Nazwa	Typ	Opis
key	string	Określa klucz używany do uzyskiwania dostępu do konta magazynu.
name	string	Określa nazwę konta magazynu.

TableSpecification

Objekt

Schemat struktury Swagger 2.0 opisujący pojedyncze dane wejściowe lub wyjściowe usługi. Zobacz Specyfikacja struktury Swagger: http://swagger.io/specification/

Nazwa	Typ	Domyślna wartość	Opis
description	string		Opis schematu struktury Swagger.
format	string		Format, jeśli typ nie jest "obiektem"
properties	<string,  ColumnSpecification>		Zestaw kolumn w tabeli danych.
title	string		Tytuł schematu struktury Swagger.
type	string	object	Typ jednostki opisanej w programie Swagger.

WebService

Objekt

Wystąpienie zasobu usługi internetowej usługi Azure ML.

Nazwa	Typ	Opis
id	string	Określa identyfikator zasobu.
location	string	Określa lokalizację zasobu.
name	string	Określa nazwę zasobu.
properties	WebServiceProperties: WebServicePropertiesForGraph	Zawiera ładunek właściwości opisujący usługę internetową.
tags	object	Zawiera tagi zasobów zdefiniowane jako pary klucz/wartość.
type	string	Określa typ zasobu.

WebServiceKeys

Objekt

Klucze dostępu dla wywołań usługi internetowej.

Nazwa	Typ	Opis
primary	string	Podstawowy klucz dostępu.
secondary	string	Pomocniczy klucz dostępu.

WebServicePropertiesForGraph

Objekt

Właściwości specyficzne dla usługi internetowej opartej na programie Graph.

Nazwa	Typ	Opis
assets	<string,  AssetItem>	Zawiera właściwości zdefiniowane przez użytkownika opisujące zasoby usługi internetowej. Właściwości są wyrażane jako pary klucz/wartość.
commitmentPlan	CommitmentPlan	Zawiera plan zobowiązania skojarzony z tą usługą internetową. Ustaw w czasie tworzenia. Po ustawieniu tej wartości nie można zmienić. Uwaga: plan zobowiązania nie jest zwracany z wywołań do operacji GET.
createdOn	string (date-time)	Tylko do odczytu: data i godzina utworzenia usługi internetowej.
description	string	Opis usługi internetowej.
diagnostics	DiagnosticsConfiguration	Ustawienia kontrolujące zbieranie śladów diagnostycznych dla usługi internetowej.
exampleRequest	ExampleRequest	Definiuje przykładowe dane wejściowe dla co najmniej jednego danych wejściowych usługi.
exposeSampleData	boolean	W przypadku ustawienia wartości true przykładowe dane są uwzględniane w definicji struktury swagger usługi internetowej. Wartość domyślna to true.
input	ServiceInputOutputSpecification	Zawiera schemat struktury Swagger 2.0 opisujący co najmniej jeden z danych wejściowych usługi internetowej. Aby uzyskać więcej informacji, zobacz specyfikację struktury Swagger.
keys	WebServiceKeys	Zawiera klucze aprowizacji usługi internetowej. Jeśli nie określisz kluczy aprowizacji, system Azure Machine Learning wygeneruje je dla Ciebie. Uwaga: klucze nie są zwracane z wywołań do operacji GET.
machineLearningWorkspace	MachineLearningWorkspace	Określa obszar roboczy usługi Machine Learning zawierający eksperyment źródłowy dla usługi internetowej.
modifiedOn	string (date-time)	Tylko do odczytu: data i godzina ostatniej modyfikacji usługi internetowej.
output	ServiceInputOutputSpecification	Zawiera schemat struktury Swagger 2.0 opisujący co najmniej jeden z danych wyjściowych usługi internetowej. Aby uzyskać więcej informacji, zobacz specyfikację struktury Swagger.
package	GraphPackage	Definicja pakietu grafu tworzącego tę usługę internetową.
packageType	string: Graph	Określa typ pakietu. Prawidłowe wartości to Graph (określa usługę internetową opublikowaną za pośrednictwem usługi Machine Learning Studio) i Kod (określa usługę internetową opublikowaną przy użyciu kodu takiego jak Python). Uwaga: kod nie jest obecnie obsługiwany.
parameters	object	Zestaw wartości parametrów globalnych zdefiniowanych dla usługi internetowej, podany jako nazwa parametru globalnego na domyślną mapę wartości. Jeśli nie określono wartości domyślnej, parametr jest uznawany za wymagany.
provisioningState	ProvisioningState	Tylko do odczytu: stan aprowizacji usługi internetowej. Prawidłowe wartości to Nieznane, Aprowizowanie, Powodzenie i Niepowodzenie.
readOnly	boolean	Po ustawieniu wartości true oznacza, że usługa internetowa jest tylko do odczytu i nie może być już aktualizowana ani poprawiana, tylko usunięta. Wartość domyślna to false. Uwaga: Po ustawieniu wartości true nie można zmienić jej wartości.
realtimeConfiguration	RealtimeConfiguration	Zawiera ustawienia konfiguracji punktu końcowego usługi internetowej.
storageAccount	StorageAccount	Określa konto magazynu używane przez usługę Azure Machine Learning do przechowywania informacji o usłudze internetowej. Tylko nazwa konta magazynu jest zwracana z wywołań do operacji GET. Podczas aktualizowania informacji o koncie magazynu należy upewnić się, że wszystkie niezbędne zasoby są dostępne na nowym koncie magazynu lub wywołania usługi internetowej nie będą działać.
swaggerLocation	string	Tylko do odczytu: zawiera identyfikator URI specyfikacji struktury Swagger skojarzonej z tą usługą internetową.
title	string	Tytuł usługi internetowej.