Items - Create Item
지정된 작업 영역에 항목을 만듭니다.
이 API는 다양한 항목 유형에 대해 지원되며 항목 관리 개요지원되는 항목 유형을 찾습니다. 항목 정의 가져오기 API 사용하여 항목 정의를 가져올 수 있습니다.
이 API는 LRO(장기 실행 작업)지원합니다.
권한을
호출자에게는 기여자 이상의 작업 영역 역할이 있어야 합니다.
필요한 위임된 범위
항목 API의 경우 다음 범위 유형을 사용합니다.
- 제네릭 범위: Item.ReadWrite.All
- 특정 범위: itemType. ReadWrite.All(예: Notebook.ReadWrite.All)
범위에 대한 자세한 내용은 범위 문서참조하세요.
제한
- PowerBI Fabric이 아닌 항목을 만들려면 작업 영역이 지원되는 패브릭 용량에 있어야 합니다. 자세한 내용은 microsoft Fabric 라이선스 유형 참조하세요.
- PowerBI 항목을 만들려면 사용자에게 적절한 라이선스가 있어야 합니다. 자세한 내용은 microsoft Fabric 라이선스 유형 참조하세요.
- 항목을 만들 때
creationPayload
또는definition
사용하지만 동시에 둘 다 사용하지는 않습니다.
Microsoft Entra 지원 ID
이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.
신원 | 지원 |
---|---|
사용자 | 예 |
서비스 주체 및 관리 ID | 호출의 항목 유형이 지원되는 경우 호출하는 항목 유형에 대한 해당 API를 확인하여 호출이 지원되는지 확인합니다. 예를 들어 의미 체계 모델이 지원됩니다. |
인터페이스
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
작업 영역 ID입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
displayName | True |
string |
항목 표시 이름입니다. 표시 이름은 항목 유형에 따라 명명 규칙을 따라야 합니다. |
type | True |
항목 유형입니다. |
|
creationPayload |
object |
항목을 만드는 데 사용되는 속성 집합입니다. 관련 형식의 항목 만들기 페이지는 |
|
definition |
항목 정의입니다. 관련 형식의 항목 만들기 페이지는 정의가 지원되는지 여부를 나타내고 해당 구조를 자세히 설명합니다.
|
||
description |
string |
항목 설명입니다. 최대 길이는 256자입니다. |
응답
Name | 형식 | Description |
---|---|---|
201 Created |
성공적으로 생성됨 |
|
202 Accepted |
요청 수락됨, 항목 프로비전 진행 중 헤더
|
|
Other Status Codes |
일반적인 오류 코드:
|
예제
Create an item example
샘플 요청
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items
{
"displayName": "Item 1",
"type": "Lakehouse"
}
샘플 응답
{
"displayName": "Item 1",
"description": "",
"type": "Lakehouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30
정의
Name | Description |
---|---|
Create |
항목 요청 페이로드를 만듭니다. |
Error |
오류 관련 리소스 세부 정보 개체입니다. |
Error |
오류 응답입니다. |
Error |
오류 응답 세부 정보입니다. |
Item |
항목 개체입니다. |
Item |
항목 정의 개체입니다. |
Item |
항목 정의 파트 개체입니다. |
Item |
항목의 형식입니다. 추가 항목 유형은 시간이 지남에 따라 추가될 수 있습니다. |
Payload |
정의 파트 페이로드의 형식입니다. 추가 페이로드 유형은 시간이 지남에 따라 추가될 수 있습니다. |
CreateItemRequest
항목 요청 페이로드를 만듭니다.
Name | 형식 | Description |
---|---|---|
creationPayload |
object |
항목을 만드는 데 사용되는 속성 집합입니다. 관련 형식의 항목 만들기 페이지는 |
definition |
항목 정의입니다. 관련 형식의 항목 만들기 페이지는 정의가 지원되는지 여부를 나타내고 해당 구조를 자세히 설명합니다.
|
|
description |
string |
항목 설명입니다. 최대 길이는 256자입니다. |
displayName |
string |
항목 표시 이름입니다. 표시 이름은 항목 유형에 따라 명명 규칙을 따라야 합니다. |
type |
항목 유형입니다. |
ErrorRelatedResource
오류 관련 리소스 세부 정보 개체입니다.
Name | 형식 | Description |
---|---|---|
resourceId |
string |
오류와 관련된 리소스 ID입니다. |
resourceType |
string |
오류와 관련된 리소스의 형식입니다. |
ErrorResponse
오류 응답입니다.
Name | 형식 | Description |
---|---|---|
errorCode |
string |
오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다. |
message |
string |
사용자가 읽을 수 있는 오류 표현입니다. |
moreDetails |
추가 오류 세부 정보 목록입니다. |
|
relatedResource |
오류 관련 리소스 세부 정보입니다. |
|
requestId |
string |
오류와 연결된 요청의 ID입니다. |
ErrorResponseDetails
오류 응답 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
errorCode |
string |
오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다. |
message |
string |
사용자가 읽을 수 있는 오류 표현입니다. |
relatedResource |
오류 관련 리소스 세부 정보입니다. |
Item
항목 개체입니다.
Name | 형식 | Description |
---|---|---|
description |
string |
항목 설명입니다. |
displayName |
string |
항목 표시 이름입니다. |
id |
string uuid |
항목 ID입니다. |
type |
항목 유형입니다. |
|
workspaceId |
string uuid |
작업 영역 ID입니다. |
ItemDefinition
항목 정의 개체입니다.
Name | 형식 | Description |
---|---|---|
format |
string |
항목 정의의 형식입니다. |
parts |
정의 부분 목록입니다. |
ItemDefinitionPart
항목 정의 파트 개체입니다.
Name | 형식 | Description |
---|---|---|
path |
string |
항목 파트 경로입니다. |
payload |
string |
항목 부분 페이로드입니다. |
payloadType |
페이로드 형식입니다. |
ItemType
항목의 형식입니다. 추가 항목 유형은 시간이 지남에 따라 추가될 수 있습니다.
값 | Description |
---|---|
Dashboard |
PowerBI 대시보드. |
DataPipeline |
데이터 파이프라인입니다. |
Datamart |
PowerBI datamart. |
Environment |
환경입니다. |
Eventhouse |
이벤트 하우스. |
Eventstream |
eventstream입니다. |
GraphQLApi |
GraphQL 항목에 대한 API입니다. |
KQLDashboard |
KQL 대시보드. |
KQLDatabase |
KQL 데이터베이스입니다. |
KQLQueryset |
KQL 쿼리 세트입니다. |
Lakehouse |
레이크 하우스. |
MLExperiment |
기계 학습 실험입니다. |
MLModel |
기계 학습 모델입니다. |
MirroredDatabase |
미러된 데이터베이스입니다. |
MirroredWarehouse |
미러된 창고입니다. |
MountedDataFactory |
MountedDataFactory입니다. |
Notebook |
전자 필기장입니다. |
PaginatedReport |
PowerBI 페이지를 매긴 보고서입니다. |
Reflex |
반사. |
Report |
PowerBI 보고서입니다. |
SQLDatabase |
SQLDatabase입니다. |
SQLEndpoint |
SQL 엔드포인트입니다. |
SemanticModel |
PowerBI 의미 체계 모델입니다. |
SparkJobDefinition |
Spark 작업 정의입니다. |
Warehouse |
창고. |
PayloadType
정의 파트 페이로드의 형식입니다. 추가 페이로드 유형은 시간이 지남에 따라 추가될 수 있습니다.
값 | Description |
---|---|
InlineBase64 |
인라인 베이스 64. |