Κοινοποίηση μέσω

Workspaces - Create Workspace

Υπηρεσία:
Core
Έκδοση API:
v1

Δημιουργεί έναν νέο χώρο εργασίας.

Δικαιώματα

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

Workspace.ReadWrite.All

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

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

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

Διασύνδεση

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

Κυρίως τμήμα αίτησης

Όνομα Απαιτείται Τύπος Περιγραφή
displayName True

string

Το εμφανιζόμενο όνομα του χώρου εργασίας.
Το εμφανιζόμενο όνομα δεν μπορεί να περιέχει περισσότερους από 256 χαρακτήρες.
Επιτρέπονται μόνο ονόματα χώρων εργασίας που δεν χρησιμοποιείται.
Η "Παρακολούθηση διαχειριστή" είναι ένα δεσμευμένο όνομα χώρου εργασίας.
capacityId

string (uuid)

Το αναγνωριστικό του συνόλου εκχωρημένων πόρων στο οποίο θα εκχωρηθεί ο χώρος εργασίας.
description

string

Η περιγραφή του χώρου εργασίας.
Η περιγραφή δεν μπορεί να περιέχει περισσότερους από 4000 χαρακτήρες.
domainId

string (uuid)

Το αναγνωριστικό του τομέα στον οποίο θα εκχωρηθεί ο χώρος εργασίας.

Αποκρίσεις

Όνομα Τύπος Περιγραφή
201 Created

Workspace

Δημιουργήθηκε με επιτυχία.

Κεφαλίδες

Location: string
Other Status Codes

ErrorResponse

Συνήθεις κωδικοί σφαλμάτων:

  • DomainNotFound - Ο τομέας που δόθηκε δεν βρέθηκε

  • InsufficientPermissionsToDomain - Το δικαίωμα χρήστη στον τομέα δεν επαρκεί για την εκτέλεση της λειτουργίας

  • UnknownError - Παρουσιάστηκε σφάλμα.

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

Create a workspace example

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

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

{
  "displayName": "New workspace"
}

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

Κωδικός κατάστασης:
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"
}

Ορισμοί

Όνομα Περιγραφή
CreateWorkspaceRequest

Δημιουργία ωφέλιμου φορτίου αίτησης χώρου εργασίας.
ErrorRelatedResource

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

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

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

Ένα αντικείμενο χώρου εργασίας.
WorkspaceType

Ένας τύπος χώρου εργασίας. Επιπλέον τύποι χώρου εργασίας μπορούν να προστεθούν με την πάροδο του χρόνου.

CreateWorkspaceRequest

Object

Δημιουργία ωφέλιμου φορτίου αίτησης χώρου εργασίας.

Όνομα Τύπος Περιγραφή
capacityId

string (uuid)

Το αναγνωριστικό του συνόλου εκχωρημένων πόρων στο οποίο θα εκχωρηθεί ο χώρος εργασίας.
description

string

Η περιγραφή του χώρου εργασίας.
Η περιγραφή δεν μπορεί να περιέχει περισσότερους από 4000 χαρακτήρες.
displayName

string

Το εμφανιζόμενο όνομα του χώρου εργασίας.
Το εμφανιζόμενο όνομα δεν μπορεί να περιέχει περισσότερους από 256 χαρακτήρες.
Επιτρέπονται μόνο ονόματα χώρων εργασίας που δεν χρησιμοποιείται.
Η "Παρακολούθηση διαχειριστή" είναι ένα δεσμευμένο όνομα χώρου εργασίας.
domainId

string (uuid)

Το αναγνωριστικό του τομέα στον οποίο θα εκχωρηθεί ο χώρος εργασίας.

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

Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

Workspace

Object

Ένα αντικείμενο χώρου εργασίας.

Όνομα Τύπος Περιγραφή
apiEndpoint

string (uri)

Διεύθυνση URL HTTP που αντιπροσωπεύει το τελικό σημείο API ειδικά για τον χώρο εργασίας. Αυτή η τιμή τελικού σημείου επιστρέφεται όταν ο χρήστης ενεργοποιεί την προτίμησηWorkspaceSpecificEndpoints. Επιτρέπει την πρόσβαση στο API μέσω ιδιωτικών συνδέσεων.
capacityId

string (uuid)

Το αναγνωριστικό των εκχωρημένων πόρων στους οποίους έχει αντιστοιχιστεί ο χώρος εργασίας.
description

string

Η περιγραφή του χώρου εργασίας.
displayName

string

Το εμφανιζόμενο όνομα του χώρου εργασίας.
domainId

string (uuid)

Το αναγνωριστικό του τομέα στον οποίο έχει αντιστοιχιστεί ο χώρος εργασίας.
id

string (uuid)

Το αναγνωριστικό χώρου εργασίας.
type

WorkspaceType

Ο τύπος χώρου εργασίας.

WorkspaceType

Απαρίθμηση

Ένας τύπος χώρου εργασίας. Επιπλέον τύποι χώρου εργασίας μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή Περιγραφή
Personal

Ο φάκελος μου ή Ο χώρος εργασίας μου χρησιμοποιείται για τη διαχείριση στοιχείων χρήστη.
Workspace

Χώρος εργασίας που χρησιμοποιείται για τη διαχείριση των στοιχείων Fabric.
AdminWorkspace

Χώρος εργασίας παρακολούθησης διαχειριστή. Περιέχει αναφορές διαχειριστή, όπως η αναφορά ελέγχου και η αναφορά χρήσης και υιοθέτησης.