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	Kuvaus
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 Kuvaus

200 OK

Nimi	Tyyppi	Kuvaus
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.

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ö

HTTP

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ö

HTTP

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ö

HTTP

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ö

HTTP

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ö

HTTP

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ö

HTTP

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ö

HTTP

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	Kuvaus
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	Kuvaus
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	Kuvaus
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi	Tyyppi	Kuvaus
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
isRetriable	boolean	Kun arvo on tosi, pyyntöä voidaan yrittää uudelleen. Määritä viive vastausotsikon `Retry-After` avulla, jos se on käytettävissä.
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	Kuvaus
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	Kuvaus
groupType	GroupType	Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.

GroupPrincipal

Kohde

Edustaa käyttöoikeusryhmää.

Nimi	Tyyppi	Kuvaus
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	Kuvaus
Unknown	Pääryhmän tyyppi on tuntematon.
SecurityGroup	Principal on käyttöoikeusryhmä.
DistributionList	Principal on jakeluluettelo.

Item

Kohde

Kohdeobjekti.

Nimi	Tyyppi	Kuvaus
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	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	Kuvaus
DefaultIdentity	Sisältää oletusarvoiset käyttäjätiedot

Items

Kohde

Nimi	Tyyppi	Kuvaus
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	Kuvaus
displayName	string	Tunnisteen nimi.
id	string (uuid)	Tunnisteen tunnus.

ItemType

Luettelointi

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

Arvo	Kuvaus
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.
MirroredCatalog	A MirroredCatalog.
AppBackend	An AppBackend.
OrgApp	Organisaatiosovellus.
OrgAppAudience	An Org App Audience.
DataBuildToolJob	A DataBuildToolJob.
AzureDatabricksStorage	OneLake-taustainen tallennuskohde Azure Databricks.
Plan	Suunnitelma.

PrincipalType

Luettelointi

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

Arvo	Kuvaus
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	Kuvaus
id	string (uuid)	Tämä on luottamuksellisuustunnisteen tunnus.

ServicePrincipalDetails

Kohde

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

Nimi	Tyyppi	Kuvaus
aadAppId	string (uuid)	Palvelun päänimen Microsoft Entra AppId.

ServicePrincipalPrincipal

Kohde

Ilmaisee Microsoft Entra palvelun päänimen.

Nimi	Tyyppi	Kuvaus
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	Kuvaus
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Palvelun pääprofiilin pääobjekti.

ServicePrincipalProfilePrincipal

Kohde

Edustaa palvelun pääprofiilia.

Nimi	Tyyppi	Kuvaus
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	Kuvaus
userPrincipalName	string	Täydellinen käyttäjänimi.

UserPrincipal

Kohde

Edustaa Microsoft Entra käyttäjäobjektia.

Nimi	Tyyppi	Kuvaus
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`.