Items - Publish Environment (preview)

บริการ:: Environment

เวอร์ชัน API:: v1

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

Note

API นี้เป็นส่วนหนึ่งของการเผยแพร่รุ่นเบต้า และมีไว้สําหรับวัตถุประสงค์ในการประเมินและการพัฒนาเท่านั้น ซึ่งอาจเปลี่ยนแปลงตามคําติชมและไม่แนะนําสําหรับการใช้งานด้านการผลิต API รุ่นเบต้านี้จะถูกยกเลิกการสนับสนุนในวันที่ 1 มีนาคม 2026 และแทนที่ด้วยเวอร์ชันที่เสถียรซึ่งพร้อมใช้งานที่นี่ เวอร์ชันใหม่จะทําให้เกิดการเปลี่ยนแปลงที่เสียหายและไม่สามารถเข้ากันได้แบบย้อนหลัง เมื่อเรียกใช้ API นี้ ผู้เรียกต้องระบุ true เป็นค่าสําหรับพารามิเตอร์ beta คิวรี (preview พารามิเตอร์คิวรีถูกแทนที่ด้วย beta สําหรับความเข้ากันได้ preview ย้อนหลัง จะยังคงได้รับการสนับสนุนและทํางานเหมือนกับ beta)

ประกาศการเลิกใช้

มีการนําพารามิเตอร์ beta คิวรีใหม่เข้ามาเพื่ออํานวยความสะดวกในการเปลี่ยนนี้:

ในขณะนี้betaพารามิเตอร์คิวรีมีค่าเริ่มต้นเป็นtrue
ตั้งค่าของ beta พารามิเตอร์แบบสอบถามเพื่อใช้ false รุ่นที่เสถียรเผยแพร่ของ API นี้
เริ่มต้นวันที่ 1 มีนาคม 2026 ค่าเริ่มต้นสําหรับ beta จะเปลี่ยนเป็นfalse

เราขอแนะนําให้โยกย้ายการรวมของคุณเพื่อใช้เวอร์ชันที่วางจําหน่ายโดยเร็วที่สุดโดยการระบุ false สําหรับ beta พารามิเตอร์คิวรี (ค่าเริ่มต้นสําหรับ beta พารามิเตอร์คิวรีจะถูกตั้งค่าเป็น false วันที่ไม่สนับสนุน API)

มีการเปลี่ยนแปลงที่เข้ากันไม่ได้ต่อไปนี้ถูกนํามาใช้ในรุ่นการเผยแพร่:

การตอบสนองเป็นไปตามรูปแบบ การดําเนินการที่ยาวนาน (LRO) และรหัสการตอบสนอง HTTP 202 อาจถูกส่งกลับ

สิทธิ์

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

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

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 ที่จะใช้ ตั้งค่าเพื่อใช้ `true` เวอร์ชันเบต้าที่อธิบายไว้ในหน้านี้ หรือเพื่อใช้ `false` เวอร์ชันเบต้าที่อธิบายไว้ ที่นี่โดยละเอียด เริ่มต้นวันที่ 1 มีนาคม 2026 ค่าเริ่มต้นสําหรับ `beta` จะเปลี่ยนเป็น`false`

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK	EnvironmentProperties	ส่งคําขอการดําเนินการเผยแพร่เรียบร้อยแล้ว
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: InvalidEnvironmentPublish - การดําเนินการเผยแพร่สภาพแวดล้อมสําหรับเวอร์ชัน <GUID ของการดําเนินการ> เผยแพร่ที่ล้มเหลวล้มเหลวเนื่องจากข้อผิดพลาด: รหัส = EnvironmentAnotherOngoingPublishProcesss

ชื่อ

พิมพ์

คำอธิบาย

200 OK

EnvironmentProperties

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

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=True

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

รหัสสถานะ:: 200

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

คำจำกัดความ

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

แชร์ผ่าน

Items - Publish Environment (preview)

ประกาศการเลิกใช้

สิทธิ์

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

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

ส่วนติดต่อ

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

การตอบสนอง

ตัวอย่าง

Publish environment example

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

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

คำจำกัดความ

ComponentPublishInfo

EnvironmentProperties

EnvironmentPublishState

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

PublishDetails

SparkLibraries

SparkSettings