Web Services - Create Or Update
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 |
---|---|---|---|---|
resource
|
path | True |
string |
Annak az erőforráscsoportnak a neve, amelyben a webszolgáltatás található. |
subscription
|
path | True |
string |
Az Azure-előfizetés azonosítója. |
web
|
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: |
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 |
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 |
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 |
---|---|
Asset |
A webszolgáltatáshoz társított eszköz adatai. |
Asset |
Egy webszolgáltatás-objektum hozzáférési helyét ismerteti. |
Asset |
Az eszköz típusa. |
Column |
További formátuminformációk az adattípushoz. |
Column |
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/ |
Column |
Az oszlop adattípusa. |
Commitment |
Információ a webszolgáltatáshoz társított gépi tanulási kötelezettségvállalási csomagról. |
Diagnostics |
Diagnosztikai beállítások egy Azure ML-webszolgáltatáshoz. |
Diagnostics |
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). |
Example |
Minta bemeneti adatok a szolgáltatás bemenete(i)hez. |
Graph |
A webszolgáltatás gráfján belül definiál egy élet. |
Graph |
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. |
Graph |
Meghatározza a gépi tanulási megoldást alkotó modulok grafikonját. |
Graph |
Globális paramétert határoz meg a gráfban. |
Graph |
Társítás hivatkozása egy gráf globális paraméteréhez egy csomóponthoz a gráfban. |
Input |
Eszköz bemeneti portja |
Input |
Portadatok típusa. |
Machine |
A webszolgáltatás forrását képező kísérletet tartalmazó gépi tanulási munkaterületre vonatkozó információk. |
Mode |
Beágyazott paraméterdefiníció. |
Module |
Modulegység paraméterdefiníciója. |
Output |
Eszköz kimeneti portja |
Output |
Portadatok típusa. |
Parameter |
A gráfparaméter típusa. |
Provisioning |
Csak olvasható: A webszolgáltatás kiépítési állapota. Az érvényes értékek: Ismeretlen, Kiépítés, Sikeres és Sikertelen. |
Realtime |
Az Azure ML webszolgáltatás-végpontjaihoz elérhető konfigurációs beállításokat tartalmazza. |
Service |
A szolgáltatás bemeneteit vagy kimeneteit leíró swagger 2.0-s séma. Lásd: Swagger specifikáció: http://swagger.io/specification/ |
Storage |
Tárfiók adatainak elérése. |
Table |
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/ |
Web |
Egy Azure ML-webszolgáltatás-erőforrás példánya. |
Web |
A webszolgáltatás hívásainak hozzáférési kulcsai. |
Web |
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,
Input |
Információ az eszköz bemeneti portjáról. |
locationInfo |
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,
Output |
Információ az eszköz kimeneti portjáról. |
parameters |
Ha az objektum egyéni modul, az tartalmazza a modul paramétereit. |
|
type |
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 |
További formátuminformációk az adattípushoz. |
|
type |
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 |
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 |
A gráfot alkotó élek listája. |
|
graphParameters |
<string,
Graph |
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,
Graph |
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 |
Társítás a paraméterhez a gráf csomópontjaihoz. |
|
type |
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 | 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 |
A paraméter definíciója. |
ModuleAssetParameter
Modulegység paraméterdefiníciója.
Name | Típus | Description |
---|---|---|
modeValuesInfo |
<string,
Mode |
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 | 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,
Table |
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,
Column |
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: |
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,
Asset |
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 |
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 |
A webszolgáltatás diagnosztikai nyomkövetési gyűjteményét vezérlő beállítások. |
|
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 |
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 |
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 |
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 |
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 |
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 |
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 |
A webszolgáltatás-végpont konfigurációs beállításait tartalmazza. |
|
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. |