Standby Virtual Machine Pools - Create Or Update

Serviço:: Standby Pools

Versão da API:: 2025-10-01

Criar um StandbyVirtualMachinePoolResource

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/{standbyVirtualMachinePoolName}?api-version=2025-10-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
standbyVirtualMachinePoolName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	Nome do pool de máquinas virtuais em espera
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	A geolocalização onde o recurso vive
properties.virtualMachineState	True	VirtualMachineState	Especifica o estado desejado das máquinas virtuais no pool.
properties.attachedVirtualMachineScaleSetId		string (arm-id)	Especifica a ID de recurso totalmente qualificada de um conjunto de escala de máquina virtual ao qual o pool está anexado.
properties.elasticityProfile		StandbyVirtualMachinePoolElasticityProfile	Especifica o perfil de elasticidade dos pools de máquinas virtuais em espera.
tags		object	Tags de recursos.

Respostas

Name	Tipo	Description
200 OK	StandbyVirtualMachinePoolResource	Operação de atualização do recurso 'StandbyVirtualMachinePoolResource' bem-sucedida
201 Created	StandbyVirtualMachinePoolResource	Operação de criação de recurso 'StandbyVirtualMachinePoolResource' bem-sucedida Cabeçalhos Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Name

Tipo

Description

200 OK

StandbyVirtualMachinePoolResource

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

201 Created

StandbyVirtualMachinePoolResource

Operação de criação de recurso 'StandbyVirtualMachinePoolResource' bem-sucedida

Cabeçalhos

Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

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

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

StandbyVirtualMachinePools_CreateOrUpdate

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool?api-version=2025-10-01

{
  "properties": {
    "elasticityProfile": {
      "maxReadyCapacity": 304,
      "minReadyCapacity": 300,
      "postProvisioningDelay": "PT2S",
      "dynamicSizing": {
        "enabled": true
      }
    },
    "virtualMachineState": "Running",
    "attachedVirtualMachineScaleSetId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachineScaleSets/myVmss"
  },
  "tags": {},
  "location": "West US"
}

Resposta da amostra

Código de estado:: 200

{
  "properties": {
    "elasticityProfile": {
      "maxReadyCapacity": 304,
      "minReadyCapacity": 300,
      "postProvisioningDelay": "PT2S",
      "dynamicSizing": {
        "enabled": true
      }
    },
    "virtualMachineState": "Running",
    "attachedVirtualMachineScaleSetId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachineScaleSets/myVmss",
    "provisioningState": "Succeeded"
  },
  "tags": {},
  "location": "West US",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool",
  "name": "pool",
  "type": "Microsoft.StandbyPool/standbyVirtualMachinePools",
  "systemData": {
    "createdBy": "pooluser@microsoft.com",
    "createdByType": "User",
    "createdAt": "2023-09-07T16:33:22.210Z",
    "lastModifiedBy": "pooluser@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2023-09-07T16:33:22.210Z"
  }
}

Código de estado:: 201

Azure-AsyncOperation: https://contoso.com/operationstatus

{
  "properties": {
    "elasticityProfile": {
      "maxReadyCapacity": 304,
      "minReadyCapacity": 300,
      "postProvisioningDelay": "PT2S",
      "dynamicSizing": {
        "enabled": true
      }
    },
    "virtualMachineState": "Running",
    "attachedVirtualMachineScaleSetId": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachineScaleSets/myVmss",
    "provisioningState": "Succeeded"
  },
  "tags": {},
  "location": "West US",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000009/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool",
  "name": "pool",
  "type": "Microsoft.StandbyPool/standbyVirtualMachinePools",
  "systemData": {
    "createdBy": "pooluser@microsoft.com",
    "createdByType": "User",
    "createdAt": "2023-09-07T16:33:22.210Z",
    "lastModifiedBy": "pooluser@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2023-09-07T16:33:22.210Z"
  }
}

Definições

Name	Description
createdByType	O tipo de identidade que criou o recurso.
DynamicSizing	Especifica a configuração de dimensionamento dinâmico.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ProvisioningState	Estado de aprovisionamento
StandbyVirtualMachinePoolElasticityProfile	Detalhes do perfil de elasticidade.
StandbyVirtualMachinePoolResource	Um StandbyVirtualMachinePoolResource.
systemData	Metadados referentes à criação e última modificação do recurso.
VirtualMachineState	Estado das máquinas virtuais em espera

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DynamicSizing

Object

Especifica a configuração de dimensionamento dinâmico.

Name	Tipo	Description
enabled	boolean	Indica se o dimensionamento dinâmico está habilitado para o pool em espera.

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

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

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
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

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

ProvisioningState

Enumeração

Estado de aprovisionamento

Valor	Description
Succeeded	O recurso foi criado.
Failed	Falha na criação de recursos.
Canceled	A criação de recursos foi cancelada.
Deleting	O recurso está sendo excluído.

StandbyVirtualMachinePoolElasticityProfile

Object

Detalhes do perfil de elasticidade.

Name	Tipo	Description
dynamicSizing	DynamicSizing	Especifica a configuração de dimensionamento dinâmico.
maxReadyCapacity	integer (int64) minimum: 0	Especifica o número máximo de máquinas virtuais no pool de máquinas virtuais em espera.
minReadyCapacity	integer (int64) minimum: 0	Especifica o número mínimo desejado de máquinas virtuais no pool de máquinas virtuais em espera. MinReadyCapacity não pode exceder MaxReadyCapacity.
postProvisioningDelay	string	Especifica a duração a aguardar após o provisionamento da máquina virtual antes que a máquina virtual fique disponível para uso. A duração deve ser especificada no formato ISO 8601 (por exemplo, PT2S durante 2 segundos).

StandbyVirtualMachinePoolResource

Object

Um StandbyVirtualMachinePoolResource.

Name	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	A geolocalização onde o recurso vive
name	string	O nome do recurso
properties.attachedVirtualMachineScaleSetId	string (arm-id)	Especifica a ID de recurso totalmente qualificada de um conjunto de escala de máquina virtual ao qual o pool está anexado.
properties.elasticityProfile	StandbyVirtualMachinePoolElasticityProfile	Especifica o perfil de elasticidade dos pools de máquinas virtuais em espera.
properties.provisioningState	ProvisioningState	O status da última operação.
properties.virtualMachineState	VirtualMachineState	Especifica o estado desejado das máquinas virtuais no pool.
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.Storage/storageAccounts"

systemData

Object

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

Name	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.

VirtualMachineState

Enumeração

Estado das máquinas virtuais em espera

Valor	Description
Running	A máquina virtual está em funcionamento.
Deallocated	A máquina virtual liberou a concessão no hardware subjacente e está desligada.
Hibernated	A máquina virtual liberou a concessão no hardware subjacente e está desligada. O conteúdo da memória da VM é armazenado no disco do sistema operacional. Quando iniciados novamente, os aplicativos e processos que estavam sendo executados anteriormente em sua VM são retomados do estado anterior à hibernação.

Partilhar via

Standby Virtual Machine Pools - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

StandbyVirtualMachinePools_CreateOrUpdate

Pedido de amostra

Resposta da amostra

Definições

createdByType

DynamicSizing

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningState

StandbyVirtualMachinePoolElasticityProfile

StandbyVirtualMachinePoolResource

systemData

VirtualMachineState