Items - Create Reflex

Referencia

Szolgáltatás:: Reflex

API-verzió:: v1

Reflexet hoz létre a megadott munkaterületen.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

Ha definícióval szeretne jegyzetfüzetet létrehozni, tekintse meg Reflex definíciós cikket.

Engedélyek

A hívónak közreműködői vagy magasabb munkaterületi szerepkört kell tartalmaznia.

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

Reflex.ReadWrite.All vagy Item.ReadWrite.All

Korlátozások

Reflex létrehozásához a munkaterületnek támogatott hálókapacitáson kell lennie. További információ: Microsoft Fabric-licenctípusok.

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság	Támogat
Felhasználó	Igen
szolgáltatásnév és felügyelt identitások	Nem

Interfész

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.

Kérelem törzse

Name	Kötelező	Típus	Description
displayName	True	string	A Reflex megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.
definition		ReflexDefinition	A Reflex nyilvános definíciója.
description		string	A Reflex leírása. A maximális hossz 256 karakter.

Válaszok

Name	Típus	Description
201 Created	Reflex	Sikeresen létrehozva
202 Accepted		A kérelem elfogadva, a jegyzetfüzet kiépítése folyamatban van. Fejlécek Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Gyakori hibakódok: InvalidItemType – Az elem típusa érvénytelen ItemDisplayNameAlreadyInUse – Az elem megjelenítendő neve már használatban van. CorruptedPayload – A megadott hasznos adatok sérültek. WorkspaceItemsLimitExceeded – A munkaterület elemkorlátja túllépve.

Name

Típus

Description

201 Created

Reflex

Sikeresen létrehozva

202 Accepted

A kérelem elfogadva, a jegyzetfüzet kiépítése folyamatban van.

Fejlécek

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

Other Status Codes

ErrorResponse

Gyakori hibakódok:

InvalidItemType – Az elem típusa érvénytelen
ItemDisplayNameAlreadyInUse – Az elem megjelenítendő neve már használatban van.
CorruptedPayload – A megadott hasznos adatok sérültek.
WorkspaceItemsLimitExceeded – A munkaterület elemkorlátja túllépve.

Példák

Create a Reflex example

Create a Reflex with public definition example

Create a Reflex example

Mintakérelem

HTTP

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

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

Mintaválasz

Állapotkód:: 201

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

Állapotkód:: 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 Reflex with public definition example

Mintakérelem

HTTP

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

{
  "displayName": "Reflex 1",
  "description": "A Reflex description",
  "definition": {
    "format": "json",
    "parts": [
      {
        "path": "ReflexEntities.json",
        "payload": "eyJuYmZvcm1hdCI6N..5ndWUiOiJweXRob24ifX19",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Mintaválasz

Állapotkód:: 201

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

Állapotkód:: 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

Definíciók

Name	Description
CreateReflexRequest	Reflex-kérelem hasznos adatainak létrehozása.
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
ItemType	Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
PayloadType	A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.
Reflex	Reflex objektum.
ReflexDefinition	Reflex nyilvános definíciós objektum. Ebben a cikkben további információt a Reflex nyilvános definíciójának elkészítéséről.
ReflexDefinitionPart	Reflexdefiníciós részobjektum.

CreateReflexRequest

Objektum

Reflex-kérelem hasznos adatainak létrehozása.

Name	Típus	Description
definition	ReflexDefinition	A Reflex nyilvános definíciója.
description	string	A Reflex leírása. A maximális hossz 256 karakter.
displayName	string	A Reflex megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.

ErrorRelatedResource

Objektum

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

Objektum

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	A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

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.

ItemType

Enumerálás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték	Description
CopyJob	Másolási feladat.
Dashboard	PowerBI-irányítópult.
DataPipeline	Egy adatfolyam.
Datamart	PowerBI datamart.
Environment	Egy környezet.
Eventhouse	Egy rendezvényház.
Eventstream	Eseménystream.
GraphQLApi	Api a GraphQL-elemhez.
KQLDashboard	KQL-irányítópult.
KQLDatabase	KQL-adatbázis.
KQLQueryset	KQL-lekérdezéskészlet.
Lakehouse	Egy tóház.
MLExperiment	Gépi tanulási kísérlet.
MLModel	Gépi tanulási modell.
MirroredDatabase	Tükrözött adatbázis.
MirroredWarehouse	Egy tükrözött raktár.
MountedDataFactory	A MountedDataFactory.
Notebook	Egy jegyzetfüzet.
PaginatedReport	Többoldalas PowerBI-jelentés.
Reflex	Egy reflex.
Report	PowerBI-jelentés.
SQLDatabase	A SQLDatabase.
SQLEndpoint	EGY SQL-végpont.
SemanticModel	PowerBI szemantikai modell.
SparkJobDefinition	Spark-feladat definíciója.
VariableLibrary	Egy VariableLibrary.
Warehouse	Egy raktár.

PayloadType

Enumerálá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.

Reflex

Objektum

Reflex objektum.

Name	Típus	Description
description	string	Az elem leírása.
displayName	string	Az elem megjelenítendő neve.
folderId	string (uuid)	A mappa azonosítója.
id	string (uuid)	Az elem azonosítója.
type	ItemType	Az elem típusa.
workspaceId	string (uuid)	A munkaterület azonosítója.

ReflexDefinition

Objektum

Reflex nyilvános definíciós objektum. Ebben a cikkben további információt a Reflex nyilvános definíciójának elkészítéséről.

Name	Típus	Description
format	string	Az elemdefiníció formátuma. Támogatott formátum: `json`.
parts	ReflexDefinitionPart[]	Definíciórészek listája.

ReflexDefinitionPart

Objektum

Reflexdefiníciós részobjektum.

Name	Típus	Description
path	string	A Reflex nyilvános definíció részútvonala.
payload	string	A Reflex nyilvános definíciójának hasznos adatai.
payloadType	PayloadType	A hasznos adat típusa.

Megosztás a következőn keresztül:

Items - Create Reflex

Engedélyek

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

Korlátozások

Microsoft Entra által támogatott identitások

Interfész

URI-paraméterek

Kérelem törzse

Válaszok

Példák

Create a Reflex example

Mintakérelem

Mintaválasz

Create a Reflex with public definition example

Mintakérelem

Mintaválasz

Definíciók

CreateReflexRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemType

PayloadType

Reflex

ReflexDefinition

ReflexDefinitionPart

További források