Items - Get Item

Service:

Core

API-versie:

v1

Retourneert eigenschappen van het opgegeven item.
Deze API wordt ondersteund voor een aantal itemtypen, zoek de ondersteunde itemtypen in Overzicht van itembeheer.

Als u aanvullende typespecifieke eigenschappen wilt ophalen, raadpleegt u de get API-referentiepagina van het specifieke itemtype.

Machtigingen

De beller moet viewer hebben of een hogere rol in de werkruimte.

Vereiste gedelegeerde bereiken

Voor item-API's worden deze bereiktypen gebruikt:

• Algemeen bereik: Item.Read.All of Item.ReadWrite.All
• Specifiek bereik: itemType. Read.All of itemType. ReadWrite.All (bijvoorbeeld: Notebook.ReadWrite.All)

Zie voor meer informatie over bereiken: artikel bereiken.

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Steunen
Gebruiker	Ja
service-principal en beheerde identiteiten	Ja

Interface

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

URI-parameters

Name	In	Vereist	Type	Description
itemId	path	True	string uuid	De item-id.
workspaceId	path	True	string uuid	De werkruimte-id.

Antwoorden

Name	Type	Description
200 OK	Item	De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: ItemNotFound : het aangevraagde item is niet gevonden.

Voorbeelden

Get an item example

Voorbeeldaanvraag

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715

Voorbeeldrespons

Statuscode:

200

{
  "displayName": "Item 1",
  "description": "Item 1 description",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Definities

Name	Description
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
Item	Een itemobject.
ItemType	Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

Item

Object

Een itemobject.

Name	Type	Description
description	string	De beschrijving van het item.
displayName	string	De weergavenaam van het item.
id	string uuid	De item-id.
type	ItemType	Het itemtype.
workspaceId	string uuid	De werkruimte-id.

ItemType

Inventarisatie

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde	Description
Dashboard	PowerBI-dashboard.
DataPipeline	Een gegevenspijplijn.
Datamart	PowerBI-datamart.
Environment	Een omgeving.
Eventhouse	Een eventhouse.
Eventstream	Een eventstream.
GraphQLApi	Een API voor GraphQL-item.
KQLDashboard	Een KQL-dashboard.
KQLDatabase	Een KQL-database.
KQLQueryset	Een KQL-queryset.
Lakehouse	Een lakehouse.
MLExperiment	Een machine learning-experiment.
MLModel	Een machine learning-model.
MirroredDatabase	Een gespiegelde database.
MirroredWarehouse	Een gespiegeld magazijn.
MountedDataFactory	Een MountedDataFactory.
Notebook	Een notitieblok.
PaginatedReport	Gepagineerd Power BI-rapport.
Reflex	Een reflex.
Report	PowerBI-rapport.
SQLDatabase	Een SQLDatabase.
SQLEndpoint	Een SQL-eindpunt.
SemanticModel	Semantisch Power BI-model.
SparkJobDefinition	Een Spark-taakdefinitie.
Warehouse	Een magazijn.