Web Services - Create Or Update

Service:

ML Studio (classic)

API Version:

2016-05-01-preview

Cree o actualice un servicio web. Esta llamada sobrescribirá un servicio web existente. Tenga en cuenta que no hay ninguna advertencia o confirmación. Se trata de una operación irrecuperable. Si su intención es crear un nuevo servicio web, llame primero a la operación Get para comprobar que no existe.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos en el que se encuentra el servicio web.
subscriptionId	path	True	string	El identificador de la suscripción de Azure.
webServiceName	path	True	string	Nombre del servicio web.
api-version	query	True	string	Versión de la API del proveedor de recursos Microsoft.MachineLearning que se va a usar.

Cuerpo de la solicitud

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

Nombre	Requerido	Tipo	Description
location	True	string	Especifica la ubicación del recurso.
properties	True	WebServiceProperties: WebServicePropertiesForGraph	Contiene la carga de propiedad que describe el servicio web.
name		string	Especifica el nombre del recurso.
tags		object	Contiene etiquetas de recursos definidas como pares clave-valor.

Respuestas

Nombre	Tipo	Description
200 OK	WebService	Correcto. Esta respuesta se devuelve para una operación de actualización del servicio web. La carga de respuesta es idéntica a la carga de respuesta que devuelve la operación GET. La respuesta incluye el estado de aprovisionamiento y el encabezado Azure-AsyncOperation. Para obtener el progreso de la operación, llame a la operación GET en la dirección URL en Azure-AsyncOperation campo de encabezado. Para obtener más información sobre las operaciones asincrónicas, vea https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"
201 Created	WebService	Creado. Esta respuesta se devuelve para una operación de creación de servicio web. La respuesta incluye el estado de aprovisionamiento y el encabezado Azure-AsyncOperation. Para obtener el progreso de la operación, llame a la operación GET en la dirección URL en Azure-AsyncOperation campo de encabezado. Para obtener más información sobre las operaciones asincrónicas, vea https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"

Definiciones

Nombre	Description
AssetItem	Información sobre un recurso asociado al servicio web.
AssetLocation	Describe la ubicación de acceso de un recurso de servicio web.
AssetType	Tipo del recurso.
ColumnFormat	Información de formato adicional para el tipo de datos.
ColumnSpecification	Esquema de Swagger 2.0 para una columna dentro de la tabla de datos que representa una entrada o salida del servicio web. Consulte especificación de Swagger: http://swagger.io/specification/
ColumnType	Tipo de datos de la columna.
CommitmentPlan	Información sobre el plan de compromiso de aprendizaje automático asociado al servicio web.
DiagnosticsConfiguration	Configuración de diagnóstico para un servicio web de Azure ML.
DiagnosticsLevel	Especifica el nivel de detalle de la salida de diagnóstico. Los valores válidos son: None - deshabilita el seguimiento; Error: recopila solo seguimientos de error (stderr); All: recopila todos los seguimientos (stdout y stderr).
ExampleRequest	Datos de entrada de ejemplo para las entradas del servicio.
GraphEdge	Define un perímetro dentro del gráfico del servicio web.
GraphNode	Especifica un nodo en el gráfico de servicios web. El nodo puede ser un nodo de entrada, salida o recurso, por lo que solo se rellena una de las propiedades de identificador correspondientes en un momento dado.
GraphPackage	Define el gráfico de módulos que componen la solución de aprendizaje automático.
GraphParameter	Define un parámetro global en el gráfico.
GraphParameterLink	Vínculo de asociación de un parámetro global de grafo a un nodo del grafo.
InputPort	Puerto de entrada de recursos
InputPortType	Tipo de datos de puerto.
MachineLearningWorkspace	Información sobre el área de trabajo de Machine Learning que contiene el experimento que es el origen del servicio web.
ModeValueInfo	Definición de parámetro anidado.
ModuleAssetParameter	Definición de parámetro para un recurso de módulo.
OutputPort	Puerto de salida del recurso
OutputPortType	Tipo de datos de puerto.
ParameterType	Tipo del parámetro Graph.
ProvisioningState	Solo lectura: estado de aprovisionamiento del servicio web. Los valores válidos son Unknown, Provisioning, Succeeded y Failed.
RealtimeConfiguration	Contiene las opciones de configuración disponibles para un punto de conexión de servicio web de Azure ML.
ServiceInputOutputSpecification	Esquema swagger 2.0 que describe las entradas o salidas del servicio. Consulte especificación de Swagger: http://swagger.io/specification/
StorageAccount	Información de acceso para una cuenta de almacenamiento.
TableSpecification	Esquema swagger 2.0 que describe una única entrada o salida de servicio. Consulte especificación de Swagger: http://swagger.io/specification/
WebService	Instancia de un recurso de servicio web de Azure ML.
WebServiceKeys	Claves de acceso para las llamadas de servicio web.
WebServicePropertiesForGraph	Propiedades específicas de un servicio web basado en Graph.

