Web Services - Patch

Služba:

ML Studio (classic)

Verze rozhraní API:

2016-05-01-preview

Upraví existující prostředek webové služby. Volání rozhraní PATCH API je asynchronní operace. Chcete-li zjistit, zda se úspěšně dokončil, musíte provést operaci Get.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků, ve které se nachází webová služba.
subscriptionId	path	True	string	ID předplatného Azure.
webServiceName	path	True	string	Název webové služby.
api-version	query	True	string	Verze rozhraní API poskytovatele prostředků Microsoft.MachineLearning, která se má použít.

Text požadavku

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

Name	Vyžadováno	Typ	Description
location	True	string	Určuje umístění prostředku.
properties	True	WebServiceProperties: WebServicePropertiesForGraph	Obsahuje datovou část vlastnosti, která popisuje webovou službu.
name		string	Určuje název prostředku.
tags		object	Obsahuje značky prostředků definované jako páry klíč/hodnota.

Odpovědi

Name	Typ	Description
200 OK	WebService	Úspěch. Datová část odpovědi je identická s datovou částí odpovědi vrácenou operací GET. Odpověď obsahuje stav zřizování a hlavičku Azure-AsyncOperation. Pokud chcete zjistit průběh operace, zavolejte operaci GET na adrese URL v poli hlavičky Azure-AsyncOperation. Další informace o asynchronních operacích najdete v tématu https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"

Definice

Name	Description
AssetItem	Informace o prostředku přidruženém k webové službě.
AssetLocation	Popisuje umístění přístupu k prostředku webové služby.
AssetType	Typ prostředku.
ColumnFormat	Další informace o formátu datového typu
ColumnSpecification	Schéma Swaggeru 2.0 pro sloupec v tabulce dat představující vstup nebo výstup webové služby. Viz specifikace Swaggeru: http://swagger.io/specification/
ColumnType	Datový typ sloupce.
CommitmentPlan	Informace o plánu závazku strojového učení přidruženého k webové službě
DiagnosticsConfiguration	Nastavení diagnostiky pro webovou službu Azure ML
DiagnosticsLevel	Určuje podrobnost výstupu diagnostiky. Platné hodnoty jsou: Žádné – zakáže trasování; Chyba – shromažďuje pouze trasování chyb (stderr); All – shromažďuje všechna trasování (stdout a stderr).
ExampleRequest	Ukázková vstupní data pro vstupy služby
GraphEdge	Definuje hranu v grafu webové služby.
GraphNode	Určuje uzel v grafu webové služby. Uzlem může být vstupní, výstupní nebo assetový uzel, takže se v daném okamžiku vyplní jenom jedna z odpovídajících vlastností ID.
GraphPackage	Definuje graf modulů, které tvoří řešení strojového učení.
GraphParameter	Definuje globální parametr v grafu.
GraphParameterLink	Asociační odkaz pro globální parametr grafu k uzlu v grafu
InputPort	Vstupní port majetku
InputPortType	Datový typ portu.
MachineLearningWorkspace	Informace o pracovním prostoru Strojové učení obsahující experiment, který je zdrojem pro webovou službu.
ModeValueInfo	Definice vnořeného parametru
ModuleAssetParameter	Definice parametru pro prostředek modulu
OutputPort	Výstupní port prostředku
OutputPortType	Datový typ portu.
ParameterType	Typ parametru grafu.
ProvisioningState	Jen pro čtení: Stav zřizování webové služby. Platné hodnoty jsou Neznámé, Zřizování, Úspěšné a Neúspěšné.
RealtimeConfiguration	Obsahuje dostupné možnosti konfigurace koncového bodu webové služby Azure ML.
ServiceInputOutputSpecification	Schéma swaggeru 2.0 popisující vstupy nebo výstupy služby. Viz specifikace Swaggeru: http://swagger.io/specification/
StorageAccount	Přístup k informacím pro účet úložiště.
TableSpecification	Schéma swaggeru 2.0 popisující jeden vstup nebo výstup služby. Viz specifikace Swaggeru: http://swagger.io/specification/
WebService	Instance prostředku webové služby Azure ML
WebServiceKeys	Přístupové klíče pro volání webové služby
WebServicePropertiesForGraph	Vlastnosti specifické pro webovou službu založenou na grafech.

AssetItem

