Web Services - Create Or Update

Service:

ML Studio (classic)

API-versie:

2016-05-01-preview

Een webservice maken of bijwerken. Met deze aanroep wordt een bestaande webservice overschreven. Houd er rekening mee dat er geen waarschuwing of bevestiging is. Dit is een niet-herstelbare bewerking. Als u een nieuwe webservice wilt maken, roept u eerst de get-bewerking aan om te controleren of deze niet bestaat.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string	Naam van de resourcegroep waarin de webservice zich bevindt.
subscriptionId	path	True	string	De Azure-abonnements-id.
webServiceName	path	True	string	De naam van de webservice.
api-version	query	True	string	De versie van de Microsoft.MachineLearning-resourceprovider-API die moet worden gebruikt.

Aanvraagbody

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

Name	Vereist	Type	Description
location	True	string	Hiermee geeft u de locatie van de resource.
properties	True	WebServiceProperties: WebServicePropertiesForGraph	Bevat de nettolading van de eigenschap die de webservice beschrijft.
name		string	Hiermee geeft u de naam van de resource.
tags		object	Bevat resourcetags die zijn gedefinieerd als sleutel-waardeparen.

Antwoorden

Name	Type	Description
200 OK	WebService	Voltooid. Dit antwoord wordt geretourneerd voor een update-webservicebewerking. De nettolading van het antwoord is identiek aan de nettolading van het antwoord dat wordt geretourneerd door de GET-bewerking. Het antwoord bevat de inrichtingsstatus en de header Azure-AsyncOperation. Als u de voortgang van de bewerking wilt ophalen, roept u get-bewerking aan op de URL in Azure-AsyncOperation veld koptekst. Zie voor meer informatie over asynchrone bewerkingen https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"
201 Created	WebService	Gemaakt. Dit antwoord wordt geretourneerd voor een bewerking voor het maken van een webservice. Het antwoord bevat de inrichtingsstatus en de header Azure-AsyncOperation. Als u de voortgang van de bewerking wilt ophalen, roept u get-bewerking aan op de URL in Azure-AsyncOperation veld koptekst. Zie voor meer informatie over asynchrone bewerkingen https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"

Definities

Name	Description
AssetItem	Informatie over een asset die is gekoppeld aan de webservice.
AssetLocation	Beschrijft de toegangslocatie voor een webserviceasset.
AssetType	Het type activum.
ColumnFormat	Aanvullende opmaakinformatie voor het gegevenstype.
ColumnSpecification	Swagger 2.0-schema voor een kolom in de gegevenstabel die een invoer of uitvoer van een webservice vertegenwoordigt. Zie Swagger-specificatie: http://swagger.io/specification/
ColumnType	Gegevenstype van de kolom.
CommitmentPlan	Informatie over het machine learning-toezeggingsplan dat is gekoppeld aan de webservice.
DiagnosticsConfiguration	Diagnostische instellingen voor een Azure ML-webservice.
DiagnosticsLevel	Hiermee geeft u de uitgebreidheid van de diagnostische uitvoer. Geldige waarden zijn: Geen - tracering wordt uitgeschakeld; Fout: verzamelt alleen fouttraceringen (stderr); Alle: verzamelt alle traceringen (stdout en stderr).
ExampleRequest	Voorbeeldinvoergegevens voor de invoer(en) van de service.
GraphEdge	Hiermee definieert u een rand in de grafiek van de webservice.
GraphNode	Hiermee geeft u een knooppunt in de webservicegrafiek op. Het knooppunt kan een invoer-, uitvoer- of assetknooppunt zijn, zodat slechts één van de bijbehorende id-eigenschappen op een bepaald moment wordt ingevuld.
GraphPackage	Definieert de grafiek van modules die de machine learning-oplossing vormen.
GraphParameter	Hiermee definieert u een globale parameter in de grafiek.
GraphParameterLink	Koppelingskoppeling voor een globale grafiekparameter naar een knooppunt in de grafiek.
InputPort	Assetinvoerpoort
InputPortType	Poortgegevenstype.
MachineLearningWorkspace	Informatie over de machine learning-werkruimte met het experiment dat de bron is voor de webservice.
ModeValueInfo	Geneste parameterdefinitie.
ModuleAssetParameter	Parameterdefinitie voor een moduleasset.
OutputPort	Uitvoerpoort van asset
OutputPortType	Poortgegevenstype.
ParameterType	Het type van de grafiekparameter.
ProvisioningState	Alleen-lezen: de inrichtingsstatus van de webservice. Geldige waarden zijn Onbekend, Inrichten, Geslaagd en Mislukt.
RealtimeConfiguration	Bevat de beschikbare configuratieopties voor een Azure ML-webservice-eindpunt.
ServiceInputOutputSpecification	Het swagger 2.0-schema waarin de invoer of uitvoer van de service wordt beschreven. Zie Swagger-specificatie: http://swagger.io/specification/
StorageAccount	Toegang tot informatie voor een opslagaccount.
TableSpecification	Het swagger 2.0-schema waarin één service-invoer of -uitvoer wordt beschreven. Zie Swagger-specificatie: http://swagger.io/specification/
WebService	Exemplaar van een Azure ML-webserviceresource.
WebServiceKeys	Toegangssleutels voor de webservice-aanroepen.
WebServicePropertiesForGraph	Eigenschappen die specifiek zijn voor een Op Graph gebaseerde webservice.

