Workspaces - List Workspaces

Layanan:: Admin

Versi API:: v1

Mengembalikan daftar ruang kerja.

Note

API ini adalah bagian dari rilis Pratinjau dan disediakan hanya untuk tujuan evaluasi dan pengembangan. Ini dapat berubah berdasarkan umpan balik dan tidak disarankan untuk penggunaan produksi.

API ini mendukung penomoran halaman. Maksimal 10.000 rekaman dapat dikembalikan per permintaan. Dengan token berkelanjutan yang disediakan dalam respons, Anda bisa mendapatkan 10.000 rekaman berikutnya.

Permissions

Pemanggil harus merupakan administrator Fabric atau mengautentikasi menggunakan perwakilan layanan.

Cakupan yang Didelegasikan yang Diperlukan

Tenant.Read.All atau Tenant.ReadWrite.All

Limitations

Maksimum 200 permintaan per jam.

Identitas yang didukung oleh Microsoft Entra

API ini mendukung identitas Microsoft yang tercantum di bagian ini.

Identity	Support
User	Yes
Prinsipal Layanan dan Identitas Terkelola	Yes

Interface

GET https://api.fabric.microsoft.com/v1/admin/workspaces

Dengan parameter opsional:

GET https://api.fabric.microsoft.com/v1/admin/workspaces?type={type}&capacityId={capacityId}&name={name}&state={state}&continuationToken={continuationToken}

Parameter URI

Nama	Dalam	Jenis	Deskripsi
capacityId	query	string (uuid)	ID kapasitas ruang kerja.
continuationToken	query	string	Token kelanjutan. Digunakan untuk mendapatkan item berikutnya dalam daftar.
name	query	string	Nama ruang kerja.
state	query	string	Status ruang kerja. Status yang didukung aktif dan dihapus.
type	query	string	Jenis ruang kerja. Jenis yang didukung adalah pribadi, ruang kerja, ruang kerja admin.

Respons

Nama Jenis Deskripsi

200 OK

Nama	Jenis	Deskripsi
200 OK	Workspaces	Operasi berhasil.
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: BadRequest - Parameter kueri seperti `workspaceType` atau `workspaceState` tidak valid. InsufficientPrivileges - Pemanggil tidak memiliki izin untuk memanggil API.

Workspaces

Operasi berhasil.

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:

BadRequest - Parameter kueri seperti workspaceType atau workspaceState tidak valid.
InsufficientPrivileges - Pemanggil tidak memiliki izin untuk memanggil API.

Contoh

Get a list of workspaces example

Get a list of workspaces using state query parameter example

Get a list of workspaces example

Permintaan sampel

HTTP

GET https://api.fabric.microsoft.com/v1/admin/workspaces

Respon sampel

Kode status:: 200

{
  "workspaces": [
    {
      "id": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "name": "test report",
      "type": "Workspace",
      "state": "Active",
      "capacityId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e84",
      "domainId": "039bd896-b39c-4540-93e3-e9926de135f9",
      "tags": [
        {
          "id": "b3f2c8e9-4d8e-4a7c-9a32-f8c1b2e4d6af",
          "displayName": "Finance"
        },
        {
          "id": "6f1a8d3b-92c4-4f67-8c2d-1e5a9b7f4a23",
          "displayName": "Production"
        }
      ]
    }
  ],
  "continuationUri": "https://api.fabric.microsoft.com/v1/admin/workspaces?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Get a list of workspaces using state query parameter example

Permintaan sampel

HTTP

GET https://api.fabric.microsoft.com/v1/admin/workspaces?state=Active

Respon sampel

Kode status:: 200

{
  "workspaces": [
    {
      "id": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "name": "test report",
      "type": "Workspace",
      "state": "Active",
      "capacityId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e84"
    }
  ],
  "continuationUri": null,
  "continuationToken": null
}

Definisi

Nama	Deskripsi
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
Workspace	Workspace.
WorkspaceAppliedTag	Mewakili tag yang diterapkan.
Workspaces	Daftar ruang kerja.
WorkspaceState	Status ruang kerja. Status ruang kerja tambahan dapat ditambahkan dari waktu ke waktu.
WorkspaceType	Jenis ruang kerja. Jenis ruang kerja tambahan dapat ditambahkan dari waktu ke waktu.

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.

Workspace

Objek

Workspace.

Nama	Jenis	Deskripsi
capacityId	string (uuid)	ID kapasitas ruang kerja.
domainId	string (uuid)	ID domain ruang kerja.
id	string (uuid)	ID ruangkerja.
name	string	Nama ruang kerja.
state	WorkspaceState	Status ruang kerja.
tags	WorkspaceAppliedTag[]	Daftar tag yang diterapkan.
type	WorkspaceType	Jenis ruang kerja.

WorkspaceAppliedTag

Objek

Mewakili tag yang diterapkan.

Nama	Jenis	Deskripsi
displayName	string	Nama dari tag.
id	string (uuid)	ID tag.

Workspaces

Objek

Daftar ruang kerja.

Nama	Jenis	Deskripsi
continuationToken	string	Token untuk batch tataan hasil berikutnya. Jika tidak ada rekaman lagi, rekaman akan dihapus dari respons.
continuationUri	string	URI dari batch tataan hasil berikutnya. Jika tidak ada rekaman lagi, rekaman akan dihapus dari respons.
workspaces	Workspace[]	Daftar ruang kerja fabric.

WorkspaceState

Enumerasi

Status ruang kerja. Status ruang kerja tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Active	Ruang kerja aktif. Ruang kerja tanpa sumber ditampilkan sebagai aktif.
Deleted	Ruang kerja dihapus.

WorkspaceType

Enumerasi

Jenis ruang kerja. Jenis ruang kerja tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Personal	Folder saya atau Ruang kerja saya digunakan untuk mengelola item pengguna.
Workspace	Ruang kerja yang digunakan untuk mengelola item Fabric.
AdminWorkspace	Ruang kerja pemantauan admin. Berisi laporan admin seperti laporan audit dan laporan penggunaan dan adopsi.