Workspaces - Create Workspace

Hizmet:: Core

API Sürümü:: v1

Yeni bir çalışma alanı oluşturur.

İzinler

Çağıranın Doku yöneticisi tarafından verilen çalışma alanlarını oluşturma izni olmalıdır. Daha fazla bilgi için bkz. Çalışma alanları oluşturma.
Arayanın katkıda bulunan izinlerine sahip olması veya kapasitede Yönetici olması gerekir. Daha fazla bilgi için bkz. kapasite kullanıcı izinleri.
Hizmet Sorumluları, Doku yöneticisi tarafından verilen izne sahip olmalıdır. Daha fazla bilgi için bkz. Hizmet sorumluları çalışma alanları, bağlantılar ve dağıtım işlem hatları oluşturabilir.

Gerekli Temsilci Kapsamları

Çalışma Alanı.OkumaYazma.Tümü

Kısıtlama limitleri

Sınır Türü	Value
Platform API'leri için Birleşik Kota	200 arama/dk
API sınırı	200 arama/dk

Microsoft Entra destekli kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik	Destek
Kullanıcı	Evet
Hizmet sorumlusu ve yönetilen kimlikler	Evet

Arayüz

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

İstek Gövdesi

Name	Gerekli	Tür	Description
displayName	True	string	Çalışma alanı görünen adı. Görünen ad 256'dan fazla karakter içeremez. Yalnızca kullanılmayan çalışma alanı adlara izin verilir. "Yönetici izleme", ayrılmış bir çalışma alanı adıdır.
capacityId		string (uuid)	Çalışma alanını atanacak kapasitenin kimliği.
description		string	Çalışma alanı açıklaması. Açıklama 4000'den fazla karakter içeremez.
domainId		string (uuid)	Çalışma alanının atanacak etki alanının kimliği.

Yanıtlar

Name Tür Description

201 Created

Name	Tür	Description
201 Created	Workspace	Başarıyla oluşturuldu. Üst Bilgiler Location: string
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: DomainNotFound - Sağlanan etki alanı bulunamadı InsufficientPermissionsToDomain - Etki alanına kullanıcı izni işlemi gerçekleştirmek için yeterli değil UnknownError - Bir hata oluştu.

Workspace

Başarıyla oluşturuldu.

Üst Bilgiler

Location: string

429 Too Many Requests

ErrorResponse

Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür.

Üst Bilgiler

Retry-After: integer

Other Status Codes

ErrorResponse

Yaygın hata kodları:

DomainNotFound - Sağlanan etki alanı bulunamadı
InsufficientPermissionsToDomain - Etki alanına kullanıcı izni işlemi gerçekleştirmek için yeterli değil
UnknownError - Bir hata oluştu.

Örnekler

Create a workspace example

Örnek isteği

HTTP

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

{
  "displayName": "New workspace"
}

Örnek yanıt

Durum kodu:: 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"
}

Tanımlar

Name	Description
CapacityRegion	Bu çalışma alanıyla ilişkili kapasitenin bölgesi. Zaman içinde ek kapasite bölgesi değerleri eklenebilir.
CreateWorkspaceRequest	Çalışma alanı isteği yükü oluşturun.
ErrorParameter	Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
Workspace	Çalışma alanı nesnesi.
WorkspaceAppliedTag	Uygulanan bir etiketi temsil eder.
WorkspaceType	Çalışma alanı türü. Zaman içinde ek çalışma alanı türleri eklenebilir.

CapacityRegion

Numaralandırma

Bu çalışma alanıyla ilişkili kapasitenin bölgesi. Zaman içinde ek kapasite bölgesi değerleri eklenebilir.

