Node Pools - Create Or Update

Service:: Discovery

API Version:: 2026-02-01-preview

Create a NodePool

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

URI Parameters

Name	In	Required	Type	Description
nodePoolName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	The name of the NodePool
resourceGroupName	path	True	string minLength: 1 maxLength: 90	The name of the resource group. The name is case insensitive.
subscriptionId	path	True	string (uuid)	The ID of the target subscription. The value must be an UUID.
supercomputerName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	The name of the Supercomputer
api-version	query	True	string minLength: 1	The API version to use for this operation.

Request Body

Name	Required	Type	Description
location	True	string	The geo-location where the resource lives
properties		NodePoolProperties	The resource-specific properties for this resource.
tags		object	Resource tags.

Responses

Name	Type	Description
200 OK	NodePool	Resource 'NodePool' update operation succeeded
201 Created	NodePool	Resource 'NodePool' create operation succeeded Headers Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	An unexpected error response.

Name

Type

Description

200 OK

NodePool

Resource 'NodePool' update operation succeeded

201 Created

NodePool

Resource 'NodePool' create operation succeeded

Headers

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

An unexpected error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

NodePools_CreateOrUpdate_MaximumSet

Sample request

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"
}

Sample response

Status code:: 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"
  }
}

Status code:: 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"
  }
}

Definitions

Name	Description
createdByType	The type of identity that created the resource.
ErrorAdditionalInfo	The resource management error additional info.
ErrorDetail	The error detail.
ErrorResponse	Error response
NodePool	NodePool tracked resource
NodePoolProperties	NodePool properties
ProvisioningState	The resource provisioning state.
ScaleSetPriority	Supported Virtual Machine Scale Set priorities.
systemData	Metadata pertaining to creation and last modification of the resource.
VmSize	Supported Azure VM Sizes.

createdByType

Enumeration

The type of identity that created the resource.

Value	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

ErrorDetail

Object

The error detail.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	ErrorDetail[]	The error details.
message	string	The error message.
target	string	The error target.

ErrorResponse

Object

Error response

Name	Type	Description
error	ErrorDetail	The error object.

NodePool

Object

NodePool tracked resource

Name	Type	Description
id	string (arm-id)	Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	The geo-location where the resource lives
name	string	The name of the resource
properties	NodePoolProperties	The resource-specific properties for this resource.
systemData	systemData	Azure Resource Manager metadata containing createdBy and modifiedBy information.
tags	object	Resource tags.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

NodePoolProperties

Object

NodePool properties

Name	Type	Default value	Description
maxNodeCount	integer (int32) minimum: 1		The maximum number of nodes.
minNodeCount	integer (int32) minimum: 0	0	The minimum number of nodes.
provisioningState	ProvisioningState		The status of the last operation.
scaleSetPriority	ScaleSetPriority	Regular	The Virtual Machine Scale Set priority. If not specified, the default is 'Regular'.
subnetId	string (arm-id)		The node pool subnet.
vmSize	VmSize		The size of the underlying Azure VM.

ProvisioningState

Enumeration

The resource provisioning state.

Value	Description
Succeeded	Resource has been created.
Failed	Resource creation failed.
Canceled	Resource creation was canceled.
Accepted	The resource create request has been accepted
Provisioning	The resource is being provisioned
Updating	The resource is updating
Deleting	The resource is being deleted

ScaleSetPriority

Enumeration

Supported Virtual Machine Scale Set priorities.

Value	Description
Regular	Regular priority Virtual Machine Scale Set.
Spot	Spot priority Virtual Machine Scale Set.

systemData

Object

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string (date-time)	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string (date-time)	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.

VmSize

Enumeration

Supported Azure VM Sizes.

Value	Description
Standard_NC24ads_A100_v4	Standard_NC24ads_A100_v4 GPU-optimized Azure VM Size
Standard_NC48ads_A100_v4	Standard_NC48ads_A100_v4 GPU-optimized Azure VM Size
Standard_NC96ads_A100_v4	Standard_NC96ads_A100_v4 GPU-optimized Azure VM Size
Standard_NC4as_T4_v3	Standard_NC4as_T4_v3 GPU-optimized Azure VM Size
Standard_NC8as_T4_v3	Standard_NC8as_T4_v3 GPU-optimized Azure VM Size
Standard_NC16as_T4_v3	Standard_NC16as_T4_v3 GPU-optimized Azure VM Size
Standard_NC64as_T4_v3	Standard_NC64as_T4_v3 GPU-optimized Azure VM Size
Standard_NV6ads_A10_v5	Standard_NV6ads_A10_v5 GPU-optimized Azure VM Size
Standard_NV12ads_A10_v5	Standard_NV12ads_A10_v5 GPU-optimized Azure VM Size
Standard_NV24ads_A10_v5	Standard_NV24ads_A10_v5 GPU-optimized Azure VM Size
Standard_NV36ads_A10_v5	Standard_NV36ads_A10_v5 GPU-optimized Azure VM Size
Standard_NV36adms_A10_v5	Standard_NV36ads_A10_v5 GPU-optimized Azure VM Size
Standard_NV72ads_A10_v5	Standard_NV36ads_A10_v5 GPU-optimized Azure VM Size
Standard_ND40rs_v2	Standard_ND40rs_v2 GPU-optimized Azure VM Size

Share via

Node Pools - Create Or Update

URI Parameters

Request Body

Responses

Security

azure_auth

Scopes

Examples

NodePools_CreateOrUpdate_MaximumSet

Sample request

Sample response

Definitions

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

NodePool

NodePoolProperties

ProvisioningState

ScaleSetPriority

systemData

VmSize