Staging - Update Spark Compute

บริการ:: Environment

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

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

Note

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

สิทธิ์

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

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

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 ที่จะใช้ ตั้งค่าเพื่อใช้ `false` เวอร์ชันที่วางจําหน่าย

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

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

การตอบสนอง

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

ชื่อ

พิมพ์

คำอธิบาย

200 OK

EnvironmentSparkCompute

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

Other Status Codes

ErrorResponse

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

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

ตัวอย่าง

Update environment staging spark compute example

Update environment staging spark compute instance pool using pool ID example

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

{
  "instancePool": {
    "name": "MyWorkspacePool",
    "type": "Workspace"
  },
  "driverCores": 4,
  "driverMemory": "56g",
  "executorCores": 4,
  "executorMemory": "56g",
  "dynamicExecutorAllocation": {
    "enabled": false,
    "minExecutors": 1,
    "maxExecutors": 1
  },
  "sparkProperties": [
    {
      "key": "spark.acls.enable",
      "value": "false"
    },
    {
      "key": "spark.admin.acls",
      "value": 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": [
    {
      "key": "spark.acls.enable",
      "value": "false"
    }
  ],
  "runtimeVersion": "1.2"
}

Update environment staging spark compute instance pool using pool ID example

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

HTTP

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

{
  "instancePool": {
    "id": "78942136-106c-4f3e-80fc-7ff4eae11603"
  }
}

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

รหัสสถานะ:: 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": [
    {
      "key": "spark.acls.enable",
      "value": "false"
    }
  ],
  "runtimeVersion": "1.2"
}

คำจำกัดความ

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

CustomPoolMemory

การแจงนับ

หน่วยความจําพูลแบบกําหนดเองสําหรับโปรแกรมควบคุม Spark หรือ Spark executor ประเภท CustomPoolMemory เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
28g	หน่วยความจํา 28GB
56g	หน่วยความจํา 56G
112g	หน่วยความจํา 112G
224g	หน่วยความจํา 224G
400g	หน่วยความจํา 400G

CustomPoolType

การแจงนับ

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

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

DynamicExecutorAllocationProperties

วัตถุ

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

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

EnvironmentSparkCompute

วัตถุ

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

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	ชนิดพูลอินสแตนซ์

SparkProperty

วัตถุ

คีย์คุณสมบัติ Spark และค่า

ชื่อ	พิมพ์	คำอธิบาย
key	string	คีย์คุณสมบัติ Spark
value	string	ค่าคุณสมบัติ Spark

UpdateEnvironmentSparkComputeRequest

วัตถุ

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

แชร์ผ่าน

Staging - Update Spark Compute

สิทธิ์

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

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

ส่วนติดต่อ

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

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

การตอบสนอง

ตัวอย่าง

Update environment staging spark compute example

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

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

Update environment staging spark compute instance pool using pool ID example

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

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

คำจำกัดความ

CustomPoolMemory

CustomPoolType

DynamicExecutorAllocationProperties

EnvironmentSparkCompute

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

InstancePool

SparkProperty

UpdateEnvironmentSparkComputeRequest