Items - Update Variable Library Definition

Szolgáltatás:

VariableLibrary

API-verzió:

v1

Felülbírálja a megadott változótár definícióját.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

A VariableLibrary definíciójának frissítése nem befolyásolja a bizalmassági címkét.

Engedélyek

A hívónak olvasási és írási engedélyekkel kell rendelkeznie a változótárhoz.

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

VariableLibrary.ReadWrite.All vagy Item.ReadWrite.All

Microsoft Entra által 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/{variableLibraryId}/updateDefinition

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
variableLibraryId	path	True	string (uuid)	A VariableLibrary azonosítója.
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.
updateMetadata	query		boolean	Ha igaz értékre van állítva, és a .platformfájl a definíció részeként van megadva, az elem metaadatai a .platformfájl metaadataival frissülnek

Kérelem törzse

Name	Kötelező	Típus	Description
definition	True	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 .

Válaszok

Name	Típus	Description
200 OK		A kérés sikeresen befejeződött.
202 Accepted		A kérelem elfogadva. A frissítésdefiníció 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: OperationNotSupportedForItem – A művelet nem támogatott a kért elemhez. CorruptedPayload – A megadott hasznos adatok sérültek.

Példák

Update a VariableLibrary public definition example

Mintakérelem

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

Mintaválasz

Állapotkód:

200

Állapotkód:

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

Definíciók

Name	Description
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
PayloadType	A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.
UpdateVariableLibraryDefinitionRequest	Frissítse a VariableLibrary nyilvános definíciós kérés hasznos adatait.
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.

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.

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.

UpdateVariableLibraryDefinitionRequest

Tárgy

Frissítse a VariableLibrary nyilvános definíciós kérés hasznos adatait.

Name	Típus	Description
definition	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 .

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.