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 sieci Web. 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ę Get, 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	Powodzenie. 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	Utworzone. 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ł na wykresie 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 wykresie.
GraphParameterLink	Link skojarzenia dla parametru globalnego grafu do węzła na grafie.
InputPort	Port wejściowy elementu zawartości
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 elementu zawartości
OutputPortType	Typ danych portów.
ParameterType	Typ parametru grafu.
ProvisioningState	Tylko do odczytu: stan aprowizacji usługi internetowej. Prawidłowe wartości to Nieznany, Aprowizowanie, Powodzenie i Niepowodzenie.
RealtimeConfiguration	Przechowuje dostępne opcje konfiguracji punktu końcowego usługi internetowej usługi Azure ML.
ServiceInputOutputSpecification	Schemat programu Swagger 2.0 opisujący dane wejściowe lub wyjściowe usługi. Zobacz Specyfikacja struktury Swagger: http://swagger.io/specification/
StorageAccount	Uzyskiwanie dostępu 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 sieci Web.
WebServicePropertiesForGraph	Właściwości specyficzne dla usługi internetowej opartej na grafie.

AssetItem

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	Uzyskiwanie dostępu 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, przechowuje parametry modułu.
type	AssetType	Typ zasobu.

AssetLocation

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

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

AssetType

Typ zasobu.

Nazwa	Typ	Opis
Module	string
Resource	string

ColumnFormat

Dodatkowe informacje o formacie dla typu danych.

Nazwa	Typ	Opis
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

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

Typ danych kolumny.

Nazwa	Typ	Opis
Boolean	string
Integer	string
Number	string
String	string

CommitmentPlan

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

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

DiagnosticsConfiguration

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

Nazwa	Typ	Opis
expiry	string	Określa datę i godzinę zakończenia rejestrowania. Jeśli wartość null, kolekcja diagnostyki 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

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).

Nazwa	Typ	Opis
All	string
Error	string
None	string

ExampleRequest

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

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

Nazwa	Typ	Opis
sourceNodeId	string	Identyfikator węzła grafu ź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órymi łączy się krawędź.

GraphNode

Określa węzeł na wykresie 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ą mapowe na te wartości ustawione w czasie wykonywania.

GraphPackage

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

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

GraphParameter

Definiuje parametr globalny na wykresie.

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

GraphParameterLink

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.

InputPort

Port wejściowy elementu zawartości

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

InputPortType

Typ danych portów.

Nazwa	Typ	Opis
Dataset	string

MachineLearningWorkspace

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

Definicja zagnieżdżonego parametru.

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

ModuleAssetParameter

Definicja parametru elementu zawartości modułu.

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

OutputPort

Port wyjściowy elementu zawartości

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

OutputPortType

Typ danych portów.

Nazwa	Typ	Opis
Dataset	string

ParameterType

Typ parametru grafu.

Nazwa	Typ	Opis
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

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

Nazwa	Typ	Opis
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

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

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

ServiceInputOutputSpecification

Schemat programu 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 kolumn dla każdego wejściowego lub wyjściowego 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

Uzyskiwanie dostępu 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

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

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

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

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

WebServicePropertiesForGraph

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

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	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	Po ustawieniu wartości true przykładowe dane są uwzględniane w definicji struktury swagger usługi internetowej. Wartością domyślną jest 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ług internetowych. Jeśli nie określisz kluczy aprowizacji, system usługi Azure Machine Learning generuje 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	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 Code (Określa usługę internetową opublikowaną przy użyciu kodu, takiego jak Python). Uwaga: kod nie jest obecnie obsługiwany.
parameters	object	Zestaw globalnych wartości parametrów zdefiniowanych dla usługi internetowej, podany jako globalna nazwa parametru do domyślnej mapy wartości. Jeśli nie określono wartości domyślnej, parametr jest uważany za wymagany.
provisioningState	ProvisioningState	Tylko do odczytu: stan aprowizacji usługi internetowej. Prawidłowe wartości to Nieznany, 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 zakończy się niepowodzeniem.
swaggerLocation	string	Tylko do odczytu: zawiera identyfikator URI specyfikacji struktury Swagger skojarzonej z tą usługą internetową.
title	string	Tytuł usługi internetowej.