Items - Create Item
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
taidefinition
, 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 |
---|---|---|---|---|
workspace
|
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 |
Kohdetyyppi. |
|
creationPayload |
object |
Joukko ominaisuuksia, joita käytetään kohteen luomiseen. Soveltuvan tyypin Luo kohde -sivu osoittaa, tuetaanko |
|
definition |
Kohdemääritys. Soveltuvan tyypin Luo kohde -sivu osoittaa, tuetaanko määritystä, ja kertoo sen rakenteen yksityiskohtaisesti. Käytä |
||
description |
string |
Kohteen kuvaus. Enimmäispituus on 256 merkkiä. |
Vastaukset
Nimi | Tyyppi | Description |
---|---|---|
201 Created |
Luonti onnistui |
|
202 Accepted |
Pyyntö hyväksytty, keskeneräinen valmistelu Otsikot
|
|
Other Status Codes |
Yleiset virhekoodit:
|
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
{
"displayName": "Item 1",
"description": "",
"type": "Lakehouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
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 |
---|---|
Create |
Kohteen pyynnön tietojen luominen. |
Error |
Virheeseen liittyvä resurssitieto-objekti. |
Error |
Virhevastaus. |
Error |
Virheen vastauksen tiedot. |
Item |
Kohdeobjekti. |
Item |
Kohdemääritelmäobjekti. |
Item |
Kohteen määritelmäosan objekti. |
Item |
Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa. |
Payload |
Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa. |
CreateItemRequest
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 |
definition |
Kohdemääritys. Soveltuvan tyypin Luo kohde -sivu osoittaa, tuetaanko määritystä, ja kertoo sen rakenteen yksityiskohtaisesti. Käytä |
|
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 |
Kohdetyyppi. |
ErrorRelatedResource
Virheeseen liittyvä resurssitieto-objekti.
Nimi | Tyyppi | Description |
---|---|---|
resourceId |
string |
Virheestä liittyvä resurssitunnus. |
resourceType |
string |
Virheestä liittyvän resurssin tyyppi. |
ErrorResponse
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 |
Luettelo virheiden lisätiedoista. |
|
relatedResource |
Virheisiin liittyvät resurssitiedot. |
|
requestId |
string |
Virheeseen liittyvän pyynnön tunnus. |
ErrorResponseDetails
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 |
Virheisiin liittyvät resurssitiedot. |
Item
Kohdeobjekti.
Nimi | Tyyppi | Description |
---|---|---|
description |
string |
Kohteen kuvaus. |
displayName |
string |
Kohteen näyttönimi. |
id |
string uuid |
Kohdetunnus. |
type |
Kohdetyyppi. |
|
workspaceId |
string uuid |
Työtilan tunnus. |
ItemDefinition
Kohdemääritelmäobjekti.
Nimi | Tyyppi | Description |
---|---|---|
format |
string |
Kohteen määrityksen muoto. |
parts |
Luettelo määritysosista. |
ItemDefinitionPart
Kohteen määritelmäosan objekti.
Nimi | Tyyppi | Description |
---|---|---|
path |
string |
Kohdeosan polku. |
payload |
string |
Kohteen osan tiedot. |
payloadType |
Hyötykuorman tyyppi. |
ItemType
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
Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.
Arvo | Description |
---|---|
InlineBase64 |
Inline Base 64. |