Items - Create Variable Library

Szolgáltatás:: VariableLibrary

API-verzió:: v1

Létrehoz egy változótárat a megadott munkaterületen.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

A VariableLibrary nyilvános definícióval való létrehozásához tekintse meg a VariableLibrary cikket.

Engedélyek

A hívónak közreműködői munkaterületi szerepkörrel kell rendelkeznie.

Kötelező delegált hatókörök

VariableLibrary.ReadWrite.All vagy Item.ReadWrite.All

Korlátozások

A VariableLibrary létrehozásához a munkaterületnek támogatott hálókapacitáson kell lennie. További információ: Microsoft Fabric licenctípusok.

Microsoft Entra támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Személyazonosság	Támogatás
Felhasználó	Igen
szolgáltatás-princípium és felügyelt identitások	Igen

Interfész

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.

Kérelem törzse

Name	Kötelező	Típus	Description
displayName	True	string	A VariableLibrary megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.
definition		VariableLibraryPublicDefinition	A VariableLibrary nyilvános definíciója.
description		string	A VariableLibrary leírása. A maximális hossz 256 karakter.
folderId		string (uuid)	A mappa azonosítója. Ha nincs megadva vagy null, a VariableLibrary a munkaterülettel jön létre mappaként.
sensitivityLabelSettings		SensitivityLabelSettings	A VariableLibrary bizalmassági címkebeállításai.

Válaszok

Name	Típus	Description
201 Created	VariableLibrary	Sikeresen létrehozva
202 Accepted		A kérelem elfogadva, a VariableLibrary kiépítése folyamatban van. Fejlécek Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Túllépte a szolgáltatási sebesség korlátját. A kiszolgáló egy `Retry-After` fejlécet ad vissza másodpercek alatt, amely jelzi, hogy az ügyfélnek mennyi ideig kell várnia a további kérések elküldése előtt. Fejlécek Retry-After: integer
Other Status Codes	ErrorResponse	Gyakori hibakódok: InvalidItemType – Az elem típusa érvénytelen ItemDisplayNameAlreadyInUse – Az elem megjelenítendő neve már használatban van. CorruptedPayload – A megadott hasznos adatok sérültek.

Példák

Create a VariableLibrary example

Create a VariableLibrary with public definition example

Create a VariableLibrary example

Mintakérelem

HTTP

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

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

Mintaválasz

Állapotkód:: 201

{
  "displayName": "VariableLibrary 1",
  "description": "A VariableLibrary description.",
  "type": "VariableLibrary",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Állapotkód:: 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

Mintakérelem

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"
      }
    ]
  }
}

Mintaválasz

Állapotkód:: 201

