Web Services - Create Or Update

Serviço:

ML Studio (classic)

Versão da API:

2016-05-01-preview

Criar ou atualizar um serviço Web. Esta chamada substituirá um serviço Web existente. Tenha em atenção que não existe nenhum aviso ou confirmação. Esta é uma operação não detetável. Se a sua intenção for criar um novo serviço Web, chame primeiro a operação Get para verificar se não existe.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
resourceGroupName	path	True	string	Nome do grupo de recursos no qual o serviço Web está localizado.
subscriptionId	path	True	string	O ID da subscrição do Azure.
webServiceName	path	True	string	O nome do serviço Web.
api-version	query	True	string	A versão da API do fornecedor de recursos Microsoft.MachineLearning a utilizar.

Corpo do Pedido

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

Name	Necessário	Tipo	Description
location	True	string	Especifica a localização do recurso.
properties	True	WebServiceProperties: WebServicePropertiesForGraph	Contém o payload da propriedade que descreve o serviço Web.
name		string	Especifica o nome do recurso.
tags		object	Contém etiquetas de recursos definidas como pares chave/valor.

Respostas

Name	Tipo	Description
200 OK	WebService	Com êxito. Esta resposta é devolvida para uma operação de atualização do serviço Web. O payload de resposta é idêntico ao payload de resposta que é devolvido pela operação GET. A resposta inclui o Estado de Aprovisionamento e o cabeçalho Azure-AsyncOperation. Para obter o progresso da operação, chame a operação GET no URL no campo de cabeçalho Azure-AsyncOperation. Para obter mais informações sobre operações assíncronas, consulte https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"
201 Created	WebService	Criado. Esta resposta é devolvida para uma operação de criação de serviço Web. A resposta inclui o Estado de Aprovisionamento e o cabeçalho Azure-AsyncOperation. Para obter o progresso da operação, chame a operação GET no URL no campo de cabeçalho Azure-AsyncOperation. Para obter mais informações sobre operações assíncronas, consulte https://msdn.microsoft.com/en-us/library/mt742920.aspx. Media Types: "application/json", "text/json"

Definições

Name	Description
AssetItem	Informações sobre um recurso associado ao serviço Web.
AssetLocation	Descreve a localização de acesso de um recurso de serviço Web.
AssetType	Tipo de recurso.
ColumnFormat	Informações de formato adicionais para o tipo de dados.
ColumnSpecification	Esquema swagger 2.0 para uma coluna na tabela de dados que representa uma entrada ou saída do serviço Web. Veja Especificação do Swagger: http://swagger.io/specification/
ColumnType	Tipo de dados da coluna.
CommitmentPlan	Informações sobre o plano de alocação de machine learning associado ao serviço Web.
DiagnosticsConfiguration	Definições de diagnóstico para um serviço Web do Azure ML.
DiagnosticsLevel	Especifica a verbosidade da saída de diagnóstico. Os valores válidos são: Nenhum – desativa o rastreio; Erro – recolhe apenas rastreios de erro (stderr) ; All - recolhe todos os rastreios (stdout e stderr).
ExampleRequest	Dados de entrada de exemplo para as entradas do serviço.
GraphEdge	Define uma aresta no gráfico do serviço Web.
GraphNode	Especifica um nó no gráfico do serviço Web. O nó pode ser um nó de entrada, saída ou recurso, pelo que apenas uma das propriedades de ID correspondentes é preenchida a qualquer momento.
GraphPackage	Define o gráfico de módulos que compõem a solução de machine learning.
GraphParameter	Define um parâmetro global no gráfico.
GraphParameterLink	Ligação de associação para um parâmetro global de gráfico para um nó no gráfico.
InputPort	Porta de entrada de recursos
InputPortType	Tipo de dados de porta.
MachineLearningWorkspace	Informações sobre a área de trabalho de machine learning que contém a experimentação que é a origem do serviço Web.
ModeValueInfo	Definição de parâmetro aninhada.
ModuleAssetParameter	Definição de parâmetro para um recurso de módulo.
OutputPort	Porta de saída do recurso
OutputPortType	Tipo de dados de porta.
ParameterType	Tipo de parâmetro de gráfico.
ProvisioningState	Só de Leitura: o estado de aprovisionamento do serviço Web. Os valores válidos são Desconhecido, Aprovisionamento, Com Êxito e Com Falhas.
RealtimeConfiguration	Contém as opções de configuração disponíveis para um ponto final de serviço Web do Azure ML.
ServiceInputOutputSpecification	O esquema swagger 2.0 que descreve as entradas ou saídas do serviço. Veja Especificação do Swagger: http://swagger.io/specification/
StorageAccount	Aceder a informações de uma conta de armazenamento.
TableSpecification	O esquema swagger 2.0 que descreve uma entrada ou saída de serviço único. Veja Especificação do Swagger: http://swagger.io/specification/
WebService	Instância de um recurso de serviço Web do Azure ML.
WebServiceKeys	Chaves de acesso para as chamadas do serviço Web.
WebServicePropertiesForGraph	Propriedades específicas de um serviço Web baseado no Graph.

