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
ชื่อ | ใน | จำเป็น | พิมพ์ | คำอธิบาย |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
ID พื้นที่ทํางาน |
เนื้อความของคำขอ
ชื่อ | จำเป็น | พิมพ์ | คำอธิบาย |
---|---|---|---|
displayName | True |
string |
ชื่อที่แสดงของรายการ ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล |
type | True |
ชนิดหน่วยข้อมูล |
|
creationPayload |
object |
ชุดของคุณสมบัติที่ใช้ในการสร้างหน่วยข้อมูล หน้า สร้างรายการ ของประเภทที่เกี่ยวข้องจะระบุว่า |
|
definition |
ข้อกําหนดของหน่วยข้อมูล หน้า สร้างรายการ ของชนิดที่เกี่ยวข้องระบุว่ามีการสนับสนุนข้อกําหนดและให้รายละเอียดโครงสร้างหรือไม่ ใช้ |
||
description |
string |
คําอธิบายสินค้า ความยาวสูงสุดคือ 256 อักขระ |
การตอบสนอง
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
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
คำจำกัดความ
ชื่อ | คำอธิบาย |
---|---|
Create |
สร้างส่วนของคําขอรายการ |
Error |
ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
Error |
การตอบสนองข้อผิดพลาด |
Error |
รายละเอียดการตอบสนองข้อผิดพลาด |
Item |
วัตถุรายการ |
Item |
วัตถุข้อกําหนดรายการ |
Item |
ออบเจ็กต์ส่วนของข้อกําหนดหน่วยข้อมูล |
Item |
ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป |
Payload |
ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป |
CreateItemRequest
สร้างส่วนของคําขอรายการ
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
creationPayload |
object |
ชุดของคุณสมบัติที่ใช้ในการสร้างหน่วยข้อมูล หน้า สร้างรายการ ของประเภทที่เกี่ยวข้องจะระบุว่า |
definition |
ข้อกําหนดของหน่วยข้อมูล หน้า สร้างรายการ ของชนิดที่เกี่ยวข้องระบุว่ามีการสนับสนุนข้อกําหนดและให้รายละเอียดโครงสร้างหรือไม่ ใช้ |
|
description |
string |
คําอธิบายสินค้า ความยาวสูงสุดคือ 256 อักขระ |
displayName |
string |
ชื่อที่แสดงของรายการ ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล |
type |
ชนิดหน่วยข้อมูล |
ErrorRelatedResource
ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
resourceId |
string |
ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
resourceType |
string |
ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
ErrorResponse
การตอบสนองข้อผิดพลาด
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
errorCode |
string |
ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้ |
message |
string |
การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้ |
moreDetails |
รายการรายละเอียดข้อผิดพลาดเพิ่มเติม |
|
relatedResource |
รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
|
requestId |
string |
รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด |
ErrorResponseDetails
รายละเอียดการตอบสนองข้อผิดพลาด
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
errorCode |
string |
ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้ |
message |
string |
การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้ |
relatedResource |
รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด |
Item
วัตถุรายการ
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
description |
string |
คําอธิบายสินค้า |
displayName |
string |
ชื่อที่แสดงของรายการ |
id |
string uuid |
รหัสสินค้า |
type |
ชนิดหน่วยข้อมูล |
|
workspaceId |
string uuid |
ID พื้นที่ทํางาน |
ItemDefinition
วัตถุข้อกําหนดรายการ
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
format |
string |
รูปแบบของข้อกําหนดหน่วยข้อมูล |
parts |
รายการของส่วนข้อกําหนด |
ItemDefinitionPart
ออบเจ็กต์ส่วนของข้อกําหนดหน่วยข้อมูล
ชื่อ | พิมพ์ | คำอธิบาย |
---|---|---|
path |
string |
เส้นทางของหน่วยข้อมูล |
payload |
string |
ส่วนข้อมูลของหน่วยข้อมูล |
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 |