Items - Update User Data Function Definition

Služba:: UserDataFunction

Verzia rozhrania API:: v1

Prepíše definíciu pre zadanú funkciu UserDataFunction.
Toto rozhranie API podporuje dlhotrvajúce operácie (LRO).

Aktualizácia definície funkcie UserDataFunction neovplyvňuje jej označenie citlivosti.

Povolenia

Volajúci musí mať povolenia na čítanie a zapisovanie pre funkciu UserDataFunction.

Povinné delegované rozsahy

Item.ReadWrite.All

podporované identity Microsoft Entra

Toto rozhranie API podporuje identity Microsoft uvedené v tejto časti.

Identita	Podporovať
Používateľ	Áno
Objekt služby a spravované identity	Nie

Rozhranie

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/userDataFunctions/{userDataFunctionId}/updateDefinition

S voliteľnými parametrami:

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

Parametre URI

Name	V	Povinné	Typ	Description
userDataFunctionId	path	True	string (uuid)	ID userDataFunction.
workspaceId	path	True	string (uuid)	ID pracovného priestoru.
updateMetadata	query		boolean	Keď je hodnota nastavená na true a súbor .platform sa poskytne ako súčasť definície, metaúdaje položky sa aktualizujú pomocou metaúdajov v súbore .platform

Text požiadavky

Name	Povinné	Typ	Description
definition	True	UserDataFunctionPublicDefinition	Objekt verejnej definície UserDataFunction. Ďalšie podrobnosti o štruktúre definície userDataFunction nájdete v tomto článku .

Odpovede

Name	Typ	Description
200 OK		Požiadavka sa úspešne dokončila.
202 Accepted		Žiadosť prijatá. Prebieha definícia aktualizácie. Hlavičky Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Prekročil sa limit rýchlosti služby. Server vráti hlavičku `Retry-After` v sekundách, ako dlho musí klient počkať, kým odošle ďalšie požiadavky. Hlavičky Retry-After: integer
Other Status Codes	ErrorResponse	Bežné kódy chýb: OperationNotSupportedForItem – Operácia nie je podporovaná pre požadovanú položku. CorruptedPayload – poskytnutá údajová časť je poškodená.

Príklady

Update a UserDataFunction public definition example

Vzorová požiadavka

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/userDataFunctions/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "UserDataFunctionV1.json",
        "payload": "ew0KICAiZXhlY3V0YW..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Vzorová odpoveď

Kód stavu:: 200

Kód stavu:: 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ície

Name	Description
ErrorRelatedResource	Objekt s podrobnosťami o zdroji súvisiacej s chybou.
ErrorResponse	Odpoveď na chybu.
ErrorResponseDetails	Podrobnosti o chybovej odpovedi.
PayloadType	Typ údajovej časti definície. V priebehu času je možné pridať ďalšie typy údajovej časti.
UpdateUserDataFunctionDefinitionRequest	Aktualizujte údajovú časť požiadavky verejnej definície UserDataFunction.
UserDataFunctionPublicDefinition	Objekt verejnej definície UserDataFunction. Ďalšie podrobnosti o štruktúre definície userDataFunction nájdete v tomto článku .
UserDataFunctionPublicDefinitionPart	Časť objektu definície UserDataFunction.

ErrorRelatedResource

Object

Objekt s podrobnosťami o zdroji súvisiacej s chybou.

Name	Typ	Description
resourceId	string	ID prostriedku, ktoré je súčasťou chyby.
resourceType	string	Typ prostriedku, ktorý je zapojený do chyby.

ErrorResponse

Object

Odpoveď na chybu.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
isRetriable	boolean	Ak je hodnota true, žiadosť sa môže zopakovať. `Retry-After` Ak je k dispozícii, oneskorenie môžete určiť pomocou hlavičky odpovede.
message	string	Zobrazenie chyby čitateľné ľuďmi.
moreDetails	ErrorResponseDetails[]	Zoznam ďalších podrobností o chybe.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.
requestId	string (uuid)	ID požiadavky súvisiacej s chybou.

ErrorResponseDetails

Object

Podrobnosti o chybovej odpovedi.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.

PayloadType

Enumerácia

Typ údajovej časti definície. V priebehu času je možné pridať ďalšie typy údajovej časti.

Hodnota	Description
InlineBase64	Inline Base 64.

UpdateUserDataFunctionDefinitionRequest

Object

Aktualizujte údajovú časť požiadavky verejnej definície UserDataFunction.

Name	Typ	Description
definition	UserDataFunctionPublicDefinition	Objekt verejnej definície UserDataFunction. Ďalšie podrobnosti o štruktúre definície userDataFunction nájdete v tomto článku .

UserDataFunctionPublicDefinition

Object

Objekt verejnej definície UserDataFunction. Ďalšie podrobnosti o štruktúre definície userDataFunction nájdete v tomto článku .

Name	Typ	Description
format	string	Formát definície údajovej funkcie používateľa.
parts	UserDataFunctionPublicDefinitionPart[]	Zoznam častí definície.

UserDataFunctionPublicDefinitionPart

Object

Časť objektu definície UserDataFunction.

Name	Typ	Description
path	string	Cesta k verejnej definícii UserDataFunction.
payload	string	Údajová časť údajovej časti funkcie UserDataFunction.
payloadType	PayloadType	Typ údajovej časti.