Backend - List By Service
列出指定之服務實例中的後端集合。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends?api-version=2022-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends?$filter={$filter}&$top={$top}&$skip={$skip}&api-version=2022-08-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
資源群組的名稱。 名稱不區分大小寫。 |
service
|
path | True |
string |
API 管理 服務的名稱。 Regex pattern: |
subscription
|
path | True |
string |
目標訂用帳戶的標識碼。 |
api-version
|
query | True |
string |
用於此作業的 API 版本。 |
$filter
|
query |
string |
|欄位 |使用量 |支持的運算子 |支援的函式 | |
|
$skip
|
query |
integer int32 |
要略過的記錄數目。 |
|
$top
|
query |
integer int32 |
要傳回的記錄數目。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
列出後端實體的集合。 |
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名稱 | Description |
---|---|
user_impersonation | 模擬您的用戶帳戶 |
範例
ApiManagementListBackends
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/backends?api-version=2022-08-01
Sample Response
{
"value": [
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/backends/proxybackend",
"type": "Microsoft.ApiManagement/service/backends",
"name": "proxybackend",
"properties": {
"description": "description5308",
"url": "https://backendname2644/",
"protocol": "http",
"credentials": {
"query": {
"sv": [
"xx",
"bb",
"cc"
]
},
"header": {
"x-my-1": [
"val1",
"val2"
]
},
"authorization": {
"scheme": "Basic",
"parameter": "opensesma"
}
},
"proxy": {
"url": "http://192.168.1.1:8080",
"username": "Contoso\\admin",
"password": "<password>"
},
"tls": {
"validateCertificateChain": false,
"validateCertificateName": false
}
}
},
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/backends/sfbackend",
"type": "Microsoft.ApiManagement/service/backends",
"name": "sfbackend",
"properties": {
"description": "Service Fabric Test App 1",
"url": "fabric:/mytestapp/mytestservice",
"protocol": "http",
"properties": {
"serviceFabricCluster": {
"managementEndpoints": [
"https://somecluster.com"
],
"clientCertificateId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
"serverX509Names": [
{
"name": "ServerCommonName1",
"issuerCertificateThumbprint": "IssuerCertificateThumbprint1"
}
],
"maxPartitionResolutionRetries": 5
}
}
}
}
],
"count": 2,
"nextLink": ""
}
定義
名稱 | Description |
---|---|
Backend |
授權標頭資訊。 |
Backend |
分頁後端清單表示法。 |
Backend |
後端詳細數據。 |
Backend |
用來連線到後端的認證詳細數據。 |
Backend |
後端類型特定的屬性。 |
Backend |
後端通訊協定。 |
Backend |
在要求後端中使用的後端 WebProxy 伺服器詳細數據。 |
Backend |
Service Fabric 類型後端的屬性。 |
Backend |
控制 TLS 憑證驗證的屬性。 |
Error |
錯誤欄位合約。 |
Error |
錯誤回應。 |
X509Certificate |
伺服器 X509Names 的屬性。 |
BackendAuthorizationHeaderCredentials
授權標頭資訊。
名稱 | 類型 | Description |
---|---|---|
parameter |
string |
驗證參數值。 |
scheme |
string |
驗證配置名稱。 |
BackendCollection
分頁後端清單表示法。
名稱 | 類型 | Description |
---|---|---|
count |
integer |
所有頁面的記錄計數總數。 |
nextLink |
string |
如果有的話,下一頁連結。 |
value |
後端值。 |
BackendContract
後端詳細數據。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源的完整資源識別碼。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
資源的名稱 |
properties.credentials |
後端認證合約屬性 |
|
properties.description |
string |
後端描述。 |
properties.properties |
後端屬性合約 |
|
properties.protocol |
後端通訊協定。 |
|
properties.proxy |
後端閘道合約屬性 |
|
properties.resourceId |
string |
外部系統中資源的管理 URI。 此 URL 可以是 Logic Apps、函式應用程式或 API 應用程式的 Arm 資源識別碼。 |
properties.title |
string |
後端標題。 |
properties.tls |
後端 TLS 屬性 |
|
properties.url |
string |
後端的運行時間 URL。 |
type |
string |
資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts” |
BackendCredentialsContract
用來連線到後端的認證詳細數據。
名稱 | 類型 | Description |
---|---|---|
authorization |
授權標頭驗證 |
|
certificate |
string[] |
用戶端憑證指紋的清單。 如果提供 certificatesIds,將會忽略。 |
certificateIds |
string[] |
用戶端憑證標識碼的清單。 |
header |
object |
標頭參數描述。 |
query |
object |
查詢參數描述。 |
BackendProperties
後端類型特定的屬性。
名稱 | 類型 | Description |
---|---|---|
serviceFabricCluster |
後端 Service Fabric 叢集屬性 |
BackendProtocol
後端通訊協定。
名稱 | 類型 | Description |
---|---|---|
http |
string |
後端是 RESTful 服務。 |
soap |
string |
後端是SOAP服務。 |
BackendProxyContract
在要求後端中使用的後端 WebProxy 伺服器詳細數據。
名稱 | 類型 | Description |
---|---|---|
password |
string |
線上到 WebProxy 伺服器的密碼 |
url |
string |
WebProxy Server AbsoluteUri 屬性,其中包含儲存在 Uri 實例中的整個 URI,包括所有片段和查詢字串。 |
username |
string |
線上到 WebProxy 伺服器的使用者名稱 |
BackendServiceFabricClusterProperties
Service Fabric 類型後端的屬性。
名稱 | 類型 | Description |
---|---|---|
clientCertificateId |
string |
管理端點的客戶端憑證標識碼。 |
clientCertificatethumbprint |
string |
管理端點的客戶端憑證指紋。 如果提供 certificatesIds,將會忽略 |
managementEndpoints |
string[] |
叢集管理端點。 |
maxPartitionResolutionRetries |
integer |
嘗試解析數據分割時重試次數上限。 |
serverCertificateThumbprints |
string[] |
叢集管理服務用於 TLS 通訊的憑證指紋 |
serverX509Names |
伺服器 X509 憑證名稱集合 |
BackendTlsProperties
控制 TLS 憑證驗證的屬性。
名稱 | 類型 | 預設值 | Description |
---|---|---|---|
validateCertificateChain |
boolean |
True |
旗標,指出是否應該在此後端主機使用自我簽署憑證時完成SSL憑證鏈結驗證。 |
validateCertificateName |
boolean |
True |
旗標,指出是否應該在此後端主機使用自我簽署憑證時完成SSL憑證名稱驗證。 |
ErrorFieldContract
錯誤欄位合約。
名稱 | 類型 | Description |
---|---|---|
code |
string |
屬性層級錯誤碼。 |
message |
string |
人類可讀取的屬性層級錯誤表示法。 |
target |
string |
屬性名稱。 |
ErrorResponse
錯誤回應。
名稱 | 類型 | Description |
---|---|---|
error.code |
string |
服務定義的錯誤碼。 此代碼會作為回應中指定之 HTTP 錯誤碼的子狀態。 |
error.details |
要求中傳送無效欄位的清單,以防發生驗證錯誤。 |
|
error.message |
string |
人類可閱讀的錯誤表示法。 |
X509CertificateName
伺服器 X509Names 的屬性。
名稱 | 類型 | Description |
---|---|---|
issuerCertificateThumbprint |
string |
憑證簽發者的指紋。 |
name |
string |
憑證的一般名稱。 |