為指定客戶刪除裝置

發行項
09/11/2024

適用于：合作夥伴中心

本文說明如何刪除屬於指定客戶的裝置。

必要條件

認證，如合作夥伴中心驗證所述。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶識別碼 (customer-tenant-id)。如果您不知道客戶的識別碼，您可以選取 [客戶] 工作區，然後從客戶清單中選取客戶，然後從客戶清單中查詢該識別碼，然後查閱合作夥伴中心。在客戶的 [帳戶] 頁面上，尋找 [客戶帳戶資訊] 區段中的 [Microsoft 識別碼] 。 Microsoft 識別碼與客戶識別碼 () customer-tenant-id 相同。
裝置批次識別碼。
裝置識別碼。

C#

若要刪除指定客戶的裝置：

使用客戶識別碼呼叫 IAggregatePartner.Customers.ById 方法，以擷取對客戶作業的介面。
使用裝置批次識別碼呼叫 DeviceBatches.ById 方法，以取得指定批次作業的介面。
呼叫 Devices.ById 方法，以取得在指定裝置上作業的介面。
呼叫 Delete 或DeleteAsync方法，從批次中刪除裝置。

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedDeviceBatchId;
string selectedDeviceId;

partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.ById(selectedDeviceBatchId).Devices.ById(selectedDeviceId).Delete();

範例：主控台測試應用程式。專案：合作夥伴中心 SDK 範例類別：DeleteDevice.cs

REST 要求

要求的語法

方法	要求 URI
DELETE	{baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1

URI 參數

建立要求時，請使用下列路徑參數。

名稱	類型	必要	描述
customer-id	string	Yes	用來識別客戶的 GUID 格式字串。
devicebatch-id	string	Yes	包含裝置之批次的裝置批次識別碼。
device-id	string	Yes	裝置識別碼。

要求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

要求本文

無

要求範例

DELETE https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/deviceBatches/testbatch/devices/7b11cd8b-dd1e-4840-8c4a-84215e4de782 HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Length: 0
Content-Type: application/json
Host: api.partnercenter.microsoft.com

REST 回應

如果成功，回應會傳回 204 無內容 狀態碼。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。如需完整清單，請參閱合作夥伴中心的 REST 錯誤碼。

回應範例

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 8b3e6f78-220b-4177-861b-33d6f38f7b97
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 17:58:53 GMT

共用方式為