Items - Get Item Definition

지정된 항목 정의를 반환합니다.
이 API는 다양한 항목 유형에 대해 지원되며, 항목 정의 개요에서 지원되는 항목 유형 및 해당 정의 구조에 대한 정보를 찾습니다. 항목의 정의를 받으면 민감도 레이블이 정의의 일부가 아닙니다.

이 API는 LRO(장기 실행 작업)지원합니다.

권한

호출자에게 항목에 대한 읽기 및 쓰기 권한이 있어야 합니다.

필요한 위임된 범위

항목 API의 경우 다음 범위 유형을 사용합니다.

• 제네릭 범위: Item.ReadWrite.All
• 특정 범위: itemType. ReadWrite.All(예: Notebook.ReadWrite.All)

범위에 대한 자세한 내용은 범위 문서를 참조하세요.

제한점

이 API는 호출자가 민감도 레이블을 삭제할 수 있는 사용 권한이 없는 한 보호된 민감도 레이블이 있는 항목에 대해 차단됩니다.

Microsoft Entra 지원 식별자

이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.

인터페이스

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

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/getDefinition?format={format}

URI 매개 변수

응답

예제

Get an item definition example

POST https://api.fabric.microsoft.com/v1/workspaces/6e335e92-a2a2-4b5a-970a-bd6a89fbb765/items/cfafbeb1-8037-4d0c-896e-a46fb27ff229/getDefinition

{
  "definition": {
    "parts": [
      {
        "path": "report.json",
        "payload": "QmFzZTY0U3RyaW5n",
        "payloadType": "InlineBase64"
      },
      {
        "path": "definition.pbir",
        "payload": "QW5vdGhlckJhc2U2NFN0cmluZw",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30

정의

ErrorRelatedResource

오류 관련 리소스 세부 정보 개체입니다.

ErrorResponse

오류 응답입니다.

ErrorResponseDetails

오류 응답 세부 정보입니다.

ItemDefinition

항목 정의 개체입니다.

ItemDefinitionPart

항목 정의 파트 개체입니다.

ItemDefinitionResponse

항목 공용 정의 응답입니다.

PayloadType

정의 파트 페이로드의 형식입니다. 추가 페이로드 유형은 시간이 지남에 따라 추가될 수 있습니다.