Items - Create Variable Library

Palvelu:: VariableLibrary

Ohjelmointirajapinnan versio:: v1

Luo muuttujakirjaston määritettyyn työtilaan.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Jos haluat luoda VariableLibraryn julkisella määrityksellä, katso artikkeli VariableLibrary .

Käyttöoikeudet

Kutsujalla on oltava osallistujan työtilan rooli.

Vaaditut delegoidut vaikutusalueet

VariableLibrary.ReadWrite.All tai Item.ReadWrite.All

Rajoitukset

VariableLibrary-ominaisuuden luomiseksi työtilan on oltava tuetussa Fabric-kapasiteetissa. Lisätietoja on ohjeaiheessa Microsoft Fabric -käyttöoikeustyypit.

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Käyttäjätiedot	Tuki
Käyttäjä	Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen	Kyllä

Liittymä

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Description
workspaceId	path	True	string (uuid)	Työtilan tunnus.

Pyynnön leipäteksti

Nimi	Pakollinen	Tyyppi	Description
displayName	True	string	VariableLibrary-näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.
definition		VariableLibraryPublicDefinition	Julkinen VariableLibrary-määritys.
description		string	VariableLibrary-kuvaus. Enimmäispituus on 256 merkkiä.
folderId		string (uuid)	Kansion tunnus. Jos sitä ei määritetä tai se on tyhjäarvo, VariableLibrary luodaan niin, että työtila on sen kansio.

Vastaukset

Nimi	Tyyppi	Description
201 Created	VariableLibrary	Luonti onnistui
202 Accepted		Pyynnön hyväksyminen, VariableLibrary-valmistelu on meneillään. Otsikot Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: InvalidItemType – Kohdetyyppi on virheellinen ItemDisplayNameAlreadyInUse – Kohteen näyttönimi on jo käytössä. VioittunutPayload – Annetut tiedot ovat vioittuneet.

Nimi

Tyyppi

Description

201 Created

VariableLibrary

Luonti onnistui

202 Accepted

Pyynnön hyväksyminen, VariableLibrary-valmistelu on meneillään.

Otsikot

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

Other Status Codes

ErrorResponse

Yleiset virhekoodit:

InvalidItemType – Kohdetyyppi on virheellinen
ItemDisplayNameAlreadyInUse – Kohteen näyttönimi on jo käytössä.
VioittunutPayload – Annetut tiedot ovat vioittuneet.

Esimerkit

Create a VariableLibrary example

Create a VariableLibrary with public definition example

Create a VariableLibrary example

Mallipyyntö

HTTP

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

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

Mallivastaus

Tilakoodi:: 201

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

Tilakoodi:: 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

Mallipyyntö

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

Mallivastaus

Tilakoodi:: 201

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

Tilakoodi:: 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

Määritelmät

Nimi	Description
CreateVariableLibraryRequest	Luo VariableLibrary-pyynnön tiedot.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
ItemTag	Edustaa kohteelle käytettyä tunnistetta.
ItemType	Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.
PayloadType	Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.
VariableLibrary	VariableLibrary-objekti.
VariableLibraryProperties	VariableLibrary-ominaisuudet.
VariableLibraryPublicDefinition	VariableLibrary public definition object. Katso tästä artikkelista lisätietoja VariableLibrary-julkisen määrityksen luomisesta.
VariableLibraryPublicDefinitionPart	VariableLibrary-määritelmäosaobjekti.

CreateVariableLibraryRequest

Kohde

Luo VariableLibrary-pyynnön tiedot.

Nimi	Tyyppi	Description
definition	VariableLibraryPublicDefinition	Julkinen VariableLibrary-määritys.
description	string	VariableLibrary-kuvaus. Enimmäispituus on 256 merkkiä.
displayName	string	VariableLibrary-näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.
folderId	string (uuid)	Kansion tunnus. Jos sitä ei määritetä tai se on tyhjäarvo, VariableLibrary luodaan niin, että työtila on sen kansio.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Description
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

ItemTag

Kohde

Edustaa kohteelle käytettyä tunnistetta.

Nimi	Tyyppi	Description
displayName	string	Tunnisteen nimi.
id	string (uuid)	Tunnisteen tunnus.

ItemType

Luettelointi

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.

Arvo	Description
Dashboard	Power BI -koontinäyttö.
Report	PowerBI -raportti.
SemanticModel	PowerBI:n semanttinen malli.
PaginatedReport	PowerBI:n sivutettu raportti.
Datamart	PowerBI -tietomarssi.
Lakehouse	Tämä on lakehouse.
Eventhouse	Tapahtumatalo.
Environment	Ympäristö.
KQLDatabase	KQL-tietokanta.
KQLQueryset	KQL-kyselyjoukko.
KQLDashboard	KQL-koontinäyttö.
DataPipeline	Tietoputki.
Notebook	Muistikirja.
SparkJobDefinition	Spark-työn määritelmä.
MLExperiment	Koneoppimisen kokeilu.
MLModel	Koneoppimismalli.
Warehouse	Varasto.
Eventstream	Tapahtumavirta.
SQLEndpoint	SQL-päätepiste.
MirroredWarehouse	Peilattu varasto.
MirroredDatabase	Peilattu tietokanta.
Reflex	Refleksi.
GraphQLApi	Ohjelmointirajapinta GraphQL-kohteelle.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Kopiotyö.
VariableLibrary	MuuttujaLibrary.
Dataflow	Tietovuo.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Varastotilannevedos.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Digital Twin Builder -työnkulku.
MirroredAzureDatabricksCatalog	Peilattu Azure Databricks -luettelo.
Map	Kartta.
AnomalyDetector	Poikkeamien tunnistaminen.
UserDataFunction	Käyttäjätietofunktio.
GraphModel	A GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	Snowflake-tietokannalla tallennetaan Snowflake-tililtä luodut Iceberg-taulukot.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Cosmos DB -tietokanta.
Ontology	Ontologia.
EventSchemaSet	An EventSchemaSet.

PayloadType

Luettelointi

Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.

Arvo	Description
InlineBase64	Inline Base 64.

VariableLibrary

Kohde

VariableLibrary-objekti.

Nimi	Tyyppi	Description
description	string	Kohteen kuvaus.
displayName	string	Kohteen näyttönimi.
folderId	string (uuid)	Kansion tunnus.
id	string (uuid)	Kohdetunnus.
properties	VariableLibraryProperties	VariableLibrary-ominaisuudet.
tags	ItemTag[]	Luettelo käytössä olevista tunnisteista.
type	ItemType	Kohdetyyppi.
workspaceId	string (uuid)	Työtilan tunnus.

VariableLibraryProperties

Kohde

VariableLibrary-ominaisuudet.

Nimi	Tyyppi	Description
activeValueSetName	string	VariableLibrary-ominaisuuden nykyinen aktiivinen arvojoukko.

VariableLibraryPublicDefinition

Kohde

VariableLibrary public definition object. Katso tästä artikkelista lisätietoja VariableLibrary-julkisen määrityksen luomisesta.

Nimi	Tyyppi	Description
format	string	Kohteen määrityksen muoto. Tuettu muoto: `VariableLibraryV1`.
parts	VariableLibraryPublicDefinitionPart[]	Luettelo määritysosista.

VariableLibraryPublicDefinitionPart

Kohde

VariableLibrary-määritelmäosaobjekti.

Nimi	Tyyppi	Description
path	string	VariableLibrary-julkisen määrityksen osan polku.
payload	string	VariableLibrary-julkisen määritelmän osakuormitus.
payloadType	PayloadType	Hyötykuorman tyyppi.

Jaa

Items - Create Variable Library

Käyttöoikeudet

Vaaditut delegoidut vaikutusalueet

Rajoitukset

Microsoft Entran tukemat käyttäjätiedot

Liittymä

URI-parametrit

Pyynnön leipäteksti

Vastaukset

Esimerkit

Create a VariableLibrary example

Mallipyyntö

Mallivastaus

Create a VariableLibrary with public definition example

Mallipyyntö

Mallivastaus

Määritelmät

CreateVariableLibraryRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

PayloadType

VariableLibrary

VariableLibraryProperties

VariableLibraryPublicDefinition

VariableLibraryPublicDefinitionPart