{
  "displayName": "VariableLibrary 1",
  "description": "A VariableLibrary description.",
  "type": "VariableLibrary",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Állapotkód:: 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

Definíciók

Name	Description
CreateVariableLibraryRequest	A VariableLibrary-kérelem hasznos adatainak létrehozása.
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
ItemTag	Egy elemre alkalmazott címkét jelöl.
ItemType	Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
PayloadType	A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.
SensitivityLabel	Egy elemre alkalmazott bizalmassági címkét jelöl.
SensitivityLabelApplyStrategy	A bizalmassági címke alkalmazásának stratégiája. Az alapértelmezett érték az ApplyOrFail. Idővel további típusok is hozzáadhatók.
SensitivityLabelSettings	A bizalmassági címke beállításai.
VariableLibrary	Egy VariableLibrary objektum.
VariableLibraryProperties	A VariableLibrary tulajdonságai.
VariableLibraryPublicDefinition	VariableLibrary nyilvános definíciós objektum. A VariableLibrary definíció szerkezetével kapcsolatos további részletekért tekintse meg ezt a cikket .
VariableLibraryPublicDefinitionPart	A VariableLibrary definíció részobjektuma.

CreateVariableLibraryRequest

Tárgy

A VariableLibrary-kérelem hasznos adatainak létrehozása.

Name	Típus	Description
definition	VariableLibraryPublicDefinition	A VariableLibrary nyilvános definíciója.
description	string	A VariableLibrary leírása. A maximális hossz 256 karakter.
displayName	string	A VariableLibrary megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.
folderId	string (uuid)	A mappa azonosítója. Ha nincs megadva vagy null, a VariableLibrary a munkaterülettel jön létre mappaként.
sensitivityLabelSettings	SensitivityLabelSettings	A VariableLibrary bizalmassági címkebeállításai.

ErrorRelatedResource

Tárgy

A hibával kapcsolatos erőforrás-részletek objektum.

Name	Típus	Description
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Tárgy

A hibaválasz.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string (uuid)	A hibához társított kérés azonosítója.

ErrorResponseDetails

Tárgy

A hibaválasz részletei.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

ItemTag

Tárgy

Egy elemre alkalmazott címkét jelöl.

Name	Típus	Description
displayName	string	A címke neve.
id	string (uuid)	A címke azonosítója.

ItemType

Felsorolás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték	Description
Dashboard	PowerBI-irányítópult.
Report	PowerBI-jelentés.
SemanticModel	PowerBI szemantikai modell.
PaginatedReport	Többoldalas PowerBI-jelentés.
Datamart	PowerBI datamart.
Lakehouse	Egy tóház.
Eventhouse	Egy rendezvényház.
Environment	Egy környezet.
KQLDatabase	KQL-adatbázis.
KQLQueryset	KQL-lekérdezéskészlet.
KQLDashboard	KQL-irányítópult.
DataPipeline	Egy adatfolyam.
Notebook	Egy jegyzetfüzet.
SparkJobDefinition	Spark-feladat definíciója.
MLExperiment	Gépi tanulási kísérlet.
MLModel	Gépi tanulási modell.
Warehouse	Egy raktár.
Eventstream	Eseménystream.
SQLEndpoint	EGY SQL-végpont.
MirroredWarehouse	Egy tükrözött raktár.
MirroredDatabase	Tükrözött adatbázis.
Reflex	Egy reflex.
GraphQLApi	Api a GraphQL-elemhez.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Másolási feladat.
VariableLibrary	Egy VariableLibrary.
Dataflow	Adatfolyam.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Raktári pillanatkép.
DigitalTwinBuilder	Egy DigitalTwinBuilder.
DigitalTwinBuilderFlow	A Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	Tükrözött Azure Databricks-katalógus.
Map	Térkép.
AnomalyDetector	Anomáliadetektor.
UserDataFunction	Felhasználói adatfüggvény.
GraphModel	Egy GraphModel.
GraphQuerySet	Egy Graph Queryset.
SnowflakeDatabase	Snowflake-adatbázis a Snowflake-fiókból létrehozott Iceberg-táblák tárolására.
OperationsAgent	Egy OperationsAgent.
CosmosDBDatabase	Cosmos DB-adatbázis.
Ontology	Egy ontológia.
EventSchemaSet	An EventSchemaSet.
DataAgent	Egy DataAgent.

PayloadType

Felsorolás

A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.

Érték	Description
InlineBase64	Beágyazott 64-es alap.

SensitivityLabel

Tárgy

Egy elemre alkalmazott bizalmassági címkét jelöl.

Name	Típus	Description
id	string (uuid)	A bizalmassági címke azonosítója.

SensitivityLabelApplyStrategy

Felsorolás

A bizalmassági címke alkalmazásának stratégiája. Az alapértelmezett érték az ApplyOrFail. Idővel további típusok is hozzáadhatók.

Érték	Description
ApplyOrFail	Alkalmazza a bizalmassági címkét, vagy ha nem alkalmazható, akkor a művelet meghiúsul.
Ignore	Hagyja figyelmen kívül a bizalmassági címkét, ha nem alkalmazható, és folytassa a műveletet a címke alkalmazása nélkül.

SensitivityLabelSettings

Tárgy

A bizalmassági címke beállításai.

Name	Típus	Description
labelId	string (uuid)	A bizalmassági címke azonosítója.
sensitivityLabelApplyStrategy	SensitivityLabelApplyStrategy	A bizalmassági címke alkalmazásának stratégiája.

VariableLibrary

Tárgy

Egy VariableLibrary objektum.

Name	Típus	Description
description	string	Az elem leírása.
displayName	string	Az elem megjelenítendő neve.
folderId	string (uuid)	A mappa azonosítója.
id	string (uuid)	Az elem azonosítója.
properties	VariableLibraryProperties	A VariableLibrary tulajdonságai.
sensitivityLabel	SensitivityLabel	Az elem bizalmassági címkéje.
tags	ItemTag[]	Az alkalmazott címkék listája.
type	ItemType	Az elem típusa.
workspaceId	string (uuid)	A munkaterület azonosítója.

VariableLibraryProperties

Tárgy

A VariableLibrary tulajdonságai.

Name	Típus	Description
activeValueSetName	string	A VariableLibrary aktuális aktív értékkészlete.

VariableLibraryPublicDefinition

Tárgy

VariableLibrary nyilvános definíciós objektum. A VariableLibrary definíció szerkezetével kapcsolatos további részletekért tekintse meg ezt a cikket .

Name	Típus	Description
format	string	Az elemdefiníció formátuma. Támogatott formátum: `VariableLibraryV1`.
parts	VariableLibraryPublicDefinitionPart[]	Definíciórészek listája.

VariableLibraryPublicDefinitionPart

Tárgy

A VariableLibrary definíció részobjektuma.

Name	Típus	Description
path	string	A VariableLibrary nyilvános definíciós rész elérési útja.
payload	string	A VariableLibrary nyilvános definíciójának hasznos adatai.
payloadType	PayloadType	A hasznos adat típusa.

Megosztás a következőn keresztül:

Items - Create Variable Library

Engedélyek

Kötelező delegált hatókörök

Korlátozások

Microsoft Entra támogatott identitások

Interfész

URI-paraméterek

Kérelem törzse

Válaszok

Példák

Create a VariableLibrary example

Mintakérelem

Mintaválasz

Create a VariableLibrary with public definition example

Mintakérelem

Mintaválasz

Definíciók

CreateVariableLibraryRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

PayloadType

SensitivityLabel

SensitivityLabelApplyStrategy

SensitivityLabelSettings

VariableLibrary

VariableLibraryProperties

VariableLibraryPublicDefinition

VariableLibraryPublicDefinitionPart