แชร์ผ่าน


Items - Create Item

สร้างรายการในพื้นที่ทํางานที่ระบุ
API นี้ได้รับการสนับสนุนสําหรับจํานวนของชนิดรายการ ค้นหาประเภทหน่วยข้อมูลที่สนับสนุนใน ภาพรวมการจัดการรายการ คุณสามารถใช้ รับ API นิยามรายการ เพื่อรับข้อกําหนดรายการได้

API นี้สนับสนุน การดําเนินการที่ใช้เวลานาน (LRO)

สิทธิ์

ผู้โทรต้องมีบทบาท ผู้สนับสนุน หรือสูงกว่า

จําเป็นต้องมีขอบเขตที่ได้รับมอบสิทธิ์

สําหรับรายการ API ใช้ชนิดขอบเขตเหล่านี้:

  • ขอบเขตทั่วไป: Item.ReadWrite.All
  • ขอบเขตเฉพาะ: itemTypeReadWrite.All (ตัวอย่างเช่น: Notebook.ReadWrite.All)

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต โปรดดูบทความขอบเขต

ขีด จำกัด

  • ในการสร้างรายการที่ไม่ใช่ PowerBI Fabric พื้นที่ทํางานจะต้องอยู่บนความจุ Fabric ที่ได้รับการสนับสนุน สําหรับข้อมูลเพิ่มเติม โปรดดู สิทธิ์การใช้งาน Microsoft Fabric
  • หากต้องการสร้างรายการ PowerBI ผู้ใช้ต้องมีสิทธิการใช้งานที่เหมาะสม สําหรับข้อมูลเพิ่มเติม โปรดดู สิทธิ์การใช้งาน Microsoft Fabric
  • เมื่อสร้างรายการ ให้ใช้ creationPayload หรือ definitionแต่ไม่ได้ใช้ทั้งสองอย่างในเวลาเดียวกัน

ข้อมูลประจําตัวที่สนับสนุนของ Microsoft Entra

API นี้สนับสนุนข้อมูลประจําตัวของ Microsoft แสดงรายการในส่วนนี้

เอกลักษณ์ สนับสนุน
ผู้ใช้ ใช่
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ เมื่อชนิดรายการในการเรียกใช้ได้รับการสนับสนุน ตรวจสอบ API ที่สอดคล้องกันสําหรับชนิดรายการที่คุณกําลังเรียกใช้ เพื่อดูว่าการเรียกใช้ของคุณรองรับหรือไม่ ตัวอย่างเช่น แบบจําลองความหมายได้รับการสนับสนุน

อิน เทอร์ เฟซ

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

พารามิเตอร์ URI

ชื่อ ใน จำเป็น พิมพ์ คำอธิบาย
workspaceId
path True

string

uuid

ID พื้นที่ทํางาน

เนื้อความของคำขอ

ชื่อ จำเป็น พิมพ์ คำอธิบาย
displayName True

string

ชื่อที่แสดงของรายการ ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล

type True

ItemType

ชนิดหน่วยข้อมูล

creationPayload

object

ชุดของคุณสมบัติที่ใช้ในการสร้างหน่วยข้อมูล หน้า สร้างรายการ ของประเภทที่เกี่ยวข้องจะระบุว่า creationPayload ได้รับการสนับสนุนและแสดงรายการคุณสมบัติของหน่วยข้อมูลหรือไม่ ใช้ creationPayload หรือ definition คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน

definition

ItemDefinition

ข้อกําหนดของหน่วยข้อมูล หน้า สร้างรายการ ของชนิดที่เกี่ยวข้องระบุว่ามีการสนับสนุนข้อกําหนดและให้รายละเอียดโครงสร้างหรือไม่ ใช้ definition หรือ creationPayload คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน

description

string

คําอธิบายสินค้า ความยาวสูงสุดคือ 256 อักขระ

การตอบสนอง

ชื่อ พิมพ์ คำอธิบาย
201 Created

Item

สร้างเสร็จเรียบร้อยแล้ว

202 Accepted

คําขอที่ยอมรับ กําลังดําเนินการเตรียมใช้งานรายการ

ส่วนหัว

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

รหัสข้อผิดพลาดทั่วไป:

  • InvalidItemType - ชนิดรายการไม่ถูกต้อง

  • ItemDisplayNameAlreadyInUse - ชื่อที่ใช้แสดงรายการถูกใช้แล้ว

  • CorruptedPayload - ส่วนข้อมูลที่ให้มาเสียหาย

ตัวอย่าง

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

คำจำกัดความ

ชื่อ คำอธิบาย
CreateItemRequest

สร้างส่วนของคําขอรายการ

ErrorRelatedResource

ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

การตอบสนองข้อผิดพลาด

ErrorResponseDetails

