Folders - Get Folder

Υπηρεσία:

Core

Έκδοση API:

v1

Σημείωμα

Αυτό το API είναι σε προεπισκόπηση.

Επιστρέφει τις ιδιότητες του καθορισμένου φακέλου.

Δικαιώματα

Ο καλών πρέπει να έχει θεατή ή υψηλότερο ρόλο στον χώρο εργασίας.

Απαιτούμενες εμβέλειες με ανάθεση

Workspace.Read.All ή Workspace.ReadWrite.All

Υποστηριζόμενες ταυτότητες Microsoft Entra

Αυτό το API υποστηρίζει τις ταυτότητες Microsoft που παρατίθενται σε αυτή την ενότητα.

Ταυτότητα	Υποστήριξη
Χρήστης	Ναι
Υπηρεσίας και διαχειριζόμενες ταυτότητες	Ναι

Διασύνδεση

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

Παράμετροι URI

Όνομα	Σε	Απαιτείται	Τύπος	Περιγραφή
folderId	path	True	string (uuid)	Το αναγνωριστικό φακέλου.
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.

Αποκρίσεις

Όνομα	Τύπος	Περιγραφή
200 OK	Folder	Η αίτηση ολοκληρώθηκε με επιτυχία.
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: FolderNotFound - Ο φάκελος που ζητήθηκε δεν βρέθηκε στον χώρο εργασίας.

Παραδείγματα

Get a folder example

Δείγμα αίτησης

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/folders/bbbbbbbb-1111-2222-3333-cccccccccccc

Δείγμα απόκρισης

Κωδικός κατάστασης:

200

{
  "id": "bbbbbbbb-1111-2222-3333-cccccccccccc",
  "displayName": "A nested folder",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "parentFolderId": "aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb"
}

Ορισμοί

Όνομα	Περιγραφή
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
Folder	Ένα αντικείμενο φακέλου.

ErrorRelatedResource

Object

Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.

Όνομα	Τύπος	Περιγραφή
resourceId	string	Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType	string	Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Object

Η απόκριση σφάλματος.

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails	ErrorResponseDetails[]	Λίστα πρόσθετων λεπτομερειών σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId	string	Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Object

Οι λεπτομέρειες της απόκρισης σφάλματος.

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

Folder

Object

Ένα αντικείμενο φακέλου.

Όνομα	Τύπος	Περιγραφή
displayName	string	Το εμφανιζόμενο όνομα του φακέλου.
id	string (uuid)	Το αναγνωριστικό φακέλου.
parentFolderId	string (uuid)	Το αναγνωριστικό γονικού φακέλου. Εάν ο γονικός φάκελος είναι χώρος εργασίας, parentFolderId δεν έχει καθοριστεί ή είναι null.
workspaceId	string (uuid)	Το αναγνωριστικό χώρου εργασίας.