Web Services - Create Or Update

Service:

ML Studio (classic)

API Version:

2016-05-01-preview

Criar ou atualizar um serviço Web. Essa chamada substituirá um serviço Web existente. Observe que não há nenhum aviso ou confirmação. Esta é uma operação não detectável. Se sua intenção for criar um novo serviço Web, chame a operação Get primeiro para verificar se ela 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 de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	Nome do grupo de recursos no qual o serviço Web está localizado.
subscriptionId	path	True	string	A ID de assinatura do Azure.
webServiceName	path	True	string	O nome do serviço Web.
api-version	query	True	string	A versão da API do provedor de recursos Microsoft.MachineLearning a ser usada.

Corpo da solicitação

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

Nome	Obrigatório	Tipo	Description
location	True	string	Especifica o local do recurso.
properties	True	WebServiceProperties: WebServicePropertiesForGraph	Contém o conteúdo da propriedade que descreve o serviço Web.
name		string	Especifica o nome do recurso.
tags		object	Contém marcas de recurso definidas como pares chave/valor.

Respostas

Nome	Tipo	Description
200 OK	WebService	Êxito. Essa resposta é retornada para uma operação de serviço Web de atualização. A carga de resposta é idêntica à carga de resposta retornada pela operação GET. A resposta inclui o Estado de Provisionamento e o cabeçalho Azure-AsyncOperation. Para obter o progresso da operação, chame a operação GET na 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. Essa resposta é retornada para uma operação de criação de serviço Web. A resposta inclui o Estado de Provisionamento e o cabeçalho Azure-AsyncOperation. Para obter o progresso da operação, chame a operação GET na 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

Nome	Description
AssetItem	Informações sobre um ativo associado ao serviço Web.
AssetLocation	Descreve o local de acesso para um ativo de serviço Web.
AssetType	Tipo do ativo.
ColumnFormat	Informações adicionais de formato para o tipo de dados.
ColumnSpecification	Esquema swagger 2.0 para uma coluna dentro da tabela de dados que representa uma entrada ou saída de serviço Web. Consulte Especificação do Swagger: http://swagger.io/specification/
ColumnType	Tipo de dados da coluna.
CommitmentPlan	Informações sobre o plano de compromisso de machine learning associado ao serviço Web.
DiagnosticsConfiguration	Configuraçõ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 – desabilita o rastreamento; Erro – coleta apenas rastreamentos de erro (stderr) ; Todos – coleta todos os rastreamentos (stdout e stderr).
ExampleRequest	Dados de entrada de exemplo para as entradas do serviço.
GraphEdge	Define uma borda dentro do grafo do serviço Web.
GraphNode	Especifica um nó no grafo do serviço Web. O nó pode ser um nó de entrada, saída ou ativo, portanto, apenas uma das propriedades de ID correspondentes é preenchida a qualquer momento.
GraphPackage	Define o grafo de módulos que compõem a solução de machine learning.
GraphParameter	Define um parâmetro global no grafo.
GraphParameterLink	Link de associação de um parâmetro global de grafo para um nó no grafo.
InputPort	Porta de entrada do ativo
InputPortType	Tipo de dados de porta.
MachineLearningWorkspace	Informações sobre o workspace de machine learning que contém o experimento que é a origem do serviço Web.
ModeValueInfo	Definição de parâmetro aninhado.
ModuleAssetParameter	Definição de parâmetro para um ativo de módulo.
OutputPort	Porta de saída do ativo
OutputPortType	Tipo de dados de porta.
ParameterType	Tipo do parâmetro graph.
ProvisioningState	Somente Leitura: o estado de provisionamento do serviço Web. Os valores válidos são Desconhecido, Provisionamento, Êxito e Falha.
RealtimeConfiguration	Contém as opções de configuração disponíveis para um ponto de extremidade de serviço Web do Azure ML.
ServiceInputOutputSpecification	O esquema swagger 2.0 que descreve as entradas ou saídas do serviço. Consulte Especificação do Swagger: http://swagger.io/specification/
StorageAccount	Informações de acesso para uma conta de armazenamento.
TableSpecification	O esquema swagger 2.0 que descreve uma única entrada ou saída de serviço. Consulte 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 em Graph.

AssetItem

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

Nome	Tipo	Description
id	string	ID do ativo.
inputPorts	<string,  InputPort>	Informações sobre as portas de entrada do ativo.
locationInfo	AssetLocation	Informações de acesso para o ativo.
metadata	object	Se o ativo for um módulo personalizado, ele conterá os metadados do módulo.
name	string	Nome amigável do ativo.
outputPorts	<string,  OutputPort>	Informações sobre as portas de saída do ativo.
parameters	ModuleAssetParameter[]	Se o ativo for um módulo personalizado, isso conterá os parâmetros do módulo.
type	AssetType	Tipo do ativo.

