Jaa

Items - Create Item

  • Viite
Palvelu:
Core
Ohjelmointirajapinnan versio:
v1

Luo kohteen määritettyyn työtilaan.
Tätä ohjelmointirajapintaa tuetaan useille kohdetyypeille. Se etsii tuetut kohdetyypit kohdasta Kohdehallinnan yleiskatsaus. Voit käyttää Hae kohteen määrityksen ohjelmointirajapinta - kohdemäärityksen saamiseksi.

Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Käyttöoikeudet

Kutsujalla on oltava osallistujan tai suurempi työtilarooli.

Vaaditut delegoidut vaikutusalueet

Kohteiden ohjelmointirajapinnoilla voit käyttää seuraavia vaikutusaluetyyppejä:

  • Yleinen vaikutusalue: Item.ReadWrite.All
  • Tietty vaikutusalue: itemType. ReadWrite.All (esimerkiksi: Notebook.ReadWrite.All)

Lisätietoja vaikutusalueista on vaikutusalueita artikkelissa.

Rajoitukset

  • Jotta voit luoda muun kuin PowerBI Fabric -kohteen, työtilan on oltava tuetussa Fabric-kapasiteetissa. Lisätietoja on artikkelissa Microsoft Fabric -käyttöoikeustyyppien .
  • Jotta käyttäjä voi luoda PowerBI -kohteen, hänellä on oltava asianmukainen käyttöoikeus. Lisätietoja on artikkelissa Microsoft Fabric -käyttöoikeustyyppien .
  • Käytä kohdetta luodessasi joko creationPayload tai definition, mutta älä käytä molempia samanaikaisesti.

Microsoft Entran tukemat käyttäjätiedot

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

Identiteetti Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Kun kutsun kohdetyyppiä tuetaan. Tarkista vastaava ohjelmointirajapinta kohdetyypille, jota kutsut, ja tarkista, tuetaanko kutsuasi. Esimerkiksi semanttisia malleja tuetaan.

Rajapinta

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

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

Kohteen näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.
type True

ItemType

Kohdetyyppi.
creationPayload

object

Joukko ominaisuuksia, joita käytetään kohteen luomiseen. Soveltuvan tyypin Luo kohde -sivu osoittaa, tuetaanko creationPayload, ja siinä luetellaan kohteen ominaisuudet. Käytä creationPayload tai definition. Molempia ei voi käyttää samanaikaisesti.
definition

ItemDefinition

Kohdemääritys. Soveltuvan tyypin Luo kohde -sivu osoittaa, tuetaanko määritystä, ja kertoo sen rakenteen yksityiskohtaisesti. Käytä definition tai creationPayload. Molempia ei voi käyttää samanaikaisesti.
description

string

Kohteen kuvaus. Enimmäispituus on 256 merkkiä.

Vastaukset

Nimi Tyyppi Description
201 Created

Item

Luonti onnistui
202 Accepted

Pyyntö hyväksytty, keskeneräinen valmistelu

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 - Annettu hyötykuorma on vioittunut

Esimerkit

Create an item example

Mallipyyntö

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

{
  "displayName": "Item 1",
  "type": "Lakehouse"
}

Mallivastaus

Tilakoodi:
201 
{
  "displayName": "Item 1",
  "description": "",
  "type": "Lakehouse",
  "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
CreateItemRequest

Kohteen pyynnön tietojen luominen.
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen tiedot.
Item

Kohdeobjekti.
ItemDefinition

Kohdemääritelmäobjekti.
ItemDefinitionPart

Kohteen määritelmäosan objekti.
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.

CreateItemRequest

Object

Kohteen pyynnön tietojen luominen.

Nimi Tyyppi Description
creationPayload

object

Joukko ominaisuuksia, joita käytetään kohteen luomiseen. Soveltuvan tyypin Luo kohde -sivu osoittaa, tuetaanko creationPayload, ja siinä luetellaan kohteen ominaisuudet. Käytä creationPayload tai definition. Molempia ei voi käyttää samanaikaisesti.
definition

ItemDefinition

Kohdemääritys. Soveltuvan tyypin Luo kohde -sivu osoittaa, tuetaanko määritystä, ja kertoo sen rakenteen yksityiskohtaisesti. Käytä definition tai creationPayload. Molempia ei voi käyttää samanaikaisesti.
description

string

Kohteen kuvaus. Enimmäispituus on 256 merkkiä.
displayName

string

Kohteen näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.
type

ItemType

Kohdetyyppi.

ErrorRelatedResource

Object

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.
resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Object

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

Object

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.

Item

Object

Kohdeobjekti.

Nimi Tyyppi Description
description

string

Kohteen kuvaus.
displayName

string

Kohteen näyttönimi.
id

string

uuid

Kohdetunnus.
type

ItemType

Kohdetyyppi.
workspaceId

string

uuid

Työtilan tunnus.

ItemDefinition

Object

Kohdemääritelmäobjekti.

Nimi Tyyppi Description
format

string

Kohteen määrityksen muoto.
parts

ItemDefinitionPart[]

Luettelo määritysosista.

ItemDefinitionPart

Object

Kohteen määritelmäosan objekti.

Nimi Tyyppi Description
path

string

Kohdeosan polku.
payload

string

Kohteen osan tiedot.
payloadType

PayloadType

Hyötykuorman tyyppi.

ItemType

Luettelointi

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

Arvo Description
Dashboard

Power BI -koontinäyttö.
DataPipeline

Tietoputki.
Datamart

PowerBI -tietomarssi.
Environment

Ympäristö.
Eventhouse

Tapahtumatalo.
Eventstream

Tapahtumavirta.
GraphQLApi

Ohjelmointirajapinta GraphQL-kohteelle.
KQLDashboard

KQL-koontinäyttö.
KQLDatabase

KQL-tietokanta.
KQLQueryset

KQL-kyselyjoukko.
Lakehouse

Tämä on lakehouse.
MLExperiment

Koneoppimisen kokeilu.
MLModel

Koneoppimismalli.
MirroredDatabase

Peilattu tietokanta.
MirroredWarehouse

Peilattu varasto.
MountedDataFactory

A MountedDataFactory.
Notebook

Muistikirja.
PaginatedReport

PowerBI:n sivutettu raportti.
Reflex

Refleksi.
Report

PowerBI -raportti.
SQLDatabase

A SQLDatabase.
SQLEndpoint

SQL-päätepiste.
SemanticModel

PowerBI:n semanttinen malli.
SparkJobDefinition

Spark-työn määritelmä.
Warehouse

Varasto.

PayloadType

Luettelointi

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

Arvo Description
InlineBase64

Inline Base 64.