แชร์ผ่าน

Custom Pools - Create Workspace Custom Pool

บริการ:
Spark
เวอร์ชัน API:
v1

สร้างกลุ่มแบบกําหนดเอง

สิทธิ์

ผู้เรียกต้องมีบทบาทพื้นที่ทํางาน ของผู้ดูแลระบบ

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

Workspace.ReadWrite.All

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

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

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

อินเตอร์เฟซ

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/spark/pools

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

ชื่อ ใน จำเป็น พิมพ์ คำอธิบาย
workspaceId
 path True

string (uuid)

ID พื้นที่ทํางาน

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

ชื่อ จำเป็น พิมพ์ คำอธิบาย
autoScale True

AutoScaleProperties

ปรับขนาดอัตโนมัติ
dynamicExecutorAllocation True

DynamicExecutorAllocationProperties

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

string

ชื่อกลุ่มแบบกําหนดเอง
ชื่อต้องมีความยาวระหว่าง 1 ถึง 64 อักขระ และต้องมีเพียงตัวอักษร ตัวเลข เส้นประ ขีดล่าง และช่องว่างเท่านั้น
ชื่อกลุ่มแบบกําหนดเองต้องไม่ซ้ํากันภายในพื้นที่ทํางาน
"Starter Pool" เป็นชื่อพูลแบบกําหนดเองที่สงวนไว้
nodeFamily True

NodeFamily

ตระกูลโหนด
nodeSize True

NodeSize

ขนาดโหนด

การตอบสนอง

ชื่อ พิมพ์ คำอธิบาย
201 Created

CustomPool

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

ส่วนหัว

Location: string
Other Status Codes

ErrorResponse

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

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

ตัวอย่าง

Create custom pool example

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

POST https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/spark/pools

{
  "name": "pool1",
  "nodeFamily": "MemoryOptimized",
  "nodeSize": "Small",
  "autoScale": {
    "enabled": true,
    "minNodeCount": 1,
    "maxNodeCount": 2
  },
  "dynamicExecutorAllocation": {
    "enabled": true,
    "minExecutors": 1,
    "maxExecutors": 1
  }
}

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

รหัสสถานะ:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/spark/pools/2367293d-b70b-4b33-97f2-161b8d04a8d7
{
  "id": "2367293d-b70b-4b33-97f2-161b8d04a8d7",
  "name": "pool1",
  "type": "Workspace",
  "nodeFamily": "MemoryOptimized",
  "nodeSize": "Small",
  "autoScale": {
    "enabled": true,
    "minNodeCount": 1,
    "maxNodeCount": 2
  },
  "dynamicExecutorAllocation": {
    "enabled": true,
    "minExecutors": 1,
    "maxExecutors": 1
  }
}

คำจำกัดความ

ชื่อ คำอธิบาย
AutoScaleProperties

คุณสมบัติการปรับขนาดอัตโนมัติ
CreateCustomPoolRequest

สร้างส่วนข้อมูลคําขอพูลแบบกําหนดเอง
CustomPool

กลุ่มแบบกําหนดเอง
CustomPoolType

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

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

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

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

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

ตระกูลโหนด ประเภท NodeFamily เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
NodeSize

ขนาดโหนด ประเภท NodeSize เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

AutoScaleProperties

ออบเจ็กต์

คุณสมบัติการปรับขนาดอัตโนมัติ

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

boolean

สถานะของมาตราส่วนอัตโนมัติ False - ปิดใช้งาน จริง - เปิดใช้งาน
maxNodeCount

integer (int32)

minimum: 1

จํานวนโหนดสูงสุด
minNodeCount

integer (int32)

minimum: 1

จํานวนโหนดต่ําสุด

CreateCustomPoolRequest

ออบเจ็กต์

สร้างส่วนข้อมูลคําขอพูลแบบกําหนดเอง

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

AutoScaleProperties

ปรับขนาดอัตโนมัติ
dynamicExecutorAllocation

DynamicExecutorAllocationProperties

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

string

ชื่อกลุ่มแบบกําหนดเอง
ชื่อต้องมีความยาวระหว่าง 1 ถึง 64 อักขระ และต้องมีเพียงตัวอักษร ตัวเลข เส้นประ ขีดล่าง และช่องว่างเท่านั้น
ชื่อกลุ่มแบบกําหนดเองต้องไม่ซ้ํากันภายในพื้นที่ทํางาน
"Starter Pool" เป็นชื่อพูลแบบกําหนดเองที่สงวนไว้
nodeFamily

NodeFamily

ตระกูลโหนด
nodeSize

NodeSize

ขนาดโหนด

CustomPool

ออบเจ็กต์

กลุ่มแบบกําหนดเอง

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

AutoScaleProperties

ปรับขนาดอัตโนมัติ
dynamicExecutorAllocation

DynamicExecutorAllocationProperties

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

string (uuid)

รหัสกลุ่มแบบกําหนดเอง
name

string

ชื่อกลุ่มแบบกําหนดเอง
nodeFamily

NodeFamily

ตระกูลโหนด
nodeSize

NodeSize

ขนาดโหนด
type

CustomPoolType

ชนิดกลุ่มที่กําหนดเอง

CustomPoolType

การแจงนับ

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

ค่า คำอธิบาย
Workspace

กลุ่มแบบกําหนดเองระดับพื้นที่ทํางาน
Capacity

กลุ่มที่กําหนดเองของระดับกําลังการผลิต

DynamicExecutorAllocationProperties

ออบเจ็กต์

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

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

boolean

สถานะของการปันส่วนผู้ปฏิบัติการแบบไดนามิก False - ปิดใช้งาน จริง - เปิดใช้งาน
maxExecutors

integer (int32)

minimum: 1

ตัวดําเนินการสูงสุด
minExecutors

integer (int32)

minimum: 1

ตัวปฏิบัติการขั้นต่ํา

ErrorRelatedResource

ออบเจ็กต์

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

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

string

ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType

string

ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

ออบเจ็กต์

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

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

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails

ErrorResponseDetails[]

รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
relatedResource

ErrorRelatedResource

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

string

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

ErrorResponseDetails

ออบเจ็กต์

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

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

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource

ErrorRelatedResource

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

NodeFamily

การแจงนับ

ตระกูลโหนด ประเภท NodeFamily เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า คำอธิบาย
MemoryOptimized

ปรับหน่วยความจําให้เหมาะสมแล้ว

NodeSize

การแจงนับ

ขนาดโหนด ประเภท NodeSize เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า คำอธิบาย
Small

โหนดขนาดเล็ก
Medium

ขนาดโหนดขนาดกลาง
Large

โหนดขนาดใหญ่ขนาด
XLarge

ขนาดโหนด XLarge
XXLarge

ขนาดโหนด XXLarge