Delen via

Standby Virtual Machine Pools - Create Or Update

Service:
Standby Pools
API-versie:
2025-10-01

Een StandbyVirtualMachinePoolResource maken

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.
standbyVirtualMachinePoolName
 path True

string

pattern: ^[a-zA-Z0-9-]{3,24}$

Naam van de stand-by-vm-pool
subscriptionId
 path True

string (uuid)

De id van het doelabonnement. De waarde moet een UUID zijn.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Vereist Type Description
location True

string

De geografische locatie waar de resource zich bevindt
properties.virtualMachineState True

VirtualMachineState

Hiermee geeft u de gewenste status van virtuele machines in de pool.
properties.attachedVirtualMachineScaleSetId

string (arm-id)

Hiermee geeft u de volledig gekwalificeerde resource-id op van een virtuele-machineschaalset waaraan de pool is gekoppeld.
properties.elasticityProfile

StandbyVirtualMachinePoolElasticityProfile

Hiermee geeft u het elasticiteitsprofiel van de stand-by-vm-pools.
tags

object

Resourcetags.

Antwoorden

Name Type Description
200 OK

StandbyVirtualMachinePoolResource

Resource 'StandbyVirtualMachinePoolResource' updatebewerking geslaagd
201 Created

StandbyVirtualMachinePoolResource

Resource 'StandbyVirtualMachinePoolResource' create-bewerking geslaagd

Kopteksten

Retry-After: integer
Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation zich voordoen als uw gebruikersaccount

Voorbeelden

StandbyVirtualMachinePools_CreateOrUpdate

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
createdByType

Het type identiteit waarmee de resource is gemaakt.
DynamicSizing

Hiermee geeft u de dynamische formaatconfiguratie op.
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
ProvisioningState

Toewijzingsstatus
StandbyVirtualMachinePoolElasticityProfile

Details van het elasticiteitsprofiel.
StandbyVirtualMachinePoolResource

Een StandbyVirtualMachinePoolResource.
systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
VirtualMachineState

Status van virtuele machines in stand-by

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

DynamicSizing

Object

Hiermee geeft u de dynamische formaatconfiguratie op.

Name Type Description
enabled

boolean

Geeft aan of dynamische grootte is ingeschakeld voor de stand-bypool.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

ErrorResponse

Object

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ProvisioningState

Opsomming

Toewijzingsstatus

Waarde Description
Succeeded

Er is een bron gemaakt.
Failed

Het maken van bronnen is mislukt.
Canceled

Het maken van grondstoffen is geannuleerd.
Deleting

Resource wordt verwijderd.

StandbyVirtualMachinePoolElasticityProfile

Object

Details van het elasticiteitsprofiel.

Name Type Description
dynamicSizing

DynamicSizing

Hiermee geeft u de dynamische formaatconfiguratie op.
maxReadyCapacity

integer (int64)

minimum: 0

Hiermee geeft u het maximum aantal virtuele machines in de stand-by-vm-pool.
minReadyCapacity

integer (int64)

minimum: 0

Hiermee geeft u het gewenste minimum aantal virtuele machines in de stand-by-vm-pool. MinReadyCapacity kan maxReadyCapacity niet overschrijden.
postProvisioningDelay

string

Hiermee geeft u de duur op die moet wachten na de inrichting van de virtuele machine voordat de virtuele machine beschikbaar wordt voor gebruik. De duur moet worden gespecificeerd in ISO 8601-formaat (bijv. PT2S gedurende 2 seconden).

StandbyVirtualMachinePoolResource

Object

Een StandbyVirtualMachinePoolResource.

Name Type Description
id

string (arm-id)

Volledig gekwalificeerde resource-ID voor de resource. Bijv. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location

string

De geografische locatie waar de resource zich bevindt
name

string

De naam van de resource
properties.attachedVirtualMachineScaleSetId

string (arm-id)

Hiermee geeft u de volledig gekwalificeerde resource-id op van een virtuele-machineschaalset waaraan de pool is gekoppeld.
properties.elasticityProfile

StandbyVirtualMachinePoolElasticityProfile

Hiermee geeft u het elasticiteitsprofiel van de stand-by-vm-pools.
properties.provisioningState

ProvisioningState

De status van de laatste bewerking.
properties.virtualMachineState

VirtualMachineState

Hiermee geeft u de gewenste status van virtuele machines in de pool.
systemData

systemData

Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags

object

Resourcetags.
type

string

Het type bron. Bijv. "Microsoft.Compute/virtualMachines" of "Microsoft.Storage/storageAccounts"

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).
createdBy

string

De identiteit waarmee de resource is gemaakt.
createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt

string (date-time)

De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

VirtualMachineState

Opsomming

Status van virtuele machines in stand-by

Waarde Description
Running

De virtuele machine is actief.
Deallocated

De virtuele machine heeft de lease van de onderliggende hardware vrijgegeven en is uitgeschakeld.
Hibernated

De virtuele machine heeft de lease van de onderliggende hardware vrijgegeven en is uitgeschakeld. De geheugeninhoud van de VM wordt opgeslagen op de schijf van het besturingssysteem. Wanneer u opnieuw wordt gestart, worden toepassingen en processen die eerder in uw VM werden uitgevoerd, hervat vanuit de status vóór de sluimerstand.