指定された顧客のデバイスを削除する

[アーティクル]
03/06/2024

適用対象: パートナーセンター

この記事では、指定した顧客に属するデバイスを削除する方法について説明します。

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。
顧客 ID です (customer-tenant-id)。顧客の ID がわからない場合は、パートナーセンターで [顧客] ワークスペースを選択し、 次に顧客 の一覧から [顧客]、[ アカウント] の順に選択して、その ID を検索できます。お客様のアカウントページで、 [顧客のアカウント情報] セクションの Microsoft ID を探します。 Microsoft ID は、顧客 ID (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 パラメーター

要求を作成するときは、次のパスパラメーターを使用します。

名前	Type	必須	説明
customer-id	string	はい	顧客を識別する GUID 形式の文字列。
devicebatch-id	string	はい	デバイスを含むバッチのデバイスバッチ識別子。
device-id	string	はい	デバイス識別子。

要求ヘッダー

詳細については、「パートナーセンター 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: de894e18-f027-4ac0-8b5a-34f0c222af0c
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: 394d96d0-05b2-4b02-b907-0697632ee3bb
MS-RequestId: 8b3e6f78-220b-4177-861b-33d6f38f7b97
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 17:58:53 GMT