Workspaces - Grant Admin Temporary Access

Layanan:: Admin

Versi API:: v1

Memberi admin akses sementara (24 jam) ke 'Ruang Kerja Saya' pengguna.

Permissions

Pemanggil harus menjadi administrator Fabric atau mengautentikasi menggunakan perwakilan layanan.

Cakupan Didelegasikan yang Diperlukan

Tenant.ReadWrite.All

Keterbatasan

Maksimum 25 permintaan per menit.

Identitas yang didukung oleh Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identity	Support
Pengguna	Yes
Prinsipal Layanan dan Identitas Terkelola	Yes

Interface

POST https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/grantAdminTemporaryAccess

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
workspaceId	path	True	string (uuid)	ID ruangkerja.

Respons

Nama Jenis Deskripsi

200 OK

Nama	Jenis	Deskripsi
200 OK		OK
429 Too Many Requests	ErrorResponse	Batas tarif layanan terlampaui. Server mengembalikan header `Retry-After` yang menunjukkan, dalam detik, berapa lama klien harus menunggu sebelum mengirim permintaan tambahan. Header Retry-After: integer
Other Status Codes	ErrorResponse	Kode kesalahan umum: EntityNotFound - ID ruang kerja tidak ada atau ruang kerja bukan 'Ruang Kerja Saya'. InsufficientScopes - Pemanggil tidak memiliki izin untuk memanggil API. BadRequest - Akses ke ruang kerja pribadi telah diberikan. Tidak sah - Hanya admin penyewa dan perwakilan layanan dengan peran admin penyewa yang berwenang untuk memanggil API.

429 Too Many Requests

ErrorResponse

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

Header

Retry-After: integer

Other Status Codes

ErrorResponse

Kode kesalahan umum:

EntityNotFound - ID ruang kerja tidak ada atau ruang kerja bukan 'Ruang Kerja Saya'.
InsufficientScopes - Pemanggil tidak memiliki izin untuk memanggil API.
BadRequest - Akses ke ruang kerja pribadi telah diberikan.
Tidak sah - Hanya admin penyewa dan perwakilan layanan dengan peran admin penyewa yang berwenang untuk memanggil API.

Contoh

Grant admin temporary access to workspace example

Permintaan sampel

HTTP

POST https://api.fabric.microsoft.com/v1/admin/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/grantAdminTemporaryAccess

Respon sampel

Kode status:: 200

Definisi

Nama	Deskripsi
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Rincian 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 dari sumber daya yang terkait dengan kesalahan.
requestId	string (uuid)	ID permintaan yang terkait dengan kesalahan.

ErrorResponseDetails

Objek

Rincian 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 dari sumber daya yang terkait dengan kesalahan.