Web Services - Get
取得訂用帳戶、資源群組和名稱所指定的 Web 服務定義。 請注意,此呼叫不會傳回記憶體認證和 Web 服務密鑰。 若要取得 Web 服務存取金鑰,請呼叫清單金鑰。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearning/webServices/{webServiceName}?api-version=2016-05-01-preview
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Web 服務所在的資源組名。 |
subscription
|
path | True |
string |
Azure 訂用帳戶識別碼。 |
web
|
path | True |
string |
Web 服務的名稱。 |
api-version
|
query | True |
string |
要使用的 Microsoft.MachineLearning 資源提供者 API 版本。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
成功。 回應包括布建狀態和 Azure-AsyncOperation 標頭。 若要取得作業的進度,請在 [Azure-AsyncOperation 標頭] 字段中的 URL 上呼叫 GET 作業。 如需詳細資訊如需異步操作的詳細資訊,請參閱 https://msdn.microsoft.com/en-us/library/mt742920.aspx。 Media Types: "application/json", "text/json" |
定義
名稱 | Description |
---|---|
Asset |
與 Web 服務相關聯的資產相關信息。 |
Asset |
描述 Web 服務資產的存取位置。 |
Asset |
資產的類型。 |
Column |
數據類型的其他格式資訊。 |
Column |
代表 Web 服務輸入或輸出之數據表內數據行的 Swagger 2.0 架構。 請參閱 Swagger 規格: http://swagger.io/specification/ |
Column |
資料行的資料類型。 |
Commitment |
與 Web 服務相關聯的機器學習承諾方案相關信息。 |
Diagnostics |
Azure ML Web 服務的診斷設定。 |
Diagnostics |
指定診斷輸出的詳細資訊。 有效值為:無 - 停用追蹤;錯誤 - 只收集 stderr) 追蹤 (錯誤;All - 收集 stdout 和 stderr) (的所有追蹤。 |
Example |
服務輸入 () 的範例輸入數據。 |
Graph |
定義 Web 服務圖形內的邊緣。 |
Graph |
指定 Web 服務圖形中的節點。 節點可以是輸入、輸出或資產節點,因此在任何指定時間只會填入其中一個對應的標識碼屬性。 |
Graph |
定義構成機器學習解決方案的模組圖表。 |
Graph |
定義圖形中的全局參數。 |
Graph |
圖形全域參數與圖形中節點的關聯連結。 |
Input |
資產輸入埠 |
Input |
埠數據類型。 |
Machine |
包含 Web 服務來源實驗的機器學習工作區相關信息。 |
Mode |
巢狀參數定義。 |
Module |
模組資產的參數定義。 |
Output |
資產輸出埠 |
Output |
埠數據類型。 |
Parameter |
Graph 參數的類型。 |
Provisioning |
只讀:Web 服務的布建狀態。 有效值為 Unknown、Provisioning、Succeeded 和 Failed。 |
Realtime |
保留 Azure ML Web 服務端點的可用組態選項。 |
Service |
描述服務輸入或輸出的 swagger 2.0 架構。 請參閱 Swagger 規格: http://swagger.io/specification/ |
Storage |
存取記憶體帳戶的資訊。 |
Table |
描述單一服務輸入或輸出的 swagger 2.0 架構。 請參閱 Swagger 規格: http://swagger.io/specification/ |
Web |
Azure ML Web 服務資源的實例。 |
Web |
Web 服務呼叫的存取金鑰。 |
Web |
圖形型 Web 服務特有的屬性。 |
AssetItem
與 Web 服務相關聯的資產相關信息。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資產的標識碼。 |
inputPorts |
<string,
Input |
資產輸入埠的相關信息。 |
locationInfo |
存取資產的資訊。 |
|
metadata |
object |
如果資產是自定義模組,這會保存模組的元數據。 |
name |
string |
資產的易記名稱。 |
outputPorts |
<string,
Output |
資產輸出埠的相關信息。 |
parameters |
如果資產是自定義模組,這會保存模組的參數。 |
|
type |
資產的類型。 |
AssetLocation
描述 Web 服務資產的存取位置。
名稱 | 類型 | Description |
---|---|---|
credentials |
string |
如果適用 (,請存取資產的認證,例如記憶體帳戶所指定的資產 連接字串 + Blob URI) |
uri |
string |
可從存取資產的 URI, (例如系統資產或 https://xyz 用戶資產的 aml://abc |
AssetType
資產的類型。
名稱 | 類型 | Description |
---|---|---|
Module |
string |
|
Resource |
string |
ColumnFormat
數據類型的其他格式資訊。
名稱 | 類型 | 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
代表 Web 服務輸入或輸出之數據表內數據行的 Swagger 2.0 架構。 請參閱 Swagger 規格: http://swagger.io/specification/
名稱 | 類型 | Description |
---|---|---|
enum |
object[] |
如果數據類型是類別目錄,這會提供已接受的類別清單。 |
format |
數據類型的其他格式資訊。 |
|
type |
資料行的資料類型。 |
|
x-ms-isnullable |
boolean |
旗標,指出類型是否支援 Null 值。 |
x-ms-isordered |
boolean |
旗標,指出類別是否被視為已排序的集合,如果這是類別數據行。 |
ColumnType
資料行的資料類型。
名稱 | 類型 | Description |
---|---|---|
Boolean |
string |
|
Integer |
string |
|
Number |
string |
|
String |
string |
CommitmentPlan
與 Web 服務相關聯的機器學習承諾方案相關信息。
名稱 | 類型 | Description |
---|---|---|
id |
string |
指定與 Web 服務相關聯之承諾用量方案的 Azure Resource Manager 識別碼。 |
DiagnosticsConfiguration
Azure ML Web 服務的診斷設定。
名稱 | 類型 | Description |
---|---|---|
expiry |
string |
指定記錄停止的日期和時間。 如果為 null,則診斷收集不會有時間限制。 |
level |
指定診斷輸出的詳細資訊。 有效值為:None - 停用追蹤;錯誤 - 只收集 (stderr) 追蹤的錯誤;All - 收集 stdout 和 stderr) 的所有追蹤 (。 |
DiagnosticsLevel
指定診斷輸出的詳細資訊。 有效值為:無 - 停用追蹤;錯誤 - 只收集 stderr) 追蹤 (錯誤;All - 收集 stdout 和 stderr) (的所有追蹤。
名稱 | 類型 | Description |
---|---|---|
All |
string |
|
Error |
string |
|
None |
string |
ExampleRequest
服務輸入 () 的範例輸入數據。
名稱 | 類型 | Description |
---|---|---|
globalParameters |
object |
Web 服務的全局參數範例輸入數據 |
inputs |
object |
Web 服務的輸入範例輸入數據 () 做為輸入名稱來取樣輸入值矩陣對應。 |
GraphEdge
定義 Web 服務圖形內的邊緣。
名稱 | 類型 | Description |
---|---|---|
sourceNodeId |
string |
來源圖形節點的標識碼。 |
sourcePortId |
string |
邊緣所連接之來源節點埠的標識碼。 |
targetNodeId |
string |
目的地圖形節點的標識碼。 |
targetPortId |
string |
邊緣所連線目的地節點埠的標識碼。 |
GraphNode
指定 Web 服務圖形中的節點。 節點可以是輸入、輸出或資產節點,因此在任何指定時間只會填入其中一個對應的標識碼屬性。
名稱 | 類型 | Description |
---|---|---|
assetId |
string |
這個節點所代表之資產的標識碼。 |
inputId |
string |
這個節點所表示之輸入專案的標識碼。 |
outputId |
string |
這個節點所表示之輸出項目的標識碼。 |
parameters |
object |
如果適用,節點的參數。 全域圖形參數會對應至這些參數,並在運行時間設定值。 |
GraphPackage
定義構成機器學習解決方案的模組圖表。
名稱 | 類型 | Description |
---|---|---|
edges |
構成圖形的邊緣清單。 |
|
graphParameters |
<string,
Graph |
圖形的全局參數集合,指定為 GraphParameter 地圖的全局參數名稱。 這裡的每個參數都有 1:1 的相符專案,與 WebServiceProperties 層級宣告的全域參數值對應。 |
nodes |
<string,
Graph |
組成圖形的節點集,以 nodeId 提供給 GraphNode 對應 |
GraphParameter
定義圖形中的全局參數。
名稱 | 類型 | Description |
---|---|---|
description |
string |
此圖形參數的描述。 |
links |
此參數與圖形中節點的關聯連結。 |
|
type |
Graph 參數的類型。 |
GraphParameterLink
圖形全域參數與圖形中節點的關聯連結。
名稱 | 類型 | Description |
---|---|---|
nodeId |
string |
圖形節點的標識碼 |
parameterKey |
string |
全域參數所對應之節點參數的標識碼。 |
InputPort
資產輸入埠
名稱 | 類型 | 預設值 | Description |
---|---|---|---|
type | Dataset |
埠數據類型。 |
InputPortType
埠數據類型。
名稱 | 類型 | Description |
---|---|---|
Dataset |
string |
MachineLearningWorkspace
包含 Web 服務來源實驗的機器學習工作區相關信息。
名稱 | 類型 | Description |
---|---|---|
id |
string |
指定與 Web 服務相關聯之機器學習工作區的工作區標識碼 |
ModeValueInfo
巢狀參數定義。
名稱 | 類型 | Description |
---|---|---|
interfaceString |
string |
巢狀參數的介面字串名稱。 |
parameters |
參數的定義。 |
ModuleAssetParameter
模組資產的參數定義。
名稱 | 類型 | Description |
---|---|---|
modeValuesInfo |
<string,
Mode |
如果這是複雜的模塊參數,則為巢狀介面參數的定義。 |
name |
string |
參數名稱。 |
parameterType |
string |
參數類型。 |
OutputPort
資產輸出埠
名稱 | 類型 | 預設值 | Description |
---|---|---|---|
type | Dataset |
埠數據類型。 |
OutputPortType
埠數據類型。
名稱 | 類型 | Description |
---|---|---|
Dataset |
string |
ParameterType
Graph 參數的類型。
名稱 | 類型 | 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
只讀:Web 服務的布建狀態。 有效值為 Unknown、Provisioning、Succeeded 和 Failed。
名稱 | 類型 | Description |
---|---|---|
Failed |
string |
|
Provisioning |
string |
|
Succeeded |
string |
|
Unknown |
string |
RealtimeConfiguration
保留 Azure ML Web 服務端點的可用組態選項。
名稱 | 類型 | Description |
---|---|---|
maxConcurrentCalls |
integer |
指定可以對 Web 服務進行的最大並行呼叫。 最小值:4,最大值:200。 |
ServiceInputOutputSpecification
描述服務輸入或輸出的 swagger 2.0 架構。 請參閱 Swagger 規格: http://swagger.io/specification/
名稱 | 類型 | 預設值 | Description |
---|---|---|---|
description |
string |
Swagger 架構的描述。 |
|
properties |
<string,
Table |
指定集合,其中包含 Web 服務之每個輸入或輸出的數據行架構。 如需詳細資訊,請參閱 Swagger 規格。 |
|
title |
string |
Swagger 架構的標題。 |
|
type |
string |
object |
swagger 中所述的實體類型。 一律為 『object』。 |
StorageAccount
存取記憶體帳戶的資訊。
名稱 | 類型 | Description |
---|---|---|
key |
string |
指定用來存取記憶體帳戶的金鑰。 |
name |
string |
指定儲存體帳戶的名稱。 |
TableSpecification
描述單一服務輸入或輸出的 swagger 2.0 架構。 請參閱 Swagger 規格: http://swagger.io/specification/
名稱 | 類型 | 預設值 | Description |
---|---|---|---|
description |
string |
Swagger 架構描述。 |
|
format |
string |
格式,如果 'type' 不是 'object' |
|
properties |
<string,
Column |
數據表內的數據行集合。 |
|
title |
string |
Swagger 架構標題。 |
|
type |
string |
object |
swagger 中所述之實體的類型。 |
WebService
Azure ML Web 服務資源的實例。
名稱 | 類型 | Description |
---|---|---|
id |
string |
指定資源識別碼。 |
location |
string |
指定資源的位置。 |
name |
string |
指定資源的名稱。 |
properties | WebServiceProperties: |
包含描述 Web 服務的屬性承載。 |
tags |
object |
包含定義為索引鍵/值組的資源標記。 |
type |
string |
指定資源的類型。 |
WebServiceKeys
Web 服務呼叫的存取金鑰。
名稱 | 類型 | Description |
---|---|---|
primary |
string |
主要存取金鑰。 |
secondary |
string |
次要存取金鑰。 |
WebServicePropertiesForGraph
圖形型 Web 服務特有的屬性。
名稱 | 類型 | Description |
---|---|---|
assets |
<string,
Asset |
包含描述 Web 服務資產的使用者定義屬性。 屬性會以索引鍵/值組表示。 |
commitmentPlan |
包含與此 Web 服務相關聯的承諾方案。 在建立時設定。 設定之後,就無法變更此值。 注意:承諾用量方案不會從對 GET 作業的呼叫傳回。 |
|
createdOn |
string |
唯讀:建立 Web 服務的日期和時間。 |
description |
string |
Web 服務的描述。 |
diagnostics |
控制 Web 服務的診斷追蹤集合的設定。 |
|
exampleRequest |
定義一或多個服務輸入的範例輸入數據。 |
|
exposeSampleData |
boolean |
當設定為 true 時,範例數據會包含在 Web 服務的 Swagger 定義中。 預設值為 true。 |
input |
包含 Swagger 2.0 架構,描述一或多個 Web 服務的輸入。 如需詳細資訊,請參閱 Swagger 規格。 |
|
keys |
包含 Web 服務佈建金鑰。 如果您未指定佈建密鑰,Azure Machine Learning 系統會為您產生這些密鑰。 注意:金鑰不會從對 GET 作業的呼叫傳回。 |
|
machineLearningWorkspace |
指定 Machine Learning 工作區,其中包含 Web 服務的來源實驗。 |
|
modifiedOn |
string |
唯讀:上次修改 Web 服務的日期和時間。 |
output |
包含 Swagger 2.0 架構,描述一或多個 Web 服務的輸出。 如需詳細資訊,請參閱 Swagger 規格。 |
|
package |
組成此 Web 服務的圖形套件定義。 |
|
packageType |
string:
Graph |
指定封裝類型。 有效值為 Graph (指定透過 Machine Learning Studio) 和程式碼 (指定使用 Python) 之類的程式代碼發佈的 Web 服務。 注意:目前不支持程序代碼。 |
parameters |
object |
為 Web 服務定義的全域參數值集合,指定為預設值對應的全域參數名稱。 如果未指定預設值,則會將 參數視為必要。 |
provisioningState |
只讀:Web 服務的布建狀態。 有效值為 Unknown、Provisioning、Succeeded 和 Failed。 |
|
readOnly |
boolean |
當設定為 true 時,表示 Web 服務是唯讀的,而且無法再更新或修補,只會移除。 默認值為 false。 注意:設定為 true 之後,就無法變更其值。 |
realtimeConfiguration |
包含 Web 服務端點的組態設定。 |
|
storageAccount |
指定 Azure Machine Learning 用來儲存 Web 服務相關信息的記憶體帳戶。 只有記憶體帳戶的名稱會從對 GET 作業的呼叫傳回。 更新記憶體帳戶資訊時,您必須確定新的記憶體帳戶中有所有必要的資產可用,或對 Web 服務的呼叫將會失敗。 |
|
swaggerLocation |
string |
只讀:包含與此 Web 服務相關聯的 Swagger 規格 URI。 |
title |
string |
Web 服務的標題。 |