AssetLocation

Descreve o local de acesso para um ativo de serviço Web.

Nome	Tipo	Description
credentials	string	Credenciais de acesso para o ativo, se aplicável (por exemplo, ativo especificado pela conta de armazenamento cadeia de conexão + URI de blob)
uri	string	O URI do qual o ativo está acessível (por exemplo, aml://abc para ativos do sistema ou https://xyz para ativos de usuário

AssetType

Tipo do ativo.

Nome	Tipo	Description
Module	string
Resource	string

ColumnFormat

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

Nome	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 dentro da tabela de dados que representa uma entrada ou saída de serviço Web. Consulte Especificação do Swagger: http://swagger.io/specification/

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

ColumnType

Tipo de dados da coluna.

Nome	Tipo	Description
Boolean	string
Integer	string
Number	string
String	string

CommitmentPlan

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

Nome	Tipo	Description
id	string	Especifica a ID de Resource Manager do Azure do plano de compromisso associado ao serviço Web.

DiagnosticsConfiguration

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

Nome	Tipo	Description
expiry	string	Especifica a data e a hora em que o registro em log será encerrado. Se for nulo, a coleta de diagnóstico não será limitada por tempo.
level	DiagnosticsLevel	Especifica a verbosidade da saída de diagnóstico. Os valores válidos são: Nenhum – desabilita o rastreamento; Erro – coleta apenas rastreamentos de erro (stderr) ; Todos – coleta todos os rastreamentos (stdout e stderr).

DiagnosticsLevel

Especifica a verbosidade da saída de diagnóstico. Os valores válidos são: Nenhum – desabilita o rastreamento; Erro – coleta apenas rastreamentos de erro (stderr) ; Todos – coleta todos os rastreamentos (stdout e stderr).

Nome	Tipo	Description
All	string
Error	string
None	string

ExampleRequest

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

Nome	Tipo	Description
globalParameters	object	Dados de entrada de exemplo para os parâmetros globais do serviço Web
inputs	object	Exemplo de dados de entrada 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 borda dentro do grafo do serviço Web.

Nome	Tipo	Description
sourceNodeId	string	O identificador do nó de grafo de origem.
sourcePortId	string	O identificador da porta do nó de origem da qual a borda se conecta.
targetNodeId	string	O identificador do nó do grafo de destino.
targetPortId	string	O identificador da porta do nó de destino à qual a borda se conecta.

GraphNode

Especifica um nó no grafo do serviço Web. O nó pode ser um nó de entrada, saída ou ativo, portanto, apenas uma das propriedades de ID correspondentes é preenchida a qualquer momento.

Nome	Tipo	Description
assetId	string	A ID do ativo representado por esse nó.
inputId	string	A ID do elemento de entrada representado por esse nó.
outputId	string	A ID do elemento de saída representado por esse nó.
parameters	object	Se aplicável, parâmetros do nó. Os parâmetros de grafo globais são mapeados para eles, com valores definidos em runtime.

GraphPackage

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

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

GraphParameter

Define um parâmetro global no grafo.

Nome	Tipo	Description
description	string	Descrição desse parâmetro de grafo.
links	GraphParameterLink[]	Links de associação para esse parâmetro a nós no grafo.
type	ParameterType	Tipo do parâmetro graph.

GraphParameterLink

Link de associação de um parâmetro global de grafo para um nó no grafo.

Nome	Tipo	Description
nodeId	string	O identificador do nó do grafo
parameterKey	string	O identificador do parâmetro de nó para o qual o parâmetro global é mapeado.

InputPort

Porta de entrada do ativo

Nome	Tipo	Valor padrão	Description
type	InputPortType	Dataset	Tipo de dados de porta.

InputPortType

Tipo de dados de porta.

Nome	Tipo	Description
Dataset	string

MachineLearningWorkspace

Informações sobre o workspace de machine learning que contém o experimento que é a origem do serviço Web.

Nome	Tipo	Description
id	string	Especifica a ID do workspace do machine learning associado ao serviço Web

ModeValueInfo

Definição de parâmetro aninhado.

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

ModuleAssetParameter

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

Nome	Tipo	Description
modeValuesInfo	<string,  ModeValueInfo>	Definições para parâmetros de interface aninhadas se esse 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 ativo

Nome	Tipo	Valor padrão	Description
type	OutputPortType	Dataset	Tipo de dados de porta.

OutputPortType

Tipo de dados de porta.

Nome	Tipo	Description
Dataset	string

ParameterType

Tipo do parâmetro graph.

Nome	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

Somente Leitura: o estado de provisionamento do serviço Web. Os valores válidos são Desconhecido, Provisionamento, Êxito e Falha.

Nome	Tipo	Description
Failed	string
Provisioning	string
Succeeded	string
Unknown	string

RealtimeConfiguration

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

Nome	Tipo	Description
maxConcurrentCalls	integer	Especifica as chamadas simultâneas máximas que podem ser feitas para o 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. Consulte Especificação do Swagger: http://swagger.io/specification/

Nome	Tipo	Valor padrão	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, consulte a especificação do Swagger.
title	string		O título do esquema do Swagger.
type	string	object	O tipo da entidade descrita em swagger. Sempre 'object'.

StorageAccount

Informações de acesso para uma conta de armazenamento.

Nome	Tipo	Description
key	string	Especifica a chave usada para acessar a conta de armazenamento.
name	string	Especifica o nome da conta de armazenamento.

TableSpecification

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

Nome	Tipo	Valor padrão	Description
description	string		Descrição do esquema do Swagger.
format	string		O formato, se 'type' não for 'object'
properties	<string,  ColumnSpecification>		O conjunto de colunas dentro da tabela de dados.
title	string		Título do esquema do Swagger.
type	string	object	O tipo da entidade descrita em swagger.

WebService

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

Nome	Tipo	Description
id	string	Especifica a ID do recurso.
location	string	Especifica o local do recurso.
name	string	Especifica o nome do recurso.
properties	WebServiceProperties: WebServicePropertiesForGraph	Contém o conteúdo da propriedade que descreve o serviço Web.
tags	object	Contém marcas de recurso definidas como pares chave/valor.
type	string	Especifica o tipo do recurso.

WebServiceKeys

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

Nome	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 em Graph.

Nome	Tipo	Description
assets	<string,  AssetItem>	Contém propriedades definidas pelo usuário que descrevem ativos de serviço Web. As propriedades são expressas como pares Chave/Valor.
commitmentPlan	CommitmentPlan	Contém o plano de compromisso associado a esse serviço Web. Defina no momento da criação. Depois de definido, esse valor não pode ser alterado. Observação: o plano de compromisso não é retornado de chamadas para operações GET.
createdOn	string	Somente Leitura: a data e a hora em que o serviço Web foi criado.
description	string	A descrição do serviço Web.
diagnostics	DiagnosticsConfiguration	Configurações que controlam a coleção de rastreamentos diagnóstico para o serviço Web.
exampleRequest	ExampleRequest	Define dados de entrada de exemplo para uma ou mais entradas do serviço.
exposeSampleData	boolean	Quando definido como true, os dados de exemplo são incluídos na definição de swagger do serviço Web. O valor padrão é 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, consulte a especificação do Swagger.
keys	WebServiceKeys	Contém as chaves de provisionamento do serviço Web. Se você não especificar chaves de provisionamento, o sistema do Azure Machine Learning as gerará para você. Observação: as chaves não são retornadas de chamadas para operações GET.
machineLearningWorkspace	MachineLearningWorkspace	Especifica o workspace do Machine Learning que contém o experimento que é a origem do serviço Web.
modifiedOn	string	Somente Leitura: a data e a 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, consulte a especificação do Swagger.
package	GraphPackage	A definição do pacote de grafo que compõe esse serviço Web.
packageType	string: Graph	Especifica o tipo de pacote. Os valores válidos são Graph (Especifica um serviço Web publicado por meio do Machine Learning Studio) e Code (especifica um serviço Web publicado usando código como Python). Observação: não há suporte para código no momento.
parameters	object	O conjunto de valores de parâmetros globais definidos para o serviço Web, fornecido como um nome de parâmetro global para o mapa de valor padrão. Se nenhum valor padrão for especificado, o parâmetro será considerado necessário.
provisioningState	ProvisioningState	Somente Leitura: o estado de provisionamento do serviço Web. Os valores válidos são Desconhecido, Provisionamento, Êxito e Falha.
readOnly	boolean	Quando definido como true, indica que o serviço Web é somente leitura e não pode mais ser atualizado ou corrigido, apenas removido. O padrão é false. Observação: uma vez definido como true, você não pode alterar seu valor.
realtimeConfiguration	RealtimeConfiguration	Contém as configurações do ponto de extremidade do serviço Web.
storageAccount	StorageAccount	Especifica a conta de armazenamento que o Azure Machine Learning usa para armazenar informações sobre o serviço Web. Somente o nome da conta de armazenamento é retornado de chamadas para operações GET. Ao atualizar as informações da conta de armazenamento, você deve garantir que todos os ativos necessários estejam disponíveis na nova conta de armazenamento ou as chamadas para o serviço Web falharão.
swaggerLocation	string	Somente Leitura: contém o URI da especificação swagger associada a esse serviço Web.
title	string	O título do serviço Web.