Jaa

Items - List Items

Palvelu:
Core
Ohjelmointirajapinnan versio:
v1

Palauttaa kohdeluettelon määritetystä työtilasta.
Tämä ohjelmointirajapinta tukee sivutuksen.

Käyttöoikeudet

Soittajalla on oltava katselijan työtilan rooli.

Vaaditut delegoidut vaikutusalueet

Workspace.Read.All tai Workspace.ReadWrite.All

tuettujen käyttäjätietojen Microsoft Entra

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft identities.

Identiteetti Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Kyllä

Rajapinta

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items
Valinnaisilla parametreilla: 
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items?type={type}&recursive={recursive}&rootFolderId={rootFolderId}&continuationToken={continuationToken}&include=DefaultIdentity

URI-parametrit

Nimi Kohteessa Pakollinen Tyyppi Description
workspaceId
 path True

string (uuid)

Työtilan tunnus.
continuationToken
 query

string

Tunnus seuraavan tulossivun noutamiseen.
include
 query

ItemIncludeOption[]

Määrittää, mitkä kohteen ominaisuudet sisällytetään vastaukseen pilkuin eroteltuna luettelona. Lisäarvoja voidaan lisätä ajan mittaan.
recursive
 query

boolean

Näyttää luettelon kansion kohteista ja sen sisäkkäsistä kansioista, tai vain kansiosta. True – Kaikki kansion kohteet ja niiden sisäkkäiset kansiot näkyvät luettelossa, False – vain kansiossa olevat kohteet luetellaan. Oletusarvo on true.
rootFolderId
 query

string (uuid)

Tämän parametrin avulla käyttäjät voivat suodattaa kohteita tietyn pääkansion perusteella. Jos tätä ei anneta, työtilaa käytetään pääkansiona.
type
 query

string

Kohteen tyyppi.

Vastaukset

Nimi Tyyppi Description
200 OK

Items

Pyynnön valmistuttua.
429 Too Many Requests

ErrorResponse

Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään.

Otsikot

Retry-After: integer
Other Status Codes

ErrorResponse

Yleiset virhekoodit:

  • InvalidItemType – Virheellinen kohdetyyppi.

  • FolderNotFound – Pyydettyä kansiota ei löydy.

Esimerkit

List all items in a specific folder example
List all items in workspace by type query parameter example
List all items in workspace example
List direct items in a specific folder example
List direct items in workspace example
List items in workspace with continuation example
List items with include option example

List all items in a specific folder example

Mallipyyntö

GET https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items?rootFolderId=bbbbbbbb-1111-2222-3333-cccccccccccc&include=DefaultIdentity

Mallivastaus

Tilakoodi:
200 
{
  "value": [
    {
      "id": "cccccccc-2222-3333-4444-dddddddddddd",
      "displayName": "Lakehouse",
      "description": "A lakehouse used by the sales team.",
      "type": "Lakehouse",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
    },
    {
      "id": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
      "displayName": "Notebook",
      "description": "A notebook for refining Q1 of year 2024 sales data analysis through machine learning algorithms.",
      "type": "Notebook",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "cccccccc-8888-9999-0000-dddddddddddd"
    }
  ]
}

List all items in workspace by type query parameter example

Mallipyyntö

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items?type=Lakehouse&include=DefaultIdentity

Mallivastaus

Tilakoodi:
200 
{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "Lakehouse Name 1",
      "description": "A lakehouse used by the analytics team.",
      "type": "Lakehouse",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ]
}

List all items in workspace example

Mallipyyntö

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items?include=DefaultIdentity

Mallivastaus

Tilakoodi:
200 
{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "Lakehouse",
      "description": "A lakehouse used by the analytics team.",
      "type": "Lakehouse",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    },
    {
      "id": "58fa1eac-9694-4a6b-ba25-3520288e8fea",
      "displayName": "Notebook",
      "description": "A notebook for refining medical data analysis through machine learning algorithms.",
      "type": "KustoDashboard",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ]
}

List direct items in a specific folder example

Mallipyyntö

GET https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items?recursive=False&rootFolderId=bbbbbbbb-1111-2222-3333-cccccccccccc&include=DefaultIdentity

Mallivastaus

Tilakoodi:
200 
{
  "value": [
    {
      "id": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
      "displayName": "Notebook",
      "description": "A notebook for refining year 2024 sales data analysis through machine learning algorithms.",
      "type": "Notebook",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
    }
  ]
}

List direct items in workspace example

Mallipyyntö

GET https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items?recursive=False&include=DefaultIdentity

Mallivastaus

Tilakoodi:
200 
{
  "value": [
    {
      "id": "cccccccc-2222-3333-4444-dddddddddddd",
      "displayName": "Lakehouse",
      "description": "A lakehouse shared by the all teams.",
      "type": "Lakehouse",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
    }
  ]
}