AssetItem

Informações sobre um recurso associado ao serviço Web.

Name	Tipo	Description
id	string	ID do elemento.
inputPorts	<string,  InputPort>	Informações sobre as portas de entrada do recurso.
locationInfo	AssetLocation	Aceder às informações do recurso.
metadata	object	Se o recurso for um módulo personalizado, isto contém os metadados do módulo.
name	string	Nome amigável do elemento.
outputPorts	<string,  OutputPort>	Informações sobre as portas de saída do recurso.
parameters	ModuleAssetParameter[]	Se o recurso for um módulo personalizado, isto contém os parâmetros do módulo.
type	AssetType	Tipo de recurso.

AssetLocation

Descreve a localização de acesso de um recurso de serviço Web.

Name	Tipo	Description
credentials	string	Aceder às credenciais do recurso, se aplicável (por exemplo, recurso especificado pela conta de armazenamento cadeia de ligação + URI do blob)
uri	string	O URI a partir do qual o recurso está acessível (por exemplo, aml://abc para recursos de sistema ou https://xyz para recursos de utilizador

AssetType

Tipo de recurso.

Name	Tipo	Description
Module	string
Resource	string

ColumnFormat

Informações de formato adicionais para o tipo de dados.

Name	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 swagger 2.0 para uma coluna na tabela de dados que representa uma entrada ou saída do serviço Web. Veja Especificação do Swagger: http://swagger.io/specification/

Name	Tipo	Description
enum	object[]	Se o tipo de dados for categórico, esta ação fornece a lista de categorias aceites.
format	ColumnFormat	Informações de formato adicionais para o tipo de dados.
type	ColumnType	Tipo de dados da coluna.
x-ms-isnullable	boolean	Sinalizador que indica se o tipo suporta valores nulos ou não.
x-ms-isordered	boolean	Sinalizador que indica se as categorias são tratadas como um conjunto ordenado ou não, se se trata de uma coluna categórica.

ColumnType

Tipo de dados da coluna.

Name	Tipo	Description
Boolean	string
Integer	string
Number	string
String	string

CommitmentPlan

Informações sobre o plano de alocação de machine learning associado ao serviço Web.

Name	Tipo	Description
id	string	Especifica o ID de Resource Manager do Azure do plano de alocação associado ao serviço Web.

DiagnosticsConfiguration

Definições de diagnóstico para um serviço Web do Azure ML.

Name	Tipo	Description
expiry	string	Especifica a data e hora em que o registo cessará. Se for nula, a recolha de diagnósticos não é limitada no tempo.
level	DiagnosticsLevel	Especifica a verbosidade da saída de diagnóstico. Os valores válidos são: Nenhum – desativa o rastreio; Erro – recolhe apenas rastreios de erro (stderr) ; All - recolhe todos os rastreios (stdout e stderr).

DiagnosticsLevel

Especifica a verbosidade da saída de diagnóstico. Os valores válidos são: Nenhum – desativa o rastreio; Erro – recolhe apenas rastreios de erro (stderr) ; All - recolhe todos os rastreios (stdout e stderr).

Name	Tipo	Description
All	string
Error	string
None	string

ExampleRequest

Dados de entrada de exemplo para as entradas do serviço.

Name	Tipo	Description
globalParameters	object	Dados de entrada de exemplo para os parâmetros globais do serviço Web
inputs	object	Dados de entrada de exemplo para as entradas do serviço Web fornecidas como um nome de entrada para o mapa de matriz de valores de entrada de exemplo.

GraphEdge

Define uma aresta no gráfico do serviço Web.

Name	Tipo	Description
sourceNodeId	string	O identificador do nó do grafo de origem.
sourcePortId	string	O identificador da porta do nó de origem a partir da qual o edge se liga.
targetNodeId	string	O identificador do nó do grafo de destino.
targetPortId	string	O identificador da porta do nó de destino à qual o edge se liga.

GraphNode

Especifica um nó no gráfico do serviço Web. O nó pode ser um nó de entrada, saída ou recurso, pelo que apenas uma das propriedades de ID correspondentes é preenchida a qualquer momento.

Name	Tipo	Description
assetId	string	O ID do recurso representado por este nó.
inputId	string	O ID do elemento de entrada representado por este nó.
outputId	string	O ID do elemento de saída representado por este nó.
parameters	object	Se aplicável, os parâmetros do nó. Os parâmetros de grafos globais são mapeados para estes, com valores definidos no runtime.

GraphPackage

Define o gráfico de módulos que compõem a solução de machine learning.

Name	Tipo	Description
edges	GraphEdge[]	A lista de arestas que compõem o gráfico.
graphParameters	<string,  GraphParameter>	A coleção de parâmetros globais para o gráfico, fornecida como um nome de parâmetro global para o mapa GraphParameter. Cada parâmetro aqui tem uma correspondência de 1:1 com o mapa de valores de parâmetros globais declarado ao nível de WebServiceProperties.
nodes	<string,  GraphNode>	O conjunto de nós que compõem o gráfico, fornecido como um nodeId para o mapa do GraphNode

GraphParameter

Define um parâmetro global no gráfico.

Name	Tipo	Description
description	string	Descrição deste parâmetro de gráfico.
links	GraphParameterLink[]	Ligações de associação para este parâmetro para nós no gráfico.
type	ParameterType	Tipo de parâmetro de gráfico.

GraphParameterLink

Ligação de associação para um parâmetro global de gráfico para um nó no gráfico.

Name	Tipo	Description
nodeId	string	O identificador do nó de grafo
parameterKey	string	O identificador do parâmetro do nó ao qual o parâmetro global mapeia.

InputPort

Porta de entrada de recursos

Name	Tipo	Default value	Description
type	InputPortType	Dataset	Tipo de dados de porta.

InputPortType

Tipo de dados de porta.

Name	Tipo	Description
Dataset	string

MachineLearningWorkspace

Informações sobre a área de trabalho de machine learning que contém a experimentação que é a origem do serviço Web.

Name	Tipo	Description
id	string	Especifica o ID da área de trabalho de machine learning associado ao serviço Web

ModeValueInfo

Definição de parâmetro aninhada.

Name	Tipo	Description
interfaceString	string	O nome da cadeia de interface para o parâmetro aninhado.
parameters	ModuleAssetParameter[]	A definição do parâmetro .

ModuleAssetParameter

Definição de parâmetro para um recurso de módulo.

Name	Tipo	Description
modeValuesInfo	<string,  ModeValueInfo>	Definições para parâmetros de interface aninhadas se este for um parâmetro de módulo complexo.
name	string	Nome do parâmetro.
parameterType	string	Tipo de parâmetro.

OutputPort

Porta de saída do recurso

Name	Tipo	Default value	Description
type	OutputPortType	Dataset	Tipo de dados de porta.

OutputPortType

Tipo de dados de porta.

Name	Tipo	Description
Dataset	string

ParameterType

Tipo de parâmetro de gráfico.

Name	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

Só de Leitura: o estado de aprovisionamento do serviço Web. Os valores válidos são Desconhecido, Aprovisionamento, Com Êxito e Com Falhas.

Name	Tipo	Description
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

Contém as opções de configuração disponíveis para um ponto final de serviço Web do Azure ML.

Name	Tipo	Description
maxConcurrentCalls	integer	Especifica as chamadas simultâneas máximas que podem ser efetuadas ao serviço Web. Valor mínimo: 4, Valor máximo: 200.

ServiceInputOutputSpecification

O esquema swagger 2.0 que descreve as entradas ou saídas do serviço. Veja Especificação do Swagger: http://swagger.io/specification/

Name	Tipo	Default value	Description
description	string		A descrição do esquema Swagger.
properties	<string,  TableSpecification>		Especifica uma coleção que contém o esquema de coluna para cada entrada ou saída do serviço Web. Para obter mais informações, veja a especificação swagger.
title	string		O título do seu esquema Swagger.
type	string	object	O tipo da entidade descrita no swagger. Sempre "objeto".

StorageAccount

Aceder a informações de uma conta de armazenamento.

Name	Tipo	Description
key	string	Especifica a chave utilizada para aceder à conta de armazenamento.
name	string	Especifica o nome da conta de armazenamento.

TableSpecification

O esquema swagger 2.0 que descreve uma entrada ou saída de serviço único. Veja Especificação do Swagger: http://swagger.io/specification/

Name	Tipo	Default value	Description
description	string		Descrição do esquema swagger.
format	string		O formato, se "type" não for "object"
properties	<string,  ColumnSpecification>		O conjunto de colunas na tabela de dados.
title	string		Título do esquema swagger.
type	string	object	O tipo da entidade descrita no swagger.

WebService

Instância de um recurso de serviço Web do Azure ML.

Name	Tipo	Description
id	string	Especifica o ID do recurso.
location	string	Especifica a localização do recurso.
name	string	Especifica o nome do recurso.
properties	WebServiceProperties: WebServicePropertiesForGraph	Contém o payload da propriedade que descreve o serviço Web.
tags	object	Contém etiquetas de recursos definidas como pares chave/valor.
type	string	Especifica o tipo do recurso.

WebServiceKeys

Chaves de acesso para as chamadas do serviço Web.

Name	Tipo	Description
primary	string	A chave de acesso primária.
secondary	string	A chave de acesso secundária.

WebServicePropertiesForGraph

Propriedades específicas de um serviço Web baseado no Graph.

Name	Tipo	Description
assets	<string,  AssetItem>	Contém propriedades definidas pelo utilizador que descrevem os recursos do serviço Web. As propriedades são expressas como pares Chave/Valor.
commitmentPlan	CommitmentPlan	Contém o plano de alocação associado a este serviço Web. Definido no momento da criação. Uma vez definido, este valor não pode ser alterado. Nota: o plano de alocação não é devolvido a partir de chamadas para operações GET.
createdOn	string	Só de Leitura: a data e hora em que o serviço Web foi criado.
description	string	A descrição do serviço Web.
diagnostics	DiagnosticsConfiguration	Definições que controlam a coleção de rastreios de diagnóstico do serviço Web.
exampleRequest	ExampleRequest	Define dados de entrada de exemplo para uma ou mais das entradas do serviço.
exposeSampleData	boolean	Quando definido como verdadeiro, os dados de exemplo são incluídos na definição swagger do serviço Web. O valor predefinido é true.
input	ServiceInputOutputSpecification	Contém o esquema swagger 2.0 que descreve uma ou mais entradas do serviço Web. Para obter mais informações, veja a especificação swagger.
keys	WebServiceKeys	Contém as chaves de aprovisionamento do serviço Web. Se não especificar chaves de aprovisionamento, o sistema do Azure Machine Learning gera-as automaticamente. Nota: as chaves não são devolvidas de chamadas para operações GET.
machineLearningWorkspace	MachineLearningWorkspace	Especifica a área de trabalho do Machine Learning que contém a experimentação que é a origem do serviço Web.
modifiedOn	string	Só de Leitura: a data e hora em que o serviço Web foi modificado pela última vez.
output	ServiceInputOutputSpecification	Contém o esquema swagger 2.0 que descreve uma ou mais saídas do serviço Web. Para obter mais informações, veja a especificação swagger.
package	GraphPackage	A definição do pacote de gráficos que compõe este serviço Web.
packageType	string: Graph	Especifica o tipo de pacote. Os valores válidos são Graph (Especifica um serviço Web publicado através do Machine Learning Studio) e Code (Especifica um serviço Web publicado com código como Python). Nota: o código não é suportado neste momento.
parameters	object	O conjunto de valores de parâmetros globais definidos para o serviço Web, dado como um nome de parâmetro global para o mapa de valores predefinido. Se não for especificado nenhum valor predefinido, considera-se que o parâmetro é necessário.
provisioningState	ProvisioningState	Só de Leitura: o estado de aprovisionamento do serviço Web. Os valores válidos são Desconhecido, Aprovisionamento, Com Êxito e Com Falhas.
readOnly	boolean	Quando definido como verdadeiro, indica que o serviço Web é só de leitura e já não pode ser atualizado ou corrigido, apenas removido. Predefinição, é falso. Nota: uma vez definido como verdadeiro, não pode alterar o respetivo valor.
realtimeConfiguration	RealtimeConfiguration	Contém as definições de configuração do ponto final de serviço Web.
storageAccount	StorageAccount	Especifica a conta de armazenamento que o Azure Machine Learning utiliza para armazenar informações sobre o serviço Web. Apenas o nome da conta de armazenamento é devolvido a partir de chamadas para operações GET. Ao atualizar as informações da conta de armazenamento, tem de garantir que todos os recursos necessários estão disponíveis na nova conta de armazenamento ou que as chamadas para o serviço Web irão falhar.
swaggerLocation	string	Só de Leitura: Contém o URI das especificações swagger associadas a este serviço Web.
title	string	O título do serviço Web.