Node Pools - Create Or Update

服務:: Discovery

API 版本:: 2026-02-01-preview

建立節點池

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Discovery/supercomputers/{supercomputerName}/nodePools/{nodePoolName}?api-version=2026-02-01-preview

URI 參數

名稱	位於	必要	類型	Description
nodePoolName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	NodePool 的名稱
resourceGroupName	path	True	string minLength: 1 maxLength: 90	資源群組的名稱。名稱不區分大小寫。
subscriptionId	path	True	string (uuid)	目標訂用帳戶的標識碼。此值必須是 UUID。
supercomputerName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	超級電腦的名稱
api-version	query	True	string minLength: 1	用於此作業的 API 版本。

要求本文

名稱	必要	類型	Description
location	True	string	資源所在的地理位置
properties		NodePoolProperties	此資源的資源特定屬性。
tags		object	資源標籤。

回應

名稱	類型	Description
200 OK	NodePool	資源「NodePool」更新操作成功
201 Created	NodePool	資源「NodePool」建立操作成功標題 Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	未預期的錯誤回應。

名稱

類型

Description

200 OK

NodePool

資源「NodePool」更新操作成功

201 Created

NodePool

資源「NodePool」建立操作成功

標題

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow.

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

NodePools_CreateOrUpdate_MaximumSet

範例要求

HTTP

PUT https://management.azure.com/subscriptions/C058B75F-64D2-4E9D-8B66-65339DCB22C7/resourceGroups/rgdiscovery/providers/Microsoft.Discovery/supercomputers/8074da5c77f95509a8/nodePools/5a88c24ec4e7091650?api-version=2026-02-01-preview

{
  "properties": {
    "subnetId": "/subscriptions/31735C59-6307-4464-8B80-3675223F23D2/providers/Microsoft.Network/virtualNetworks/virtualnetwork1/subnets/subnet1",
    "vmSize": "Standard_NC24ads_A100_v4",
    "maxNodeCount": 4,
    "minNodeCount": 0,
    "scaleSetPriority": "Regular"
  },
  "tags": {
    "key6074": "qlnvwgazrqmwauqqvxntjtoye"
  },
  "location": "uksouth"
}

範例回覆

狀態碼:: 200

{
  "id": "/subscriptions/C058B75F-64D2-4E9D-8B66-65339DCB22C7/resourceGroups/rgdiscovery/providers/Microsoft.Discovery/supercomputers/8074da5c77f95509a8/nodePools/5a88c24ec4e7091650",
  "name": "5a88c24ec4e7091650",
  "tags": {
    "key6074": "qlnvwgazrqmwauqqvxntjtoye"
  },
  "location": "uksouth",
  "type": "Microsoft.Discovery/supercomputers/nodePools",
  "systemData": {
    "createdBy": "ly",
    "createdByType": "User",
    "createdAt": "2026-02-10T17:26:12.585Z",
    "lastModifiedBy": "xxc",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2026-02-10T17:26:12.586Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "subnetId": "/subscriptions/31735C59-6307-4464-8B80-3675223F23D2/providers/Microsoft.Network/virtualNetworks/virtualnetwork1/subnets/subnet1",
    "vmSize": "Standard_NC24ads_A100_v4",
    "maxNodeCount": 4,
    "minNodeCount": 0,
    "scaleSetPriority": "Regular"
  }
}

狀態碼:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus
Retry-After: 10

{
  "id": "/subscriptions/C058B75F-64D2-4E9D-8B66-65339DCB22C7/resourceGroups/rgdiscovery/providers/Microsoft.Discovery/supercomputers/8074da5c77f95509a8/nodePools/5a88c24ec4e7091650",
  "name": "5a88c24ec4e7091650",
  "tags": {
    "key6074": "qlnvwgazrqmwauqqvxntjtoye"
  },
  "location": "uksouth",
  "type": "Microsoft.Discovery/supercomputers/nodePools",
  "systemData": {
    "createdBy": "ly",
    "createdByType": "User",
    "createdAt": "2026-02-10T17:26:12.585Z",
    "lastModifiedBy": "xxc",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2026-02-10T17:26:12.586Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "subnetId": "/subscriptions/31735C59-6307-4464-8B80-3675223F23D2/providers/Microsoft.Network/virtualNetworks/virtualnetwork1/subnets/subnet1",
    "vmSize": "Standard_NC24ads_A100_v4",
    "maxNodeCount": 4,
    "minNodeCount": 0,
    "scaleSetPriority": "Regular"
  }
}

