Node Pools - Create Or Update

Servizio:: Discovery

Versione API:: 2026-02-01-preview

Crea un NodePool

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
nodePoolName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	Il nome del NodePool
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
supercomputerName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	Il nome del Supercomputer
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
properties		NodePoolProperties	Proprietà specifiche della risorsa.
tags		object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	NodePool	Operazione di aggiornamento 'NodePool' della risorsa riuscita
201 Created	NodePool	Risorsa 'NodePool' crea operazione con successo Intestazioni Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

NodePool

Operazione di aggiornamento 'NodePool' della risorsa riuscita

201 Created

NodePool

Risorsa 'NodePool' crea operazione con successo

Intestazioni

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

NodePools_CreateOrUpdate_MaximumSet

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
  }
}

Codice di stato:: 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"
  }
}

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
NodePool	Risorsa tracciata da NodePool
NodePoolProperties	Proprietà di NodePool
ProvisioningState	Stato del provisioning delle risorse.
ScaleSetPriority	Supporta le priorità del set di scalabilità delle macchine virtuali.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
VmSize	Dimensioni VM Azure supportate.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

NodePool

Oggetto

Risorsa tracciata da NodePool

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties	NodePoolProperties	Proprietà specifiche della risorsa.
systemData	systemData	Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts"

NodePoolProperties

Oggetto

Proprietà di NodePool

Nome	Tipo	Valore predefinito	Descrizione
maxNodeCount	integer (int32) minimum: 1		Il numero massimo di nodi.
minNodeCount	integer (int32) minimum: 0	0	Il numero minimo di nodi.
provisioningState	ProvisioningState		Stato dell'ultima operazione.
scaleSetPriority	ScaleSetPriority	Regular	Priorità del set di scalabilità di macchine virtuali. Se non specificato, il valore predefinito è 'Regular'.
subnetId	string (arm-id)		La subrete del pool di nodi.
vmSize	VmSize		La dimensione della VM Azure sottostante.

ProvisioningState

Enumerazione

Stato del provisioning delle risorse.

Valore	Descrizione
Succeeded	La risorsa è stata creata.
Failed	Creazione della risorsa non riuscita.
Canceled	La creazione delle risorse è stata annullata.
Accepted	La richiesta di creazione della risorsa è stata accettata
Provisioning	È in corso il provisioning della risorsa
Updating	La risorsa è in fase di aggiornamento
Deleting	La risorsa è in fase di eliminazione

ScaleSetPriority

Enumerazione

Supporta le priorità del set di scalabilità delle macchine virtuali.

Valore	Descrizione
Regular	Set di scala di macchine virtuali a priorità regolare.
Spot	Set di scala della macchina virtuale a priorità spot.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Il timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

VmSize

Enumerazione

Dimensioni VM Azure supportate.

Valore	Descrizione
Standard_NC24ads_A100_v4	Standard_NC24ads_A100_v4 dimensione Azure VM ottimizzata per GPU
Standard_NC48ads_A100_v4	Standard_NC48ads_A100_v4 Dimensione Azure VM ottimizzata per GPU
Standard_NC96ads_A100_v4	Standard_NC96ads_A100_v4 Dimensione della VM ottimizzata per GPU Azure
Standard_NC4as_T4_v3	Standard_NC4as_T4_v3 dimensione Azure VM ottimizzata per GPU
Standard_NC8as_T4_v3	Standard_NC8as_T4_v3 dimensione Azure VM ottimizzata per GPU
Standard_NC16as_T4_v3	Standard_NC16as_T4_v3 Dimensione Azure VM ottimizzata per GPU
Standard_NC64as_T4_v3	Standard_NC64as_T4_v3 dimensione Azure VM ottimizzata per GPU
Standard_NV6ads_A10_v5	Standard_NV6ads_A10_v5 dimensione Azure VM ottimizzata per GPU
Standard_NV12ads_A10_v5	Standard_NV12ads_A10_v5 Dimensione Azure VM ottimizzata per GPU
Standard_NV24ads_A10_v5	Standard_NV24ads_A10_v5 Dimensione Azure VM ottimizzata per GPU
Standard_NV36ads_A10_v5	Standard_NV36ads_A10_v5 dimensione Azure VM ottimizzata per GPU
Standard_NV36adms_A10_v5	Standard_NV36ads_A10_v5 dimensione Azure VM ottimizzata per GPU
Standard_NV72ads_A10_v5	Standard_NV36ads_A10_v5 dimensione Azure VM ottimizzata per GPU
Standard_ND40rs_v2	Standard_ND40rs_v2 dimensione Azure VM ottimizzata per GPU

Condividi tramite

Node Pools - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

NodePools_CreateOrUpdate_MaximumSet

Esempio di richiesta

Risposta di esempio

Definizioni

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

NodePool

NodePoolProperties

ProvisioningState

ScaleSetPriority

systemData

VmSize