Device Management - Delete Group

Layanan:

Device Update

Versi API:

2022-10-01

Menghapus grup perangkat. Grup ini secara otomatis dibuat ketika perangkat yang mendukung Pembaruan Perangkat tersambung ke hub dan melaporkan propertinya. Grup, subgrup, dan penyebaran tidak dibersihkan secara otomatis tetapi dipertahankan untuk tujuan riwayat. Pengguna dapat memanggil metode ini untuk menghapus grup jika mereka tidak perlu mempertahankan salah satu riwayat grup dan tidak lagi membutuhkannya. Jika perangkat tersambung lagi untuk grup ini setelah grup dihapus, perangkat akan dibuat ulang secara otomatis tetapi tidak akan ada riwayat.

DELETE https://{endpoint}/deviceUpdate/{instanceId}/management/groups/{groupId}?api-version=2022-10-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string (url)	Titik akhir akun Device Update for IoT Hub (hanya nama host, tanpa protokol).
groupId	path	True	string	Pengidentifikasi grup.
instanceId	path	True	string	Pengidentifikasi instans akun Device Update for IoT Hub.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
204 No Content		Tidak ada konten yang harus dikirim untuk permintaan ini, tetapi header mungkin berguna.
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

OAuth2Auth

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
https://api.adu.microsoft.com/.default

Contoh

DeviceManagement_DeleteGroup

Permintaan sampel

HTTP

DELETE https://contoso.api.adu.microsoft.com/deviceUpdate/blue/management/groups/group1?api-version=2022-10-01

Respon sampel

Kode status:

204

Definisi

Nama	Deskripsi
Error	Detail kesalahan.
ErrorResponse	Respons kesalahan umum.
InnerError	Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.

Error

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan yang ditentukan server.
details	Error[]	Array kesalahan yang menyebabkan kesalahan yang dilaporkan.
innererror	InnerError	Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.
message	string	Representasi kesalahan yang dapat dibaca manusia.
occurredDateTime	string (date-time)	Tanggal dan waktu dalam UTC ketika kesalahan terjadi.
target	string	Target kesalahan.

ErrorResponse

Objek

Respons kesalahan umum.

Nama	Jenis	Deskripsi
error	Error	Detail kesalahan.

InnerError

Objek

Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan yang lebih spesifik daripada yang disediakan oleh kesalahan yang berisi.
errorDetail	string	Pesan kesalahan internal atau pengecualian.
innerError	InnerError	Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.
message	string	Representasi kesalahan yang dapat dibaca manusia.