Dela via

Items - Get Item

  • Referens
Tjänst:
Core
API-version:
v1

Returnerar egenskaperna för det angivna objektet.
Det här API:et stöds för ett antal objekttyper och hittar de objekttyper som stöds i Översikt över objekthantering.

Information om hur du hämtar ytterligare typspecifika egenskaper finns på sidan hämta API-referens för den specifika objekttypen.

Behörigheter

Anroparen måste ha visningsprogram eller högre roll på arbetsytan.

Obligatoriska delegerade omfång

För objekt-API:er använder du följande omfångstyper:

  • Allmänt omfång: Item.Read.All eller Item.ReadWrite.All
  • Specifikt omfång: itemType. Read.All eller itemType. ReadWrite.All (till exempel: Notebook.ReadWrite.All)

Mer information om omfång finns i artikeln om omfång.

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet Stöd
Användare Ja
Tjänstens huvudnamn och hanterade identiteter Ja

Gränssnitt

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

URI-parametrar

Name I Obligatorisk Typ Description
itemId
 path True

string

uuid

Objekt-ID:t.
workspaceId
 path True

string

uuid

Arbetsytans ID.

Svar

Name Typ Description
200 OK

Item

Begäran har slutförts.
Other Status Codes

ErrorResponse

Vanliga felkoder:

  • ItemNotFound – Det begärda objektet hittades inte.

Exempel

Get an item example

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
ErrorRelatedResource

Det felrelaterade resursinformationsobjektet.
ErrorResponse

Felsvaret.
ErrorResponseDetails

Information om felsvar.
Item

Ett objektobjekt.
ItemType

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name Typ Description
resourceId

string

Det resurs-ID som ingår i felet.
resourceType

string

Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
moreDetails

ErrorResponseDetails[]

Lista över ytterligare felinformation.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.
requestId

string

ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.

Item

Objekt

Ett objektobjekt.

Name Typ Description
description

string

Objektbeskrivningen.
displayName

string

Objektets visningsnamn.
id

string

uuid

Objekt-ID:t.
type

ItemType

Objekttypen.
workspaceId

string

uuid

Arbetsytans ID.

ItemType

Uppräkning

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

Värde Description
Dashboard

PowerBI-instrumentpanel.
DataPipeline

En datapipeline.
Datamart

PowerBI-datamart.
Environment

En miljö.
Eventhouse

Ett eventhouse.
Eventstream

En händelseström.
GraphQLApi

Ett API för GraphQL-objekt.
KQLDashboard

En KQL-instrumentpanel.
KQLDatabase

En KQL-databas.
KQLQueryset

En KQL-frågeuppsättning.
Lakehouse

Ett sjöhus.
MLExperiment

Ett maskininlärningsexperiment.
MLModel

En maskininlärningsmodell.
MirroredDatabase

En speglad databas.
MirroredWarehouse

Ett speglat lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notebook-fil.
PaginatedReport

Sidnumrerad PowerBI-rapport.
Reflex

En reflex.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

En SQL-slutpunkt.
SemanticModel

PowerBI-semantisk modell.
SparkJobDefinition

En definition för Spark-jobb.
Warehouse

Ett lager.