List items in workspace with continuation example

Mallipyyntö

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items?include=DefaultIdentity

Mallivastaus

Tilakoodi:
200 
{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "Lakehouse",
      "description": "A lakehouse used by the analytics team.",
      "type": "Lakehouse",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    },
    {
      "id": "58fa1eac-9694-4a6b-ba25-3520288e8fea",
      "displayName": "Notebook",
      "description": "A notebook for refining medical data analysis through machine learning algorithms.",
      "type": "KustoDashboard",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items?continuationToken=LDEsMTAwMDAwLDA%3D"
}

List items with include option example

Mallipyyntö

GET https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items?rootFolderId=bbbbbbbb-1111-2222-3333-cccccccccccc&include=DefaultIdentity

Mallivastaus

Tilakoodi:
200 
{
  "value": [
    {
      "id": "cccccccc-2222-3333-4444-dddddddddddd",
      "displayName": "Lakehouse",
      "description": "A lakehouse used by the sales team.",
      "type": "Lakehouse",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
      "defaultIdentity": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Caleb Foster",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "caleb@example.com"
        }
      }
    },
    {
      "id": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
      "displayName": "Notebook",
      "description": "A notebook for refining Q1 of year 2024 sales data analysis through machine learning algorithms.",
      "type": "Notebook",
      "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "folderId": "cccccccc-8888-9999-0000-dddddddddddd",
      "defaultIdentity": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Caleb Foster",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "caleb@example.com"
        }
      }
    }
  ]
}

Määritelmät

Nimi Description
EntireTenantPrincipal

Edustaa vuokraajan päänimeä
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen tiedot.
GroupDetails

Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on Group.
GroupPrincipal

Edustaa käyttöoikeusryhmää.
GroupType

Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.
Item

Kohdeobjekti.
ItemIncludeOption

Määrittää, mitkä kohteen ominaisuudet sisällytetään vastaukseen pilkuin eroteltuna luettelona. Lisäarvoja voidaan lisätä ajan mittaan.
Items
ItemTag

Edustaa kohteelle käytettyä tunnistetta.
ItemType

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

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.
SensitivityLabel

Edustaa kohteelle käytettyä luottamuksellisuustunnistetta.
ServicePrincipalDetails

Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on ServicePrincipal.
ServicePrincipalPrincipal

Ilmaisee Microsoft Entra palvelun päänimen.
ServicePrincipalProfileDetails

Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on ServicePrincipalProfile.
ServicePrincipalProfilePrincipal

Edustaa palvelun pääprofiilia.
UserDetails

Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on User.
UserPrincipal

Edustaa Microsoft Entra käyttäjäobjektia.

EntireTenantPrincipal

Kohde

Edustaa vuokraajan päänimeä

Nimi Tyyppi Description
displayName

string

Tämä on päänimen näyttönimi.
id

string (uuid)

Päänimen tunnus.
type string:

EntireTenant

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.
resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

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 (uuid)

Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

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.

GroupDetails

Kohde

Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on Group.

Nimi Tyyppi Description
groupType

GroupType

Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.

GroupPrincipal

Kohde

Edustaa käyttöoikeusryhmää.

Nimi Tyyppi Description
displayName

string

Tämä on päänimen näyttönimi.
groupDetails

GroupDetails

Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on Group.
id

string (uuid)

Päänimen tunnus.
type string:

Group

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

GroupType

Luettelointi

Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.

Arvo Description
Unknown

Pääryhmän tyyppi on tuntematon.
SecurityGroup

Principal on käyttöoikeusryhmä.
DistributionList

Principal on jakeluluettelo.

Item

Kohde

Kohdeobjekti.

Nimi Tyyppi Description
defaultIdentity Principal:

Kohteen oletusarvoiset käyttäjätiedot.
description

string

Kohteen kuvaus.
displayName

string

Kohteen näyttönimi.
folderId

string (uuid)

Kansion tunnus.
id

string (uuid)

Kohdetunnus.
sensitivityLabel

SensitivityLabel

Kohteen luottamuksellisuustunniste.
tags

ItemTag[]

Luettelo käytössä olevista tunnisteista.
type

ItemType

Kohdetyyppi.
workspaceId

string (uuid)

Työtilan tunnus.

ItemIncludeOption

Luettelointi

Määrittää, mitkä kohteen ominaisuudet sisällytetään vastaukseen pilkuin eroteltuna luettelona. Lisäarvoja voidaan lisätä ajan mittaan.

Arvo Description
DefaultIdentity

Sisältää oletusarvoiset käyttäjätiedot

Items

Kohde
Nimi Tyyppi Description
continuationToken

string

Seuraavan tulosjoukkoerän tunnus. Jos tietueita ei ole enempää, ne poistetaan vastauksesta.
continuationUri

