Items - Update Variable Library Definition

Service:

VariableLibrary

API-versie:

v1

Hiermee wordt de definitie voor de opgegeven variabelebibliotheek overschreven.
Deze API ondersteunt langlopende bewerkingen (LRO).

Het bijwerken van de definitie van VariableLibrary heeft geen invloed op het vertrouwelijkheidslabel.

Machtigingen

De aanroeper moet lees- en schrijfmachtigingen hebben voor de variabelebibliotheek.

Vereiste gedelegeerde bereiken

VariableLibrary.ReadWrite.All of Item.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Ondersteuning
Gebruiker	Ja
serviceprincipal en beheerde identiteiten	Ja

gebruikersinterface

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

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
variableLibraryId	path	True	string (uuid)	De VariableLibrary-id.
workspaceId	path	True	string (uuid)	De werkruimte-id.
updateMetadata	query		boolean	Als deze is ingesteld op true en het .platform-bestand wordt opgegeven als onderdeel van de definitie, worden de metagegevens van het item bijgewerkt met behulp van de metagegevens in het PLATFORM-bestand

Aanvraagbody

Name	Vereist	Type	Description
definition	True	VariableLibraryPublicDefinition	VariableLibrary public definition object. Raadpleeg dit artikel voor meer informatie over het maken van een variabelelibrary openbare definitie.

Antwoorden

Name	Type	Description
200 OK		De aanvraag is voltooid.
202 Accepted		Aanvraag geaccepteerd. De definitie van de update wordt uitgevoerd. Kopteksten Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: OperationNotSupportedForItem - Bewerking wordt niet ondersteund voor aangevraagd item. CorruptedPayload: de opgegeven nettolading is beschadigd.

Voorbeelden

Update a VariableLibrary public definition example

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

200

Statuscode:

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

Definities

Name	Description
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
PayloadType	Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.
UpdateVariableLibraryDefinitionRequest	Update VariableLibrary public definition request payload.
VariableLibraryPublicDefinition	VariableLibrary public definition object. Raadpleeg dit artikel voor meer informatie over het maken van een variabelelibrary openbare definitie.
VariableLibraryPublicDefinitionPart	VariableLibrary definition part object.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

PayloadType

Inventarisatie

Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.

Waarde	Description
InlineBase64	Inline base 64.

UpdateVariableLibraryDefinitionRequest

Object

Update VariableLibrary public definition request payload.

Name	Type	Description
definition	VariableLibraryPublicDefinition	VariableLibrary public definition object. Raadpleeg dit artikel voor meer informatie over het maken van een variabelelibrary openbare definitie.

VariableLibraryPublicDefinition

Object

VariableLibrary public definition object. Raadpleeg dit artikel voor meer informatie over het maken van een variabelelibrary openbare definitie.

Name	Type	Description
format	string	De indeling van de itemdefinitie. Ondersteunde indeling: VariableLibraryV1.
parts	VariableLibraryPublicDefinitionPart[]	Een lijst met definitieonderdelen.

VariableLibraryPublicDefinitionPart

Object

VariableLibrary definition part object.

Name	Type	Description
path	string	Het pad van het onderdeel VariableLibrary public definition.
payload	string	De payload van het openbare definitieonderdeel VariableLibrary.
payloadType	PayloadType	Het nettoladingstype.