AssetItem

Informatie over een asset die is gekoppeld aan de webservice.

Name	Type	Description
id	string	Id van asset.
inputPorts	<string,  InputPort>	Informatie over de invoerpoorten van de asset.
locationInfo	AssetLocation	Toegang tot informatie voor de asset.
metadata	object	Als de asset een aangepaste module is, bevat deze de metagegevens van de module.
name	string	De beschrijvende naam van het activum.
outputPorts	<string,  OutputPort>	Informatie over de uitvoerpoorten van de asset.
parameters	ModuleAssetParameter[]	Als de asset een aangepaste module is, bevat deze de parameters van de module.
type	AssetType	Het type activum.

AssetLocation

Beschrijft de toegangslocatie voor een webserviceasset.

Name	Type	Description
credentials	string	Toegangsreferenties voor de asset, indien van toepassing (bijvoorbeeld asset opgegeven door opslagaccount verbindingsreeks + blob-URI)
uri	string	De URI van waaruit de asset toegankelijk is (bijvoorbeeld aml://abc voor systeemassets of https://xyz voor gebruikersassets

AssetType

Het type activum.

Name	Type	Description
Module	string
Resource	string

ColumnFormat

Aanvullende opmaakinformatie voor het gegevenstype.

Name	Type	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-schema voor een kolom in de gegevenstabel die een invoer of uitvoer van een webservice vertegenwoordigt. Zie Swagger-specificatie: http://swagger.io/specification/

Name	Type	Description
enum	object[]	Als het gegevenstype categorisch is, wordt de lijst met geaccepteerde categorieën weergegeven.
format	ColumnFormat	Aanvullende opmaakinformatie voor het gegevenstype.
type	ColumnType	Gegevenstype van de kolom.
x-ms-isnullable	boolean	Vlag die aangeeft of het type null-waarden ondersteunt of niet.
x-ms-isordered	boolean	Vlag die aangeeft of de categorieën worden behandeld als een geordende set of niet, als dit een categorische kolom is.

ColumnType

Gegevenstype van de kolom.

Name	Type	Description
Boolean	string
Integer	string
Number	string
String	string

CommitmentPlan

Informatie over het machine learning-toezeggingsplan dat is gekoppeld aan de webservice.

Name	Type	Description
id	string	Hiermee geeft u de Azure Resource Manager-id op van het toezeggingsplan dat is gekoppeld aan de webservice.

DiagnosticsConfiguration

Diagnostische instellingen voor een Azure ML-webservice.

Name	Type	Description
expiry	string	Hiermee geeft u de datum en tijd op waarop de logboekregistratie wordt beëindigd. Als dit null is, is het verzamelen van diagnostische gegevens niet beperkt tot de tijd.
level	DiagnosticsLevel	Hiermee geeft u de uitgebreidheid van de diagnostische uitvoer. Geldige waarden zijn: Geen - tracering wordt uitgeschakeld; Fout: verzamelt alleen fouttraceringen (stderr); Alle: verzamelt alle traceringen (stdout en stderr).

DiagnosticsLevel

Hiermee geeft u de uitgebreidheid van de diagnostische uitvoer. Geldige waarden zijn: Geen - tracering wordt uitgeschakeld; Fout: verzamelt alleen fouttraceringen (stderr); Alle: verzamelt alle traceringen (stdout en stderr).

Name	Type	Description
All	string
Error	string
None	string

ExampleRequest

Voorbeeldinvoergegevens voor de invoer(en) van de service.

Name	Type	Description
globalParameters	object	Voorbeeldinvoergegevens voor de globale parameters van de webservice
inputs	object	Voorbeeldinvoergegevens voor de invoer(en) van de webservice die zijn opgegeven als invoernaam voor voorbeeldinvoerwaardenmatrixtoewijzing.

GraphEdge

Hiermee definieert u een rand in de grafiek van de webservice.

Name	Type	Description
sourceNodeId	string	De id van het brongrafiekknooppunt.
sourcePortId	string	De id van de poort van het bronknooppunt waarmee de edge verbinding maakt.
targetNodeId	string	De id van het doelgrafiekknooppunt.
targetPortId	string	De id van de poort van het doelknooppunt waarmee de edge verbinding maakt.

GraphNode

Hiermee geeft u een knooppunt in de webservicegrafiek op. Het knooppunt kan een invoer-, uitvoer- of assetknooppunt zijn, zodat slechts één van de bijbehorende id-eigenschappen op een bepaald moment wordt ingevuld.

Name	Type	Description
assetId	string	De id van de asset die wordt vertegenwoordigd door dit knooppunt.
inputId	string	De id van het invoerelement dat wordt vertegenwoordigd door dit knooppunt.
outputId	string	De id van het uitvoerelement dat wordt vertegenwoordigd door dit knooppunt.
parameters	object	Indien van toepassing, parameters van het knooppunt. Globale grafiekparameters worden hierin toegewezen, met waarden die tijdens runtime zijn ingesteld.

GraphPackage

Definieert de grafiek van modules die de machine learning-oplossing vormen.

Name	Type	Description
edges	GraphEdge[]	De lijst met randen die de grafiek vormen.
graphParameters	<string,  GraphParameter>	De verzameling globale parameters voor de grafiek, gegeven als een globale parameternaam voor graphParameter-kaart. Elke parameter hier heeft een 1:1-overeenkomst met de toewijzing van globale parameterswaarden die zijn gedeclareerd op het niveau WebServiceEigenschappen.
nodes	<string,  GraphNode>	De set knooppunten die de grafiek vormen, die als nodeId aan GraphNode-toewijzing is opgegeven

GraphParameter

Hiermee definieert u een globale parameter in de grafiek.

Name	Type	Description
description	string	Beschrijving van deze grafiekparameter.
links	GraphParameterLink[]	Koppelingen voor deze parameter naar knooppunten in de grafiek.
type	ParameterType	Het type van de grafiekparameter.

GraphParameterLink

Koppelingskoppeling voor een globale grafiekparameter naar een knooppunt in de grafiek.

Name	Type	Description
nodeId	string	De id van het grafiekknooppunt
parameterKey	string	De id van de knooppuntparameter waaraan de globale parameter is toegewezen.

InputPort

Assetinvoerpoort

Name	Type	Default value	Description
type	InputPortType	Dataset	Poortgegevenstype.

InputPortType

Poortgegevenstype.

Name	Type	Description
Dataset	string

MachineLearningWorkspace

Informatie over de machine learning-werkruimte met het experiment dat de bron is voor de webservice.

Name	Type	Description
id	string	Hiermee geeft u de werkruimte-id op van de machine learning-werkruimte die is gekoppeld aan de webservice

ModeValueInfo

Geneste parameterdefinitie.

Name	Type	Description
interfaceString	string	De naam van de interfacetekenreeks voor de geneste parameter.
parameters	ModuleAssetParameter[]	De definitie van de parameter.

ModuleAssetParameter

Parameterdefinitie voor een moduleasset.

Name	Type	Description
modeValuesInfo	<string,  ModeValueInfo>	Definities voor geneste interfaceparameters als dit een complexe moduleparameter is.
name	string	Parameternaam.
parameterType	string	Parametertype.

OutputPort

Uitvoerpoort van asset

Name	Type	Default value	Description
type	OutputPortType	Dataset	Poortgegevenstype.

OutputPortType

Poortgegevenstype.

Name	Type	Description
Dataset	string

ParameterType

Het type van de grafiekparameter.

Name	Type	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

Alleen-lezen: de inrichtingsstatus van de webservice. Geldige waarden zijn Onbekend, Inrichten, Geslaagd en Mislukt.

Name	Type	Description
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

Bevat de beschikbare configuratieopties voor een Azure ML-webservice-eindpunt.

Name	Type	Description
maxConcurrentCalls	integer	Hiermee geeft u het maximum aantal gelijktijdige aanroepen op dat naar de webservice kan worden uitgevoerd. Minimumwaarde: 4, Maximumwaarde: 200.

ServiceInputOutputSpecification

Het swagger 2.0-schema waarin de invoer of uitvoer van de service wordt beschreven. Zie Swagger-specificatie: http://swagger.io/specification/

Name	Type	Default value	Description
description	string		De beschrijving van het Swagger-schema.
properties	<string,  TableSpecification>		Hiermee geeft u een verzameling op die het kolomschema bevat voor elke invoer of uitvoer van de webservice. Zie de Swagger-specificatie voor meer informatie.
title	string		De titel van uw Swagger-schema.
type	string	object	Het type entiteit dat wordt beschreven in swagger. Altijd 'object'.

StorageAccount

Toegang tot informatie voor een opslagaccount.

Name	Type	Description
key	string	Hiermee geeft u de sleutel op die wordt gebruikt voor toegang tot het opslagaccount.
name	string	Hiermee geeft u de naam van het opslagaccount op.

TableSpecification

Het swagger 2.0-schema waarin één service-invoer of -uitvoer wordt beschreven. Zie Swagger-specificatie: http://swagger.io/specification/

Name	Type	Default value	Description
description	string		Beschrijving van het Swagger-schema.
format	string		De notatie, als 'type' niet 'object' is
properties	<string,  ColumnSpecification>		De set kolommen in de gegevenstabel.
title	string		Swagger-schematitel.
type	string	object	Het type entiteit dat wordt beschreven in swagger.

WebService

Exemplaar van een Azure ML-webserviceresource.

Name	Type	Description
id	string	Hiermee geeft u de resource-id op.
location	string	Hiermee geeft u de locatie van de resource.
name	string	Hiermee geeft u de naam van de resource.
properties	WebServiceProperties: WebServicePropertiesForGraph	Bevat de nettolading van de eigenschap die de webservice beschrijft.
tags	object	Bevat resourcetags die zijn gedefinieerd als sleutel-waardeparen.
type	string	Hiermee geeft u het type van de resource op.

WebServiceKeys

Toegangssleutels voor de webservice-aanroepen.

Name	Type	Description
primary	string	De primaire toegangssleutel.
secondary	string	De secundaire toegangssleutel.

WebServicePropertiesForGraph

Eigenschappen die specifiek zijn voor een Op Graph gebaseerde webservice.

Name	Type	Description
assets	<string,  AssetItem>	Bevat door de gebruiker gedefinieerde eigenschappen die webserviceassets beschrijven. Eigenschappen worden uitgedrukt als sleutel/waardeparen.
commitmentPlan	CommitmentPlan	Bevat het toezeggingsplan dat is gekoppeld aan deze webservice. Ingesteld op het moment van maken. Nadat deze is ingesteld, kan deze waarde niet meer worden gewijzigd. Opmerking: het toezeggingsplan wordt niet geretourneerd vanuit aanroepen naar GET-bewerkingen.
createdOn	string	Alleen-lezen: de datum en tijd waarop de webservice is gemaakt.
description	string	De beschrijving van de webservice.
diagnostics	DiagnosticsConfiguration	Instellingen die de verzameling diagnostische traceringen voor de webservice beheren.
exampleRequest	ExampleRequest	Definieert voorbeeldinvoergegevens voor een of meer van de invoer van de service.
exposeSampleData	boolean	Als deze optie is ingesteld op true, worden voorbeeldgegevens opgenomen in de swagger-definitie van de webservice. De standaardwaarde is waar.
input	ServiceInputOutputSpecification	Bevat het Swagger 2.0-schema dat een of meer invoergegevens van de webservice beschrijft. Zie de Swagger-specificatie voor meer informatie.
keys	WebServiceKeys	Bevat de inrichtingssleutels van de webservice. Als u geen inrichtingssleutels opgeeft, worden deze door het Azure Machine Learning-systeem voor u gegenereerd. Opmerking: de sleutels worden niet geretourneerd door aanroepen naar GET-bewerkingen.
machineLearningWorkspace	MachineLearningWorkspace	Hiermee geeft u de Machine Learning-werkruimte op met het experiment dat de bron is voor de webservice.
modifiedOn	string	Alleen-lezen: de datum en tijd waarop de webservice voor het laatst is gewijzigd.
output	ServiceInputOutputSpecification	Bevat het Swagger 2.0-schema dat een of meer van de uitvoer van de webservice beschrijft. Zie de Swagger-specificatie voor meer informatie.
package	GraphPackage	De definitie van het grafiekpakket dat deel van deze webservice maakt.
packageType	string: Graph	Hiermee geeft u het pakkettype op. Geldige waarden zijn Graph (hiermee geeft u een webservice op die is gepubliceerd via Machine Learning Studio) en Code (hiermee geeft u een webservice op die is gepubliceerd met behulp van code zoals Python). Opmerking: code wordt momenteel niet ondersteund.
parameters	object	De set globale parameters die zijn gedefinieerd voor de webservice, gegeven als een globale parameternaam aan de standaardwaardetoewijzing. Als er geen standaardwaarde is opgegeven, wordt de parameter als vereist beschouwd.
provisioningState	ProvisioningState	Alleen-lezen: de inrichtingsstatus van de webservice. Geldige waarden zijn Onbekend, Inrichten, Geslaagd en Mislukt.
readOnly	boolean	Als deze optie is ingesteld op waar, geeft dit aan dat de webservice alleen-lezen is en niet meer kan worden bijgewerkt of gepatcht, maar alleen kan worden verwijderd. De standaardwaarde is onwaar. Opmerking: als deze is ingesteld op waar, kunt u de waarde ervan niet meer wijzigen.
realtimeConfiguration	RealtimeConfiguration	Bevat de configuratie-instellingen voor het eindpunt van de webservice.
storageAccount	StorageAccount	Hiermee geeft u het opslagaccount op dat Azure Machine Learning gebruikt om informatie over de webservice op te slaan. Alleen de naam van het opslagaccount wordt geretourneerd vanuit aanroepen naar GET-bewerkingen. Wanneer u de gegevens van het opslagaccount bijwerkt, moet u ervoor zorgen dat alle benodigde assets beschikbaar zijn in het nieuwe opslagaccount of dat aanroepen naar uw webservice mislukken.
swaggerLocation	string	Alleen-lezen: bevat de URI van de swagger-specificatie die is gekoppeld aan deze webservice.
title	string	De titel van de webservice.