Share via

Twins - DigitalTwins Delete

  • 參考
Service:
Azure Digital Twins
API Version:
2023-10-31

刪除數位對應項。 參考數位對應項的所有關聯性都必須已經刪除。 狀態碼：

  • 204 沒有內容
  • 400 不正確的要求
    • InvalidArgument - 數位對應項識別碼無效。
    • RelationshipsNotDeleted - 數位對應項包含關聯性。
  • 404 找不到
    • DigitalTwinNotFound - 找不到數位對應項。
  • 412 先決條件失敗
    • PreconditionFailed - 前置條件檢查 (If-Match 或 If-None-Match) 失敗。
DELETE https://digitaltwins-hostname/digitaltwins/{id}?api-version=2023-10-31

URI 參數

名稱 位於 必要 類型 Description
id
 path True

string

數位對應項的識別碼。 識別碼在服務內是唯一的，而且區分大小寫。
api-version
 query True

string

要求的 API 版本。

要求標頭

名稱 必要 類型 Description
If-Match

string

只有在實體的 etag 符合提供的其中一個 etag 或 * 時，才執行作業。
traceparent

string

識別分散式追蹤系統中的要求。
tracestate

string

提供廠商特定的追蹤識別資訊，而且是追蹤親和項的隨附專案。

回應

名稱 類型 Description
204 No Content

Success
Other Status Codes

ErrorResponse

預設回應。

Headers

x-ms-error-code: string

安全性

oauth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0

範例

Delete a digital twin

Sample Request

DELETE https://digitaltwins-hostname/digitaltwins/myTwinId?api-version=2023-10-31

Sample Response

Status code:
204

定義

名稱 Description
Error

錯誤定義。
ErrorResponse

錯誤回應。
InnerError

比包含的錯誤所提供更明確的錯誤描述。

Error

錯誤定義。

名稱 類型 Description
code

string

服務特定的錯誤碼，可作為 HTTP 錯誤碼的子狀態。
details

Error[]

內部錯誤詳細資料。
innererror

InnerError

物件，包含比目前物件有關錯誤更具體的資訊。
message

string

人類可讀取的錯誤標記法。

ErrorResponse

錯誤回應。

名稱 類型 Description
error

Error

錯誤詳細資料。

InnerError

比包含的錯誤所提供更明確的錯誤描述。

名稱 類型 Description
code

string

比包含的錯誤所提供更明確的錯誤碼。
innererror

InnerError

物件，包含比目前物件有關錯誤更具體的資訊。