Değer	Description
Australia East	Doğu Avustralya bölgesi
Australia Southeast	Avustralya Güneydoğu bölgesi
Brazil South	Brezilya Güney bölgesi
Brazil Southeast	Brezilya Güneydoğu bölgesi
Canada Central	Orta Kanada bölgesi
Canada East	Doğu Kanada bölgesi
Central India	Orta Hindistan bölgesi
Central US	Orta ABD bölgesi
Central US EUAP	Orta ABD EUAP bölgesi
East Asia	Doğu Asya bölgesi
East US	Doğu ABD bölgesi
East US 2	Doğu ABD 2 bölgesi
France Central	Orta Fransa bölgesi
France South	Fransa Güney bölgesi
Germany Central	Orta Almanya bölgesi
Germany Northeast	Almanya Kuzeydoğu bölgesi
Israel Central	orta İsrail bölgesi
Italy North	İtalya Kuzey bölgesi
Japan East	Doğu Japonya bölgesi
Japan West	Batı Japonya bölgesi
Korea Central	Orta Kore bölgesi
Korea South	Güney Kore bölgesi
Mexico Central	Orta Meksika bölgesi
North Central US	Orta Kuzey ABD bölgesi
North Europe	Kuzey Avrupa bölgesi
Norway East	Norveç Doğu bölgesi
Norway West	Batı Norveç bölgesi
Poland Central	Orta Polonya bölgesi
South Africa North	Güney Afrika Kuzey bölgesi
South Africa West	Güney Afrika Batı bölgesi
South Central US	Orta Güney ABD bölgesi
South India	Güney Hindistan bölgesi
Southeast Asia	Güneydoğu Asya bölgesi
Spain Central	İspanya Orta bölgesi
Sweden Central	İsveç Orta bölgesi
Switzerland North	İsviçre Kuzey bölgesi
Switzerland West	İsviçre Batı bölgesi
West Europe	Batı Avrupa bölgesi
West India	Batı Hindistan bölgesi
West US	Batı ABD bölgesi
West US 2	Batı ABD 2 bölgesi
West US 3	Batı ABD 3 bölgesi
West Central US	Orta Batı ABD bölgesi
UAE Central	Bae Orta bölgesi
UAE North	BAE Kuzey bölgesi
Qatar Central	Orta Katar bölgesi
Germany West Central	Orta Batı Almanya bölgesi
Germany North	Almanya Kuzey bölgesi
UK South	Birleşik Krallık Güney bölgesi
UK West	Birleşik Krallık Batı bölgesi
China North	Çin Kuzey bölgesi
China East	Çin Doğu bölgesi
China East 2	Çin Doğu 2 bölgesi
China East 3	Çin Doğu 3 bölgesi
China North 2	Çin Kuzey 2 bölgesi
China North 3	Çin Kuzey 3 bölgesi

CreateWorkspaceRequest

Nesne

Çalışma alanı isteği yükü oluşturun.

Name	Tür	Description
capacityId	string (uuid)	Çalışma alanını atanacak kapasitenin kimliği.
description	string	Çalışma alanı açıklaması. Açıklama 4000'den fazla karakter içeremez.
displayName	string	Çalışma alanı görünen adı. Görünen ad 256'dan fazla karakter içeremez. Yalnızca kullanılmayan çalışma alanı adlara izin verilir. "Yönetici izleme", ayrılmış bir çalışma alanı adıdır.
domainId	string (uuid)	Çalışma alanının atanacak etki alanının kimliği.

ErrorParameter

Nesne

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.

Name	Tür	Description
message	string	Parametrenin anlamının insan tarafından okunabilen açıklaması.
name	string	Parametre tanımlayıcısı.
value	string	Parametre değeridir.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
isRetriable	boolean	True olduğunda istek yeniden denenebilir. Varsa gecikmeyi `Retry-After` belirlemek için yanıt üst bilgisini kullanın.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

Workspace

Nesne

Çalışma alanı nesnesi.

Name	Tür	Description
apiEndpoint	string (uri)	Çalışma alanına özgü API uç noktasını temsil eden HTTP URL'si. Kullanıcı preferWorkspaceSpecificEndpoints'i etkinleştirdiğinde bu uç nokta değeri döndürülür. Özel bağlantılar üzerinden API erişimine izin verir.
capacityId	string (uuid)	Çalışma alanının atandığı kapasitenin kimliği.
capacityRegion	CapacityRegion	Bu çalışma alanıyla ilişkili kapasitenin bölgesi.
description	string	Çalışma alanı açıklaması.
displayName	string	Çalışma alanı görünen adı.
domainId	string (uuid)	Çalışma alanının atandığı etki alanının kimliği.
id	string (uuid)	Çalışma alanı kimliği.
tags	WorkspaceAppliedTag[]	Uygulanan etiketlerin listesi.
type	WorkspaceType	Çalışma alanı türü.

WorkspaceAppliedTag

Nesne

Uygulanan bir etiketi temsil eder.

Name	Tür	Description
displayName	string	Etiketin adı.
id	string (uuid)	Etiket kimliği.

WorkspaceType

Numaralandırma

Çalışma alanı türü. Zaman içinde ek çalışma alanı türleri eklenebilir.

Değer	Description
Personal	Kullanıcı öğelerini yönetmek için kullanılan Klasörüm veya Çalışma alanım.
Workspace	Doku öğelerini yönetmek için kullanılan çalışma alanı.
AdminWorkspace	Yönetici izleme çalışma alanı. Denetim raporu ve kullanım ve benimseme raporu gibi yönetici raporlarını içerir.