Items - Delete Item

Layanan:: Core

Versi API:: v1

Menghapus item yang ditentukan.
API ini didukung untuk sejumlah jenis item, menemukan jenis item yang didukung dan informasi tentang struktur definisinya di Gambaran umum manajemen item. Perilaku defaultnya adalah menghapus item untuk jenis item yang didukung.

Nota

Item yang dihapus sementara akan dihitung terhadap jumlah maksimum item yang diizinkan di setiap ruang kerja.

Hak akses

Pemanggil harus memiliki izin tulis untuk item untuk penghapusan sementara. Pemanggil harus memiliki peran Admin ruang kerja yang ditetapkan untuk penghapusan permanen/keras.

Cakupan yang Didelegasikan yang Diperlukan

Untuk API item, gunakan jenis cakupan ini:

Cakupan generik: Item.ReadWrite.All
Cakupan spesifik: itemType. ReadWrite.All (misalnya: Notebook.ReadWrite.All)

untuk informasi selengkapnya tentang cakupan, lihat artikel cakupan .

Batas Pengendalian

Jenis Batas	Value
Kuota Terpadu untuk API Platform	200 panggilan/menit
Batas API	200 panggilan/menit

Identitas yang didukung oleh Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identitas	Dukungan
Pengguna	Ya
Prinsipal Layanan dan Identitas Terkelola	Saat tipe item dalam panggilan didukung. Periksa API yang sesuai untuk jenis item yang Anda panggil, untuk melihat apakah panggilan Anda didukung. Misalnya, model semantik didukung.

Antarmuka

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}

Dengan parameter opsional:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}?hardDelete={hardDelete}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
itemId	path	True	string (uuid)	ID item.
workspaceId	path	True	string (uuid)	ID ruangkerja.
hardDelete	query		boolean	Menentukan apakah akan melakukan penghapusan keras. Ketika diatur ke `true`, item dihapus secara permanen dan tidak dapat dipulihkan. Ketika diatur ke `false` atau tidak ditentukan, item dihapus sementara jika jenis item mendukungnya.

Respons

Nama Jenis Deskripsi

200 OK

Nama	Jenis	Deskripsi
200 OK		Permintaan berhasil diselesaikan.
429 Too Many Requests	ErrorResponse	Batas tarif layanan terlampaui. Server mengembalikan header yang `Retry-After` menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan. Header Retry-After: integer
Other Status Codes	ErrorResponse	Kode kesalahan umum: ItemNotFound - Item yang diminta tidak ditemukan. InsufficientWorkspaceRole - Pengguna tidak memiliki peran ruang kerja yang memadai. FeatureNotAvailable - Ini bisa disebabkan oleh fitur penghapusan sementara yang tidak tersedia. UnsupportedItemType - Ini bisa disebabkan oleh fitur penghapusan sementara yang tidak didukung oleh jenis item yang diminta. TenantSwitchDisabled - Ini bisa disebabkan oleh fitur penghapusan sementara yang dinonaktifkan oleh admin penyewa. InvalidTargetItemStateForSoftDeletion - Item berada dalam status tidak valid untuk penghapusan sementara. InvalidParentItemStateForSoftDeletion - Item induk item tidak dalam status Aktif.

Permintaan berhasil diselesaikan.

429 Too Many Requests

ErrorResponse

Batas tarif layanan terlampaui. Server mengembalikan header yang Retry-After menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan.

Header

Retry-After: integer

Other Status Codes

ErrorResponse

Kode kesalahan umum:

ItemNotFound - Item yang diminta tidak ditemukan.
InsufficientWorkspaceRole - Pengguna tidak memiliki peran ruang kerja yang memadai.
FeatureNotAvailable - Ini bisa disebabkan oleh fitur penghapusan sementara yang tidak tersedia.
UnsupportedItemType - Ini bisa disebabkan oleh fitur penghapusan sementara yang tidak didukung oleh jenis item yang diminta.
TenantSwitchDisabled - Ini bisa disebabkan oleh fitur penghapusan sementara yang dinonaktifkan oleh admin penyewa.
InvalidTargetItemStateForSoftDeletion - Item berada dalam status tidak valid untuk penghapusan sementara.
InvalidParentItemStateForSoftDeletion - Item induk item tidak dalam status Aktif.

Contoh

Delete an item example

Hard delete an item example

Delete an item example

Permintaan sampel

HTTP

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715

Respon sampel

Kode status:: 200

Hard delete an item example

Permintaan sampel

HTTP

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715?hardDelete=True

Respon sampel

Kode status:: 200

Definisi

Nama	Deskripsi
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.

ErrorRelatedResource

Objek

Objek detail sumber daya terkait kesalahan.

Nama	Jenis	Deskripsi
resourceId	string	ID sumber daya yang terlibat dalam kesalahan.
resourceType	string	Jenis sumber daya yang terlibat dalam kesalahan.

ErrorResponse

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
isRetriable	boolean	Jika benar, permintaan dapat dicoba kembali. `Retry-After` Gunakan header respons untuk menentukan penundaan, jika tersedia.
message	string	Representasi kesalahan yang dapat dibaca manusia.
moreDetails	ErrorResponseDetails[]	Daftar detail kesalahan tambahan.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.
requestId	string (uuid)	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Detail respons kesalahan.

Nama	Jenis	Deskripsi
errorCode	string	Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya.
message	string	Representasi kesalahan yang dapat dibaca manusia.
relatedResource	ErrorRelatedResource	Detail sumber daya terkait kesalahan.