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

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	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

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.

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",
  "capacityRegion": "West US"
}

Definisi

Nama	Deskripsi
CapacityRegion	Wilayah kapasitas yang terkait dengan ruang kerja ini. Nilai wilayah kapasitas tambahan dapat ditambahkan dari waktu ke waktu.
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.

CapacityRegion

Enumerasi

Wilayah kapasitas yang terkait dengan ruang kerja ini. Nilai wilayah kapasitas tambahan dapat ditambahkan dari waktu ke waktu.

Nilai	Deskripsi
Australia East	Wilayah Australia Timur
Australia Southeast	Wilayah Australia Tenggara
Brazil South	Wilayah Brasil Selatan
Brazil Southeast	Wilayah Brasil Tenggara
Canada Central	Wilayah Kanada Tengah
Canada East	Wilayah Kanada Timur
Central India	Wilayah India Tengah
Central US	Wilayah AS Tengah
Central US EUAP	Wilayah EUAP AS Tengah
East Asia	Wilayah Asia Timur
East US	Wilayah US Timur
East US 2	Wilayah US Timur 2
France Central	Wilayah Prancis Tengah
France South	Wilayah Prancis Selatan
Germany Central	Wilayah Jerman Tengah
Germany Northeast	Wilayah Jerman Timur Laut
Israel Central	Wilayah Israel Tengah
Italy North	Wilayah Italia Utara
Japan East	Wilayah Jepang Timur
Japan West	Wilayah Jepang Barat
Korea Central	Wilayah Korea Tengah
Korea South	Wilayah Korea Selatan
Mexico Central	Wilayah Meksiko Tengah
North Central US	Wilayah US Tengah Utara
North Europe	Wilayah Eropa Utara
Norway East	Wilayah Norwegia Timur
Norway West	Wilayah Norwegia Barat
Poland Central	Wilayah Polandia Tengah
South Africa North	Wilayah Afrika Selatan Utara
South Africa West	Wilayah Afrika Selatan Barat
South Central US	Wilayah US Tengah Selatan
South India	Wilayah India Selatan
Southeast Asia	Wilayah Asia Tenggara
Spain Central	Wilayah Spanyol Tengah
Sweden Central	Wilayah Swedia Tengah
Switzerland North	Wilayah Swiss Utara
Switzerland West	Wilayah Swiss Barat
West Europe	Wilayah Eropa Barat
West India	Wilayah India Barat
West US	Wilayah US Barat
West US 2	Wilayah US Barat 2
West US 3	Wilayah US Barat 3
West Central US	Wilayah US Tengah Barat
UAE Central	Wilayah UAE Tengah
UAE North	Wilayah UAE Utara
Qatar Central	Wilayah Qatar Tengah
Germany West Central	Wilayah Jerman Barat Tengah
Germany North	Wilayah Jerman Utara
UK South	Wilayah Selatan Inggris
UK West	Wilayah UK Barat
China North	Wilayah Tiongkok Utara
China East	Wilayah Tiongkok Timur
China East 2	Wilayah Tiongkok Timur 2
China East 3	Wilayah Tiongkok Timur 3
China North 2	Wilayah Tiongkok Utara 2
China North 3	Wilayah Tiongkok Utara 3

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.
capacityRegion	CapacityRegion	Wilayah kapasitas yang terkait dengan ruang kerja ini.
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.