Udostępnij przez

Items - List Items

Usługa:
Core
Wersja API:
v1

Zwraca listę elementów z określonego obszaru roboczego.
Ten interfejs API obsługuje stronicowanie.

Uprawnienia

Obiekt wywołujący musi mieć rolę obszaru roboczego przeglądarki .

Wymagane zakresy delegowane

Workspace.Read.All lub Workspace.ReadWrite.All

Tożsamości obsługiwane przez firmę Microsoft

Ten interfejs API obsługuje tożsamości firmy Microsoft wymienione w tej sekcji.

Tożsamość Wsparcie
Użytkownik Tak
jednostki usługi i tożsamości zarządzanych Tak

Interfejs

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items
Z opcjonalnymi parametrami: 
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items?type={type}&recursive={recursive}&rootFolderId={rootFolderId}&continuationToken={continuationToken}

Parametry URI

Nazwa W Wymagane Typ Opis
workspaceId
 path True

string (uuid)

Identyfikator obszaru roboczego.
continuationToken
 query

string

Token do pobierania następnej strony wyników.
recursive
 query

boolean

Wyświetla listę elementów w folderze i jego folderach zagnieżdżonych lub tylko folder. True — wszystkie elementy w folderze i jego zagnieżdżonych folderach są wymienione na liście Fałsz — są wyświetlane tylko elementy w folderze. Wartość domyślna to true.
rootFolderId
 query

string (uuid)

Ten parametr umożliwia użytkownikom filtrowanie elementów na podstawie określonego folderu głównego. Jeśli nie zostanie podany, obszar roboczy będzie używany jako folder główny.
type
 query

string

Typ elementu.

Odpowiedzi

Nazwa Typ Opis
200 OK

Items

Żądanie zostało ukończone pomyślnie.
Other Status Codes

ErrorResponse

Typowe kody błędów:

  • InvalidItemType — nieprawidłowy typ elementu.

  • FolderNotFound — nie można odnaleźć żądanego folderu.

Przykłady

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 all items in a specific folder example

Przykładowa prośba

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

Przykładowa odpowiedź

Kod statusu:
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

Przykładowa prośba

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

Przykładowa odpowiedź

Kod statusu:
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

Przykładowa prośba

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

Przykładowa odpowiedź

Kod statusu:
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

Przykładowa prośba

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

Przykładowa odpowiedź

Kod statusu:
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

Przykładowa prośba

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

Przykładowa odpowiedź

Kod statusu:
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

Przykładowa prośba

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

Przykładowa odpowiedź

Kod statusu:
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"
}

Definicje

Nazwa Opis
ErrorRelatedResource

Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse

Odpowiedź na błąd.
ErrorResponseDetails

Szczegóły odpowiedzi na błąd.
Item

Obiekt elementu.
Items
ItemTag

Reprezentuje tag zastosowany w elemencie.
ItemType

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.

ErrorRelatedResource

Sprzeciwiać się

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa Typ Opis
resourceId

string

Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType

string

Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Sprzeciwiać się

Odpowiedź na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
moreDetails

ErrorResponseDetails[]

Lista dodatkowych szczegółów błędu.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.
requestId

string

Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Sprzeciwiać się

Szczegóły odpowiedzi na błąd.

Nazwa Typ Opis
errorCode

string

Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message

string

Czytelna reprezentacja błędu przez człowieka.
relatedResource

ErrorRelatedResource

Szczegóły zasobu powiązanego z błędem.

Item

Sprzeciwiać się

Obiekt elementu.

Nazwa Typ Opis
description

string

Opis elementu.
displayName

string

Nazwa wyświetlana elementu.
folderId

string (uuid)

Identyfikator folderu.
id

string (uuid)

Identyfikator elementu.
tags

ItemTag[]

Lista zastosowanych tagów.
type

ItemType

Typ elementu.
workspaceId

string (uuid)

Identyfikator obszaru roboczego.

Items

Sprzeciwiać się
Nazwa Typ Opis
continuationToken

string

Token dla następnej partii zestawu wyników. Jeśli nie ma więcej rekordów, zostanie on usunięty z odpowiedzi.
continuationUri

string

Identyfikator URI następnego zestawu wyników wsadowy. Jeśli nie ma więcej rekordów, zostanie on usunięty z odpowiedzi.
value

Item[]

Lista elementów.

ItemTag

Sprzeciwiać się

Reprezentuje tag zastosowany w elemencie.

Nazwa Typ Opis
displayName

string

Nazwa znacznika.
id

string (uuid)

Identyfikator tagu.

ItemType

Wyliczenie

Typ elementu. Dodatkowe typy elementów można dodawać w czasie.

Wartość Opis
Dashboard

Pulpit nawigacyjny usługi Power BI.
Report

Raport usługi Power BI.
SemanticModel

Model semantyczny usługi PowerBI.
PaginatedReport

Raport podzielony na strony usługi PowerBI.
Datamart

Datamart usługi Power BI.
Lakehouse

Jezioro.
Eventhouse

Magazyn zdarzeń.
Environment

Środowisko.
KQLDatabase

Baza danych KQL.
KQLQueryset

Zestaw zapytań KQL.
KQLDashboard

Pulpit nawigacyjny KQL.
DataPipeline

Potok danych.
Notebook

Notes.
SparkJobDefinition

Definicja zadania platformy Spark.
MLExperiment

Eksperyment uczenia maszynowego.
MLModel

Model uczenia maszynowego.
Warehouse

Magazyn.
Eventstream

Strumień zdarzeń.
SQLEndpoint

Punkt końcowy SQL.
MirroredWarehouse

Dublowany magazyn.
MirroredDatabase

Dublowana baza danych.
Reflex

Refleks.
GraphQLApi

Interfejs API dla elementu GraphQL.
MountedDataFactory

A MountedDataFactory.
SQLDatabase

Baza danych SQLDatabase.
CopyJob

Zadanie kopiowania.
VariableLibrary

ZmiennaLibrary.
Dataflow

Przepływ danych.
ApacheAirflowJob

Zadanie ApacheAirflowJob.
WarehouseSnapshot

Migawka magazynu.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Przepływ usługi Digital Twin Builder.
MirroredAzureDatabricksCatalog

Dublowany wykaz usługi Azure Databricks.
Map

Mapa.
AnomalyDetector

Wykrywacz anomalii.
UserDataFunction

Funkcja danych użytkownika.
GraphModel

Model programu Graph.
GraphQuerySet

Zestaw zapytań programu Graph.
SnowflakeDatabase

Baza danych Snowflake do przechowywania tabel góry lodowej utworzonych na podstawie konta Snowflake.
OperationsAgent

A OperationsAgent.
CosmosDBDatabase

Baza danych usługi Cosmos DB.
Ontology

Ontologia.
EventSchemaSet

An EventSchemaSet.