แชร์ผ่าน

Item Lifecycle - Create Item

บริการ:
Workload Development
เวอร์ชัน API:
v1

Microsoft Fabric เรียกสําหรับการสร้างรายการใหม่
เมื่อสร้างรายการ Fabric จะดําเนินการตรวจสอบพื้นฐาน ให้สร้างรายการในสถานะการเตรียมใช้งานและเรียกใช้ API นี้เพื่อแจ้งปริมาณงาน คาดว่าจะดําเนินการตรวจสอบความถูกต้องที่จําเป็น จัดเก็บเมตาดาต้าของหน่วยข้อมูล จัดสรรทรัพยากรที่จําเป็น และอัปเดตแคชเมตาดาต้าของรายการ Fabric ด้วยความสัมพันธ์ของรายการและ ETag

API นี้ควรยอมรับการรับรองความถูกต้อง SubjectAndApp

สิทธิ์

สิทธิ์จะถูกตรวจสอบโดย Microsoft Fabric

POST https://workload.contoso.com/workload-api-path-placeholder/workspaces/{workspaceId}/items/{itemType}/{itemId}

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

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

string (uuid)

รหัสสินค้า
itemType
 path True

string

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

string (uuid)

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

ส่วนหัวของคำขอ

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

string

ID ที่ไม่ซ้ํากันสําหรับความสัมพันธ์ของคําขอกับระบบของคุณเมื่อผู้ใช้โต้ตอบกับปริมาณงานของคุณ
RequestId True

string

ID ที่ไม่ซ้ํากันทั่วโลกที่ช่วยให้ Fabric สัมพันธ์กับคําขอของคุณกับบันทึกของเรา ระบุ ID นี้เมื่อรายงานปัญหา
Authorization True

string

ส่วนหัวการอนุญาตโทเค็นคู่ที่อนุญาตให้ปริมาณงานตรวจสอบแหล่งที่มาของคําขอ ให้บริบทของผู้ใช้ และเรียกบริการอื่น ๆ ส่วนหัวนี้มีรูปแบบต่อไปนี้: SubjectAndAppToken1.0 subjectToken="delegated token", appToken="S2S token"
x-ms-client-tenant-id True

string

ID ผู้เช่าของไคลเอ็นต์ที่ทําการร้องขอ

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

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

string

maxLength: 256

ชื่อที่แสดงของรายการ ต้องไม่เกิน 256 อักขระ
creationPayload

object

การสร้างส่วนข้อมูลเฉพาะสําหรับปริมาณงานและชนิดรายการ ส่งผ่านโดยตัวแก้ไขรายการหรือเป็นพารามิเตอร์ API อัตโนมัติของ Fabric
description

string

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

การตอบสนอง

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

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

ErrorResponse

สําหรับเงื่อนไขของข้อผิดพลาด ปริมาณงานควรส่งกลับรหัสสถานะข้อผิดพลาด HTTP ที่เหมาะสม (4xx, 5xx) พร้อมข้อมูลข้อผิดพลาดโดยละเอียดในเนื้อความการตอบสนอง

ตัวอย่าง

Create item example

คำขอตัวอย่าง

POST https://workload.contoso.com/workload-api-path-placeholder/workspaces/e5ef604d-e14f-4a59-9133-75d5a0cb9334/items/Contoso.FinanceAnalytics.Forecast/b14cb7e7-d346-4751-9cfd-8c2767d53111

{
  "displayName": "Forecast 1",
  "description": "The 1st forecast item",
  "creationPayload": {
    "algorithm": "ExponentialSmoothing"
  }
}

คำตอบตัวอย่าง

รหัสสถานะ:
200

คำจำกัดความ

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

สร้างเนื้อหาการร้องขอรายการ
ErrorExtendedInformation

ข้อมูลข้อผิดพลาดเพิ่มเติม
ErrorResponse

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

แหล่งข้อมูลของข้อผิดพลาด
NameValuePair

คู่ชื่อ-ค่า

CreateItemRequest

ออบเจ็กต์

สร้างเนื้อหาการร้องขอรายการ

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

object

การสร้างส่วนข้อมูลเฉพาะสําหรับปริมาณงานและชนิดรายการ ส่งผ่านโดยตัวแก้ไขรายการหรือเป็นพารามิเตอร์ API อัตโนมัติของ Fabric
description

string

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

string

maxLength: 256

ชื่อที่แสดงของรายการ ต้องไม่เกิน 256 อักขระ

ErrorExtendedInformation

ออบเจ็กต์

ข้อมูลข้อผิดพลาดเพิ่มเติม

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

NameValuePair[]

รายการพารามิเตอร์เพิ่มเติมเฉพาะสําหรับข้อผิดพลาด
errorCode

string

รหัสข้อผิดพลาด
message

string

ข้อความแสดงข้อผิดพลาด
messageParameters

string[]

รายการพารามิเตอร์สําหรับการจัดรูปแบบข้อความที่มีการแปลเป็นภาษาท้องถิ่น

ErrorResponse

ออบเจ็กต์

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

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

string

รหัสข้อผิดพลาด
isPermanent

boolean

ระบุว่าข้อผิดพลาดเป็นแบบถาวรหรือสามารถลองดําเนินการใหม่ได้
message

string

ข้อความแสดงข้อผิดพลาด
messageParameters

string[]

รายการพารามิเตอร์สําหรับการจัดรูปแบบข้อความที่มีการแปลเป็นภาษาท้องถิ่น
moreDetails

ErrorExtendedInformation[]

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

ErrorSource

แหล่งข้อมูลข้อผิดพลาด

ErrorSource

การแจงนับ

แหล่งข้อมูลของข้อผิดพลาด

ค่า คำอธิบาย
System
User
External

NameValuePair

ออบเจ็กต์

คู่ชื่อ-ค่า

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

string

ชื่อ
value

string

ค่า