Node Pools - Create Or Update

Serviço:: Discovery

Versão da API:: 2026-02-01-preview

Criar um NodePool

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
nodePoolName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	O nome do NodePool
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
supercomputerName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	O nome do Supercomputador
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
location	True	string	A localização geográfica onde o recurso reside
properties		NodePoolProperties	As propriedades específicas do recurso para esse recurso.
tags		object	Tags de recursos.

Respostas

Nome	Tipo	Description
200 OK	NodePool	Operação de atualização do recurso 'NodePool' bem-sucedida
201 Created	NodePool	Recurso 'NodePool' criar operação bem-sucedida Cabeçalhos Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Nome

Tipo

Description

200 OK

NodePool

Operação de atualização do recurso 'NodePool' bem-sucedida

201 Created

NodePool

Recurso 'NodePool' criar operação bem-sucedida

Cabeçalhos

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

NodePools_CreateOrUpdate_MaximumSet

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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"
  }
}

Código de status:: 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"
  }
}

Definições

Nome	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
NodePool	Recurso rastreado pelo NodePool
NodePoolProperties	Propriedades do NodePool
ProvisioningState	O estado de provisionamento de recursos.
ScaleSetPriority	Prioridades de Conjunto de Escala de Máquinas Virtuais suportadas.
systemData	Metadados relativos à criação e última modificação do recurso.
VmSize	Tamanhos de VM do Azure suportados.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

NodePool

Objeto

Recurso rastreado pelo NodePool

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	A localização geográfica onde o recurso reside
name	string	O nome do recurso
properties	NodePoolProperties	As propriedades específicas do recurso para esse recurso.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft. Compute/virtualMachines" ou "Microsoft. ContasArmazenamento/Armazenamento"

NodePoolProperties

Objeto

Propriedades do NodePool

Nome	Tipo	Valor padrão	Description
maxNodeCount	integer (int32) minimum: 1		O número máximo de nós.
minNodeCount	integer (int32) minimum: 0	0	O número mínimo de nós.
provisioningState	ProvisioningState		O status da última operação.
scaleSetPriority	ScaleSetPriority	Regular	A prioridade do Conjunto de Dimensionamento de Máquinas Virtuais. Se não for especificado, o padrão será 'Regular'.
subnetId	string (arm-id)		A sub-rede do pool de nós.
vmSize	VmSize		O tamanho da VM do Azure subjacente.

ProvisioningState

Enumeração

O estado de provisionamento de recursos.

Valor	Description
Succeeded	O recurso foi criado.
Failed	Falha na criação de recursos.
Canceled	A criação de recursos foi cancelada.
Accepted	A solicitação de criação de recurso foi aceita
Provisioning	O recurso está sendo provisionado
Updating	O recurso está atualizando
Deleting	O recurso está sendo excluído

ScaleSetPriority

Enumeração

Prioridades de Conjunto de Escala de Máquinas Virtuais suportadas.

Valor	Description
Regular	Conjunto de Escala de Máquina Virtual com prioridade regular.
Spot	Prioridade Spot Conjunto de Escala de Máquinas Virtuais.

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

VmSize

Enumeração

Tamanhos de VM do Azure suportados.

Valor	Description
Standard_NC24ads_A100_v4	Standard_NC24ads_A100_v4 Tamanho Azure VM otimizado para GPU
Standard_NC48ads_A100_v4	Standard_NC48ads_A100_v4 Tamanho Azure VM otimizado para GPU
Standard_NC96ads_A100_v4	Standard_NC96ads_A100_v4 Tamanho de VM otimizado para GPU Azure
Standard_NC4as_T4_v3	Standard_NC4as_T4_v3 Tamanho de VM Azure otimizado para GPU
Standard_NC8as_T4_v3	Standard_NC8as_T4_v3 Tamanho Azure VM otimizado para GPU
Standard_NC16as_T4_v3	Standard_NC16as_T4_v3 Tamanho Azure VM otimizado para GPU
Standard_NC64as_T4_v3	Standard_NC64as_T4_v3 Tamanho de VM Azure otimizado para GPU
Standard_NV6ads_A10_v5	Standard_NV6ads_A10_v5 Tamanho de VM otimizado para GPU Azure
Standard_NV12ads_A10_v5	Standard_NV12ads_A10_v5 Tamanho de VM Azure otimizado para GPU
Standard_NV24ads_A10_v5	Standard_NV24ads_A10_v5 Tamanho de VM Azure otimizado para GPU
Standard_NV36ads_A10_v5	Standard_NV36ads_A10_v5 Tamanho Azure VM otimizado para GPU
Standard_NV36adms_A10_v5	Standard_NV36ads_A10_v5 Tamanho Azure VM otimizado para GPU
Standard_NV72ads_A10_v5	Standard_NV36ads_A10_v5 Tamanho Azure VM otimizado para GPU
Standard_ND40rs_v2	Standard_ND40rs_v2 Tamanho de VM otimizado para GPU Azure

Compartilhar via

Node Pools - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

NodePools_CreateOrUpdate_MaximumSet

Solicitação de exemplo

Resposta de exemplo

Definições

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

NodePool

NodePoolProperties

ProvisioningState

ScaleSetPriority

systemData

VmSize