Workspaces - Create Workspace

Layanan:

Core

Versi API:

v1

Membuat ruang kerja baru.

Hak akses

• Pemanggil harus memiliki izin untuk membuat ruang kerja yang diberikan oleh administrator Fabric. Untuk informasi selengkapnya lihat: membuat ruang kerja.
• Pemanggil harus memiliki izin kontributor atau menjadi Admin pada kapasitas. Untuk informasi selengkapnya, lihat: izin pengguna kapasitas.
• Perwakilan Layanan harus memiliki izin yang diberikan oleh administrator Fabric. Untuk informasi selengkapnya, lihat: Perwakilan layanan dapat membuat ruang kerja, koneksi, dan alur penyebaran.

Cakupan yang Didelegasikan yang Diperlukan

Workspace.ReadWrite.All

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	Ya

Antarmuka

POST https://api.fabric.microsoft.com/v1/workspaces

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
displayName	True	string	Nama tampilan ruang kerja. Nama tampilan tidak boleh berisi lebih dari 256 karakter. Hanya nama ruang kerja yang tidak digunakan yang diizinkan. "Pemantauan admin" adalah nama ruang kerja yang dipesan.
capacityId		string (uuid)	ID kapasitas untuk menetapkan ruang kerja.
description		string	Deskripsi ruang kerja. Deskripsi tidak boleh berisi lebih dari 4000 karakter.
domainId		string (uuid)	ID domain yang akan ditetapkan ruang kerjanya.

Respons

Nama	Jenis	Deskripsi
201 Created	Workspace	Berhasil dibuat. Header Location: string
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: DomainNotFound - Domain yang disediakan tidak ditemukan InsufficientPermissionsToDomain - Izin pengguna ke domain tidak cukup untuk melakukan operasi UnknownError - Terjadi kesalahan.

Contoh

Create a workspace example

Permintaan sampel

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces

{
  "displayName": "New workspace"
}

Respon sampel

Kode status:

201

Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb22287ff

{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb22287ff",
  "displayName": "New workspace",
  "description": "",
  "type": "Workspace"
}

Definisi

Nama	Deskripsi
CreateWorkspaceRequest	Buat payload permintaan ruang kerja.
ErrorRelatedResource	Objek detail sumber daya terkait kesalahan.
ErrorResponse	Respons kesalahan.
ErrorResponseDetails	Detail respons kesalahan.
Workspace	Objek ruang kerja.
WorkspaceAppliedTag	Mewakili tag yang diterapkan.
WorkspaceType	Jenis ruang kerja. Jenis ruang kerja tambahan dapat ditambahkan dari waktu ke waktu.

CreateWorkspaceRequest

Objek

Buat payload permintaan ruang kerja.

Nama	Jenis	Deskripsi
capacityId	string (uuid)	ID kapasitas untuk menetapkan ruang kerja.
description	string	Deskripsi ruang kerja. Deskripsi tidak boleh berisi lebih dari 4000 karakter.
displayName	string	Nama tampilan ruang kerja. Nama tampilan tidak boleh berisi lebih dari 256 karakter. Hanya nama ruang kerja yang tidak digunakan yang diizinkan. "Pemantauan admin" adalah nama ruang kerja yang dipesan.
domainId	string (uuid)	ID domain yang akan ditetapkan ruang kerjanya.

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

Objek ruang kerja.

Nama	Jenis	Deskripsi
apiEndpoint	string (uri)	URL HTTP yang mewakili titik akhir API khusus untuk ruang kerja. Nilai titik akhir ini dikembalikan saat pengguna mengaktifkan preferWorkspaceSpecificEndpoints. Ini memungkinkan akses API melalui tautan privat.
capacityId	string (uuid)	ID kapasitas tempat ruang kerja ditetapkan.
description	string	Deskripsi ruang kerja.
displayName	string	Nama tampilan ruang kerja.
domainId	string (uuid)	ID domain tempat ruang kerja ditetapkan.
id	string (uuid)	ID ruangkerja.
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.

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.