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

Domains - Update Domain

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

Σημείωση

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

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

Δικαιώματα

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

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

Tenant.ReadWrite.All.

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

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

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

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

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

Διεπαφή

PATCH https://api.fabric.microsoft.com/v1/admin/domains/{domainId}

Παράμετροι URI

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

string

uuid

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

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

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

ContributorsScopeType

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

string

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

string

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

Αποκρίσεις

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

Domain

Η αίτηση ολοκληρώθηκε με επιτυχία.
Other Status Codes

ErrorResponse

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

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

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

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

Update a domain example

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

PATCH https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f

{
  "displayName": "Domain's new name",
  "description": "Domain's new description",
  "contributorsScope": "SpecificUsersAndGroups"
}

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

Κωδικός κατάστασης:
200 
{
  "id": "f2f6a374-789e-4d1d-9cc7-6e0b934fc529",
  "displayName": "Domain's new name",
  "description": "Domain's new description",
  "parentDomainId": null,
  "contributorsScope": "SpecificUsersAndGroups"
}

Ορισμοί

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

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

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

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

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

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

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

ContributorsScopeType

Απαρίθμηση

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

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

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

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

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

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

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

UpdateDomainRequest

Object

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

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

ContributorsScopeType

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

string

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

string

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