Web Services - Patch
Modyfikuje istniejący zasób usługi internetowej. Wywołanie interfejsu API PATCH jest operacją asynchroniczną. Aby określić, czy operacja została ukończona pomyślnie, należy wykonać operację Pobierz.
PATCH 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 |
|---|---|---|---|---|
|
resource
|
path | True |
string |
Nazwa grupy zasobów, w której znajduje się usługa internetowa. |
|
subscription
|
path | True |
string |
Identyfikator subskrypcji platformy Azure. |
|
web
|
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: |
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 |
Sukces. Ł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" |
Definicje
| Nazwa | Opis |
|---|---|
|
Asset |
Informacje o zasobie skojarzonym z usługą internetową. |
|
Asset |
Opisuje lokalizację dostępu dla zasobu usługi internetowej. |
|
Asset |
Typ zasobu. |
|
Column |
Dodatkowe informacje o formacie dla typu danych. |
|
Column |
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/ |
|
Column |
Typ danych kolumny. |
|
Commitment |
Informacje o planie zobowiązania uczenia maszynowego skojarzonego z usługą internetową. |
|
Diagnostics |
Ustawienia diagnostyczne dla usługi internetowej usługi Azure ML. |
|
Diagnostics |
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). |
|
Example |
Przykładowe dane wejściowe dla danych wejściowych usługi. |
|
Graph |
Definiuje krawędź w obrębie grafu usługi internetowej. |
|
Graph |
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. |
|
Graph |
Definiuje graf modułów tworzących rozwiązanie uczenia maszynowego. |
|
Graph |
Definiuje parametr globalny na grafie. |
|
Graph |
Link skojarzenia dla parametru globalnego grafu do węzła na grafie. |
|
Input |
Port wejściowy zasobu |
|
Input |
Typ danych portów. |
|
Machine |
Informacje o obszarze roboczym uczenia maszynowego zawierającego eksperyment, który jest źródłem usługi internetowej. |
|
Mode |
Definicja zagnieżdżonego parametru. |
|
Module |
Definicja parametru elementu zawartości modułu. |
|
Output |
Port wyjściowy zasobu |
|
Output |
Typ danych portów. |
|
Parameter |
Typ parametru grafu. |
|
Provisioning |
Tylko do odczytu: stan aprowizacji usługi internetowej. Prawidłowe wartości to Nieznane, Aprowizowanie, Powodzenie i Niepowodzenie. |
|
Realtime |
Przechowuje dostępne opcje konfiguracji punktu końcowego usługi internetowej usługi Azure ML. |
|
Service |
Schemat struktury Swagger 2.0 opisujący dane wejściowe lub wyjściowe usługi. Zobacz Specyfikacja struktury Swagger: http://swagger.io/specification/ |
|
Storage |
Uzyskaj dostęp do informacji o koncie magazynu. |
|
Table |
Schemat struktury Swagger 2.0 opisujący pojedyncze dane wejściowe lub wyjściowe usługi. Zobacz Specyfikacja struktury Swagger: http://swagger.io/specification/ |
|
Web |
Wystąpienie zasobu usługi internetowej usługi Azure ML. |
|
Web |
Klucze dostępu dla wywołań usługi internetowej. |
|
Web |
Właściwości specyficzne dla usługi internetowej opartej na programie Graph. |
AssetItem
Informacje o zasobie skojarzonym z usługą internetową.
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string |
Identyfikator zasobu. |
| inputPorts |
<string,
Input |
Informacje o portach wejściowych zasobu. |
| locationInfo |
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,
Output |
Informacje o portach wyjściowych zasobu. |
| parameters |
Jeśli zasób jest modułem niestandardowym, zawiera on parametry modułu. |
|
| type |
Typ zasobu. |
AssetLocation
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
Typ zasobu.
| Wartość | Opis |
|---|---|
| Module | |
| Resource |
ColumnFormat
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
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 |
Dodatkowe informacje o formacie dla typu danych. |
|
| type |
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.
| Wartość | Opis |
|---|---|
| Boolean | |
| Integer | |
| Number | |
| String |
CommitmentPlan
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
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 |
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).
| Wartość | Opis |
|---|---|
| None | |
| Error | |
| All |
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 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
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
Definiuje graf modułów tworzących rozwiązanie uczenia maszynowego.
| Nazwa | Typ | Opis |
|---|---|---|
| edges |
Lista krawędzi tworzących graf. |
|
| graphParameters |
<string,
Graph |
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,
Graph |
Zestaw węzłów tworzących graf, podany jako nodeId do mapy GraphNode |
GraphParameter
Definiuje parametr globalny na grafie.
| Nazwa | Typ | Opis |
|---|---|---|
| description |
string |
Opis tego parametru grafu. |
| links |
Łącza skojarzenia dla tego parametru do węzłów na grafie. |
|
| type |
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 na. |
InputPort
Port wejściowy zasobu
| Nazwa | Typ | Domyślna wartość | Opis |
|---|---|---|---|
| type | Dataset |
Typ danych portów. |
InputPortType
Typ danych portów.
| Wartość | Opis |
|---|---|
| Dataset |
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 |
Definicja parametru. |
ModuleAssetParameter
Definicja parametru elementu zawartości modułu.
| Nazwa | Typ | Opis |
|---|---|---|
| modeValuesInfo |
<string,
Mode |
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
Port wyjściowy zasobu
| Nazwa | Typ | Domyślna wartość | Opis |
|---|---|---|---|
| type | Dataset |
Typ danych portów. |
OutputPortType
Typ danych portów.
| Wartość | Opis |
|---|---|
| Dataset |
ParameterType
Typ parametru grafu.
| Wartość | Opis |
|---|---|
| String | |
| Int | |
| Float | |
| Enumerated | |
| Script | |
| Mode | |
| Credential | |
| Boolean | |
| Double | |
| ColumnPicker | |
| ParameterRange | |
| DataGatewayName |
ProvisioningState
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
Przechowuje dostępne opcje konfiguracji punktu końcowego usługi internetowej usługi Azure ML.
| Nazwa | Typ | Opis |
|---|---|---|
| maxConcurrentCalls |
integer minimum: 4maximum: 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
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,
Table |
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
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
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,
Column |
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: |
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 internetowej.
| 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 programie Graph.
| Nazwa | Typ | Opis |
|---|---|---|
| assets |
<string,
Asset |
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 |
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 |
Ustawienia kontrolujące zbieranie śladów diagnostycznych dla usługi internetowej. |
|
| 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 |
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 |
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 |
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 |
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 |
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 |
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 |
Zawiera ustawienia konfiguracji punktu końcowego usługi internetowej. |
|
| 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. |