Items - Create Variable Library

Αναφορά

Υπηρεσία:: VariableLibrary

Έκδοση API:: v1

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

Για να δημιουργήσετε το VariableLibrary με έναν δημόσιο ορισμό, ανατρέξτε στο άρθρο VariableLibrary .

Δικαιώματα

Ο καλών πρέπει να έχει συνεισφέροντα ή μεγαλύτερο ρόλο χώρου εργασίας.

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

VariableLibrary.ReadWrite.All ή Item.ReadWrite.All

Περιορισμοί

Για να δημιουργήσετε ένα VariableLibrary, ο χώρος εργασίας πρέπει να βρίσκεται σε υποστηριζόμενους εκχωρημένους πόρους Fabric. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα: τύποι αδειών χρήσης Microsoft Fabric.

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

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

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

Διασύνδεση

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

Παράμετροι URI

Όνομα	Σε	Απαιτείται	Τύπος	Περιγραφή
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.

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

Όνομα	Απαιτείται	Τύπος	Περιγραφή
displayName	True	string	Το εμφανιζόμενο όνομα VariableLibrary. Το εμφανιζόμενο όνομα πρέπει να ακολουθεί τους κανόνες ονομασίας σύμφωνα με τον τύπο στοιχείου.
definition		VariableLibraryPublicDefinition	Ο δημόσιος ορισμός variableLibrary.
description		string	Η περιγραφή variableLibrary. Το μέγιστο μήκος είναι 256 χαρακτήρες.

Αποκρίσεις

Όνομα	Τύπος	Περιγραφή
201 Created	VariableLibrary	Δημιουργήθηκε με επιτυχία
202 Accepted		Αποδοχή αίτησης, Παροχή VariableLibrary σε εξέλιξη. Κεφαλίδες Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: InvalidItemType - Ο τύπος στοιχείου δεν είναι έγκυρος ItemDisplayNameAlreadyInUse - Το εμφανιζόμενο όνομα στοιχείου χρησιμοποιείται ήδη. CorruptedPayload - Το παρεχόμενο ωφέλιμο φορτίο είναι διεφθαρμένο.

Όνομα

Τύπος

Περιγραφή

201 Created

VariableLibrary

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

202 Accepted

Αποδοχή αίτησης, Παροχή VariableLibrary σε εξέλιξη.

Κεφαλίδες

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

Other Status Codes

ErrorResponse

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

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

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

Create a VariableLibrary example

Create a VariableLibrary with public definition example

Create a VariableLibrary example

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

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/VariableLibraries

{
  "displayName": "VariableLibrary 1",
  "description": "A VariableLibrary description."
}

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

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

{
  "displayName": "VariableLibrary 1",
  "description": "A VariableLibrary description.",
  "type": "VariableLibrary",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

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

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a VariableLibrary with public definition example

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

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/VariableLibraries

{
  "displayName": "VariableLibrary 1",
  "description": "A VariableLibrary description.",
  "definition": {
    "format": "VariableLibraryV1",
    "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"
      }
    ]
  }
}

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

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

{
  "displayName": "VariableLibrary 1",
  "description": "A VariableLibrary description.",
  "type": "VariableLibrary",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

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

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Ορισμοί

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

CreateVariableLibraryRequest

Object

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

Όνομα	Τύπος	Περιγραφή
definition	VariableLibraryPublicDefinition	Ο δημόσιος ορισμός variableLibrary.
description	string	Η περιγραφή variableLibrary. Το μέγιστο μήκος είναι 256 χαρακτήρες.
displayName	string	Το εμφανιζόμενο όνομα 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	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

ItemType

Απαρίθμηση

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

Τιμή	Περιγραφή
CopyJob	Μια εργασία αντιγραφής.
Dashboard	Πίνακας εργαλείων του PowerBI.
DataPipeline	Μια διοχέτευση δεδομένων.
Datamart	Datamart του PowerBI.
Environment	Ένα περιβάλλον.
Eventhouse	Μια εκδήλωση.
Eventstream	Μια ροή συμβάντος.
GraphQLApi	Ένα API για το στοιχείο GraphQL.
KQLDashboard	Ένας πίνακας εργαλείων KQL.
KQLDatabase	Μια βάση δεδομένων KQL.
KQLQueryset	Ένα σύνολο ερωτημάτων KQL.
Lakehouse	Ένα λιμνοθάσπιτο.
MLExperiment	Ένα πείραμα εκμάθησης μηχανής.
MLModel	Ένα μοντέλο εκμάθησης μηχανής.
MirroredDatabase	Μια βάση δεδομένων κατοπτρισμού.
MirroredWarehouse	Μια αποθήκη με κατοπτρικό καθρέφτη.
MountedDataFactory	A MountedDataFactory.
Notebook	Ένα σημειωματάριο.
PaginatedReport	Σελιδοποιημένη αναφορά PowerBI.
Reflex	Αντανακλαστικά.
Report	Αναφορά PowerBI.
SQLDatabase	Μια βάση δεδομένων SQL.
SQLEndpoint	Ένα τελικό σημείο SQL.
SemanticModel	Σημασιολογικό μοντέλο PowerBI.
SparkJobDefinition	Ένας ορισμός εργασίας σπινθήρα.
VariableLibrary	Μια μεταβλητήLibrary.
Warehouse	Μια αποθήκη.

PayloadType

Απαρίθμηση

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

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

VariableLibrary

Object

Ένα αντικείμενο VariableLibrary.

Όνομα	Τύπος	Περιγραφή
description	string	Η περιγραφή του στοιχείου.
displayName	string	Το εμφανιζόμενο όνομα του στοιχείου.
folderId	string (uuid)	Το αναγνωριστικό φακέλου.
id	string (uuid)	Το αναγνωριστικό στοιχείου.
properties	VariableLibraryProperties	Οι ιδιότητες variableLibrary.
type	ItemType	Ο τύπος στοιχείου.
workspaceId	string (uuid)	Το αναγνωριστικό χώρου εργασίας.

VariableLibraryProperties

Object

Οι ιδιότητες variableLibrary.

Όνομα	Τύπος	Περιγραφή
activeValueSetName	string	Το σύνολο τρέχουσας ενεργής τιμής VariableLibrary.

VariableLibraryPublicDefinition

Object

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

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

VariableLibraryPublicDefinitionPart

Object

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

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

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

Items - Create Variable Library

Δικαιώματα

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

Περιορισμοί

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

Διασύνδεση

Παράμετροι URI

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

Αποκρίσεις

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

Create a VariableLibrary example

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

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

Create a VariableLibrary with public definition example

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

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

Ορισμοί

CreateVariableLibraryRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemType

PayloadType

VariableLibrary

VariableLibraryProperties

VariableLibraryPublicDefinition

VariableLibraryPublicDefinitionPart

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