Partilhar via


Web Services - Get

Obtém a Definição de Serviço Web conforme especificado por uma subscrição, grupo de recursos e nome. Tenha em atenção que as credenciais de armazenamento e as chaves de serviço Web não são devolvidas por esta chamada. Para obter as chaves de acesso do serviço Web, chame Chaves de Lista.

GET 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.

Respostas

Name Tipo Description
200 OK

WebService

Com êxito. 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çõesPara 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.

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.