Usuwanie urządzenia dla określonego klienta
Dotyczy: Centrum partnerskie
W tym artykule wyjaśniono, jak usunąć urządzenie należące do określonego klienta.
Wymagania wstępne
Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Identyfikator klienta (
customer-tenant-id). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim , wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta . Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id).Identyfikator partii urządzenia.
Identyfikator urządzenia.
C#
Aby usunąć urządzenie dla określonego klienta:
Wywołaj metodę IAggregatePartner.Customers.ById z identyfikatorem klienta, aby pobrać interfejs operacji na kliencie.
Wywołaj metodę DeviceBatches.ById za pomocą identyfikatora partii urządzenia, aby uzyskać interfejs operacji dla określonej partii.
Wywołaj metodę Devices.ById , aby uzyskać interfejs do działania na określonym urządzeniu.
Wywołaj metodę Delete lub DeleteAsync , aby usunąć urządzenie z partii.
IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedDeviceBatchId;
string selectedDeviceId;
partnerOperations.Customers.ById(selectedCustomerId).DeviceBatches.ById(selectedDeviceBatchId).Devices.ById(selectedDeviceId).Delete();
Przykład: aplikacja testowa konsoli. Projekt: Klasa przykładów zestawu SDK Centrum partnerskiego: DeleteDevice.cs
Żądanie REST
Składnia żądania
| Metoda | Identyfikator URI żądania |
|---|---|
| DELETE | {baseURL}/v1/customers/{customer-id}/deviceBatches/{devicebatch-id}/devices/{device-id} HTTP/1.1 |
Parametry identyfikatora URI
Podczas tworzenia żądania użyj następujących parametrów ścieżki.
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| customer-id | ciąg | Tak | Ciąg sformatowany przez identyfikator GUID, który identyfikuje klienta. |
| devicebatch-id | ciąg | Tak | Identyfikator partii urządzenia, który zawiera urządzenie. |
| device-id | ciąg | Tak | Identyfikator urządzenia. |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.
Treść żądania
Brak
Przykład żądania
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
Odpowiedź REST
W przypadku powodzenia odpowiedź zwraca kod stanu 204 Brak zawartości .
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie oraz dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.
Przykład odpowiedzi
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