Items - Update Variable Library Definition

Αναφορά

Υπηρεσία:: VariableLibrary

Έκδοση API:: v1

Παρακάμπτει τον ορισμό για το καθορισμένο VariableLibrary.
Αυτό το API υποστηρίζει λειτουργίες μεγάλης διάρκειας (LRO).

Η ενημέρωση του ορισμού του VariableLibrary, δεν επηρεάζει την ετικέτα ευαισθησίας του.

Δικαιώματα

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

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

VariableLibrary.ReadWrite.All ή Item.ReadWrite.All

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

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

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

Διασύνδεση

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/VariableLibraries/{variableLibraryId}/updateDefinition

Με προαιρετικές παραμέτρους:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/VariableLibraries/{variableLibraryId}/updateDefinition?updateMetadata={updateMetadata}

Παράμετροι URI

Όνομα	Σε	Απαιτείται	Τύπος	Περιγραφή
variableLibraryId	path	True	string (uuid)	Το αναγνωριστικό VariableLibrary.
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.
updateMetadata	query		boolean	Όταν οριστεί σε true και το αρχείο .platform παρέχεται ως μέρος του ορισμού, τα μετα-δεδομένα του στοιχείου ενημερώνονται χρησιμοποιώντας τα μετα-δεδομένα στο αρχείο .platform

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

Όνομα	Απαιτείται	Τύπος	Περιγραφή
definition	True	VariableLibraryPublicDefinition	Αντικείμενο δημόσιου ορισμού VariableLibrary. Ανατρέξτε σε αυτό το άρθρο για περισσότερες λεπτομέρειες σχετικά με τον τρόπο δημιουργίας ενός δημόσιου ορισμού VariableLibrary.

Αποκρίσεις

Όνομα	Τύπος	Περιγραφή
200 OK		Η αίτηση ολοκληρώθηκε με επιτυχία.
202 Accepted		Η αίτηση έγινε δεκτή. Ο ορισμός ενημέρωσης βρίσκεται σε εξέλιξη. Κεφαλίδες Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: OperationNotSupportedForItem - Η λειτουργία δεν υποστηρίζεται για το στοιχείο που ζητήθηκε. CorruptedPayload - Το παρεχόμενο ωφέλιμο φορτίο είναι διεφθαρμένο.

Όνομα

Τύπος

Περιγραφή

200 OK

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

202 Accepted

Η αίτηση έγινε δεκτή. Ο ορισμός ενημέρωσης βρίσκεται σε εξέλιξη.

Κεφαλίδες

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

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

OperationNotSupportedForItem - Η λειτουργία δεν υποστηρίζεται για το στοιχείο που ζητήθηκε.
CorruptedPayload - Το παρεχόμενο ωφέλιμο φορτίο είναι διεφθαρμένο.

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

Update a VariableLibrary public definition example

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

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/VariableLibraries/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "variables.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "valueSets/valueSet1.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "settings.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

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

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

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

Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

Ορισμοί

Όνομα	Περιγραφή
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
PayloadType	Ο τύπος του ωφέλιμου φορτίου τμήματος ορισμού. Επιπλέον τύποι ωφέλιμου φορτίου μπορούν να προστεθούν με την πάροδο του χρόνου.
UpdateVariableLibraryDefinitionRequest	Ενημερώστε το ωφέλιμο φορτίο αίτησης δημόσιου ορισμού VariableLibrary.
VariableLibraryPublicDefinition	Αντικείμενο δημόσιου ορισμού VariableLibrary. Ανατρέξτε σε αυτό το άρθρο για περισσότερες λεπτομέρειες σχετικά με τον τρόπο δημιουργίας ενός δημόσιου ορισμού VariableLibrary.
VariableLibraryPublicDefinitionPart	Αντικείμενο τμήματος ορισμού VariableLibrary.

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	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

PayloadType

Απαρίθμηση

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

Τιμή	Περιγραφή
InlineBase64	Ενσωματωμένη βάση 64.

UpdateVariableLibraryDefinitionRequest

Object

Ενημερώστε το ωφέλιμο φορτίο αίτησης δημόσιου ορισμού VariableLibrary.

Όνομα	Τύπος	Περιγραφή
definition	VariableLibraryPublicDefinition	Αντικείμενο δημόσιου ορισμού VariableLibrary. Ανατρέξτε σε αυτό το άρθρο για περισσότερες λεπτομέρειες σχετικά με τον τρόπο δημιουργίας ενός δημόσιου ορισμού VariableLibrary.

VariableLibraryPublicDefinition

Object

Αντικείμενο δημόσιου ορισμού VariableLibrary. Ανατρέξτε σε αυτό το άρθρο για περισσότερες λεπτομέρειες σχετικά με τον τρόπο δημιουργίας ενός δημόσιου ορισμού VariableLibrary.

Όνομα	Τύπος	Περιγραφή
format	string	Η μορφή του ορισμού στοιχείου. Υποστηριζόμενη μορφή: `VariableLibraryV1`.
parts	VariableLibraryPublicDefinitionPart[]	Μια λίστα τμημάτων ορισμού.

VariableLibraryPublicDefinitionPart

Object

Αντικείμενο τμήματος ορισμού VariableLibrary.

Όνομα	Τύπος	Περιγραφή
path	string	Η διαδρομή τμήματος δημόσιου ορισμού VariableLibrary.
payload	string	Το ωφέλιμο φορτίο τμήματος δημόσιου ορισμού VariableLibrary.
payloadType	PayloadType	Ο τύπος ωφέλιμου φορτίου.

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

Items - Update Variable Library Definition

Δικαιώματα

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

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

Διασύνδεση

Παράμετροι URI

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

Αποκρίσεις

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

Update a VariableLibrary public definition example

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

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

Ορισμοί

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

PayloadType

UpdateVariableLibraryDefinitionRequest

VariableLibraryPublicDefinition

VariableLibraryPublicDefinitionPart

Πρόσθετοι πόροι