Standby Virtual Machine Pools - Create Or Update
Creación de un objeto StandbyVirtualMachinePoolResource
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/{standbyVirtualMachinePoolName}?api-version=2023-12-01-preview
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
standby
|
path | True |
string |
Nombre del grupo de máquinas virtuales en espera Patrón de Regex: |
subscription
|
path | True |
string uuid |
Identificador de la suscripción de destino. El valor debe ser un UUID. |
api-version
|
query | True |
string |
Versión de API que se usará para la operación. |
Cuerpo de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
location | True |
string |
Ubicación geográfica donde reside el recurso |
properties.virtualMachineState | True |
Especifica el estado deseado de las máquinas virtuales del grupo. |
|
properties.attachedVirtualMachineScaleSetId |
string |
Especifica el identificador de recurso completo de un conjunto de escalado de máquinas virtuales al que está asociado el grupo. |
|
properties.elasticityProfile |
Especifica el perfil de elasticidad de los grupos de máquinas virtuales en espera. |
||
tags |
object |
Etiquetas del recurso. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Operación de actualización "StandbyVirtualMachinePoolResource" del recurso correcta |
|
201 Created |
La operación de creación "StandbyVirtualMachinePoolResource" del recurso se realizó correctamente Encabezados Retry-After: integer |
|
Other Status Codes |
Una respuesta de error inesperada. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
StandbyVirtualMachinePools_CreateOrUpdate
Solicitud de ejemplo
PUT https://management.azure.com/subscriptions/8CC31D61-82D7-4B2B-B9DC-6B924DE7D229/resourceGroups/rgstandbypool/providers/Microsoft.StandbyPool/standbyVirtualMachinePools/pool?api-version=2023-12-01-preview
{
"properties": {
"elasticityProfile": {
"maxReadyCapacity": 304
},
"virtualMachineState": "Running",
"attachedVirtualMachineScaleSetId": "/subscriptions/8CC31D61-82D7-4B2B-B9DC-6B924DE7D229/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachineScaleSets/myVmss"
},
"tags": {},
"location": "West US"
}
Respuesta de muestra
{
"properties": {
"elasticityProfile": {
"maxReadyCapacity": 304
},
"virtualMachineState": "Running",
"attachedVirtualMachineScaleSetId": "/subscriptions/8CC31D61-82D7-4B2B-B9DC-6B924DE7D229/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachineScaleSets/myVmss",
"provisioningState": "Succeeded"
},
"tags": {},
"location": "West US",
"id": "/subscriptions/8CC31D61-82D7-4B2B-B9DC-6B924DE7D229/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"
}
}
Azure-AsyncOperation: https://contoso.com/operationstatus
{
"properties": {
"elasticityProfile": {
"maxReadyCapacity": 304
},
"virtualMachineState": "Running",
"attachedVirtualMachineScaleSetId": "/subscriptions/8CC31D61-82D7-4B2B-B9DC-6B924DE7D229/resourceGroups/rgstandbypool/providers/Microsoft.Compute/virtualMachineScaleSets/myVmss",
"provisioningState": "Succeeded"
},
"tags": {},
"location": "West US",
"id": "/subscriptions/8CC31D61-82D7-4B2B-B9DC-6B924DE7D229/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"
}
}
Definiciones
Nombre | Description |
---|---|
created |
Tipo de identidad que creó el recurso. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Provisioning |
Estado de aprovisionamiento |
Standby |
Detalles del perfil de elasticidad. |
Standby |
A StandbyVirtualMachinePoolResource. |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
Virtual |
Estado de las máquinas virtuales en espera |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
ProvisioningState
Estado de aprovisionamiento
Nombre | Tipo | Description |
---|---|---|
Canceled |
string |
Se canceló la creación de recursos. |
Deleting |
string |
Se está eliminando el recurso. |
Failed |
string |
Error en la creación de recursos. |
Succeeded |
string |
Se ha creado el recurso. |
StandbyVirtualMachinePoolElasticityProfile
Detalles del perfil de elasticidad.
Nombre | Tipo | Description |
---|---|---|
maxReadyCapacity |
integer |
Especifica el número máximo de máquinas virtuales en el grupo de máquinas virtuales en espera. |
StandbyVirtualMachinePoolResource
A StandbyVirtualMachinePoolResource.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
location |
string |
Ubicación geográfica donde reside el recurso |
name |
string |
Nombre del recurso. |
properties.attachedVirtualMachineScaleSetId |
string |
Especifica el identificador de recurso completo de un conjunto de escalado de máquinas virtuales al que está asociado el grupo. |
properties.elasticityProfile |
Especifica el perfil de elasticidad de los grupos de máquinas virtuales en espera. |
|
properties.provisioningState |
Estado de la última operación. |
|
properties.virtualMachineState |
Especifica el estado deseado de las máquinas virtuales del grupo. |
|
systemData |
Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy. |
|
tags |
object |
Etiquetas del recurso. |
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
VirtualMachineState
Estado de las máquinas virtuales en espera
Nombre | Tipo | Description |
---|---|---|
Deallocated |
string |
La máquina virtual ha liberado la concesión en el hardware subyacente y está apagada. |
Running |
string |
La máquina virtual está en funcionamiento. |