Workspaces - Create Workspace

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

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

Δικαιώματα

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

Workspace.ReadWrite.All

Όρια περιορισμού αριθμού αιτήσεων

Τύπος ορίου Τιμή
Ενοποιημένο όριο για API πλατφόρμας 500 κλήσεις/λεπτά
Όριο API 200 κλήσεις/λεπτά

Υποστηριζόμενες ταυτότητες 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
429 Too Many Requests

ErrorResponse

Έγινε υπέρβαση του ορίου επιτοκίου υπηρεσίας. Ο διακομιστής επιστρέφει μια Retry-After κεφαλίδα που υποδεικνύει, σε δευτερόλεπτα, πόσο πρέπει να περιμένει ο υπολογιστής-πελάτης πριν από την αποστολή πρόσθετων αιτήσεων.

Κεφαλίδες

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

Ορισμοί

Ονομασία Περιγραφή
CapacityRegion

Η περιοχή των εκχωρημένων πόρων που σχετίζεται με αυτόν τον χώρο εργασίας. Ενδέχεται να προστεθούν επιπλέον τιμές περιοχής εκχωρημένων πόρων με την πάροδο του χρόνου.
CreateWorkspaceRequest

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

Μια δομημένη παράμετρος που παρέχει πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με ένα σφάλμα.
ErrorRelatedResource

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

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

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

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

Αντιπροσωπεύει μια εφαρμοσμένη ετικέτα.
WorkspaceType

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

CapacityRegion

Απαρίθμηση

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

Τιμή Περιγραφή
Australia East

Ανατολική περιοχή Αυστραλίας
Australia Southeast

Νοτιοανατολική περιοχή Αυστραλίας
Brazil South

Νότια περιοχή Βραζιλίας
Brazil Southeast

Νοτιοανατολική περιοχή Βραζιλίας
Canada Central

Κεντρική περιοχή Του Καναδά
Canada East

Ανατολική περιοχή Καναδά
Central India

Περιοχή κεντρικής Ινδίας
Central US

Κεντρική περιοχή των Η.Π.Α.
Central US EUAP

Κεντρική περιοχή EUAP ΤΩΝ Η.Π.Α.
East Asia

Περιοχή Ανατολικής Ασίας
East US

Περιοχή Ανατολικών Η.Π.Α.
East US 2

Περιοχή Ανατολικών Η.Π.Α. 2
France Central

Κεντρική περιοχή Γαλλίας
France South

Νότια Περιοχή Γαλλίας
Germany Central

Κεντρική περιοχή Γερμανίας
Germany Northeast

Βορειοανατολική περιοχή Γερμανίας
Israel Central

Κεντρική περιοχή Ισραήλ
Italy North

Βόρεια περιοχή Ιταλίας
Japan East

Ανατολική περιοχή Ιαπωνίας
Japan West

Δυτική περιοχή Ιαπωνίας
Korea Central

Κεντρική περιοχή Κορέας
Korea South

Νότια περιοχή Κορέας
Mexico Central

Κεντρική περιοχή του Μεξικού
North Central US

Περιοχή Βορειο-Κεντρικών Η.Π.Α.
North Europe

Περιοχή Βόρειας Ευρώπης
Norway East

Ανατολική περιοχή Νορβηγίας
Norway West

Δυτική περιοχή Νορβηγίας
Poland Central

Κεντρική περιοχή Πολωνίας
South Africa North

Βόρεια περιοχή Νότιας Αφρικής
South Africa West

Δυτική περιοχή Νότιας Αφρικής
South Central US

Περιοχή Νοτιοκεντρικές Η.Π.Α.
South India

Περιοχή Νότιας Ινδίας
Southeast Asia

Περιοχή Νοτιοανατολικής Ασίας
Spain Central

Κεντρική περιοχή Ισπανίας
Sweden Central

Κεντρική περιοχή Σουηδίας
Switzerland North

Βόρεια περιοχή της Ελβετίας
Switzerland West

Δυτική περιοχή της Ελβετίας
West Europe

Περιοχή Δυτικής Ευρώπης
West India

Περιοχή Δυτικής Ινδίας
West US

Περιοχή Δυτικών Η.Π.Α.
West US 2

Περιοχή Δυτικές Η.Π.Α. 2
West US 3

Περιοχή Δυτικών Η.Π.Α. 3
West Central US

Περιοχή Μεσοδυτικών Η.Π.Α.
UAE Central

Κεντρική περιοχή ΗΑΕ
UAE North

Βόρεια περιοχή Ηνωμένα Αραβικά Εμιράτα
Qatar Central

Κεντρική περιοχή του Κατάρ
Germany West Central

Περιοχή West Central Γερμανίας
Germany North

Βόρεια περιοχή Γερμανίας
UK South

Νότια περιοχή του Ηνωμένου Βασιλείου
UK West

Δυτική περιοχή του Ηνωμένου Βασιλείου
China North

Βόρεια περιοχή Της Κίνας
China East

Ανατολική περιοχή Κίνας
China East 2

Περιοχή Ανατολική 2 Κίνας
China East 3

Περιοχή Ανατολική 3 Κίνας
China North 2

Περιοχή Βόρεια Κίνα 2
China North 3

Περιοχή Βόρεια Κίνα 3

CreateWorkspaceRequest

Αντικείμενο

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

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

string (uuid)

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

string

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

string

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

string (uuid)

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

ErrorParameter

Αντικείμενο

Μια δομημένη παράμετρος που παρέχει πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με ένα σφάλμα.

Ονομασία Τύπος Περιγραφή
message

string

Μια αναγνώσιμη από τον άνθρωπο περιγραφή της έννοιας της παραμέτρου.
name

string

Το αναγνωριστικό παραμέτρου.
value

string

Η τιμή της παραμέτρου.

ErrorRelatedResource

Αντικείμενο

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

Ονομασία Τύπος Περιγραφή
resourceId

string

Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType

string

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

ErrorResponse

Αντικείμενο

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

Ονομασία Τύπος Περιγραφή
errorCode

string

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

boolean

Όταν είναι true, η αίτηση μπορεί να επαναληφθεί. Χρησιμοποιήστε την Retry-After κεφαλίδα απόκρισης για να προσδιορίσετε την καθυστέρηση, εάν υπάρχει.
message

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails

ErrorResponseDetails[]

Λίστα πρόσθετων λεπτομερειών σφάλματος.
parameters

ErrorParameter[]

Δομημένες παράμετροι που παρέχουν πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με το σφάλμα.
relatedResource

ErrorRelatedResource

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

string (uuid)

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

ErrorResponseDetails

Αντικείμενο

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

Ονομασία Τύπος Περιγραφή
errorCode

string

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

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.
parameters

ErrorParameter[]

Δομημένες παράμετροι που παρέχουν πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με το σφάλμα.
relatedResource

ErrorRelatedResource

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

Workspace

Αντικείμενο

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

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

string (uri)

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

string (uuid)

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

CapacityRegion

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

string

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

string

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

string (uuid)

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

string (uuid)

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

WorkspaceAppliedTag[]

Λίστα εφαρμοσμένων ετικετών.
type

WorkspaceType

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

WorkspaceAppliedTag

Αντικείμενο

Αντιπροσωπεύει μια εφαρμοσμένη ετικέτα.

Ονομασία Τύπος Περιγραφή
displayName

string

Το όνομα της ετικέτας.
id

string (uuid)

Το αναγνωριστικό ετικέτας.

WorkspaceType

Απαρίθμηση

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

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

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

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

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