แชร์ผ่าน

Published - Get Spark Compute (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

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

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

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

  • เปลี่ยนชนิดของคุณสมบัติsparkPropertiesการตอบสนองจากรายการobjectSparkProperty

สิทธิ์

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

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

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

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

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

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

ส่วนติดต่อ

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/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

การตอบสนอง

ชื่อ พิมพ์ คำอธิบาย
200 OK

EnvironmentSparkComputePreview

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

ErrorResponse

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

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

ตัวอย่าง

Get environment Spark compute example

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

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

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

รหัสสถานะ:
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

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

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

ชนิดพูลอินสแตนซ์