Items - Publish Environment

บริการ:

Environment

เวอร์ชัน API:

v1

ทริกเกอร์การดําเนินการเผยแพร่สภาพแวดล้อม

Note

API นี้เป็นเวอร์ชันเบต้ารุ่นเผยแพร่เนื่องจากไม่ได้รับการสนับสนุนในวันที่ 1 มีนาคม 2026 เมื่อเรียกใช้ API นี้ - ผู้เรียกต้องตั้งค่าพารามิเตอร์ beta คิวรีเป็นค่า false

API นี้สนับสนุน การดําเนินการที่ใช้เวลานาน (LRO)

สิทธิ์

สิทธิ์การเขียนสําหรับรายการสภาพแวดล้อม

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

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

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

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

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

ส่วนติดต่อ

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/staging/publish?beta={beta}

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
environmentId	path	True	string (uuid)	รหัสสภาพแวดล้อม
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน
beta	query	True	boolean	พารามิเตอร์นี้ระบุเวอร์ชันของ API ที่จะใช้ ตั้งค่าเพื่อใช้ false เวอร์ชันที่วางจําหน่าย

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK	EnvironmentProperties	ส่งคําขอการดําเนินการเผยแพร่เรียบร้อยแล้ว
202 Accepted		การร้องขอที่ยอมรับแล้ว กําลังดําเนินการเผยแพร่อยู่ ส่งกลับสัญญา GA เมื่อ beta=false (ค่าเริ่มต้นหลังจากวันที่ 1 มีนาคม 2026) ส่วนหัว Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: InvalidEnvironmentPublish - การดําเนินการเผยแพร่สภาพแวดล้อมสําหรับเวอร์ชัน <GUID ของการดําเนินการ> เผยแพร่ที่ล้มเหลวล้มเหลวเนื่องจากข้อผิดพลาด: รหัส = EnvironmentAnotherOngoingPublishProcesss

ตัวอย่าง

Publish environment example

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

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/environments/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/staging/publish?beta=false

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

รหัสสถานะ:

200

{
  "publishDetails": {
    "state": "Running",
    "targetVersion": "46838a80-5450-4414-bea0-40fb6f3e0c0d",
    "startTime": "2024-03-29T14:17:09.0697022Z",
    "componentPublishInfo": {
      "sparkLibraries": {
        "state": "Running"
      },
      "sparkSettings": {
        "state": "Running"
      }
    }
  }
}

รหัสสถานะ:

202

Location: https://api.fabric.microsoft.com/v1/operations/abcdef00-9d7e-469a-abf1-fca847a0ea69
x-ms-operation-id: abcdef00-9d7e-469a-abf1-fca847a0ea69
Retry-After: 120

คำจำกัดความ

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

ComponentPublishInfo

วัตถุ

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

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

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	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

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	เผยแพร่สถานะ คุณสามารถเพิ่มชนิดสถานะเพิ่มเติมเมื่อเวลาผ่านไป