Partager via


Web Services - Create Or Update

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.

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.