Staging - Update Spark Compute (preview)

บริการ:: Environment

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

อัปเดตการคํานวณ Spark ในสภาพสภาพแวดล้อม ถ้าคุณต้องการลบคุณสมบัติ Spark ให้ตั้งค่าเป็น null

Note

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

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

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

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

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

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

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

เปลี่ยนชนิดของคุณสมบัติsparkPropertiesคําขอและการตอบสนองจาก object เป็นรายการSparkProperty

สิทธิ์

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

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

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

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

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

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

ส่วนติดต่อ

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/staging/sparkcompute?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`

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

ชื่อ	พิมพ์	คำอธิบาย
driverCores	integer (int32)	แกนคนขับ Spark
driverMemory	string	หน่วยความจําโปรแกรมควบคุม Spark
dynamicExecutorAllocation	DynamicExecutorAllocationProperties	การปันส่วนผู้ปฏิบัติการแบบไดนามิก
executorCores	integer (int32)	แกนประมวลผล Spark
executorMemory	string	หน่วยความจําเครื่องปฏิบัติการ Spark
instancePool	InstancePool	พูลสภาพแวดล้อมต้องเป็นพูลแบบกําหนดเองที่ถูกต้อง ชื่อสําหรับกลุ่มพื้นที่ทํางานเริ่มต้นคือ กลุ่มเริ่มต้น
runtimeVersion	string	เวอร์ชันรันไทม์ ค้นหา รันไทม์ผ้าที่รองรับ
sparkProperties	object	คุณสมบัติ Spark สัญญาที่ยึดตามพจนานุกรมสําหรับการกําหนดคุณสมบัติของ Spark จะถูกยกเลิกในวันที่ 31 มกราคม 2026 โปรดโยกย้ายไปใช้รายการคู่คีย์-ค่าแทน

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK	EnvironmentSparkComputePreview	คําขอเสร็จสมบูรณ์
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: UnknownError - เกิดข้อผิดพลาด

ชื่อ

พิมพ์

คำอธิบาย

200 OK

EnvironmentSparkComputePreview

คําขอเสร็จสมบูรณ์

Other Status Codes

ErrorResponse

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

UnknownError - เกิดข้อผิดพลาด

ตัวอย่าง

Update environment staging spark compute example

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

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/environments/707cfd07-cbf1-41da-aad7-dd157ddb8c11/staging/sparkcompute?beta=True

{
  "instancePool": {
    "name": "MyWorkspacePool",
    "type": "Workspace"
  },
  "driverCores": 4,
  "driverMemory": "56g",
  "executorCores": 4,
  "executorMemory": "56g",
  "dynamicExecutorAllocation": {
    "enabled": false,
    "minExecutors": 1,
    "maxExecutors": 1
  },
  "sparkProperties": {
    "spark.acls.enable": "false",
    "spark.admin.acls": null
  },
  "runtimeVersion": "1.2"
}

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

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

{
  "instancePool": {
    "name": "MyWorkspacePool",
    "type": "Workspace",
    "id": "78942136-106c-4f3e-80fc-7ff4eae11603"
  },
  "driverCores": 4,
  "driverMemory": "56g",
  "executorCores": 4,
  "executorMemory": "56g",
  "dynamicExecutorAllocation": {
    "enabled": false,
    "minExecutors": 1,
    "maxExecutors": 1
  },
  "sparkProperties": {
    "spark.acls.enable": "false"
  },
  "runtimeVersion": "1.2"
}

คำจำกัดความ

ชื่อ	คำอธิบาย
CustomPoolType	ชนิดกลุ่มที่กําหนดเอง ประเภท `CustomPoolType` เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
DynamicExecutorAllocationProperties	proerties การปันส่วนผู้ปฏิบัติการแบบไดนามิก
EnvironmentSparkComputePreview
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
InstancePool	อินสแตนซ์ของกลุ่ม
UpdateEnvironmentSparkComputeRequestPreview

CustomPoolType

การแจงนับ

ชนิดกลุ่มที่กําหนดเอง ประเภท CustomPoolType เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Workspace	พูลแบบกําหนดเองของพื้นที่ทํางาน
Capacity	กลุ่มกําหนดเองของความจุ

DynamicExecutorAllocationProperties

วัตถุ

proerties การปันส่วนผู้ปฏิบัติการแบบไดนามิก

ชื่อ	พิมพ์	คำอธิบาย
enabled	boolean	สถานะของการปันส่วนผู้ปฏิบัติการแบบไดนามิก False - ปิดใช้งาน จริง - เปิดใช้งาน
maxExecutors	integer (int32) minimum: 1	หมายเลขตัวดําเนินการสูงสุดสําหรับการปันส่วนแบบไดนามิกและค่าต่ําสุดสําหรับคุณสมบัตินี้คือ 1 ค่าสูงสุดต้องต่ํากว่ากลุ่ม `maxNodeCount`อินสแตนซ์
minExecutors	integer (int32) minimum: 1	หมายเลขตัวดําเนินการต่ําสุดสําหรับการปันส่วนแบบไดนามิกและค่าต่ําสุดสําหรับคุณสมบัตินี้คือ 1 ค่าสูงสุดจะต้องต่ํากว่า`maxExecutors`

EnvironmentSparkComputePreview

วัตถุ

ชื่อ	พิมพ์	คำอธิบาย
driverCores	integer (int32)	แกนคนขับ Spark ต้องเป็นหนึ่งในค่าต่อไปนี้: 4, 8, 16, 32, 64
driverMemory	string	หน่วยความจําโปรแกรมควบคุม Spark
dynamicExecutorAllocation	DynamicExecutorAllocationProperties	การปันส่วนผู้ปฏิบัติการแบบไดนามิก
executorCores	integer (int32)	แกนประมวลผล Spark ต้องเป็นหนึ่งในค่าต่อไปนี้: 4, 8, 16, 32, 64
executorMemory	string	หน่วยความจําเครื่องปฏิบัติการ Spark
instancePool	InstancePool	พูลสภาพแวดล้อมต้องเป็นพูลแบบกําหนดเองที่ถูกต้อง "Starter Pool" หมายถึงใช้พูลตัวเริ่มต้น
runtimeVersion	string	เวอร์ชันรันไทม์ ค้นหา รันไทม์ผ้าที่รองรับ
sparkProperties	object	คุณสมบัติ Spark สัญญาที่ยึดตามพจนานุกรมสําหรับการกําหนดคุณสมบัติของ Spark จะถูกยกเลิกในวันที่ 31 มกราคม 2026 โปรดโยกย้ายไปใช้รายการคู่คีย์-ค่าแทน

ErrorRelatedResource

วัตถุ

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

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

ErrorResponse

วัตถุ

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

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

ErrorResponseDetails

วัตถุ

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

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

InstancePool

วัตถุ

อินสแตนซ์ของกลุ่ม

ชื่อ	พิมพ์	คำอธิบาย
id	string (uuid)	รหัสกลุ่มอินสแตนซ์
name	string	ชื่อพูลอินสแตนซ์
type	CustomPoolType	ชนิดพูลอินสแตนซ์

UpdateEnvironmentSparkComputeRequestPreview

วัตถุ

ชื่อ	พิมพ์	คำอธิบาย
driverCores	integer (int32)	แกนคนขับ Spark
driverMemory	string	หน่วยความจําโปรแกรมควบคุม Spark
dynamicExecutorAllocation	DynamicExecutorAllocationProperties	การปันส่วนผู้ปฏิบัติการแบบไดนามิก
executorCores	integer (int32)	แกนประมวลผล Spark
executorMemory	string	หน่วยความจําเครื่องปฏิบัติการ Spark
instancePool	InstancePool	พูลสภาพแวดล้อมต้องเป็นพูลแบบกําหนดเองที่ถูกต้อง ชื่อสําหรับกลุ่มพื้นที่ทํางานเริ่มต้นคือ กลุ่มเริ่มต้น
runtimeVersion	string	เวอร์ชันรันไทม์ ค้นหา รันไทม์ผ้าที่รองรับ
sparkProperties	object	คุณสมบัติ Spark สัญญาที่ยึดตามพจนานุกรมสําหรับการกําหนดคุณสมบัติของ Spark จะถูกยกเลิกในวันที่ 31 มกราคม 2026 โปรดโยกย้ายไปใช้รายการคู่คีย์-ค่าแทน

แชร์ผ่าน

Staging - Update Spark Compute (preview)

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

สิทธิ์

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

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

ส่วนติดต่อ

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

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

การตอบสนอง

ตัวอย่าง

Update environment staging spark compute example

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

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

คำจำกัดความ

CustomPoolType

DynamicExecutorAllocationProperties

EnvironmentSparkComputePreview

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

InstancePool

UpdateEnvironmentSparkComputeRequestPreview