Items - Create Mounted Data Factory

บริการ:

MountedDataFactory

เวอร์ชัน API:

v1

สร้างโรงงานข้อมูลที่ติดตั้งอยู่ในพื้นที่ทํางานที่ระบุ
API นี้สนับสนุน การดําเนินการที่ใช้เวลานาน (LRO)

หากต้องการสร้าง MountedDataFactory ด้วยคําจํากัดความสาธารณะ โปรดดูบทความ MountedDataFactory

สิทธิ์

ผู้เรียกต้องมีบทบาทพื้นที่ทํางานผู้สนับสนุน

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

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

ขีด จำกัด

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

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

API นี้สนับสนุน Microsoft identitiesที่ระบุในส่วนนี้

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

อิน เทอร์ เฟซ

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

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน

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

ชื่อ	จำเป็น	พิมพ์	คำอธิบาย
displayName	True	string	ชื่อที่แสดง MountedDataFactory ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล
definition		MountedDataFactoryDefinition	ข้อกําหนดสาธารณะ MountedDataFactory
description		string	คําอธิบาย MountedDataFactory ความยาวสูงสุดคือ 256 อักขระ
folderId		string (uuid)	ID โฟลเดอร์ ถ้าไม่ได้ระบุ หรือเป็น null MountedDataFactory จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์ของพื้นที่ทํางาน
sensitivityLabelSettings		SensitivityLabelSettings	การตั้งค่าป้ายชื่อระดับความลับสําหรับ MountedDataFactory

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
201 Created	MountedDataFactory	สร้างเสร็จเรียบร้อยแล้ว
202 Accepted		คําขอที่ยอมรับ และกําลังดําเนินการเตรียมใช้งาน MountedDataFactory ส่วนหัว Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ Retry-After ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม ส่วนหัว Retry-After: integer
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: InvalidItemType - ชนิดรายการไม่ถูกต้อง ItemDisplayNameAlreadyInUse - ชื่อที่ใช้แสดงรายการถูกใช้แล้ว CorruptedPayload - ส่วนข้อมูลที่ให้มาเสียหาย WorkspaceItemsLimitExceeded - เกินขีดจํากัดของรายการพื้นที่ทํางาน

ตัวอย่าง

Create a MountedDataFactory with public definition example

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

HTTP

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

