Web Services - Create Or Update

Service:

ML Studio (classic)

API Version:

2016-05-01-preview

Webszolgáltatás létrehozása vagy frissítése. Ez a hívás felülír egy meglévő webszolgáltatást. Vegye figyelembe, hogy nincs figyelmeztetés vagy megerősítés. Ez egy nem helyreállítható művelet. Ha új webszolgáltatást szeretne létrehozni, először hívja meg a Lekérés műveletet annak ellenőrzéséhez, hogy nem létezik-e.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string	Annak az erőforráscsoportnak a neve, amelyben a webszolgáltatás található.
subscriptionId	path	True	string	Az Azure-előfizetés azonosítója.
webServiceName	path	True	string	A webszolgáltatás neve.
api-version	query	True	string	A Használni kívánt Microsoft.MachineLearning erőforrás-szolgáltató API verziója.

Kérelem törzse

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

Name	Kötelező	Típus	Description
location	True	string	Megadja az erőforrás helyét.
properties	True	WebServiceProperties: WebServicePropertiesForGraph	A webszolgáltatást leíró tulajdonság hasznos adatait tartalmazza.
name		string	Megadja az erőforrás nevét.
tags		object	Kulcs/érték párként definiált erőforráscímkéket tartalmaz.

Válaszok

Name	Típus	Description
200 OK	WebService	Sikeres művelet. Ez a válasz egy frissítési webszolgáltatás-művelet esetén jelenik meg. A válasz hasznos adatai megegyeznek a GET művelet által visszaadott válasz hasznos adataival. A válasz tartalmazza a kiépítési állapotot és a Azure-AsyncOperation fejlécet. A művelet előrehaladásának lekéréséhez hívja meg a GET műveletet az URL-címen Azure-AsyncOperation fejlécmezőben. Az aszinkron műveletekkel kapcsolatos további információkért lásd: https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"
201 Created	WebService	Létrehozott. Ez a válasz egy webszolgáltatás-létrehozási művelethez lesz visszaadva. A válasz tartalmazza a kiépítési állapotot és a Azure-AsyncOperation fejlécet. A művelet előrehaladásának lekéréséhez hívja meg a GET műveletet az URL-címen Azure-AsyncOperation fejlécmezőben. Az aszinkron műveletekkel kapcsolatos további információkért lásd: https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"

Definíciók

Name	Description
AssetItem	A webszolgáltatáshoz társított eszköz adatai.
AssetLocation	Egy webszolgáltatás-objektum hozzáférési helyét ismerteti.
AssetType	Az eszköz típusa.
ColumnFormat	További formátuminformációk az adattípushoz.
ColumnSpecification	Swagger 2.0-séma egy olyan oszlophoz az adattáblában, amely egy webszolgáltatás bemenetét vagy kimenetét jelöli. Lásd: Swagger specifikáció: http://swagger.io/specification/
ColumnType	Az oszlop adattípusa.
CommitmentPlan	Információ a webszolgáltatáshoz társított gépi tanulási kötelezettségvállalási csomagról.
DiagnosticsConfiguration	Diagnosztikai beállítások egy Azure ML-webszolgáltatáshoz.
DiagnosticsLevel	Meghatározza a diagnosztikai kimenet részletességét. Érvényes értékek: Nincs – letiltja a nyomkövetést; Hiba – csak hiba (stderr) nyomkövetéseket gyűjt; Mind – összegyűjti az összes nyomkövetést (stdout és stderr).
ExampleRequest	Minta bemeneti adatok a szolgáltatás bemenete(i)hez.
GraphEdge	A webszolgáltatás gráfján belül definiál egy élet.
GraphNode	Egy csomópontot határoz meg a webszolgáltatás-grafikonon. A csomópont lehet bemeneti, kimeneti vagy eszközcsomópont, így a rendszer egy adott időpontban csak a megfelelő azonosítótulajdonságok egyikét tölti ki.
GraphPackage	Meghatározza a gépi tanulási megoldást alkotó modulok grafikonját.
GraphParameter	Globális paramétert határoz meg a gráfban.
GraphParameterLink	Társítás hivatkozása egy gráf globális paraméteréhez egy csomóponthoz a gráfban.
InputPort	Eszköz bemeneti portja
InputPortType	Portadatok típusa.
MachineLearningWorkspace	A webszolgáltatás forrását képező kísérletet tartalmazó gépi tanulási munkaterületre vonatkozó információk.
ModeValueInfo	Beágyazott paraméterdefiníció.
ModuleAssetParameter	Modulegység paraméterdefiníciója.
OutputPort	Eszköz kimeneti portja
OutputPortType	Portadatok típusa.
ParameterType	A gráfparaméter típusa.
ProvisioningState	Csak olvasható: A webszolgáltatás kiépítési állapota. Az érvényes értékek: Ismeretlen, Kiépítés, Sikeres és Sikertelen.
RealtimeConfiguration	Az Azure ML webszolgáltatás-végpontjaihoz elérhető konfigurációs beállításokat tartalmazza.
ServiceInputOutputSpecification	A szolgáltatás bemeneteit vagy kimeneteit leíró swagger 2.0-s séma. Lásd: Swagger specifikáció: http://swagger.io/specification/
StorageAccount	Tárfiók adatainak elérése.
TableSpecification	A swagger 2.0 sémája, amely egyetlen szolgáltatás bemenetét vagy kimenetét írja le. Lásd: Swagger specifikáció: http://swagger.io/specification/
WebService	Egy Azure ML-webszolgáltatás-erőforrás példánya.
WebServiceKeys	A webszolgáltatás hívásainak hozzáférési kulcsai.
WebServicePropertiesForGraph	Graph-alapú webszolgáltatásra jellemző tulajdonságok.

AssetItem

A webszolgáltatáshoz társított eszköz adatai.

Name	Típus	Description
id	string	Az eszköz azonosítója.
inputPorts	<string,  InputPort>	Információ az eszköz bemeneti portjáról.
locationInfo	AssetLocation	Az eszköz hozzáférési információi.
metadata	object	Ha az objektum egyéni modul, az tartalmazza a modul metaadatait.
name	string	Az eszköz felhasználóbarát neve.
outputPorts	<string,  OutputPort>	Információ az eszköz kimeneti portjáról.
parameters	ModuleAssetParameter[]	Ha az objektum egyéni modul, az tartalmazza a modul paramétereit.
type	AssetType	Az eszköz típusa.

AssetLocation

Egy webszolgáltatás-objektum hozzáférési helyét ismerteti.

Name	Típus	Description
credentials	string	Hozzáférési hitelesítő adatok az objektumhoz, ha van (pl. tárfiók által megadott objektum kapcsolati karakterlánc + blob URI)
uri	string	Az URI, amelyből az eszköz elérhető (például aml://abc a rendszereszközökhöz vagy https://xyz a felhasználói eszközökhöz

AssetType

Az eszköz típusa.

Name	Típus	Description
Module	string
Resource	string

ColumnFormat

További formátuminformációk az adattípushoz.

Name	Típus	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

Swagger 2.0-séma egy olyan oszlophoz az adattáblában, amely egy webszolgáltatás bemenetét vagy kimenetét jelöli. Lásd: Swagger specifikáció: http://swagger.io/specification/

Name	Típus	Description
enum	object[]	Ha az adattípus kategorikus, ez az elfogadott kategóriák listáját tartalmazza.
format	ColumnFormat	További formátuminformációk az adattípushoz.
type	ColumnType	Az oszlop adattípusa.
x-ms-isnullable	boolean	Jelző, amely jelzi, hogy a típus támogatja-e a null értékeket.
x-ms-isordered	boolean	Jelző, amely azt jelzi, hogy a kategóriák rendezett készletként vannak-e kezelve, vagy sem, ha ez egy kategorikus oszlop.

ColumnType

Az oszlop adattípusa.

Name	Típus	Description
Boolean	string
Integer	string
Number	string
String	string

CommitmentPlan

Információ a webszolgáltatáshoz társított gépi tanulási kötelezettségvállalási csomagról.

Name	Típus	Description
id	string	A webszolgáltatáshoz társított kötelezettségvállalási csomag Azure Resource Manager-azonosítóját adja meg.

DiagnosticsConfiguration

Diagnosztikai beállítások egy Azure ML-webszolgáltatáshoz.

Name	Típus	Description
expiry	string	Megadja azt a dátumot és időpontot, amikor a naplózás megszűnik. Null érték esetén a diagnosztikai gyűjtemény nincs időkorlátban korlátozva.
level	DiagnosticsLevel	Meghatározza a diagnosztikai kimenet részletességét. Érvényes értékek: Nincs – letiltja a nyomkövetést; Hiba – csak hiba (stderr) nyomkövetéseket gyűjt; Mind – összegyűjti az összes nyomkövetést (stdout és stderr).

DiagnosticsLevel

Meghatározza a diagnosztikai kimenet részletességét. Érvényes értékek: Nincs – letiltja a nyomkövetést; Hiba – csak hiba (stderr) nyomkövetéseket gyűjt; Mind – összegyűjti az összes nyomkövetést (stdout és stderr).

Name	Típus	Description
All	string
Error	string
None	string

ExampleRequest

Minta bemeneti adatok a szolgáltatás bemenete(i)hez.

Name	Típus	Description
globalParameters	object	Minta bemeneti adatok a webszolgáltatás globális paramétereihez
inputs	object	Minta bemeneti adatok a webszolgáltatás bemenete(ke)hez bemeneti névként a minta bemeneti értékek mátrixtérképéhez.

GraphEdge

A webszolgáltatás gráfján belül definiál egy élet.

Name	Típus	Description
sourceNodeId	string	A forrásgráfcsomópont azonosítója.
sourcePortId	string	A forráscsomópont portjának azonosítója, amelyből az él csatlakozik.
targetNodeId	string	A célgráfcsomópont azonosítója.
targetPortId	string	A célcsomópont portjának azonosítója, amelyhez az él csatlakozik.

GraphNode

Egy csomópontot határoz meg a webszolgáltatás-grafikonon. A csomópont lehet bemeneti, kimeneti vagy eszközcsomópont, így a rendszer egy adott időpontban csak a megfelelő azonosítótulajdonságok egyikét tölti ki.

Name	Típus	Description
assetId	string	A csomópont által képviselt objektum azonosítója.
inputId	string	A csomópont által képviselt bemeneti elem azonosítója.
outputId	string	A csomópont által képviselt kimeneti elem azonosítója.
parameters	object	Adott esetben a csomópont paraméterei. A globális gráfparaméterek ezekbe vannak képezve, és az értékek futásidőben vannak beállítva.

GraphPackage

Meghatározza a gépi tanulási megoldást alkotó modulok grafikonját.

Name	Típus	Description
edges	GraphEdge[]	A gráfot alkotó élek listája.
graphParameters	<string,  GraphParameter>	A gráf globális paramétereinek gyűjteménye, amely a GraphParameter-térkép globális paraméterneveként van megadva. Minden paraméter 1:1-es egyezést tartalmaz a WebServiceProperties szinten deklarált globális paraméterek értéktérképével.
nodes	<string,  GraphNode>	A gráfot alkotó csomópontok halmaza, amely a GraphNode-térkép csomópontazonosítójaként van megadva

GraphParameter

Globális paramétert határoz meg a gráfban.

Name	Típus	Description
description	string	A gráfparaméter leírása.
links	GraphParameterLink[]	Társítás a paraméterhez a gráf csomópontjaihoz.
type	ParameterType	A gráfparaméter típusa.

GraphParameterLink

Társítás hivatkozása egy gráf globális paraméteréhez egy csomóponthoz a gráfban.

Name	Típus	Description
nodeId	string	A gráfcsomópont azonosítója
parameterKey	string	Annak a csomópontparaméternek az azonosítója, amelybe a globális paraméter leképezést ad.

InputPort

Eszköz bemeneti portja

Name	Típus	Alapértelmezett érték	Description
type	InputPortType	Dataset	Portadatok típusa.

InputPortType

Portadatok típusa.

Name	Típus	Description
Dataset	string

MachineLearningWorkspace

A webszolgáltatás forrását képező kísérletet tartalmazó gépi tanulási munkaterületre vonatkozó információk.

Name	Típus	Description
id	string	Megadja a webszolgáltatáshoz társított gépi tanulási munkaterület munkaterület-azonosítóját

ModeValueInfo

Beágyazott paraméterdefiníció.

Name	Típus	Description
interfaceString	string	A beágyazott paraméter felületi sztringneve.
parameters	ModuleAssetParameter[]	A paraméter definíciója.

ModuleAssetParameter

Modulegység paraméterdefiníciója.

Name	Típus	Description
modeValuesInfo	<string,  ModeValueInfo>	Beágyazott interfészparaméterek definíciói, ha ez egy összetett modulparaméter.
name	string	A paraméter neve.
parameterType	string	Paraméter típusa.

OutputPort

Eszköz kimeneti portja

Name	Típus	Alapértelmezett érték	Description
type	OutputPortType	Dataset	Portadatok típusa.

OutputPortType

Portadatok típusa.

Name	Típus	Description
Dataset	string

ParameterType

A gráfparaméter típusa.

Name	Típus	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

Csak olvasható: A webszolgáltatás kiépítési állapota. Az érvényes értékek: Ismeretlen, Kiépítés, Sikeres és Sikertelen.

Name	Típus	Description
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

Az Azure ML webszolgáltatás-végpontjaihoz elérhető konfigurációs beállításokat tartalmazza.

Name	Típus	Description
maxConcurrentCalls	integer	Megadja a webszolgáltatásba legfeljebb egyidejűleg indítható hívásokat. Minimális érték: 4, Maximális érték: 200.

ServiceInputOutputSpecification

A szolgáltatás bemeneteit vagy kimeneteit leíró swagger 2.0-s séma. Lásd: Swagger specifikáció: http://swagger.io/specification/

Name	Típus	Alapértelmezett érték	Description
description	string		A Swagger-séma leírása.
properties	<string,  TableSpecification>		Olyan gyűjteményt ad meg, amely a webszolgáltatás minden bemenetéhez vagy kimenetéhez tartalmazza az oszlopsémát. További információt a Swagger specifikációjában talál.
title	string		A Swagger-séma címe.
type	string	object	A swaggerben leírt entitás típusa. Mindig "objektum".

StorageAccount

Tárfiók adatainak elérése.

Name	Típus	Description
key	string	Megadja a tárfiók eléréséhez használt kulcsot.
name	string	Megadja a tárfiók nevét.

TableSpecification

A swagger 2.0 sémája, amely egyetlen szolgáltatás bemenetét vagy kimenetét írja le. Lásd: Swagger specifikáció: http://swagger.io/specification/

Name	Típus	Alapértelmezett érték	Description
description	string		Swagger-séma leírása.
format	string		A formátum, ha a "típus" nem "objektum"
properties	<string,  ColumnSpecification>		Az adattábla oszlopkészlete.
title	string		Swagger-séma címe.
type	string	object	A swaggerben leírt entitás típusa.

WebService

Egy Azure ML-webszolgáltatás-erőforrás példánya.

Name	Típus	Description
id	string	Megadja az erőforrás-azonosítót.
location	string	Megadja az erőforrás helyét.
name	string	Megadja az erőforrás nevét.
properties	WebServiceProperties: WebServicePropertiesForGraph	A webszolgáltatást leíró tulajdonság hasznos adatait tartalmazza.
tags	object	Kulcs/érték párként definiált erőforráscímkéket tartalmaz.
type	string	Az erőforrás típusát adja meg.

WebServiceKeys

A webszolgáltatás hívásainak hozzáférési kulcsai.

Name	Típus	Description
primary	string	Az elsődleges hozzáférési kulcs.
secondary	string	A másodlagos hozzáférési kulcs.

WebServicePropertiesForGraph

Graph-alapú webszolgáltatásra jellemző tulajdonságok.

Name	Típus	Description
assets	<string,  AssetItem>	A webszolgáltatás-objektumokat leíró, felhasználó által definiált tulajdonságokat tartalmazza. A tulajdonságok kulcs/érték párként vannak kifejezve.
commitmentPlan	CommitmentPlan	A webszolgáltatáshoz társított kötelezettségvállalási csomagot tartalmazza. Beállítás létrehozáskor. A beállítás után ez az érték nem módosítható. Megjegyzés: A kötelezettségvállalási csomag nem lesz visszaadva a GET-műveletek hívásaiból.
createdOn	string	Csak olvasható: A webszolgáltatás létrehozásának dátuma és időpontja.
description	string	A webszolgáltatás leírása.
diagnostics	DiagnosticsConfiguration	A webszolgáltatás diagnosztikai nyomkövetési gyűjteményét vezérlő beállítások.
exampleRequest	ExampleRequest	Minta bemeneti adatokat definiál a szolgáltatás egy vagy több bemenetéhez.
exposeSampleData	boolean	Ha igaz értékre van állítva, a mintaadatok a webszolgáltatás swagger definíciójában szerepelnek. Az alapértelmezett érték az igaz.
input	ServiceInputOutputSpecification	A Swagger 2.0 sémát tartalmazza, amely a webszolgáltatás egy vagy több bemenetét ismerteti. További információt a Swagger specifikációjában talál.
keys	WebServiceKeys	A webszolgáltatás kiépítési kulcsait tartalmazza. Ha nem ad meg kiépítési kulcsokat, az Azure Machine Learning-rendszer létrehozza őket. Megjegyzés: A rendszer nem adja vissza a kulcsokat a GET műveletek hívásaiból.
machineLearningWorkspace	MachineLearningWorkspace	Megadja a webszolgáltatás forrásának számító kísérletet tartalmazó Machine Learning-munkaterületet.
modifiedOn	string	Csak olvasható: A webszolgáltatás utolsó módosításának dátuma és időpontja.
output	ServiceInputOutputSpecification	A Swagger 2.0 sémát tartalmazza, amely a webszolgáltatás egy vagy több kimenetét ismerteti. További információt a Swagger specifikációjában talál.
package	GraphPackage	A webszolgáltatást alkotó gráfcsomag definíciója.
packageType	string: Graph	A csomag típusát adja meg. Az érvényes értékek a Graph (A Machine Learning Studióban közzétett webszolgáltatást adja meg) és a Code (A Pythonhoz hasonló kóddal közzétett webszolgáltatást adja meg). Megjegyzés: A kód jelenleg nem támogatott.
parameters	object	A webszolgáltatáshoz definiált globális paraméterértékek halmaza, amely globális paraméternévként az alapértelmezett értéktérképre van adva. Ha nincs megadva alapértelmezett érték, a paraméter kötelezőnek minősül.
provisioningState	ProvisioningState	Csak olvasható: A webszolgáltatás kiépítési állapota. Az érvényes értékek: Ismeretlen, Kiépítés, Sikeres és Sikertelen.
readOnly	boolean	Ha igaz értékre van állítva, azt jelzi, hogy a webszolgáltatás írásvédett, és a továbbiakban nem frissíthető vagy javítható, csak eltávolítható. Alapértelmezés szerint hamis. Megjegyzés: Ha igaz értékre van állítva, nem módosíthatja annak értékét.
realtimeConfiguration	RealtimeConfiguration	A webszolgáltatás-végpont konfigurációs beállításait tartalmazza.
storageAccount	StorageAccount	Megadja azt a tárfiókot, amelyet az Azure Machine Learning a webszolgáltatással kapcsolatos információk tárolására használ. A rendszer csak a tárfiók nevét adja vissza a GET-műveletek hívásaiból. A tárfiók adatainak frissítésekor gondoskodnia kell arról, hogy az összes szükséges adategység elérhető legyen az új tárfiókban, vagy a webszolgáltatás felé irányuló hívások sikertelenek lesznek.
swaggerLocation	string	Csak olvasható: A webszolgáltatáshoz társított swagger-specifikáció URI-ját tartalmazza.
title	string	A webszolgáltatás címe.