定義

名稱	Description
createdByType	建立資源的身分識別類型。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
NodePool	NodePool 追蹤資源
NodePoolProperties	NodePool 屬性
ProvisioningState	資源布建狀態。
ScaleSetPriority	支援虛擬機縮放設定優先順序。
systemData	與建立和上次修改資源相關的元數據。
VmSize	支援 Azure VM 大小。

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳情
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

NodePool

Object

NodePool 追蹤資源

名稱	類型	Description
id	string (arm-id)	資源的完整資源標識碼。例如，“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
location	string	資源所在的地理位置
name	string	資源的名稱
properties	NodePoolProperties	此資源的資源特定屬性。
systemData	systemData	Azure Resource Manager 包含 createdBy 與 modifiedBy 資訊的元資料。
tags	object	資源標籤。
type	string	資源的類型。例如：「Microsoft。運算/虛擬機器」或「Microsoft」。儲存/儲存帳號」

NodePoolProperties

Object

NodePool 屬性

名稱	類型	預設值	Description
maxNodeCount	integer (int32) minimum: 1		節點數量最多。
minNodeCount	integer (int32) minimum: 0	0	最低節點數。
provisioningState	ProvisioningState		上次作業的狀態。
scaleSetPriority	ScaleSetPriority	Regular	虛擬機擴展集優先順序。如果未指定，則預設值為『Regular』。
subnetId	string (arm-id)		節點池子網。
vmSize	VmSize		底層 Azure 虛擬機的大小。

ProvisioningState

列舉型別

資源布建狀態。

值	Description
Succeeded	資源已建立。
Failed	資源建立失敗。
Canceled	資源建立已取消。
Accepted	資源建立要求已被接受
Provisioning	正在佈建資源
Updating	資源正在更新中
Deleting	正在刪除資源

ScaleSetPriority

列舉型別

支援虛擬機縮放設定優先順序。

值	Description
Regular	一般優先權虛擬機縮放集。
Spot	Spot 優先虛擬機尺度集。

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	資源上次修改的時間戳記（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

VmSize

列舉型別

支援 Azure VM 大小。

值	Description
Standard_NC24ads_A100_v4	Standard_NC24ads_A100_v4 GPU 最佳化Azure虛擬機大小
Standard_NC48ads_A100_v4	Standard_NC48ads_A100_v4 GPU 優化的 Azure VM 大小
Standard_NC96ads_A100_v4	Standard_NC96ads_A100_v4 GPU 最佳化 Azure VM 大小
Standard_NC4as_T4_v3	Standard_NC4as_T4_v3 GPU 最佳化Azure虛擬機大小
Standard_NC8as_T4_v3	Standard_NC8as_T4_v3 GPU 最佳化 Azure VM 大小
Standard_NC16as_T4_v3	Standard_NC16as_T4_v3 GPU 最佳化 Azure VM 大小
Standard_NC64as_T4_v3	Standard_NC64as_T4_v3 GPU 優化的 Azure VM 大小
Standard_NV6ads_A10_v5	Standard_NV6ads_A10_v5 GPU 優化 Azure VM 大小
Standard_NV12ads_A10_v5	Standard_NV12ads_A10_v5 GPU 優化Azure虛擬機大小
Standard_NV24ads_A10_v5	Standard_NV24ads_A10_v5 GPU 最佳化 Azure 虛擬機大小
Standard_NV36ads_A10_v5	Standard_NV36ads_A10_v5 GPU 最佳化 Azure VM 大小
Standard_NV36adms_A10_v5	Standard_NV36ads_A10_v5 GPU 最佳化 Azure VM 大小
Standard_NV72ads_A10_v5	Standard_NV36ads_A10_v5 GPU 最佳化 Azure VM 大小
Standard_ND40rs_v2	Standard_ND40rs_v2 GPU 優化的 Azure VM 大小

共用方式為

Node Pools - Create Or Update

URI 參數

要求本文

回應

安全性

azure_auth

範圍

範例

NodePools_CreateOrUpdate_MaximumSet

範例要求

範例回覆

定義

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

NodePool

NodePoolProperties

ProvisioningState

ScaleSetPriority

systemData

VmSize