string

Seuraavan tulosjoukkoerän URI. Jos tietueita ei ole enempää, ne poistetaan vastauksesta.
value

Item[]

Kohteiden luettelo.

ItemTag

Kohde

Edustaa kohteelle käytettyä tunnistetta.

Nimi Tyyppi Description
displayName

string

Tunnisteen nimi.
id

string (uuid)

Tunnisteen tunnus.

ItemType

Luettelointi

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

Arvo Description
Dashboard

Power BI -koontinäyttö.
Report

PowerBI -raportti.
SemanticModel

PowerBI:n semanttinen malli.
PaginatedReport

PowerBI:n sivutettu raportti.
Datamart

PowerBI -tietomarssi.
Lakehouse

Tämä on lakehouse.
Eventhouse

Tapahtumatalo.
Environment

Ympäristö.
KQLDatabase

KQL-tietokanta.
KQLQueryset

KQL-kyselyjoukko.
KQLDashboard

KQL-koontinäyttö.
DataPipeline

Tietoputki.
Notebook

Muistikirja.
SparkJobDefinition

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

Koneoppimisen kokeilu.
MLModel

Koneoppimismalli.
Warehouse

Varasto.
Eventstream

Tapahtumavirta.
SQLEndpoint

SQL-päätepiste.
MirroredWarehouse

Peilattu varasto.
MirroredDatabase

Peilattu tietokanta.
Reflex

Refleksi.
GraphQLApi

Ohjelmointirajapinta GraphQL-kohteelle.
MountedDataFactory

A MountedDataFactory.
SQLDatabase

A SQLDatabase.
CopyJob

Kopiotyö.
VariableLibrary

MuuttujaLibrary.
Dataflow

Tietovuo.
ApacheAirflowJob

An ApacheAirflowJob.
WarehouseSnapshot

Varastotilannevedos.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Digital Twin Builder -työnkulku.
MirroredAzureDatabricksCatalog

Peilattu Azure Databricks -luettelo.
Map

Kartta.
AnomalyDetector

Poikkeamien tunnistaminen.
UserDataFunction

Käyttäjätietofunktio.
GraphModel

A GraphModel.
GraphQuerySet

A Graph QuerySet.
SnowflakeDatabase

Snowflake-tietokannalla tallennetaan Snowflake-tililtä luodut Iceberg-taulukot.
OperationsAgent

A OperationsAgent.
CosmosDBDatabase

Cosmos DB -tietokanta.
Ontology

Ontologia.
EventSchemaSet

An EventSchemaSet.
DataAgent

A DataAgent.

PrincipalType

Luettelointi

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

Arvo Description
User

Principal on Microsoft Entra käyttäjäobjekti.
ServicePrincipal

Principal on Microsoft Entra palvelun päänimi.
Group

Principal on käyttöoikeusryhmä.
ServicePrincipalProfile

Principal on palvelun pääprofiili.
EntireTenant

Principal edustaa kaikkia vuokraajan käyttäjiä.

SensitivityLabel

Kohde

Edustaa kohteelle käytettyä luottamuksellisuustunnistetta.

Nimi Tyyppi Description
id

string (uuid)

Tämä on luottamuksellisuustunnisteen tunnus.

ServicePrincipalDetails

Kohde

Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on ServicePrincipal.

Nimi Tyyppi Description
aadAppId

string (uuid)

Palvelun päänimen Microsoft Entra AppId.

ServicePrincipalPrincipal

Kohde

Ilmaisee Microsoft Entra palvelun päänimen.

Nimi Tyyppi Description
displayName

string

Tämä on päänimen näyttönimi.
id

string (uuid)

Päänimen tunnus.
servicePrincipalDetails

ServicePrincipalDetails

Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on ServicePrincipal.
type string:

ServicePrincipal

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

ServicePrincipalProfileDetails

Kohde

Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on ServicePrincipalProfile.

Nimi Tyyppi Description
parentPrincipal Principal:

Palvelun pääprofiilin pääobjekti.

ServicePrincipalProfilePrincipal

Kohde

Edustaa palvelun pääprofiilia.

Nimi Tyyppi Description
displayName

string

Tämä on päänimen näyttönimi.
id

string (uuid)

Päänimen tunnus.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on ServicePrincipalProfile.
type string:

ServicePrincipalProfile

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

UserDetails

Kohde

Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on User.

Nimi Tyyppi Description
userPrincipalName

string

Täydellinen käyttäjänimi.

UserPrincipal

Kohde

Edustaa Microsoft Entra käyttäjäobjektia.

Nimi Tyyppi Description
displayName

string

Tämä on päänimen näyttönimi.
id

string (uuid)

Päänimen tunnus.
type string:

User

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.
userDetails

UserDetails

Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on User.