Κοινή χρήση μέσω

Domains - Create Domain

  • Αναφορά
Υπηρεσία:
Admin
Έκδοση API:
v1

Σημείωση

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

Δημιουργεί έναν νέο τομέα.

Δικαιώματα

Ο καλών πρέπει να είναι διαχειριστής Fabric.

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

Tenant.ReadWrite.All.

Περιορισμούς

Μέγιστος αριθμός 25 αιτήσεων ανά ένα λεπτό ανά κεφάλαιο.

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

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

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

Διεπαφή

POST https://api.fabric.microsoft.com/v1/admin/domains

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

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

string

Το εμφανιζόμενο όνομα τομέα. Το εμφανιζόμενο όνομα δεν μπορεί να περιέχει περισσότερους από 40 χαρακτήρες.
description

string

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

string

uuid

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

Αποκρίσεις

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

Domain

Ο τομέας δημιουργήθηκε με επιτυχία.
Other Status Codes

ErrorResponse

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

  • EntityNotFound - Η δημιουργία τομέα απέτυχε επειδή το αναγνωριστικό γονικού τομέα δεν βρέθηκε.

  • EntityConflict - Η δημιουργία τομέα απέτυχε επειδή υπάρχει ήδη το εμφανιζόμενο όνομα τομέα.

  • InvalidInput - Μη έγκυρο αναγνωριστικό γονικού τομέα.

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

Create a domain example

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

POST https://api.fabric.microsoft.com/v1/admin/domains

{
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df"
}

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

Κωδικός κατάστασης:
201 
{
  "id": "9eba6944-daff-4441-b9b5-630ce34238fd",
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df",
  "contributorsScope": "AllTenant"
}

Ορισμοί

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

Η εμβέλεια συμφερόντος. Επιπλέον εμβέλειες συμφερόντων μπορούν να προστεθούν με την πάροδο του χρόνου.
CreateDomainRequest

Το ωφέλιμο φορτίο αίτησης για τη δημιουργία ενός τομέα ή υποτομέα.
Domain

Αντιπροσωπεύει έναν τομέα ή υποτομέα.
ErrorRelatedResource

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

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

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

ContributorsScopeType

Απαρίθμηση

Η εμβέλεια συμφερόντος. Επιπλέον εμβέλειες συμφερόντων μπορούν να προστεθούν με την πάροδο του χρόνου.

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

Μόνο μισθωτές και διαχειριστές τομέα.
AllTenant

Όλοι οι χρήστες του μισθωτή.
SpecificUsersAndGroups

Συγκεκριμένοι χρήστες και ομάδες.

CreateDomainRequest

Object

Το ωφέλιμο φορτίο αίτησης για τη δημιουργία ενός τομέα ή υποτομέα.

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

string

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

string

Το εμφανιζόμενο όνομα τομέα. Το εμφανιζόμενο όνομα δεν μπορεί να περιέχει περισσότερους από 40 χαρακτήρες.
parentDomainId

string

uuid

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

Domain

Object

Αντιπροσωπεύει έναν τομέα ή υποτομέα.

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

ContributorsScopeType

Η εμβέλεια των συμβαλλόντων στον τομέα.
description

string

Η περιγραφή του τομέα.
displayName

string

Το όνομα του τομέα.
id

string

uuid

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

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

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