Sdílet prostřednictvím


Web Services - Get

Získá definici webové služby, jak je určeno předplatném, skupinou prostředků a názvem. Upozorňujeme, že toto volání nevrátí přihlašovací údaje úložiště a klíče webové služby. Pokud chcete získat přístupové klíče webové služby, zavolejte Seznam klíčů.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
resourceGroupName
path True

string

Název skupiny prostředků, ve které se nachází webová služba.

subscriptionId
path True

string

ID předplatného Azure.

webServiceName
path True

string

Název webové služby.

api-version
query True

string

Verze rozhraní API poskytovatele prostředků Microsoft.MachineLearning, která se má použít.

Odpovědi

Name Typ Description
200 OK

WebService

Úspěch. Odpověď obsahuje stav zřizování a hlavičku Azure-AsyncOperation. Pokud chcete zjistit průběh operace, zavolejte operaci GET na adrese URL v poli hlavičky Azure-AsyncOperation. Další informace: Další informace o asynchronních operacích najdete v tématu https://msdn.microsoft.com/en-us/library/mt742920.aspx.

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

Definice

Name Description
AssetItem

Informace o prostředku přidruženém k webové službě

AssetLocation

Popisuje umístění přístupu k prostředku webové služby.

AssetType

Typ prostředku.

ColumnFormat

Další informace o formátu datového typu

ColumnSpecification

Schéma Swaggeru 2.0 pro sloupec v tabulce dat představující vstup nebo výstup webové služby. Viz specifikace Swaggeru: http://swagger.io/specification/

ColumnType

Datový typ sloupce.

CommitmentPlan

Informace o plánu závazku strojového učení přidruženého k webové službě

DiagnosticsConfiguration

Nastavení diagnostiky pro webovou službu Azure ML

DiagnosticsLevel

Určuje podrobnost výstupu diagnostiky. Platné hodnoty jsou: Žádné – zakáže trasování; Chyba – shromažďuje pouze trasování chyb (stderr); All – shromažďuje všechna trasování (stdout a stderr).

ExampleRequest

Ukázková vstupní data pro vstupy služby

GraphEdge

Definuje hranu v grafu webové služby.

GraphNode

Určuje uzel v grafu webové služby. Uzlem může být vstupní, výstupní nebo assetový uzel, takže se v daném okamžiku naplní jenom jedna z odpovídajících vlastností ID.

GraphPackage

Definuje graf modulů, které tvoří řešení strojového učení.

GraphParameter

Definuje globální parametr v grafu.

GraphParameterLink

Asociační odkaz pro globální parametr grafu k uzlu v grafu

InputPort

Vstupní port majetku

InputPortType

Datový typ portu.

MachineLearningWorkspace

Informace o pracovním prostoru strojového učení obsahujícího experiment, který je zdrojem pro webovou službu.

ModeValueInfo

Definice vnořeného parametru

ModuleAssetParameter

Definice parametru pro prostředek modulu

OutputPort

Výstupní port prostředku

OutputPortType

Datový typ portu.

ParameterType

Typ parametru grafu.

ProvisioningState

Jen pro čtení: Stav zřizování webové služby. Platné hodnoty jsou Neznámé, Zřizování, Úspěšné a Neúspěšné.

RealtimeConfiguration

Obsahuje dostupné možnosti konfigurace koncového bodu webové služby Azure ML.

ServiceInputOutputSpecification

Schéma swaggeru 2.0 popisující vstupy nebo výstupy služby Viz specifikace Swaggeru: http://swagger.io/specification/

StorageAccount

Přístup k informacím pro účet úložiště

TableSpecification

Schéma swaggeru 2.0 popisující jeden vstup nebo výstup služby. Viz specifikace Swaggeru: http://swagger.io/specification/

WebService

Instance prostředku webové služby Azure ML

WebServiceKeys

Přístupové klíče pro volání webové služby.

WebServicePropertiesForGraph

Vlastnosti specifické pro webovou službu založenou na grafech.

AssetItem

Informace o prostředku přidruženém k webové službě

Name Typ Description
id

string

ID prostředku.

inputPorts

<string,  InputPort>

Informace o vstupních portech prostředku

locationInfo

AssetLocation

Informace o přístupu k prostředku.