AssetItem

Información sobre un recurso asociado al servicio web.

Nombre	Tipo	Description
id	string	Id. del recurso.
inputPorts	<string,  InputPort>	Información sobre los puertos de entrada del recurso.
locationInfo	AssetLocation	Obtenga acceso a la información del recurso.
metadata	object	Si el recurso es un módulo personalizado, contiene los metadatos del módulo.
name	string	Nombre descriptivo del recurso.
outputPorts	<string,  OutputPort>	Información sobre los puertos de salida del recurso.
parameters	ModuleAssetParameter[]	Si el recurso es un módulo personalizado, contiene los parámetros del módulo.
type	AssetType	Tipo del recurso.

AssetLocation

Describe la ubicación de acceso de un recurso de servicio web.

Nombre	Tipo	Description
credentials	string	Acceda a las credenciales del recurso, si procede (por ejemplo, recurso especificado por la cuenta de almacenamiento cadena de conexión + URI de blob).
uri	string	El URI desde el que se puede acceder al recurso (por ejemplo, aml://abc para los recursos del sistema o https://xyz para los recursos de usuario.

AssetType

Tipo del recurso.

Nombre	Tipo	Description
Module	string
Resource	string

ColumnFormat

Información de formato adicional para el tipo de datos.

Nombre	Tipo	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

Esquema de Swagger 2.0 para una columna dentro de la tabla de datos que representa una entrada o salida del servicio web. Consulte especificación de Swagger: http://swagger.io/specification/

Nombre	Tipo	Description
enum	object[]	Si el tipo de datos es categórico, proporciona la lista de categorías aceptadas.
format	ColumnFormat	Información de formato adicional para el tipo de datos.
type	ColumnType	Tipo de datos de la columna.
x-ms-isnullable	boolean	Marca que indica si el tipo admite valores NULL o no.
x-ms-isordered	boolean	Marca que indica si las categorías se tratan como un conjunto ordenado o no, si se trata de una columna de categorías.

ColumnType

Tipo de datos de la columna.

Nombre	Tipo	Description
Boolean	string
Integer	string
Number	string
String	string

CommitmentPlan

Información sobre el plan de compromiso de aprendizaje automático asociado al servicio web.

Nombre	Tipo	Description
id	string	Especifica el identificador de Resource Manager de Azure del plan de compromiso asociado al servicio web.

DiagnosticsConfiguration

Configuración de diagnóstico para un servicio web de Azure ML.

Nombre	Tipo	Description
expiry	string	Especifica la fecha y hora en que el registro dejará de funcionar. Si es null, la recopilación de diagnósticos no tiene tiempo limitado.
level	DiagnosticsLevel	Especifica el nivel de detalle de la salida de diagnóstico. Los valores válidos son: None - deshabilita el seguimiento; Error: recopila solo seguimientos de error (stderr); All: recopila todos los seguimientos (stdout y stderr).

DiagnosticsLevel

Especifica el nivel de detalle de la salida de diagnóstico. Los valores válidos son: None - deshabilita el seguimiento; Error: recopila solo seguimientos de error (stderr); All: recopila todos los seguimientos (stdout y stderr).

Nombre	Tipo	Description
All	string
Error	string
None	string

ExampleRequest

Datos de entrada de ejemplo para las entradas del servicio.

Nombre	Tipo	Description
globalParameters	object	Datos de entrada de ejemplo para los parámetros globales del servicio web
inputs	object	Datos de entrada de ejemplo para las entradas del servicio web dadas como un nombre de entrada para el mapa de matriz de valores de entrada de ejemplo.

GraphEdge

Define un perímetro dentro del gráfico del servicio web.

Nombre	Tipo	Description
sourceNodeId	string	Identificador del nodo del grafo de origen.
sourcePortId	string	Identificador del puerto del nodo de origen desde el que se conecta el borde.
targetNodeId	string	Identificador del nodo del grafo de destino.
targetPortId	string	Identificador del puerto del nodo de destino al que se conecta el borde.

GraphNode

Especifica un nodo en el gráfico de servicios web. El nodo puede ser un nodo de entrada, salida o recurso, por lo que solo se rellena una de las propiedades de identificador correspondientes en un momento dado.

Nombre	Tipo	Description
assetId	string	Identificador del recurso representado por este nodo.
inputId	string	Identificador del elemento de entrada representado por este nodo.
outputId	string	Identificador del elemento de salida representado por este nodo.
parameters	object	Si procede, los parámetros del nodo. Los parámetros del grafo global se asignan a ellos, con valores establecidos en tiempo de ejecución.

GraphPackage

Define el gráfico de módulos que componen la solución de aprendizaje automático.

Nombre	Tipo	Description
edges	GraphEdge[]	Lista de bordes que componen el gráfico.
graphParameters	<string,  GraphParameter>	Colección de parámetros globales para el grafo, dado como nombre de parámetro global a la asignación de GraphParameter. Cada parámetro aquí tiene una coincidencia 1:1 con los valores de parámetros globales que se declaran en el nivel WebServiceProperties.
nodes	<string,  GraphNode>	El conjunto de nodos que componen el grafo, proporcionado como nodeId para el mapa de GraphNode.

GraphParameter

Define un parámetro global en el gráfico.

Nombre	Tipo	Description
description	string	Descripción de este parámetro de grafo.
links	GraphParameterLink[]	Vínculos de asociación de este parámetro a los nodos del gráfico.
type	ParameterType	Tipo del parámetro Graph.

GraphParameterLink

Vínculo de asociación de un parámetro global de grafo a un nodo del grafo.

Nombre	Tipo	Description
nodeId	string	Identificador del nodo del grafo
parameterKey	string	Identificador del parámetro de nodo al que se asigna el parámetro global.

InputPort

Puerto de entrada de recursos

Nombre	Tipo	Valor predeterminado	Description
type	InputPortType	Dataset	Tipo de datos de puerto.

InputPortType

Tipo de datos de puerto.

Nombre	Tipo	Description
Dataset	string

MachineLearningWorkspace

Información sobre el área de trabajo de Machine Learning que contiene el experimento que es el origen del servicio web.

Nombre	Tipo	Description
id	string	Especifica el identificador de área de trabajo del área de trabajo de Machine Learning asociada al servicio web.

ModeValueInfo

Definición de parámetro anidado.

Nombre	Tipo	Description
interfaceString	string	Nombre de cadena de interfaz para el parámetro anidado.
parameters	ModuleAssetParameter[]	Definición del parámetro .

ModuleAssetParameter

Definición de parámetro para un recurso de módulo.

Nombre	Tipo	Description
modeValuesInfo	<string,  ModeValueInfo>	Definiciones de parámetros de interfaz anidados si se trata de un parámetro de módulo complejo.
name	string	Nombre del parámetro.
parameterType	string	Tipo de parámetro.

OutputPort

Puerto de salida del recurso

Nombre	Tipo	Valor predeterminado	Description
type	OutputPortType	Dataset	Tipo de datos de puerto.

OutputPortType

Tipo de datos de puerto.

Nombre	Tipo	Description
Dataset	string

ParameterType

Tipo del parámetro Graph.

Nombre	Tipo	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

Solo lectura: estado de aprovisionamiento del servicio web. Los valores válidos son Unknown, Provisioning, Succeeded y Failed.

Nombre	Tipo	Description
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

Contiene las opciones de configuración disponibles para un punto de conexión de servicio web de Azure ML.

Nombre	Tipo	Description
maxConcurrentCalls	integer	Especifica el número máximo de llamadas simultáneas que se pueden realizar en el servicio web. Valor mínimo: 4, Valor máximo: 200.

ServiceInputOutputSpecification

Esquema swagger 2.0 que describe las entradas o salidas del servicio. Consulte especificación de Swagger: http://swagger.io/specification/

Nombre	Tipo	Valor predeterminado	Description
description	string		Descripción del esquema de Swagger.
properties	<string,  TableSpecification>		Especifica una colección que contiene el esquema de columna para cada entrada o salida del servicio web. Para más información, consulte la especificación de Swagger.
title	string		Título del esquema de Swagger.
type	string	object	Tipo de la entidad descrita en swagger. Siempre 'object'.

StorageAccount

Información de acceso para una cuenta de almacenamiento.

Nombre	Tipo	Description
key	string	Especifica la clave usada para acceder a la cuenta de almacenamiento.
name	string	Especifica el nombre de la cuenta de almacenamiento.

TableSpecification

Esquema swagger 2.0 que describe una única entrada o salida de servicio. Consulte especificación de Swagger: http://swagger.io/specification/

Nombre	Tipo	Valor predeterminado	Description
description	string		Descripción del esquema de Swagger.
format	string		El formato, si 'type' no es 'object'
properties	<string,  ColumnSpecification>		Conjunto de columnas dentro de la tabla de datos.
title	string		Título del esquema de Swagger.
type	string	object	Tipo de la entidad descrita en swagger.

WebService

Instancia de un recurso de servicio web de Azure ML.

Nombre	Tipo	Description
id	string	Especifica el identificador de recurso.
location	string	Especifica la ubicación del recurso.
name	string	Especifica el nombre del recurso.
properties	WebServiceProperties: WebServicePropertiesForGraph	Contiene la carga de propiedad que describe el servicio web.
tags	object	Contiene etiquetas de recursos definidas como pares clave-valor.
type	string	Especifica el tipo del recurso.

WebServiceKeys

Claves de acceso para las llamadas de servicio web.

Nombre	Tipo	Description
primary	string	Clave de acceso principal.
secondary	string	Clave de acceso secundaria.

WebServicePropertiesForGraph

Propiedades específicas de un servicio web basado en Graph.

Nombre	Tipo	Description
assets	<string,  AssetItem>	Contiene propiedades definidas por el usuario que describen los recursos del servicio web. Las propiedades se expresan como pares clave-valor.
commitmentPlan	CommitmentPlan	Contiene el plan de compromiso asociado a este servicio web. Establézcalo en el momento de la creación. Una vez establecido, este valor no se puede cambiar. Nota: El plan de compromiso no se devuelve de llamadas a operaciones GET.
createdOn	string	Solo lectura: fecha y hora en que se creó el servicio web.
description	string	Descripción del servicio web.
diagnostics	DiagnosticsConfiguration	Configuración que controla la colección de seguimientos de diagnóstico para el servicio web.
exampleRequest	ExampleRequest	Define los datos de entrada de ejemplo para una o varias de las entradas del servicio.
exposeSampleData	boolean	Cuando se establece en true, los datos de ejemplo se incluyen en la definición de swagger del servicio web. El valor predeterminado es true.
input	ServiceInputOutputSpecification	Contiene el esquema de Swagger 2.0 que describe una o varias de las entradas del servicio web. Para más información, consulte la especificación de Swagger.
keys	WebServiceKeys	Contiene las claves de aprovisionamiento del servicio web. Si no especifica claves de aprovisionamiento, el sistema de Azure Machine Learning los genera automáticamente. Nota: Las claves no se devuelven de llamadas a operaciones GET.
machineLearningWorkspace	MachineLearningWorkspace	Especifica el área de trabajo de Machine Learning que contiene el experimento que es el origen del servicio web.
modifiedOn	string	Solo lectura: fecha y hora en que se modificó por última vez el servicio web.
output	ServiceInputOutputSpecification	Contiene el esquema de Swagger 2.0 que describe una o varias de las salidas del servicio web. Para más información, consulte la especificación de Swagger.
package	GraphPackage	Definición del paquete de grafos que compone este servicio web.
packageType	string: Graph	Especifica el tipo de paquete. Los valores válidos son Graph (especifica un servicio web publicado a través de Machine Learning Studio) y Code (Especifica un servicio web publicado mediante código como Python). Nota: El código no se admite en este momento.
parameters	object	Conjunto de valores de parámetros globales definidos para el servicio web, dado como un nombre de parámetro global para el mapa de valores predeterminado. Si no se especifica ningún valor predeterminado, el parámetro se considera necesario.
provisioningState	ProvisioningState	Solo lectura: estado de aprovisionamiento del servicio web. Los valores válidos son Unknown, Provisioning, Succeeded y Failed.
readOnly	boolean	Cuando se establece en true, indica que el servicio web es de solo lectura y ya no se puede actualizar ni aplicar revisiones, solo se quita. El valor predeterminado es false. Nota: Una vez establecido en true, no puede cambiar su valor.
realtimeConfiguration	RealtimeConfiguration	Contiene los valores de configuración para el punto de conexión de servicio web.
storageAccount	StorageAccount	Especifica la cuenta de almacenamiento que Usa Azure Machine Learning para almacenar información sobre el servicio web. Solo se devuelve el nombre de la cuenta de almacenamiento de las llamadas a las operaciones GET. Al actualizar la información de la cuenta de almacenamiento, debe asegurarse de que todos los recursos necesarios están disponibles en la nueva cuenta de almacenamiento o se producirá un error en las llamadas al servicio web.
swaggerLocation	string	Solo lectura: contiene el URI de la especificación swagger asociada a este servicio web.
title	string	Título del servicio web.