Folders - Move Folder

Hizmet:: Core

API Sürümü:: v1

Belirtilen klasörü aynı çalışma alanı içinde taşır.

Note

Bu API, önizleme sürümünün bir parçasıdır ve yalnızca değerlendirme ve geliştirme amacıyla sağlanır. Geri bildirim temelinde değişebilir ve üretim kullanımı için önerilmez.

Permissions

Çağıranın çalışma alanında katkıda bulunan veya daha yüksek bir role sahip olması gerekir.

Gerekli Temsilci Kapsamları

Workspace.ReadWrite.All

Microsoft Entra tarafından desteklenen kimlikler

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

Identity	Support
User	Yes
Hizmet sorumlusu ve yönetilen kimlikler	Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/folders/{folderId}/move

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
folderId	path	True	string (uuid)	Klasör kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.

İstek Gövdesi

Name	Tür	Description
targetFolderId	string (uuid)	Hedef klasör kimliği. Sağlanmadıysa, çalışma alanı hedef klasör olarak kullanılır.

Yanıtlar

Name Tür Description

200 OK

Name	Tür	Description
200 OK	Folder	İstek başarıyla tamamlandı.
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ı: FolderNotFound - İstenen klasör bulunamadı. FolderDepthOutOfRange - Üst klasör maksimum derinliğe ulaştı, yeni bir alt klasör oluşturamıyor. InfiniteFolderHierarchyLoop - Klasör herhangi bir inişine taşınamaz. FolderDisplayNameAlreadyInUse - Klasör görünen adı zaten kullanılıyor.

Folder

İstek başarıyla tamamlandı.

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

FolderNotFound - İstenen klasör bulunamadı.
FolderDepthOutOfRange - Üst klasör maksimum derinliğe ulaştı, yeni bir alt klasör oluşturamıyor.
InfiniteFolderHierarchyLoop - Klasör herhangi bir inişine taşınamaz.
FolderDisplayNameAlreadyInUse - Klasör görünen adı zaten kullanılıyor.

Örnekler

Move a folder into another folder example

Move a folder with the workspace as the destination example

Move a folder into another folder example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/folders/dddddddd-9999-0000-1111-eeeeeeeeeeee/move

{
  "targetFolderId": "cccccccc-8888-9999-0000-dddddddddddd"
}

Örnek yanıt

Durum kodu:: 200

{
  "id": "dddddddd-9999-0000-1111-eeeeeeeeeeee",
  "displayName": "Q2",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "parentFolderId": "cccccccc-8888-9999-0000-dddddddddddd"
}

Move a folder with the workspace as the destination example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/folders/dddddddd-9999-0000-1111-eeeeeeeeeeee/move

{}

Örnek yanıt

Durum kodu:: 200

{
  "id": "dddddddd-9999-0000-1111-eeeeeeeeeeee",
  "displayName": "Q2",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
}

Tanımlar

Name	Description
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ı.
Folder	Klasör nesnesi.
MoveFolderRequest	Klasör isteğini taşıma.

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

Folder

Nesne

Klasör nesnesi.

Name	Tür	Description
displayName	string	Klasör görünen adı.
id	string (uuid)	Klasör kimliği.
parentFolderId	string (uuid)	Üst klasör kimliği. Üst klasör bir çalışma alanıysa, `parentFolderId` belirtilmez veya null olur.
workspaceId	string (uuid)	Çalışma alanı kimliği.

MoveFolderRequest

Nesne

Klasör isteğini taşıma.

Name	Tür	Description
targetFolderId	string (uuid)	Hedef klasör kimliği. Sağlanmadıysa, çalışma alanı hedef klasör olarak kullanılır.