Items - Update Variable Library

Služba:

VariableLibrary

Verze rozhraní API:

v1

Aktualizuje vlastnosti zadané knihovny proměnných.

Dovolení

Volající musí mít oprávnění ke čtení a zápisu pro knihovnu proměnných.

Požadované delegovaná rozsahy

VariableLibrary.ReadWrite.All nebo Item.ReadWrite.All

Microsoft Entra podporované identity

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita	Podpora
Uživatel	Ano
Hlavní služba a Spravované identity	Ano

Rozhraní

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
variableLibraryId	path	True	string (uuid)	ID VariableLibrary.
workspaceId	path	True	string (uuid)	ID pracovního prostoru.

Text požadavku

Name	Typ	Description
description	string	Popis VariableLibrary. Maximální délka je 256 znaků.
displayName	string	Zobrazovaný název VariableLibrary. Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.
properties	VariableLibraryProperties	Vlastnosti VariableLibrary.

Odpovědi

Name	Typ	Description
200 OK	VariableLibrary	Žádost byla úspěšně dokončena.
429 Too Many Requests	ErrorResponse	Byl překročen limit přenosové rychlosti služby. Server vrátí hlavičku označující Retry-After , jak dlouho musí klient čekat před odesláním dalších požadavků. Hlavičky Retry-After: integer
Other Status Codes	ErrorResponse	Běžné kódy chyb: ItemNotFound – Požadovaná položka nebyla nalezena. InvalidRequest – Neplatný požadavek na aktualizaci

Příklady

Update a VariableLibrary example

Ukázkový požadavek

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/variableLibraries/5b218778-e7a5-4d73-8187-f10824047715

{
  "displayName": "VariableLibrary's New name",
  "description": "VariableLibrary's New description",
  "properties": {
    "activeValueSetName": "SomeValueSetName"
  }
}

Ukázková odpověď

Stavový kód:

200

{
  "displayName": "VariableLibrary's New name",
  "description": "VariableLibrary's New description",
  "type": "VariableLibrary",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "properties": {
    "activeValueSetName": "SomeValueSetName"
  },
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Definice

Name	Description
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.
ItemTag	Představuje značku použitou u položky.
ItemType	Typ položky. V průběhu času je možné přidat další typy položek.
SensitivityLabel	Představuje popisek citlivosti použitý u položky.
UpdateVariableLibraryRequest	Aktualizace požadavku VariableLibrary
VariableLibrary	A VariableLibrary objekt.
VariableLibraryProperties	Vlastnosti VariableLibrary.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string (uuid)	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou

ItemTag

Objekt

Představuje značku použitou u položky.

Name	Typ	Description
displayName	string	Název značky.
id	string (uuid)	ID značky.

ItemType

Výčet

Typ položky. V průběhu času je možné přidat další typy položek.

Hodnota	Description
Dashboard	Řídicí panel PowerBI
Report	Sestava PowerBI
SemanticModel	Sémantický model PowerBI
PaginatedReport	Stránkovaná sestava PowerBI
Datamart	Datový diagram PowerBI
Lakehouse	Jezero.
Eventhouse	Eventhouse.
Environment	Prostředí.
KQLDatabase	Databáze KQL.
KQLQueryset	Sada dotazů KQL.
KQLDashboard	Řídicí panel KQL.
DataPipeline	Datový kanál.
Notebook	Poznámkový blok.
SparkJobDefinition	Definice úlohy Sparku.
MLExperiment	Experiment strojového učení.
MLModel	Model strojového učení.
Warehouse	Sklad.
Eventstream	Eventstream.
SQLEndpoint	Koncový bod SQL.
MirroredWarehouse	Zrcadlený sklad.
MirroredDatabase	Zrcadlené databáze.
Reflex	A Reflex.
GraphQLApi	Rozhraní API pro položku GraphQL
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Databáze SQLDatabase.
CopyJob	Úloha kopírování.
VariableLibrary	ProměnnáLibrary.
Dataflow	Tok dat.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Snímek skladu.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Tok digitálního dvojčete.
MirroredAzureDatabricksCatalog	Zrcadlený katalog Azure Databricks.
Map	Mapa.
AnomalyDetector	Detektor anomálií.
UserDataFunction	Funkce uživatelských dat.
GraphModel	A GraphModel.
GraphQuerySet	Sada dotazů grafu.
SnowflakeDatabase	Snowflake Database pro ukládání tabulek Iceberg vytvořených z účtu Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Databáze Cosmos DB.
Ontology	Ontologie.
EventSchemaSet	An EventSchemaSet.
DataAgent	A DataAgent.

SensitivityLabel

Objekt

Představuje popisek citlivosti použitý u položky.

Name	Typ	Description
id	string (uuid)	ID popisku citlivosti.

UpdateVariableLibraryRequest

Objekt

Aktualizace požadavku VariableLibrary

Name	Typ	Description
description	string	Popis VariableLibrary. Maximální délka je 256 znaků.
displayName	string	Zobrazovaný název VariableLibrary. Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.
properties	VariableLibraryProperties	Vlastnosti VariableLibrary.

VariableLibrary

Objekt

A VariableLibrary objekt.

Name	Typ	Description
description	string	Popis položky.
displayName	string	Zobrazovaný název položky.
folderId	string (uuid)	ID složky.
id	string (uuid)	ID položky.
properties	VariableLibraryProperties	Vlastnosti VariableLibrary.
sensitivityLabel	SensitivityLabel	Popisek citlivosti položky.
tags	ItemTag[]	Seznam použitých značek
type	ItemType	Typ položky.
workspaceId	string (uuid)	ID pracovního prostoru.

VariableLibraryProperties

Objekt

Vlastnosti VariableLibrary.

Name	Typ	Description
activeValueSetName	string	ProměnnáLibrary – aktuální sada aktivních hodnot.