Connections - Delete Connection
刪除指定的連線。
Note
Fabric 租戶管理員連線管理目前處於預覽階段(了解更多)。
Permissions
呼叫端必須是網狀架構系統管理員,或使用服務主體進行驗證。
必要的委派範圍
Tenant.ReadWrite.All
Limitations
None.
Microsoft Entra 支援的身份識別
此 API 支援本節中列出的Microsoft 身分識別。
| Identity | Support |
|---|---|
| 使用者 | Yes |
| 服務主體 和 受控識別 | Yes |
Interface
DELETE https://api.fabric.microsoft.com/v1/admin/connections/{connectionId}
URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
connection
|
path | True |
string (uuid) |
連線ID。 |
回覆
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
OK. 作業成功。 |
|
| 429 Too Many Requests |
服務費率上限被超標。 伺服器會回傳一個 標題 Retry-After: integer |
|
| Other Status Codes |
常見的錯誤碼:
|
範例
Delete connection as admin example
範例要求
DELETE https://api.fabric.microsoft.com/v1/admin/connections/536f7c95-1b4e-4d3a-8e7f-9c2d5a6b8e01
範例回覆
定義
| 名稱 | Description |
|---|---|
|
Error |
一個結構化參數,提供關於錯誤的額外機器可讀上下文。 |
|
Error |
錯誤相關的資源詳細資料物件。 |
|
Error |
錯誤回應。 |
|
Error |
錯誤回應的細節。 |
ErrorParameter
一個結構化參數,提供關於錯誤的額外機器可讀上下文。
| 名稱 | 類型 | Description |
|---|---|---|
| message |
string |
一個人類可讀的參數意義描述。 |
| name |
string |
參數識別碼。 |
| value |
string |
這是參數值。 |
ErrorRelatedResource
錯誤相關的資源詳細資料物件。
| 名稱 | 類型 | Description |
|---|---|---|
| resourceId |
string |
發生錯誤的資源識別碼。 |
| resourceType |
string |
發生錯誤的資源類型。 |
ErrorResponse
錯誤回應。
| 名稱 | 類型 | Description |
|---|---|---|
| errorCode |
string |
提供錯誤狀況相關信息的特定標識碼,允許服務與其使用者之間的標準化通訊。 |
| isRetriable |
boolean |
若屬實,請求可重新嘗試。 如果有延遲,請使用 |
| message |
string |
以人類可讀格式呈現的錯誤訊息。 |
| moreDetails |
其他錯誤詳情的清單。 |
|
| parameters |
結構化參數提供更多機器可讀的錯誤上下文。 |
|
| relatedResource |
與錯誤相關的資源詳情。 |
|
| requestId |
string (uuid) |
與錯誤相關聯的要求識別碼。 |
ErrorResponseDetails
錯誤回應的細節。
| 名稱 | 類型 | Description |
|---|---|---|
| errorCode |
string |
提供錯誤狀況相關信息的特定標識碼,允許服務與其使用者之間的標準化通訊。 |
| message |
string |
以人類可讀格式呈現的錯誤訊息。 |
| parameters |
結構化參數提供更多機器可讀的錯誤上下文。 |
|
| relatedResource |
與錯誤相關的資源詳情。 |