{
  "displayName": "MountedDataFactory 1",
  "description": "A MountedDataFactory description.",
  "definition": {
    "parts": [
      {
        "path": "mountedDataFactory-content.json",
        "payload": "ewogICJkYXRhRmFjdG9yeVJlc291cmNlSWQiOiAiL3N1YnNjcmlwdGlvbnMvPHN1YnNjcmlwdGlvbklkPi9yZXNvdXJjZUdyb3Vwcy88cmVzb3VyY2VHcm91cD4vcHJvdmlkZXJzL01pY3Jvc29mdC5EYXRhRmFjdG9yeS9mYWN0b3JpZXMvPGZhY3RvcnlOYW1lPiIKfQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

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

รหัสสถานะ:

201

{
  "displayName": "MountedDataFactory 1",
  "description": "A MountedDataFactory description.",
  "type": "MountedDataFactory",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

รหัสสถานะ:

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

คำจำกัดความ

ชื่อ	คำอธิบาย
CreateMountedDataFactoryRequest	สร้างส่วนข้อมูลคําขอ MountedDataFactory
EntireTenantPrincipal	แสดงองค์ประกอบหลักของผู้เช่า
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
GroupDetails	รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก Group
GroupPrincipal	แสดงกลุ่มความปลอดภัย
GroupType	ชนิดของกลุ่ม คุณสามารถเพิ่มชนิดกลุ่มเพิ่มเติมเมื่อเวลาผ่านไป
ItemTag	แสดงแท็กที่ใช้กับรายการ
ItemType	ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
MountedDataFactory	ออบเจ็กต์ MountedDataFactory
MountedDataFactoryDefinition	ออบเจ็กต์ข้อกําหนดสาธารณะ MountedDataFactory ดู บทความนี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับโครงสร้างของข้อกําหนด MountedDataFactory
MountedDataFactoryDefinitionPart	ออบเจ็กต์ส่วนของข้อกําหนด MountedDataFactory
PayloadType	ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
PrincipalType	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป
SensitivityLabel	แสดงป้ายชื่อระดับความลับที่ใช้กับรายการ
SensitivityLabelApplyStrategy	กลยุทธ์สําหรับการใช้ป้ายชื่อระดับความลับ ค่าเริ่มต้นคือ ApplyOrFail คุณสามารถเพิ่มชนิดเพิ่มเติมเมื่อเวลาผ่านไป
SensitivityLabelSettings	การตั้งค่าป้ายชื่อระดับความลับ
ServicePrincipalDetails	รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก ServicePrincipal
ServicePrincipalPrincipal	แสดง Microsoft Entra บริการหลัก
ServicePrincipalProfileDetails	รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก ServicePrincipalProfile
ServicePrincipalProfilePrincipal	แสดงโปรไฟล์บริการหลัก
UserDetails	รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก User
UserPrincipal	แสดง Microsoft Entra หลักของผู้ใช้

CreateMountedDataFactoryRequest

วัตถุ

สร้างส่วนข้อมูลคําขอ MountedDataFactory

ชื่อ	พิมพ์	คำอธิบาย
definition	MountedDataFactoryDefinition	ข้อกําหนดสาธารณะ MountedDataFactory
description	string	คําอธิบาย MountedDataFactory ความยาวสูงสุดคือ 256 อักขระ
displayName	string	ชื่อที่แสดง MountedDataFactory ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล
folderId	string (uuid)	ID โฟลเดอร์ ถ้าไม่ได้ระบุ หรือเป็น null MountedDataFactory จะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์ของพื้นที่ทํางาน
sensitivityLabelSettings	SensitivityLabelSettings	การตั้งค่าป้ายชื่อระดับความลับสําหรับ MountedDataFactory

EntireTenantPrincipal

วัตถุ

แสดงองค์ประกอบหลักของผู้เช่า

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงขององค์ประกอบหลัก
id	string (uuid)	ID ของโครงร่างสําคัญ
type	string: EntireTenant	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป

ErrorRelatedResource

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
resourceId	string	ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType	string	ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails	ErrorResponseDetails[]	รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId	string (uuid)	รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

GroupDetails

วัตถุ

รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก Group

ชื่อ	พิมพ์	คำอธิบาย
groupType	GroupType	ชนิดของกลุ่ม คุณสามารถเพิ่มชนิดกลุ่มเพิ่มเติมเมื่อเวลาผ่านไป

GroupPrincipal

วัตถุ

แสดงกลุ่มความปลอดภัย

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงขององค์ประกอบหลัก
groupDetails	GroupDetails	รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก Group
id	string (uuid)	ID ของโครงร่างสําคัญ
type	string: Group	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป

GroupType

การแจงนับ

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

ค่า	คำอธิบาย
Unknown	ไม่รู้จักชนิดกลุ่มหลัก
SecurityGroup	หลักคือกลุ่มความปลอดภัย
DistributionList	หลักคือรายการการแจกจ่าย

ItemTag

วัตถุ

แสดงแท็กที่ใช้กับรายการ

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อของแท็ก
id	string (uuid)	ID แท็ก

ItemType

การแจงนับ

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

ค่า	คำอธิบาย
Dashboard	แดชบอร์ด PowerBI
Report	รายงาน PowerBI
SemanticModel	แบบจําลองความหมายของ PowerBI
PaginatedReport	รายงานที่มีการแบ่งหน้าของ PowerBI
Datamart	Datamart ของ PowerBI
Lakehouse	เลคเฮ้าส์
Eventhouse	อาคารจัดงาน
Environment	สภาพแวดล้อม
KQLDatabase	ฐานข้อมูล KQL
KQLQueryset	ชุดคิวรี KQL
KQLDashboard	แดชบอร์ด KQL
DataPipeline	ไปป์ไลน์ข้อมูล
Notebook	โน๊ตบุ๊ค
SparkJobDefinition	ข้อกําหนดงานแบบประกายไฟ
MLExperiment	การทดลองการเรียนรู้ของเครื่อง
MLModel	แบบจําลองการเรียนรู้ของเครื่อง
Warehouse	คลังสินค้า
Eventstream	เหตุการณ์กระแสข้อมูล
SQLEndpoint	จุดสิ้นสุด SQL
MirroredWarehouse	คลังสินค้าที่มิเรอร์
MirroredDatabase	ฐานข้อมูลที่มิเรอร์
Reflex	รีเฟล็กซ์
GraphQLApi	API สําหรับรายการ GraphQL
MountedDataFactory	เมาท์ DataFactory
SQLDatabase	SQLDatabase
CopyJob	งานคัดลอก
VariableLibrary	VariableLibrary
Dataflow	กระแสข้อมูล
ApacheAirflowJob	ApacheAirflowJob
WarehouseSnapshot	สแนปช็อตของคลังสินค้า
DigitalTwinBuilder	DigitalTwinBuilder
DigitalTwinBuilderFlow	โฟลว์ Digital Twin Builder
MirroredAzureDatabricksCatalog	แค็ตตาล็อก azure databricks ที่มิเรอร์
Map	แผนที่.
AnomalyDetector	การตรวจหาความผิดปกติ
UserDataFunction	ฟังก์ชันข้อมูลผู้ใช้
GraphModel	GraphModel
GraphQuerySet	ชุดคิวรีกราฟ
SnowflakeDatabase	ฐานข้อมูล Snowflake เพื่อจัดเก็บตาราง Iceberg ที่สร้างขึ้นจากบัญชี Snowflake
OperationsAgent	OperationsAgent
CosmosDBDatabase	ฐานข้อมูล Cosmos DB
Ontology	โทโพโลยี
EventSchemaSet	EventSchemaSet
DataAgent	DataAgent
MirroredCatalog	มิเรอร์ดคาตาล็อก

MountedDataFactory

วัตถุ

ออบเจ็กต์ MountedDataFactory

ชื่อ	พิมพ์	คำอธิบาย
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	ข้อมูลประจําตัวเริ่มต้นของรายการ
description	string	คําอธิบายสินค้า
displayName	string	ชื่อที่แสดงของรายการ
folderId	string (uuid)	ID โฟลเดอร์
id	string (uuid)	รหัสสินค้า
sensitivityLabel	SensitivityLabel	ป้ายชื่อระดับความลับของหน่วยข้อมูล
tags	ItemTag[]	รายการของแท็กที่ใช้
type	ItemType	ชนิดหน่วยข้อมูล
workspaceId	string (uuid)	ID พื้นที่ทํางาน

MountedDataFactoryDefinition

วัตถุ

ออบเจ็กต์ข้อกําหนดสาธารณะ MountedDataFactory ดู บทความนี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับโครงสร้างของข้อกําหนด MountedDataFactory

ชื่อ	พิมพ์	คำอธิบาย
format	string	รูปแบบของข้อกําหนดหน่วยข้อมูล รูปแบบที่ได้รับการสนับสนุน: MountedDataFactoryV1
parts	MountedDataFactoryDefinitionPart[]	รายการของส่วนข้อกําหนด

MountedDataFactoryDefinitionPart

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
path	string	เส้นทางส่วนข้อกําหนดสาธารณะ MountedDataFactory
payload	string	ส่วนข้อกําหนดสาธารณะ MountedDataFactory
payloadType	PayloadType	ชนิดของส่วนข้อมูล

PayloadType

การแจงนับ

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

ค่า	คำอธิบาย
InlineBase64	ฐานแบบอินไลน์ 64

PrincipalType

การแจงนับ

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

ค่า	คำอธิบาย
User	หลักเป็น Microsoft Entra หลักของผู้ใช้
ServicePrincipal	หลักเป็น Microsoft Entra บริการหลัก
Group	หลักคือกลุ่มความปลอดภัย
ServicePrincipalProfile	หลักคือ โปรไฟล์โครงร่างสําคัญของบริการ
EntireTenant	หลักแสดงผู้ใช้ที่เป็นผู้เช่าทั้งหมด

SensitivityLabel

วัตถุ

แสดงป้ายชื่อระดับความลับที่ใช้กับรายการ

ชื่อ	พิมพ์	คำอธิบาย
id	string (uuid)	รหัสป้ายชื่อระดับความลับ

SensitivityLabelApplyStrategy

การแจงนับ

กลยุทธ์สําหรับการใช้ป้ายชื่อระดับความลับ ค่าเริ่มต้นคือ ApplyOrFail คุณสามารถเพิ่มชนิดเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
ApplyOrFail	ใช้ป้ายชื่อระดับความลับหรือล้มเหลวของการดําเนินการถ้าไม่สามารถนําไปใช้ได้
Ignore	ละเว้นป้ายชื่อระดับความลับหากไม่สามารถใช้และดําเนินการต่อด้วยการดําเนินการโดยไม่ต้องใช้ป้ายชื่อ

SensitivityLabelSettings

วัตถุ

การตั้งค่าป้ายชื่อระดับความลับ

ชื่อ	พิมพ์	คำอธิบาย
labelId	string (uuid)	รหัสป้ายชื่อระดับความลับ
sensitivityLabelApplyStrategy	SensitivityLabelApplyStrategy	กลยุทธ์สําหรับการใช้ป้ายชื่อระดับความลับ

ServicePrincipalDetails

วัตถุ

รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก ServicePrincipal

ชื่อ	พิมพ์	คำอธิบาย
aadAppId	string (uuid)	AppId Microsoft Entra ของโครงร่างสําคัญของบริการ

ServicePrincipalPrincipal

วัตถุ

แสดง Microsoft Entra บริการหลัก

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงขององค์ประกอบหลัก
id	string (uuid)	ID ของโครงร่างสําคัญ
servicePrincipalDetails	ServicePrincipalDetails	รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก ServicePrincipal
type	string: ServicePrincipal	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป

ServicePrincipalProfileDetails

วัตถุ

รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก ServicePrincipalProfile

ชื่อ	พิมพ์	คำอธิบาย
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	โครงร่างสําคัญของโปรไฟล์บริการหลัก

ServicePrincipalProfilePrincipal

วัตถุ

แสดงโปรไฟล์บริการหลัก

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงขององค์ประกอบหลัก
id	string (uuid)	ID ของโครงร่างสําคัญ
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก ServicePrincipalProfile
type	string: ServicePrincipalProfile	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป

UserDetails

วัตถุ

รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก User

ชื่อ	พิมพ์	คำอธิบาย
userPrincipalName	string	ชื่อหลักของผู้ใช้

UserPrincipal

วัตถุ

แสดง Microsoft Entra หลักของผู้ใช้

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงขององค์ประกอบหลัก
id	string (uuid)	ID ของโครงร่างสําคัญ
type	string: User	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป
userDetails	UserDetails	รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก User