แชร์ผ่าน

Items - Create Eventstream

  • การอ้างอิง
บริการ:
Eventstream
เวอร์ชัน API:
v1

สร้างเหตุการณ์สตรีมในพื้นที่ทํางานที่ระบุ
API นี้สนับสนุน การดําเนินการที่ใช้เวลานาน (LRO)

เมื่อต้องการสร้างเหตุการณ์สตรีมที่มีข้อกําหนด ให้อ้างอิงถึง ข้อกําหนด Eventstream

สิทธิ์

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

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

Eventstream.ReadWrite.All หรือ Item.ReadWrite.All

ขีด จำกัด

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

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

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

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

อิน เทอร์ เฟซ

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

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

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

string

uuid

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

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

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

string

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

EventstreamDefinition

ข้อกําหนดสาธารณะเหตุการณ์
description

string

คําอธิบายเหตุการณ์ ความยาวสูงสุดคือ 256 อักขระ

การตอบสนอง

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

Eventstream

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

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

ส่วนหัว

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

ErrorResponse

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

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

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

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

ตัวอย่าง

Create an eventstream example
Create an eventstream with public definition example

Create an eventstream example

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventstreams

{
  "displayName": "Eventstream_1",
  "description": "Eventstream_1 description."
}

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

รหัสสถานะ:
201 
{
  "displayName": "Eventstream_1",
  "description": "Eventstream_1 description.",
  "type": "Eventstream",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
รหัสสถานะ:
202 
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 an eventstream with public definition example

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventstreams

{
  "displayName": "Eventstream_1",
  "description": "Eventstream_1 description.",
  "definition": {
    "format": "eventstream",
    "parts": [
      {
        "path": "eventstream.json",
        "payload": "SSdkIGxpa2UgdG8gdGVsbCBh..IGpva2UgZm9yIHlvdS4K",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

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

รหัสสถานะ:
201 
{
  "displayName": "Eventstream_1",
  "description": "Eventstream_1 description.",
  "type": "Eventstream",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
รหัสสถานะ:
202 
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

คำจำกัดความ

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

สร้างส่วนข้อมูลคําขอเหตุการณ์สตรีม
ErrorRelatedResource

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

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

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

วัตถุเหตุการณ์
EventstreamDefinition

ออบเจ็กต์ข้อกําหนดสาธารณะของเหตุการณ์
EventstreamDefinitionPart

ออบเจ็กต์ส่วนของข้อกําหนดเหตุการณ์
ItemType

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

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

CreateEventstreamRequest

ออบเจ็กต์

สร้างส่วนข้อมูลคําขอเหตุการณ์สตรีม

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

EventstreamDefinition

ข้อกําหนดสาธารณะเหตุการณ์
description

string

คําอธิบายเหตุการณ์ ความยาวสูงสุดคือ 256 อักขระ
displayName

string

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

ErrorRelatedResource

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponse

ออบเจ็กต์

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

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

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

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

ErrorResponseDetails

ออบเจ็กต์

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

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

string

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

string

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

ErrorRelatedResource

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

Eventstream

ออบเจ็กต์

วัตถุเหตุการณ์

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

string

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

string

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

string

uuid

รหัสสินค้า
type

ItemType

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

string

uuid

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

EventstreamDefinition

ออบเจ็กต์

ออบเจ็กต์ข้อกําหนดสาธารณะของเหตุการณ์

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

string

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

EventstreamDefinitionPart[]

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

EventstreamDefinitionPart

ออบเจ็กต์

ออบเจ็กต์ส่วนของข้อกําหนดเหตุการณ์

ชื่อ พิมพ์ คำอธิบาย
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