Web Services - Create Or Update

Service:

ML Studio (classic)

Version d'API:

2016-05-01-preview

Créer ou mettre à jour un service web. Cet appel remplacera un service web existant. Notez qu’il n’y a aucun avertissement ou confirmation. Il s’agit d’une opération non récupérable. Si votre intention est de créer un service web, appelez d’abord l’opération Get pour vérifier qu’il n’existe pas.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources dans lequel se trouve le service web.
subscriptionId	path	True	string	L’ID d’abonnement Azure.
webServiceName	path	True	string	Nom du service web.
api-version	query	True	string	Version de l’API du fournisseur de ressources Microsoft.MachineLearning à utiliser.

Corps de la demande

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

Nom	Obligatoire	Type	Description
location	True	string	Spécifie l’emplacement de la ressource.
properties	True	WebServiceProperties: WebServicePropertiesForGraph	Contient la charge utile de propriété qui décrit le service web.
name		string	Spécifie le nom de la ressource.
tags		object	Contient des étiquettes de ressources définies en tant que paires clé/valeur.

Réponses

Nom	Type	Description
200 OK	WebService	Réussite. Cette réponse est retournée pour une opération de mise à jour du service web. La charge utile de réponse est identique à la charge utile de réponse retournée par l’opération GET. La réponse inclut l’état d’approvisionnement et l’en-tête Azure-AsyncOperation. Pour obtenir la progression de l’opération, appelez l’opération GET sur l’URL dans Azure-AsyncOperation champ d’en-tête. Pour plus d’informations sur les opérations asynchrones, consultez https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"
201 Created	WebService	Créé. Cette réponse est retournée pour une opération de création de service web. La réponse inclut l’état d’approvisionnement et l’en-tête Azure-AsyncOperation. Pour obtenir la progression de l’opération, appelez l’opération GET sur l’URL dans Azure-AsyncOperation champ d’en-tête. Pour plus d’informations sur les opérations asynchrones, consultez https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"

Définitions

Nom	Description
AssetItem	Informations sur une ressource associée au service web.
AssetLocation	Décrit l’emplacement d’accès d’une ressource de service web.
AssetType	Type de la ressource.
ColumnFormat	Informations de format supplémentaires pour le type de données.
ColumnSpecification	Schéma Swagger 2.0 pour une colonne dans la table de données représentant une entrée ou une sortie de service web. Consultez spécification Swagger : http://swagger.io/specification/
ColumnType	Type de données de la colonne.
CommitmentPlan	Informations sur le plan d’engagement Machine Learning associé au service web.
DiagnosticsConfiguration	Paramètres de diagnostic pour un service web Azure ML.
DiagnosticsLevel	Spécifie le détail de la sortie de diagnostic. Les valeurs valides sont les suivantes : Aucun - désactive le suivi ; Erreur : collecte uniquement les traces d’erreur (stderr) ; All : collecte toutes les traces (stdout et stderr).
ExampleRequest	Exemples de données d’entrée pour les entrées du service.
GraphEdge	Définit une arête dans le graphe du service web.
GraphNode	Spécifie un nœud dans le graphique de service web. Le nœud peut être un nœud d’entrée, de sortie ou de ressource, de sorte qu’une seule des propriétés d’ID correspondantes est renseignée à un moment donné.
GraphPackage	Définit le graphique des modules qui composent la solution Machine Learning.
GraphParameter	Définit un paramètre global dans le graphique.
GraphParameterLink	Lien d’association d’un paramètre global de graphe à un nœud dans le graphe.
InputPort	Port d’entrée de ressource
InputPortType	Type de données de port.
MachineLearningWorkspace	Informations sur l’espace de travail Machine Learning contenant l’expérience source pour le service web.
ModeValueInfo	Définition de paramètre imbriqué.
ModuleAssetParameter	Définition de paramètre pour une ressource de module.
OutputPort	Port de sortie de l’élément multimédia
OutputPortType	Type de données de port.
ParameterType	Type du paramètre Graph.
ProvisioningState	Lecture seule : état de provisionnement du service web. Les valeurs valides sont Unknown, Provisioning, Succeeded et Failed.
RealtimeConfiguration	Contient les options de configuration disponibles pour un point de terminaison de service web Azure ML.
ServiceInputOutputSpecification	Schéma swagger 2.0 décrivant les entrées ou sorties du service. Consultez spécification Swagger : http://swagger.io/specification/
StorageAccount	Accéder aux informations d’un compte de stockage.
TableSpecification	Schéma swagger 2.0 décrivant une entrée ou une sortie de service unique. Consultez spécification Swagger : http://swagger.io/specification/
WebService	Instance d’une ressource de service web Azure ML.
WebServiceKeys	Clés d’accès pour les appels de service web.
WebServicePropertiesForGraph	Propriétés spécifiques à un service web basé sur Graph.