Informace o prostředku přidruženém k webové službě.

Name	Typ	Description
id	string	ID prostředku.
inputPorts	<string,  InputPort>	Informace o vstupních portech prostředku
locationInfo	AssetLocation	Přístup k informacím k prostředku.
metadata	object	Pokud je assetem vlastní modul, bude obsahovat metadata modulu.
name	string	Popisný název prostředku.
outputPorts	<string,  OutputPort>	Informace o výstupních portech prostředku
parameters	ModuleAssetParameter[]	Pokud je assetem vlastní modul, bude obsahovat parametry modulu.
type	AssetType	Typ prostředku.

AssetLocation

Popisuje umístění přístupu k prostředku webové služby.

Name	Typ	Description
credentials	string	Přístup k přihlašovacím údajům pro prostředek, pokud je to možné (např. prostředek zadaný účtem úložiště připojovací řetězec + identifikátor URI objektu blob)
uri	string	Identifikátor URI, ze kterého je prostředek přístupný (např. aml://abc pro systémové prostředky nebo https://xyz pro uživatelské prostředky

AssetType

Typ prostředku.

Name	Typ	Description
Module	string
Resource	string

ColumnFormat

Další informace o formátu datového typu

Name	Typ	Description
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

Schéma Swaggeru 2.0 pro sloupec v tabulce dat představující vstup nebo výstup webové služby. Viz specifikace Swaggeru: http://swagger.io/specification/

Name	Typ	Description
enum	object[]	Pokud je datový typ kategorický, zobrazí se seznam přijatých kategorií.
format	ColumnFormat	Další informace o formátu datového typu
type	ColumnType	Datový typ sloupce.
x-ms-isnullable	boolean	Příznak označující, jestli typ podporuje hodnoty null, nebo ne.
x-ms-isordered	boolean	Příznak označující, jestli jsou kategorie považovány za uspořádanou sadu, nebo ne, pokud se jedná o sloupec kategorií.

ColumnType

Datový typ sloupce.

Name	Typ	Description
Boolean	string
Integer	string
Number	string
String	string

CommitmentPlan

Informace o plánu závazku strojového učení přidruženého k webové službě

Name	Typ	Description
id	string	Určuje ID Resource Manager Azure plánu závazku přidruženého k webové službě.

DiagnosticsConfiguration

Nastavení diagnostiky pro webovou službu Azure ML

Name	Typ	Description
expiry	string	Určuje datum a čas ukončení protokolování. Pokud je null, diagnostické shromažďování není časově omezené.
level	DiagnosticsLevel	Určuje úroveň výstupu diagnostiky. Platné hodnoty jsou: Žádné – zakáže trasování; Chyba – shromažďuje pouze trasování chyb (stderr). All – shromažďuje všechna trasování (stdout a stderr).

DiagnosticsLevel

Určuje podrobnost výstupu diagnostiky. Platné hodnoty jsou: Žádné – zakáže trasování; Chyba – shromažďuje pouze trasování chyb (stderr); All – shromažďuje všechna trasování (stdout a stderr).

Name	Typ	Description
All	string
Error	string
None	string

ExampleRequest

Ukázková vstupní data pro vstupy služby

Name	Typ	Description
globalParameters	object	Ukázková vstupní data pro globální parametry webové služby
inputs	object	Ukázková vstupní data pro vstupy webové služby zadané jako název vstupu pro ukázkovou mapu matice vstupních hodnot.

GraphEdge

Definuje hranu v grafu webové služby.

Name	Typ	Description
sourceNodeId	string	Identifikátor uzlu zdrojového grafu
sourcePortId	string	Identifikátor portu zdrojového uzlu, ze kterého se edge připojuje.
targetNodeId	string	Identifikátor cílového uzlu grafu
targetPortId	string	Identifikátor portu cílového uzlu, ke kterému se edge připojuje.

GraphNode

Určuje uzel v grafu webové služby. Uzlem může být vstupní, výstupní nebo assetový uzel, takže se v daném okamžiku vyplní jenom jedna z odpovídajících vlastností ID.

Name	Typ	Description
assetId	string	ID prostředku reprezentované tímto uzlem.
inputId	string	ID vstupního prvku reprezentované tímto uzlem.
outputId	string	ID výstupního prvku reprezentované tímto uzlem.
parameters	object	Pokud je to možné, parametry uzlu. Globální parametry grafu se namapují na tyto parametry s hodnotami nastavenými za běhu.

GraphPackage

Definuje graf modulů, které tvoří řešení strojového učení.

Name	Typ	Description
edges	GraphEdge[]	Seznam hran, které tvoří graf
graphParameters	<string,  GraphParameter>	Kolekce globálních parametrů pro graf zadaný jako globální název parametru pro mapu GraphParameter. Každý zde zadaný parametr má shodu 1:1 s mapou hodnot globálních parametrů deklarovanou na úrovni WebServiceProperties.
nodes	<string,  GraphNode>	Sada uzlů, které tvoří graf, poskytovaná jako nodeId k mapě GraphNode

GraphParameter

Definuje globální parametr v grafu.

Name	Typ	Description
description	string	Popis tohoto parametru grafu
links	GraphParameterLink[]	Přidružení odkazuje pro tento parametr na uzly v grafu.
type	ParameterType	Typ parametru grafu.

GraphParameterLink

Asociační odkaz pro globální parametr grafu k uzlu v grafu

Name	Typ	Description
nodeId	string	Identifikátor uzlu grafu
parameterKey	string	Identifikátor parametru uzlu, na který se globální parametr mapuje.

InputPort

Vstupní port majetku

Name	Typ	Default value	Description
type	InputPortType	Dataset	Datový typ portu.

InputPortType

Datový typ portu.

Name	Typ	Description
Dataset	string

MachineLearningWorkspace

Informace o pracovním prostoru Strojové učení obsahující experiment, který je zdrojem pro webovou službu.

Name	Typ	Description
id	string	Určuje ID pracovního prostoru strojového učení přidruženého k webové službě.

ModeValueInfo

Definice vnořeného parametru

Name	Typ	Description
interfaceString	string	Název řetězce rozhraní pro vnořený parametr.
parameters	ModuleAssetParameter[]	Definice parametru.

ModuleAssetParameter

Definice parametru pro prostředek modulu

Name	Typ	Description
modeValuesInfo	<string,  ModeValueInfo>	Definice vnořených parametrů rozhraní, pokud se jedná o komplexní parametr modulu.
name	string	Názvy parametrů.
parameterType	string	Typ parametru.

OutputPort

Výstupní port prostředku

Name	Typ	Default value	Description
type	OutputPortType	Dataset	Datový typ portu.

OutputPortType

Datový typ portu.

Name	Typ	Description
Dataset	string

ParameterType

Typ parametru grafu.

Name	Typ	Description
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

Jen pro čtení: Stav zřizování webové služby. Platné hodnoty jsou Neznámé, Zřizování, Úspěšné a Neúspěšné.

Name	Typ	Description
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

Obsahuje dostupné možnosti konfigurace koncového bodu webové služby Azure ML.

Name	Typ	Description
maxConcurrentCalls	integer	Určuje maximální počet souběžných volání webové služby. Minimální hodnota: 4, Maximální hodnota: 200.

ServiceInputOutputSpecification

Schéma swaggeru 2.0 popisující vstupy nebo výstupy služby. Viz specifikace Swaggeru: http://swagger.io/specification/

Name	Typ	Default value	Description
description	string		Popis schématu Swagger.
properties	<string,  TableSpecification>		Určuje kolekci, která obsahuje schéma sloupců pro každý vstup nebo výstup webové služby. Další informace najdete ve specifikaci Swaggeru.
title	string		Název schématu Swagger.
type	string	object	Typ entity popsané ve swaggeru. Vždy "objekt".

StorageAccount

Přístup k informacím pro účet úložiště.

Name	Typ	Description
key	string	Určuje klíč použitý pro přístup k účtu úložiště.
name	string	Určuje název účtu úložiště.

TableSpecification

Schéma swaggeru 2.0 popisující jeden vstup nebo výstup služby. Viz specifikace Swaggeru: http://swagger.io/specification/

Name	Typ	Default value	Description
description	string		Popis schématu Swagger.
format	string		Formát, pokud "type" není "object".
properties	<string,  ColumnSpecification>		Sada sloupců v tabulce dat.
title	string		Název schématu Swagger.
type	string	object	Typ entity popsané v swaggeru.

WebService

Instance prostředku webové služby Azure ML

Name	Typ	Description
id	string	Určuje ID prostředku.
location	string	Určuje umístění prostředku.
name	string	Určuje název prostředku.
properties	WebServiceProperties: WebServicePropertiesForGraph	Obsahuje datovou část vlastnosti, která popisuje webovou službu.
tags	object	Obsahuje značky prostředků definované jako páry klíč/hodnota.
type	string	Určuje typ prostředku.

WebServiceKeys

Přístupové klíče pro volání webové služby

Name	Typ	Description
primary	string	Primární přístupový klíč.
secondary	string	Sekundární přístupový klíč.

WebServicePropertiesForGraph

Vlastnosti specifické pro webovou službu založenou na grafech.

Name	Typ	Description
assets	<string,  AssetItem>	Obsahuje uživatelem definované vlastnosti popisující prostředky webové služby. Vlastnosti jsou vyjádřeny jako páry klíč/hodnota.
commitmentPlan	CommitmentPlan	Obsahuje plán závazku přidružený k této webové službě. Nastaví se při vytváření. Po nastavení nelze tuto hodnotu změnit. Poznámka: Plán závazku se nevrtí z volání operací GET.
createdOn	string	Jen pro čtení: Datum a čas vytvoření webové služby.
description	string	Popis webové služby.
diagnostics	DiagnosticsConfiguration	Nastavení, které řídí shromažďování diagnostických trasování pro webovou službu.
exampleRequest	ExampleRequest	Definuje ukázková vstupní data pro jeden nebo více vstupů služby.
exposeSampleData	boolean	Pokud je nastavená hodnota true, ukázková data se zahrnou do definice swaggeru webové služby. Výchozí hodnotou je hodnota true.
input	ServiceInputOutputSpecification	Obsahuje schéma Swagger 2.0 popisující jeden nebo více vstupů webové služby. Další informace najdete ve specifikaci Swaggeru.
keys	WebServiceKeys	Obsahuje klíče zřizování webové služby. Pokud nezadáte zřizovací klíče, vygeneruje je za vás systém Azure Machine Learning. Poznámka: Klíče se nevrácejí z volání operací GET.
machineLearningWorkspace	MachineLearningWorkspace	Určuje pracovní prostor Machine Learning obsahující experiment, který je zdrojem pro webovou službu.
modifiedOn	string	Jen pro čtení: Datum a čas poslední změny webové služby.
output	ServiceInputOutputSpecification	Obsahuje schéma Swagger 2.0 popisující jeden nebo více výstupů webové služby. Další informace najdete ve specifikaci Swaggeru.
package	GraphPackage	Definice balíčku grafu, který tvoří tuto webovou službu.
packageType	string: Graph	Určuje typ balíčku. Platné hodnoty jsou Graph (Určuje webovou službu publikovanou prostřednictvím nástroje Machine Learning Studio) a Code (určuje webovou službu publikovanou pomocí kódu, jako je Python). Poznámka: Kód se v tuto chvíli nepodporuje.
parameters	object	Sada hodnot globálních parametrů definovaných pro webovou službu, zadaná jako globální název parametru výchozí mapování hodnot. Pokud není zadána žádná výchozí hodnota, parametr se považuje za povinný.
provisioningState	ProvisioningState	Jen pro čtení: Stav zřizování webové služby. Platné hodnoty jsou Neznámé, Zřizování, Úspěšné a Neúspěšné.
readOnly	boolean	Pokud je nastavená hodnota true, znamená to, že webová služba je jen pro čtení a už se nedá aktualizovat ani opravit, pouze odebrat. Výchozí hodnota je false. Poznámka: Jakmile je hodnota true nastavená, nemůžete změnit její hodnotu.
realtimeConfiguration	RealtimeConfiguration	Obsahuje nastavení konfigurace pro koncový bod webové služby.
storageAccount	StorageAccount	Určuje účet úložiště, který Azure Machine Learning používá k ukládání informací o webové službě. Z volání operací GET se vrátí jenom název účtu úložiště. Při aktualizaci informací o účtu úložiště musíte zajistit, aby v novém účtu úložiště byly k dispozici všechny potřebné prostředky, jinak volání webové služby selže.
swaggerLocation	string	Jen pro čtení: Obsahuje identifikátor URI specifikace Swagger přidružené k této webové službě.
title	string	Název webové služby.