metadata

object

Pokud se jedná o vlastní modul, bude obsahovat metadata modulu.

name

string

Popisný název prostředku.

outputPorts

<string,  OutputPort>

Informace o výstupních portech prostředku

parameters

ModuleAssetParameter[]

Pokud se jedná o vlastní modul, bude obsahovat parametry modulu.

type

AssetType

Typ prostředku.

AssetLocation

Popisuje umístění přístupu k prostředku webové služby.

Name Typ Description
credentials

string

Přístup k přihlašovacím údajům pro prostředek, pokud je to možné (např. prostředek zadaný účtem úložiště připojovací řetězec + identifikátor URI objektu blob)

uri

string

Identifikátor URI, ze kterého je prostředek přístupný (např. aml://abc pro systémové prostředky nebo https://xyz pro uživatelské prostředky

AssetType

Typ prostředku.

Name Typ Description
Module

string

Resource

string

ColumnFormat

Další informace o formátu datového typu

Name Typ 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 Swaggeru 2.0 pro sloupec v tabulce dat představující vstup nebo výstup webové služby. Viz specifikace Swaggeru: http://swagger.io/specification/

Name Typ Description
enum

object[]

Pokud je datový typ kategorický, zobrazí se seznam přijatých kategorií.

format

ColumnFormat

Další informace o formátu datového typu

type

ColumnType

Datový typ sloupce.

x-ms-isnullable

boolean

Příznak označující, jestli typ podporuje hodnoty null, nebo ne.

x-ms-isordered

boolean

Příznak označující, jestli jsou kategorie považovány za uspořádanou sadu, nebo ne, pokud se jedná o sloupec kategorií.

ColumnType

Datový typ sloupce.

Name Typ Description
Boolean

string

Integer

string

Number

string

String

string

CommitmentPlan

Informace o plánu závazku strojového učení přidruženého k webové službě

Name Typ Description
id

string

Určuje ID azure Resource Manager plánu závazku přidruženého k webové službě.

DiagnosticsConfiguration

Nastavení diagnostiky pro webovou službu Azure ML

Name Typ Description
expiry

string

Určuje datum a čas ukončení protokolování. Pokud je hodnota null, není kolekce diagnostiky časově omezená.

level

DiagnosticsLevel

Určuje podrobnost výstupu diagnostiky. Platné hodnoty jsou: Žádné – zakáže trasování; Chyba – shromažďuje pouze trasování chyb (stderr); All – shromažďuje všechna trasování (stdout a stderr).

DiagnosticsLevel

Určuje podrobnost výstupu diagnostiky. Platné hodnoty jsou: Žádné – zakáže trasování; Chyba – shromažďuje pouze trasování chyb (stderr); All – shromažďuje všechna trasování (stdout a stderr).

Name Typ Description
All

string

Error

string

None

string

ExampleRequest

Ukázková vstupní data pro vstupy služby

Name Typ Description
globalParameters

object

Ukázková vstupní data pro globální parametry webové služby

inputs

object

Ukázková vstupní data pro vstupy webové služby zadané jako vstupní název pro ukázkovou mapu matice vstupních hodnot.

GraphEdge

Definuje hranu v grafu webové služby.

Name Typ Description
sourceNodeId

string

Identifikátor uzlu zdrojového grafu

sourcePortId

string

Identifikátor portu zdrojového uzlu, ze kterého se edge připojuje.

targetNodeId

string

Identifikátor cílového uzlu grafu

targetPortId

string

Identifikátor portu cílového uzlu, ke kterému se edge připojuje.

GraphNode

Určuje uzel v grafu webové služby. Uzlem může být vstupní, výstupní nebo assetový uzel, takže se v daném okamžiku naplní jenom jedna z odpovídajících vlastností ID.

Name Typ Description
assetId

string

ID prostředku reprezentované tímto uzlem.

inputId

string

ID vstupního prvku reprezentovaný tímto uzlem.

outputId

string

ID výstupního prvku reprezentovaný tímto uzlem.

parameters

object

Pokud je to možné, parametry uzlu. Globální parametry grafu se namapují na tyto parametry s hodnotami nastavenými za běhu.

GraphPackage

Definuje graf modulů, které tvoří řešení strojového učení.

Name Typ Description
edges

GraphEdge[]

Seznam hran, které tvoří graf

graphParameters

<string,  GraphParameter>

Kolekce globálních parametrů pro graf, která je přiřazena jako globální název parametru mapování GraphParameter. Každý zde zadaný parametr má shodu 1:1 s mapou hodnot globálních parametrů deklarovaných na úrovni WebServiceProperties.

nodes

<string,  GraphNode>

Sada uzlů, které tvoří graf, poskytnuté jako nodeId pro mapování GraphNode

GraphParameter

Definuje globální parametr v grafu.

Name Typ Description
description

string

Popis tohoto parametru grafu

links

GraphParameterLink[]

Přidružení odkazuje pro tento parametr na uzly v grafu.

type

ParameterType

Typ parametru grafu.

Asociační odkaz pro globální parametr grafu k uzlu v grafu

Name Typ Description
nodeId

string

Identifikátor uzlu grafu

parameterKey

string

Identifikátor parametru uzlu, na který se globální parametr mapuje.

InputPort

Vstupní port majetku

Name Typ Výchozí hodnota Description
type

InputPortType

Dataset

Datový typ portu.

InputPortType

Datový typ portu.

Name Typ Description
Dataset

string

MachineLearningWorkspace

Informace o pracovním prostoru strojového učení obsahujícího experiment, který je zdrojem pro webovou službu.

Name Typ Description
id

string

Určuje ID pracovního prostoru strojového učení přidruženého k webové službě.

ModeValueInfo

Definice vnořeného parametru

Name Typ Description
interfaceString

string

Název řetězce rozhraní pro vnořený parametr.

parameters

ModuleAssetParameter[]

Definice parametru.

ModuleAssetParameter

Definice parametru pro prostředek modulu

Name Typ Description
modeValuesInfo

<string,  ModeValueInfo>

Definice vnořených parametrů rozhraní, pokud se jedná o komplexní parametr modulu.

name

string

Názvy parametrů.

parameterType

string

Typ parametru.

OutputPort

Výstupní port prostředku

Name Typ Výchozí hodnota Description
type

OutputPortType

Dataset

Datový typ portu.

OutputPortType

Datový typ portu.

Name Typ Description
Dataset

string

ParameterType

Typ parametru grafu.

Name Typ 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

Jen pro čtení: Stav zřizování webové služby. Platné hodnoty jsou Neznámé, Zřizování, Úspěšné a Neúspěšné.

Name Typ Description
Failed

string

Provisioning

string

Succeeded

string

Unknown

string

RealtimeConfiguration

Obsahuje dostupné možnosti konfigurace koncového bodu webové služby Azure ML.

Name Typ Description
maxConcurrentCalls

integer

Určuje maximální počet souběžných volání, která lze provést do webové služby. Minimální hodnota: 4, Maximální hodnota: 200.

ServiceInputOutputSpecification

Schéma swaggeru 2.0 popisující vstupy nebo výstupy služby Viz specifikace Swaggeru: http://swagger.io/specification/

Name Typ Výchozí hodnota Description
description

string

Popis schématu Swagger.

properties

<string,  TableSpecification>

Určuje kolekci, která obsahuje schéma sloupců pro každý vstup nebo výstup webové služby. Další informace najdete ve specifikaci Swaggeru.

title

string

Název schématu Swagger.

type

string

object

Typ entity popsané v swaggeru. Vždy "objekt".

StorageAccount

Přístup k informacím pro účet úložiště

Name Typ Description
key

string

Určuje klíč použitý pro přístup k účtu úložiště.

name

string

Určuje název účtu úložiště.

TableSpecification

Schéma swaggeru 2.0 popisující jeden vstup nebo výstup služby. Viz specifikace Swaggeru: http://swagger.io/specification/

Name Typ Výchozí hodnota Description
description

string

Popis schématu Swagger.

format

string

Formát, pokud "type" není "object".

properties

<string,  ColumnSpecification>

Sada sloupců v tabulce dat.

title

string

Název schématu Swagger.

type

string

object

Typ entity popsané v swaggeru.

WebService

Instance prostředku webové služby Azure ML

Name Typ Description
id

string

Určuje ID prostředku.

location

string

Určuje umístění prostředku.

name

string

Určuje název prostředku.

properties WebServiceProperties:

WebServicePropertiesForGraph

Obsahuje datovou část vlastnosti, která popisuje webovou službu.

tags

object

Obsahuje značky prostředků definované jako páry klíč/hodnota.

type

string

Určuje typ prostředku.

WebServiceKeys

Přístupové klíče pro volání webové služby.

Name Typ Description
primary

string

Primární přístupový klíč.

secondary

string

Sekundární přístupový klíč.

WebServicePropertiesForGraph

Vlastnosti specifické pro webovou službu založenou na grafech.

Name Typ Description
assets

<string,  AssetItem>

Obsahuje uživatelem definované vlastnosti popisující prostředky webové služby. Vlastnosti jsou vyjádřeny jako páry klíč/hodnota.

commitmentPlan

CommitmentPlan

Obsahuje plán závazku přidružený k této webové službě. Nastaví se při vytváření. Po nastavení nelze tuto hodnotu změnit. Poznámka: Plán závazku se nevrátí z volání operací GET.

createdOn

string

Jen pro čtení: Datum a čas vytvoření webové služby.

description

string

Popis webové služby.

diagnostics

DiagnosticsConfiguration

Nastavení, která řídí shromažďování trasování diagnostiky pro webovou službu.

exampleRequest

ExampleRequest

Definuje ukázková vstupní data pro jeden nebo více vstupů služby.

exposeSampleData

boolean

Při nastavení na hodnotu true jsou ukázková data zahrnuta do definice swaggeru webové služby. Výchozí hodnotou je hodnota true.

input

ServiceInputOutputSpecification

Obsahuje schéma Swagger 2.0 popisující jeden nebo více vstupů webové služby. Další informace najdete ve specifikaci Swaggeru.

keys

WebServiceKeys

Obsahuje zřizovací klíče webové služby. Pokud nezadáte zřizovací klíče, vygeneruje je za vás systém Azure Machine Learning. Poznámka: Klíče se nevrácejí z volání operací GET.

machineLearningWorkspace

MachineLearningWorkspace

Určuje pracovní prostor Machine Learning obsahující experiment, který je zdrojem webové služby.

modifiedOn

string

Jen pro čtení: Datum a čas, kdy byla webová služba naposledy změněna.

output

ServiceInputOutputSpecification

Obsahuje schéma Swagger 2.0 popisující jeden nebo více výstupů webové služby. Další informace najdete ve specifikaci Swaggeru.

package

GraphPackage

Definice balíčku grafu, který tvoří tuto webovou službu.

packageType string:

Graph

Určuje typ balíčku. Platné hodnoty jsou Graph (Určuje webovou službu publikovanou prostřednictvím nástroje Machine Learning Studio) a Code (určuje webovou službu publikovanou pomocí kódu, jako je Python). Poznámka: Kód se v tuto chvíli nepodporuje.

parameters

object

Sada hodnot globálních parametrů definovaných pro webovou službu zadaná jako název globálního parametru na výchozí mapování hodnot. Pokud není zadána žádná výchozí hodnota, parametr se považuje za povinný.

provisioningState

ProvisioningState

Jen pro čtení: Stav zřizování webové služby. Platné hodnoty jsou Neznámé, Zřizování, Úspěšné a Neúspěšné.

readOnly

boolean

Pokud je nastavená hodnota true, znamená to, že webová služba je jen pro čtení a už ji nelze aktualizovat ani opravit, pouze odebrat. Výchozí hodnota je false. Poznámka: Jakmile nastavíte hodnotu true, nemůžete změnit její hodnotu.

realtimeConfiguration

RealtimeConfiguration

Obsahuje nastavení konfigurace pro koncový bod webové služby.

storageAccount

StorageAccount

Určuje účet úložiště, který Azure Machine Learning používá k ukládání informací o webové službě. Z volání operací GET se vrátí jenom název účtu úložiště. Při aktualizaci informací o účtu úložiště musíte zajistit, aby v novém účtu úložiště byly k dispozici všechny potřebné prostředky, jinak volání webové služby selže.

swaggerLocation

string

Jen pro čtení: Obsahuje identifikátor URI specifikace Swagger přidružené k této webové službě.

title

string

Název webové služby.