AssetItem

Informations sur une ressource associée au service web.

Nom	Type	Description
id	string	ID de la ressource.
inputPorts	<string,  InputPort>	Informations sur les ports d’entrée de la ressource.
locationInfo	AssetLocation	Accéder aux informations pour la ressource.
metadata	object	Si la ressource est un module personnalisé, celle-ci contient les métadonnées du module.
name	string	Nom convivial de la ressource.
outputPorts	<string,  OutputPort>	Informations sur les ports de sortie de la ressource.
parameters	ModuleAssetParameter[]	Si la ressource est un module personnalisé, cela contient les paramètres du module.
type	AssetType	Type de ressource.

AssetLocation

Décrit l’emplacement d’accès d’une ressource de service web.

Nom	Type	Description
credentials	string	Informations d’identification d’accès pour la ressource, le cas échéant (par exemple, ressource spécifiée par le compte de stockage chaîne de connexion + URI d’objet blob)
uri	string	URI à partir duquel la ressource est accessible (par exemple, aml://abc pour les ressources système ou https://xyz pour les ressources utilisateur

AssetType

Type de la ressource.

Nom	Type	Description
Module	string
Resource	string

ColumnFormat

Informations de format supplémentaires pour le type de données.

Nom	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

Schéma Swagger 2.0 pour une colonne dans la table de données représentant une entrée ou une sortie de service web. Consultez spécification Swagger : http://swagger.io/specification/

Nom	Type	Description
enum	object[]	Si le type de données est catégorique, cela fournit la liste des catégories acceptées.
format	ColumnFormat	Informations de format supplémentaires pour le type de données.
type	ColumnType	Type de données de la colonne.
x-ms-isnullable	boolean	Indicateur indiquant si le type prend en charge les valeurs Null ou non.
x-ms-isordered	boolean	Indicateur indiquant si les catégories sont traitées comme un ensemble ordonné ou non, s’il s’agit d’une colonne catégorielle.

ColumnType

Type de données de la colonne.

Nom	Type	Description
Boolean	string
Integer	string
Number	string
String	string

CommitmentPlan

Informations sur le plan d’engagement Machine Learning associé au service web.

Nom	Type	Description
id	string	Spécifie l’ID de Resource Manager Azure du plan d’engagement associé au service web.

DiagnosticsConfiguration

Paramètres de diagnostic pour un service web Azure ML.

Nom	Type	Description
expiry	string	Spécifie la date et l’heure de fin de la journalisation. Si la valeur est null, la collecte de diagnostics n’est pas limitée dans le temps.
level	DiagnosticsLevel	Spécifie le détail de la sortie de diagnostic. Les valeurs valides sont les suivantes : Aucun - désactive le suivi ; Erreur : collecte uniquement les traces d’erreur (stderr) ; All : collecte toutes les traces (stdout et stderr).

DiagnosticsLevel

Spécifie le détail de la sortie de diagnostic. Les valeurs valides sont les suivantes : Aucun - désactive le suivi ; Erreur : collecte uniquement les traces d’erreur (stderr) ; All : collecte toutes les traces (stdout et stderr).

Nom	Type	Description
All	string
Error	string
None	string

ExampleRequest

Exemples de données d’entrée pour les entrées du service.

Nom	Type	Description
globalParameters	object	Exemples de données d’entrée pour les paramètres globaux du service web
inputs	object	Exemples de données d’entrée pour les entrées du service web fournies en tant que nom d’entrée pour échantillonner la carte matricielle des valeurs d’entrée.

GraphEdge

Définit une arête dans le graphe du service web.

Nom	Type	Description
sourceNodeId	string	Identificateur du nœud du graphe source.
sourcePortId	string	Identificateur du port du nœud source à partir duquel l’arête se connecte.
targetNodeId	string	Identificateur du nœud du graphe de destination.
targetPortId	string	Identificateur du port du nœud de destination auquel l’arête se connecte.

GraphNode

Spécifie un nœud dans le graphique de service web. Le nœud peut être un nœud d’entrée, de sortie ou de ressource, de sorte qu’une seule des propriétés d’ID correspondantes est renseignée à un moment donné.

Nom	Type	Description
assetId	string	ID de la ressource représentée par ce nœud.
inputId	string	ID de l’élément d’entrée représenté par ce nœud.
outputId	string	ID de l’élément de sortie représenté par ce nœud.
parameters	object	Le cas échéant, les paramètres du nœud. Les paramètres de graphe globaux sont mappés dans ceux-ci, avec des valeurs définies au moment de l’exécution.

GraphPackage

Définit le graphique des modules qui composent la solution Machine Learning.

Nom	Type	Description
edges	GraphEdge[]	Liste des arêtes qui composent le graphe.
graphParameters	<string,  GraphParameter>	Collection de paramètres globaux pour le graphe, donné sous la forme d’un nom de paramètre global à la carte GraphParameter. Chaque paramètre a ici une correspondance 1 :1 avec les valeurs de paramètres globaux déclarées au niveau de WebServiceProperties.
nodes	<string,  GraphNode>	Ensemble de nœuds composant le graphe, fourni sous la forme d’un nodeId à la carte GraphNode

GraphParameter

Définit un paramètre global dans le graphique.

Nom	Type	Description
description	string	Description de ce paramètre de graphe.
links	GraphParameterLink[]	Liens d’association pour ce paramètre aux nœuds du graphe.
type	ParameterType	Type du paramètre Graph.

GraphParameterLink

Lien d’association d’un paramètre global de graphe à un nœud dans le graphe.

Nom	Type	Description
nodeId	string	Identificateur du nœud de graphe
parameterKey	string	Identificateur du paramètre de nœud auquel le paramètre global est mappé.

InputPort

Port d’entrée de ressource

Nom	Type	Valeur par défaut	Description
type	InputPortType	Dataset	Type de données de port.

InputPortType

Type de données de port.

Nom	Type	Description
Dataset	string

MachineLearningWorkspace

Informations sur l’espace de travail Machine Learning contenant l’expérience source pour le service web.

Nom	Type	Description
id	string	Spécifie l’ID d’espace de travail de l’espace de travail Machine Learning associé au service web

ModeValueInfo

Définition de paramètre imbriqué.

Nom	Type	Description
interfaceString	string	Nom de chaîne d’interface pour le paramètre imbriqué.
parameters	ModuleAssetParameter[]	Définition du paramètre.

ModuleAssetParameter

Définition de paramètre pour une ressource de module.

Nom	Type	Description
modeValuesInfo	<string,  ModeValueInfo>	Définitions des paramètres d’interface imbriqués s’il s’agit d’un paramètre de module complexe.
name	string	Nom du paramètre.
parameterType	string	Type de paramètre.

OutputPort

Port de sortie de l’élément multimédia

Nom	Type	Valeur par défaut	Description
type	OutputPortType	Dataset	Type de données de port.

OutputPortType

Type de données de port.

Nom	Type	Description
Dataset	string

ParameterType

Type du paramètre Graph.

Nom	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

Lecture seule : état de provisionnement du service web. Les valeurs valides sont Unknown, Provisioning, Succeeded et Failed.

Nom	Type	Description
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

Contient les options de configuration disponibles pour un point de terminaison de service web Azure ML.

Nom	Type	Description
maxConcurrentCalls	integer	Spécifie le nombre maximal d’appels simultanés pouvant être effectués au service web. Valeur minimale : 4, Valeur maximale : 200.

ServiceInputOutputSpecification

Schéma swagger 2.0 décrivant les entrées ou sorties du service. Consultez spécification Swagger : http://swagger.io/specification/

Nom	Type	Valeur par défaut	Description
description	string		Description du schéma Swagger.
properties	<string,  TableSpecification>		Spécifie une collection qui contient le schéma de colonne pour chaque entrée ou sortie du service web. Pour plus d’informations, consultez la spécification Swagger.
title	string		Titre de votre schéma Swagger.
type	string	object	Type de l’entité décrite dans swagger. Toujours 'object'.

StorageAccount

Accéder aux informations d’un compte de stockage.

Nom	Type	Description
key	string	Spécifie la clé utilisée pour accéder au compte de stockage.
name	string	Spécifie le nom du compte de stockage.

TableSpecification

Schéma swagger 2.0 décrivant une entrée ou une sortie de service unique. Consultez spécification Swagger : http://swagger.io/specification/

Nom	Type	Valeur par défaut	Description
description	string		Description du schéma Swagger.
format	string		Format, si 'type' n’est pas 'object'
properties	<string,  ColumnSpecification>		Ensemble de colonnes dans la table de données.
title	string		Titre du schéma Swagger.
type	string	object	Type de l’entité décrite dans swagger.

WebService

Instance d’une ressource de service web Azure ML.

Nom	Type	Description
id	string	Spécifie l’ID de ressource.
location	string	Spécifie l’emplacement de la ressource.
name	string	Spécifie le nom de la ressource.
properties	WebServiceProperties: WebServicePropertiesForGraph	Contient la charge utile de la propriété qui décrit le service web.
tags	object	Contient des balises de ressources définies en tant que paires clé/valeur.
type	string	Spécifie le type de la ressource.

WebServiceKeys

Clés d’accès pour les appels de service web.

Nom	Type	Description
primary	string	Clé d’accès primaire.
secondary	string	Clé d’accès secondaire.

WebServicePropertiesForGraph

Propriétés spécifiques à un service web basé sur Graph.

Nom	Type	Description
assets	<string,  AssetItem>	Contient des propriétés définies par l’utilisateur décrivant des ressources de service web. Les propriétés sont exprimées sous forme de paires Clé/Valeur.
commitmentPlan	CommitmentPlan	Contient le plan d’engagement associé à ce service web. Défini au moment de la création. Une fois définie, cette valeur ne peut pas être modifiée. Remarque : Le plan d’engagement n’est pas retourné par les appels aux opérations GET.
createdOn	string	Lecture seule : date et heure de création du service web.
description	string	Description du service web.
diagnostics	DiagnosticsConfiguration	Paramètres contrôlant la collection de traces diagnostics pour le service web.
exampleRequest	ExampleRequest	Définit des exemples de données d’entrée pour une ou plusieurs entrées du service.
exposeSampleData	boolean	Lorsque la valeur est true, les exemples de données sont inclus dans la définition swagger du service web. La valeur par défaut est true.
input	ServiceInputOutputSpecification	Contient le schéma Swagger 2.0 décrivant une ou plusieurs entrées du service web. Pour plus d’informations, consultez la spécification Swagger.
keys	WebServiceKeys	Contient les clés d’approvisionnement de service web. Si vous ne spécifiez pas de clés d’approvisionnement, le système Azure Machine Learning les génère pour vous. Remarque : Les clés ne sont pas retournées par les appels aux opérations GET.
machineLearningWorkspace	MachineLearningWorkspace	Spécifie l’espace de travail Machine Learning contenant l’expérience source du service web.
modifiedOn	string	Lecture seule : date et heure de la dernière modification du service web.
output	ServiceInputOutputSpecification	Contient le schéma Swagger 2.0 décrivant une ou plusieurs sorties du service web. Pour plus d’informations, consultez la spécification Swagger.
package	GraphPackage	Définition du package de graphe qui compose ce service web.
packageType	string: Graph	Spécifie le type de package. Les valeurs valides sont Graph (Spécifie un service web publié via Machine Learning Studio) et Code (Spécifie un service web publié à l’aide de code tel que Python). Remarque : Le code n’est pas pris en charge pour l’instant.
parameters	object	Ensemble de valeurs de paramètres globaux définies pour le service web, données sous la forme d’un nom de paramètre global à la carte de valeurs par défaut. Si aucune valeur par défaut n’est spécifiée, le paramètre est considéré comme obligatoire.
provisioningState	ProvisioningState	Lecture seule : état de provisionnement du service web. Les valeurs valides sont Unknown, Provisioning, Succeeded et Failed.
readOnly	boolean	Lorsque la valeur est true, indique que le service web est en lecture seule et ne peut plus être mis à jour ou corrigé, uniquement supprimé. La valeur par défaut est false. Remarque : Une fois défini sur true, vous ne pouvez pas modifier sa valeur.
realtimeConfiguration	RealtimeConfiguration	Contient les paramètres de configuration du point de terminaison de service web.
storageAccount	StorageAccount	Spécifie le compte de stockage utilisé par Azure Machine Learning pour stocker des informations sur le service web. Seul le nom du compte de stockage est retourné par les appels aux opérations GET. Lorsque vous mettez à jour les informations du compte de stockage, vous devez vous assurer que toutes les ressources nécessaires sont disponibles dans le nouveau compte de stockage ou que les appels à votre service web échouent.
swaggerLocation	string	Lecture seule : contient l’URI de la spécification swagger associée à ce service web.
title	string	Titre du service web.