รายละเอียดการตอบสนองข้อผิดพลาด

Item

วัตถุรายการ

ItemDefinition

วัตถุข้อกําหนดรายการ

ItemDefinitionPart

ออบเจ็กต์ส่วนของข้อกําหนดหน่วยข้อมูล

ItemType

ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

PayloadType

ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

CreateItemRequest

สร้างส่วนของคําขอรายการ

ชื่อ พิมพ์ คำอธิบาย
creationPayload

object

ชุดของคุณสมบัติที่ใช้ในการสร้างหน่วยข้อมูล หน้า สร้างรายการ ของประเภทที่เกี่ยวข้องจะระบุว่า creationPayload ได้รับการสนับสนุนและแสดงรายการคุณสมบัติของหน่วยข้อมูลหรือไม่ ใช้ creationPayload หรือ definition คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน

definition

ItemDefinition

ข้อกําหนดของหน่วยข้อมูล หน้า สร้างรายการ ของชนิดที่เกี่ยวข้องระบุว่ามีการสนับสนุนข้อกําหนดและให้รายละเอียดโครงสร้างหรือไม่ ใช้ definition หรือ creationPayload คุณไม่สามารถใช้ทั้งสองอย่างในเวลาเดียวกัน

description

string

คําอธิบายสินค้า ความยาวสูงสุดคือ 256 อักขระ

displayName

string

ชื่อที่แสดงของรายการ ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล

type

ItemType

ชนิดหน่วยข้อมูล

ErrorRelatedResource

ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ชื่อ พิมพ์ คำอธิบาย
resourceId

string

ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

resourceType

string

ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

การตอบสนองข้อผิดพลาด

ชื่อ พิมพ์ คำอธิบาย
errorCode

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้

message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้

moreDetails

ErrorResponseDetails[]

รายการรายละเอียดข้อผิดพลาดเพิ่มเติม

relatedResource

ErrorRelatedResource

รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

requestId

string

รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

รายละเอียดการตอบสนองข้อผิดพลาด

ชื่อ พิมพ์ คำอธิบาย
errorCode

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้

message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้

relatedResource

ErrorRelatedResource

รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

Item

วัตถุรายการ

ชื่อ พิมพ์ คำอธิบาย
description

string

คําอธิบายสินค้า

displayName

string

ชื่อที่แสดงของรายการ

id

string

uuid

รหัสสินค้า

type

ItemType

ชนิดหน่วยข้อมูล

workspaceId

string

uuid

ID พื้นที่ทํางาน

ItemDefinition

วัตถุข้อกําหนดรายการ

ชื่อ พิมพ์ คำอธิบาย
format

string

รูปแบบของข้อกําหนดหน่วยข้อมูล

parts

ItemDefinitionPart[]

รายการของส่วนข้อกําหนด

ItemDefinitionPart

ออบเจ็กต์ส่วนของข้อกําหนดหน่วยข้อมูล

ชื่อ พิมพ์ คำอธิบาย
path

string

เส้นทางของหน่วยข้อมูล

payload

string

ส่วนข้อมูลของหน่วยข้อมูล

payloadType

PayloadType

ชนิดของส่วนข้อมูล

ItemType

ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

ค่า คำอธิบาย
Dashboard

แดชบอร์ด PowerBI

DataPipeline

ไปป์ไลน์ข้อมูล

Datamart

Datamart ของ PowerBI

Environment

สภาพแวดล้อม

Eventhouse

อาคารจัดงาน

Eventstream

เหตุการณ์กระแสข้อมูล

GraphQLApi

API สําหรับรายการ GraphQL

KQLDashboard

แดชบอร์ด KQL

KQLDatabase

ฐานข้อมูล KQL

KQLQueryset

ชุดคิวรี KQL

Lakehouse

เลคเฮ้าส์

MLExperiment

การทดลองการเรียนรู้ของเครื่อง

MLModel

แบบจําลองการเรียนรู้ของเครื่อง

MirroredDatabase

ฐานข้อมูลที่มิเรอร์

MirroredWarehouse

คลังสินค้าที่มิเรอร์

MountedDataFactory

เมาท์ DataFactory

Notebook

โน๊ตบุ๊ค

PaginatedReport

รายงานที่มีการแบ่งหน้าของ PowerBI

Reflex

รีเฟล็กซ์

Report

รายงาน PowerBI

SQLDatabase

SQLDatabase

SQLEndpoint

จุดสิ้นสุด SQL

SemanticModel

แบบจําลองความหมายของ PowerBI

SparkJobDefinition

ข้อกําหนดงานแบบประกายไฟ

Warehouse

คลังสินค้า

PayloadType

ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

ค่า คำอธิบาย
InlineBase64

ฐานแบบอินไลน์ 64