Items - Create Environment

บริการ:

Environment

เวอร์ชัน API:

v1

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

สิทธิ์

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

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

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

ขีด จำกัด

• ในการสร้างสภาพแวดล้อม พื้นที่ทํางานต้องอยู่บนความจุ Fabric ที่ได้รับการสนับสนุน

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

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

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

อิน เทอร์ เฟซ

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

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

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

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

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

การตอบสนอง

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

ตัวอย่าง

Create an environment example

Create an environment with public definition example

Create an environment example

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

HTTP

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

{
  "displayName": "Environment_1",
  "description": "An environment description."
}

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

รหัสสถานะ:

201

{
  "displayName": "Environment_1",
  "description": "An environment description.",
  "type": "Environment",
  "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 environment with public definition example

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

HTTP

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

{
  "displayName": "Environment_1",
  "description": "An environment description.",
  "definition": {
    "parts": [
      {
        "path": "Libraries/CustomLibraries/samplelibrary.jar",
        "payload": "eyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": "Libraries/CustomLibraries/samplepython.py",
        "payload": "FyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": "Libraries/CustomLibraries/samplewheel-0.18.0-py2.py3-none-any.whl",
        "payload": "LyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": "Libraries/CustomLibraries/sampleR.tar.gz",
        "payload": "ZyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": "Libraries/PublicLibraries/environment.yml",
        "payload": "IyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": "Setting/Sparkcompute.yml",
        "payload": "GyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

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

รหัสสถานะ:

201

{
  "displayName": "Environment_1",
  "description": "An environment description.",
  "type": "Environment",
  "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

คำจำกัดความ

ชื่อ	คำอธิบาย
ComponentPublishInfo	เผยแพร่ข้อมูลสําหรับแต่ละคอมโพเนนต์ในสภาพแวดล้อม
CreateEnvironmentRequest	สร้างส่วนข้อมูลคําขอของสภาพแวดล้อม
Environment	รายการสภาพแวดล้อม
EnvironmentDefinition	วัตถุข้อกําหนดสาธารณะของสภาพแวดล้อม โปรดดู บทความนี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการสร้างคําจํากัดความสาธารณะของสภาพแวดล้อม
EnvironmentDefinitionPart	ออบเจ็กต์ส่วนของข้อกําหนดสภาพแวดล้อม
EnvironmentProperties	คุณสมบัติของสภาพแวดล้อม
EnvironmentPublishState	เผยแพร่สถานะ คุณสามารถเพิ่มชนิดสถานะเพิ่มเติมเมื่อเวลาผ่านไป
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
ItemTag	แสดงแท็กที่ใช้กับรายการ
ItemType	ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
PayloadType	ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
PublishDetails	รายละเอียดของการดําเนินการเผยแพร่
SparkLibraries	ไลบรารี Spark
SparkSettings	การตั้งค่า Spark

ComponentPublishInfo

วัตถุ

เผยแพร่ข้อมูลสําหรับแต่ละคอมโพเนนต์ในสภาพแวดล้อม

ชื่อ	พิมพ์	คำอธิบาย
sparkLibraries	SparkLibraries	ไลบรารี Spark จะเผยแพร่ข้อมูล
sparkSettings	SparkSettings	การตั้งค่า Spark เผยแพร่ข้อมูล

CreateEnvironmentRequest

วัตถุ

สร้างส่วนข้อมูลคําขอของสภาพแวดล้อม

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

Environment

วัตถุ

รายการสภาพแวดล้อม

ชื่อ	พิมพ์	คำอธิบาย
description	string	คําอธิบายสินค้า
displayName	string	ชื่อที่แสดงของรายการ
folderId	string (uuid)	ID โฟลเดอร์
id	string (uuid)	รหัสสินค้า
properties	EnvironmentProperties	คุณสมบัติสภาพแวดล้อม
tags	ItemTag[]	รายการของแท็กที่ใช้
type	ItemType	ชนิดหน่วยข้อมูล
workspaceId	string (uuid)	ID พื้นที่ทํางาน

EnvironmentDefinition

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
format	string	รูปแบบของข้อกําหนดสภาพแวดล้อม
parts	EnvironmentDefinitionPart[]	รายการของส่วนข้อกําหนด

EnvironmentDefinitionPart

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
path	string	เส้นทางของส่วนสภาพแวดล้อม
payload	string	ส่วนข้อมูลของสภาพแวดล้อม
payloadType	PayloadType	ชนิดของส่วนข้อมูล

EnvironmentProperties

วัตถุ

คุณสมบัติของสภาพแวดล้อม

ชื่อ	พิมพ์	คำอธิบาย
publishDetails	PublishDetails	รายละเอียดการดําเนินการเผยแพร่สภาพแวดล้อม

EnvironmentPublishState

การแจงนับ

เผยแพร่สถานะ คุณสามารถเพิ่มชนิดสถานะเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Success	การเผยแพร่สภาพแวดล้อมอยู่ในสถานะสําเร็จ
Cancelled	การเผยแพร่สภาพแวดล้อมอยู่ในสถานะถูกยกเลิก
Failed	การเผยแพร่สภาพแวดล้อมอยู่ในสถานะล้มเหลว
Cancelling	การเผยแพร่สภาพแวดล้อมอยู่ในสถานะการยกเลิก
Running	การเผยแพร่สภาพแวดล้อมอยู่ในสถานะกําลังทํางาน
Waiting	การเผยแพร่สภาพแวดล้อมอยู่ในสถานะกําลังรอ

ErrorRelatedResource

วัตถุ

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

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

ErrorResponse

วัตถุ

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

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

ErrorResponseDetails

วัตถุ

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

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

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

PayloadType

การแจงนับ

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

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

PublishDetails

วัตถุ

รายละเอียดของการดําเนินการเผยแพร่

ชื่อ	พิมพ์	คำอธิบาย
componentPublishInfo	ComponentPublishInfo	ข้อมูลการเผยแพร่คอมโพเนนต์ของสภาพแวดล้อม
endTime	string (date-time)	เวลาสิ้นสุดของการเผยแพร่ในรูปแบบ UTC โดยใช้รูปแบบ YYYY-MM-DDTHH:mm:ssZ
startTime	string (date-time)	เริ่มเวลาของการเผยแพร่ในรูปแบบ UTC โดยใช้รูปแบบ YYYY-MM-DDTHH:mm:ssZ
state	EnvironmentPublishState	เผยแพร่สถานะ คุณสามารถเพิ่มชนิดสถานะเพิ่มเติมเมื่อเวลาผ่านไป
targetVersion	string (uuid)	รุ่นเป้าหมายที่จะเผยแพร่

SparkLibraries

วัตถุ

ไลบรารี Spark

ชื่อ	พิมพ์	คำอธิบาย
state	EnvironmentPublishState	เผยแพร่สถานะ คุณสามารถเพิ่มชนิดสถานะเพิ่มเติมเมื่อเวลาผ่านไป

SparkSettings

วัตถุ

การตั้งค่า Spark

ชื่อ	พิมพ์	คำอธิบาย
state	EnvironmentPublishState	เผยแพร่สถานะ คุณสามารถเพิ่มชนิดสถานะเพิ่มเติมเมื่อเวลาผ่านไป