Web Services - Create Or Update

Szolgáltatás:

ML Studio (classic)

API-verzió:

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 a szándéka egy új webszolgáltatás létrehozása, először hívja meg a Get 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ói 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	Siker. A rendszer ezt a választ adja vissza egy frissítési webszolgáltatás-művelethez. 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	Információ a webszolgáltatáshoz társított objektumról.
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 a Swagger specifikációját: http://swagger.io/specification/
ColumnType	Az oszlop adattípusa.
CommitmentPlan	Információk a webszolgáltatáshoz társított gépi tanulási kötelezettségvállalási tervről.
DiagnosticsConfiguration	Diagnosztikai beállítások egy Azure ML-webszolgáltatáshoz.
DiagnosticsLevel	A diagnosztikai kimenet részletességét adja meg. Érvényes értékek: Nincs – letiltja a nyomkövetést; Hiba – csak hiba (stderr) nyomkövetéseket gyűjt; Minden - összegyűjti az összes nyomkövetést (stdout és stderr).
ExampleRequest	Minta bemeneti adatok a szolgáltatás bemenete(i)hez.
GraphEdge	Meghatározza a webszolgáltatás gráfján belüli éleket.
GraphNode	Egy csomópontot határoz meg a webszolgáltatás-gráfban. A csomópont lehet bemeneti, kimeneti vagy eszközcsomópont is, így a megfelelő azonosítótulajdonságok közül csak egy tölthető fel egy adott időpontban.
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	Modulobjektum 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 ismeretlenek, kiépítések, sikeresek és sikertelenek.
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éma. Lásd a Swagger specifikációját: http://swagger.io/specification/
StorageAccount	Tárfiók hozzáférési adatai.
TableSpecification	A swagger 2.0 séma, amely egyetlen szolgáltatás bemenetét vagy kimenetét írja le. Lásd a Swagger specifikációját: http://swagger.io/specification/
WebService	Azure ML webszolgáltatás-erőforrás példánya.
WebServiceKeys	Hozzáférési kulcsok a webszolgáltatás-hívásokhoz.
WebServicePropertiesForGraph	Graph-alapú webszolgáltatásra jellemző tulajdonságok.

AssetItem

Objektum

Információ a webszolgáltatáshoz társított objektumról.

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

AssetLocation

Objektum

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 kapcsolati sztringje + blob URI által megadott objektum)
uri	string (url)	Az URI, amelyből az eszköz elérhető (például a rendszereszközök aml://abc vagy a felhasználói eszközök https://xyz

AssetType

Enumerálás

Az eszköz típusa.

Érték	Description
Module
Resource

ColumnFormat

Enumerálás

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

Érték	Description
Byte
Char
Complex64
Complex128
Date-time
Date-timeOffset
Double
Duration
Float
Int8
Int16
Int32
Int64
Uint8
Uint16
Uint32
Uint64

ColumnSpecification

Objektum

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 a Swagger specifikációját: 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	Jelölő, amely jelzi, hogy a kategóriák rendezett készletként vannak-e kezelve, vagy sem, ha ez egy kategorikus oszlop.

ColumnType

Enumerálás

Az oszlop adattípusa.

Érték	Description
Boolean
Integer
Number
String

CommitmentPlan

Objektum

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

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

DiagnosticsConfiguration

Objektum

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

Name	Típus	Description
expiry	string (date-time)	Megadja a naplózás leállításának dátumát és időpontját. Null érték esetén a diagnosztikai gyűjtemény nincs időkorlátban.
level	DiagnosticsLevel	A diagnosztikai kimenet részletességét adja meg. Érvényes értékek: Nincs – letiltja a nyomkövetést; Hiba – csak hiba (stderr) nyomkövetéseket gyűjt; Minden - összegyűjti az összes nyomkövetést (stdout és stderr).

DiagnosticsLevel

Enumerálás

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

Érték	Description
None
Error
All

ExampleRequest

Objektum

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 bemeneti neveként megadott bemeneti adatokhoz a minta bemeneti értékek mátrixtérképéhez.

GraphEdge

Objektum

Meghatározza a webszolgáltatás gráfján belüli éleket.

Name	Típus	Description
sourceNodeId	string	A forrásdiagram-csomó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

Objektum

Egy csomópontot határoz meg a webszolgáltatás-gráfban. A csomópont lehet bemeneti, kimeneti vagy eszközcsomópont is, így a megfelelő azonosítótulajdonságok közül csak egy tölthető fel egy adott időpontban.

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	Ha lehetséges, a csomópont paraméterei. A globális gráfparaméterek ezekbe vannak képezve, futásidőben beállított értékekkel.

GraphPackage

Objektum

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 globális paraméternévként van megadva a GraphParameter-térképhez. Minden paraméter 1:1-es egyezéssel rendelkezik a WebServiceProperties szintjén deklarált globális paraméterek értéktérképével.
nodes	<string,  GraphNode>	A gráfot alkotó csomópontok készlete, amely a GraphNode-térkép csomópontazonosítójaként van megadva

GraphParameter

Objektum

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[]	A paraméter társítása a gráf csomópontjaihoz.
type	ParameterType	A gráfparaméter típusa.

GraphParameterLink

Objektum

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

Objektum

Eszköz bemeneti portja

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

InputPortType

Enumerálás

Portadatok típusa.

Érték	Description
Dataset

MachineLearningWorkspace

Objektum

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

Objektum

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

Objektum

Modulobjektum 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	Paraméter neve.
parameterType	string	Paraméter típusa.

OutputPort

Objektum

Eszköz kimeneti portja

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

OutputPortType

Enumerálás

Portadatok típusa.

Érték	Description
Dataset

ParameterType

Enumerálás

A gráfparaméter típusa.

Érték	Description
String
Int
Float
Enumerated
Script
Mode
Credential
Boolean
Double
ColumnPicker
ParameterRange
DataGatewayName

ProvisioningState

Enumerálás

Csak olvasható: A webszolgáltatás kiépítési állapota. Az érvényes értékek ismeretlenek, kiépítések, sikeresek és sikertelenek.

Érték	Description
Unknown
Provisioning
Succeeded
Failed

RealtimeConfiguration

Objektum

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

Name	Típus	Description
maxConcurrentCalls	integer minimum: 4 maximum: 200	Megadja a webszolgáltatásba indítható egyidejű hívások maximális száma. Minimális érték: 4, Maximális érték: 200.

ServiceInputOutputSpecification

Objektum

A szolgáltatás bemeneteit vagy kimeneteit leíró Swagger 2.0-séma. Lásd a Swagger specifikációját: 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

Objektum

Tárfiók hozzáférési adatai.

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

Objektum

A swagger 2.0 séma, amely egyetlen szolgáltatás bemenetét vagy kimenetét írja le. Lásd a Swagger specifikációját: 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

Objektum

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	Megadja az erőforrás típusát.

WebServiceKeys

Objektum

Hozzáférési kulcsok a webszolgáltatás-hívásokhoz.

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

Objektum

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 tervet 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 lekötési tervet a get műveletek hívásai nem adják vissza.
createdOn	string (date-time)	Írásvédett: 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 határoz meg 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 igaz.
input	ServiceInputOutputSpecification	A webszolgáltatás egy vagy több bemenetét leíró Swagger 2.0-sémát tartalmazza. 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 (date-time)	Csak olvasható: A webszolgáltatás utolsó módosításának dátuma és időpontja.
output	ServiceInputOutputSpecification	A webszolgáltatás egy vagy több kimenetét leíró Swagger 2.0-sémát tartalmazza. 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	Megadja a csomag típusát. Az érvényes értékek a Graph (A Machine Learning Studióban közzétett webszolgáltatást adja meg) és a Code (a Kód használatával közzétett webszolgáltatást adja meg, például a Pythont). 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 van megadva az alapértelmezett értéktérképhez. 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 ismeretlenek, kiépítések, sikeresek és sikertelenek.
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 az é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 eszköz elérhető legyen az új tárfiókban, vagy a webszolgáltatás hívásai 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.