Compartir a través de


Capacity Reservations - Create Or Update

Operación para crear o actualizar una reserva de capacidad. Solo se pueden establecer algunas propiedades durante la creación de la reserva de capacidad. Consulte para https://aka.ms/CapacityReservation obtener más detalles.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}/capacityReservations/{capacityReservationName}?api-version=2024-03-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
capacityReservationGroupName
path True

string

Nombre del grupo de reserva de capacidad.

capacityReservationName
path True

string

Nombre de la reserva de capacidad.

resourceGroupName
path True

string

Nombre del grupo de recursos.

subscriptionId
path True

string

Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.

api-version
query True

string

Versión de api de cliente.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación de los recursos

sku True

Sku

SKU del recurso para el que se debe reservar la capacidad. Es necesario establecer el nombre y la capacidad de la SKU. Actualmente, se admiten las Sku de máquina virtual con la funcionalidad "CapacityReservationSupported" establecida en true. Consulte Lista de SKU de Microsoft.Compute en una región (https://docs.microsoft.com/rest/api/compute/resourceskus/list) para conocer los valores admitidos.

tags

object

Etiquetas del recurso

zones

string[]

Zona de disponibilidad que se usará para esta reserva de capacidad. La zona debe ser un valor único y también debe formar parte de la lista de zonas especificadas durante la creación del grupo de reserva de capacidad. La zona solo se puede asignar durante la creación. Si no se proporciona, la reserva solo admite implementaciones no zonales. Si se proporciona, exige que vm/VMSS use esta reserva de capacidad para que esté en la misma zona.

Respuestas

Nombre Tipo Description
200 OK

CapacityReservation

Aceptar

201 Created

CapacityReservation

Creado

Other Status Codes

CloudError

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo 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

Create or update a capacity reservation .

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation?api-version=2024-03-01

{
  "location": "westus",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ]
}

Respuesta de muestra

{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}
{
  "name": "myCapacityReservation",
  "location": "westus",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/myCapacityReservationGroup/capacityReservations/myCapacityReservation",
  "tags": {
    "department": "HR"
  },
  "sku": {
    "name": "Standard_DS1_v2",
    "capacity": 4
  },
  "zones": [
    "1"
  ],
  "properties": {
    "platformFaultDomainCount": 3,
    "reservationId": "{GUID}",
    "provisioningState": "Creating",
    "provisioningTime": "2021-06-27T01:02:38.3138469+00:00"
  }
}

Definiciones

Nombre Description
ApiError

Error de API.

ApiErrorBase

Base de errores de API.

CapacityReservation

Especifica información sobre la reserva de capacidad.

CapacityReservationInstanceView

Vista de instancia de una reserva de capacidad que proporciona como instantánea de las propiedades en tiempo de ejecución de la reserva de capacidad administrada por la plataforma y puede cambiar fuera de las operaciones del plano de control.

CapacityReservationUtilization

Representa el uso de la reserva de capacidad en términos de recursos asignados.

CloudError

Respuesta de error del servicio Compute.

InnerError

Detalles del error interno.

InstanceViewStatus

Estado de la vista de instancia.

Sku

Describe una SKU de conjunto de escalado de máquinas virtuales. NOTA: Si la nueva SKU de máquina virtual no se admite en el hardware en el que se encuentra actualmente el conjunto de escalado, debe desasignar las máquinas virtuales del conjunto de escalado antes de modificar el nombre de la SKU.

StatusLevelTypes

Código de nivel.

SubResourceReadOnly

ApiError

Error de API.

Nombre Tipo Description
code

string

Código de error.

details

ApiErrorBase[]

Detalles del error de api

innererror

InnerError

Error interno de api

message

string

El mensaje de error.

target

string

Destino del error concreto.

ApiErrorBase

Base de errores de API.

Nombre Tipo Description
code

string

Código de error.

message

string

El mensaje de error.

target

string

Destino del error concreto.

CapacityReservation

Especifica información sobre la reserva de capacidad.

Nombre Tipo Description
id

string

Id. de recurso

location

string

Ubicación de los recursos

name

string

Nombre del recurso

properties.instanceView

CapacityReservationInstanceView

Vista de instancia de reserva de capacidad.

properties.platformFaultDomainCount

integer

Especifica el valor del recuento de dominios de error que admite la reserva de capacidad para el tamaño de máquina virtual solicitado. Nota: El recuento de dominios de error especificado para un recurso (como el conjunto de escalado de máquinas virtuales) debe ser menor o igual que este valor si se implementa mediante la reserva de capacidad. Versión mínima de api: 2022-08-01.

properties.provisioningState

string

El estado de aprovisionamiento, que solo aparece en la respuesta.

properties.provisioningTime

string

Fecha y hora en que se actualizó por última vez la reserva de capacidad.

properties.reservationId

string

Identificador único generado y asignado a la reserva de capacidad por la plataforma que no cambia durante toda la vigencia del recurso.

properties.timeCreated

string

Especifica la hora a la que se creó el recurso de reserva de capacidad. Versión mínima de api: 2021-11-01.

properties.virtualMachinesAssociated

SubResourceReadOnly[]

Lista de todos los identificadores de recursos de máquina virtual asociados a la reserva de capacidad.

sku

Sku

SKU del recurso para el que se debe reservar la capacidad. Es necesario establecer el nombre y la capacidad de la SKU. Actualmente, se admiten las Sku de máquina virtual con la funcionalidad "CapacityReservationSupported" establecida en true. Consulte Lista de SKU de Microsoft.Compute en una región (https://docs.microsoft.com/rest/api/compute/resourceskus/list) para conocer los valores admitidos.

tags

object

Etiquetas del recurso

type

string

Tipo de recurso

zones

string[]

Zona de disponibilidad que se usará para esta reserva de capacidad. La zona debe ser un valor único y también debe formar parte de la lista de zonas especificadas durante la creación del grupo de reserva de capacidad. La zona solo se puede asignar durante la creación. Si no se proporciona, la reserva solo admite implementaciones no zonales. Si se proporciona, exige que vm/VMSS use esta reserva de capacidad para que esté en la misma zona.

CapacityReservationInstanceView

Vista de instancia de una reserva de capacidad que proporciona como instantánea de las propiedades en tiempo de ejecución de la reserva de capacidad administrada por la plataforma y puede cambiar fuera de las operaciones del plano de control.

Nombre Tipo Description
statuses

InstanceViewStatus[]

Información de estado del recurso.

utilizationInfo

CapacityReservationUtilization

Capacidad no utilizada de la reserva de capacidad.

CapacityReservationUtilization

Representa el uso de la reserva de capacidad en términos de recursos asignados.

Nombre Tipo Description
currentCapacity

integer

El valor proporciona la capacidad actual del tamaño de máquina virtual que se reservó correctamente y para el que se factura al cliente. Versión mínima de api: 2022-08-01.

virtualMachinesAllocated

SubResourceReadOnly[]

Lista de todos los identificadores de recursos de máquinas virtuales asignados a la reserva de capacidad.

CloudError

Respuesta de error del servicio Compute.

Nombre Tipo Description
error

ApiError

Error de API.

InnerError

Detalles del error interno.

Nombre Tipo Description
errordetail

string

Mensaje de error interno o volcado de memoria de excepciones.

exceptiontype

string

Tipo de la excepción.

InstanceViewStatus

Estado de la vista de instancia.

Nombre Tipo Description
code

string

Código de estado.

displayStatus

string

Etiqueta localizable corta para el estado.

level

StatusLevelTypes

Código de nivel.

message

string

Mensaje de estado detallado, incluido para alertas y mensajes de error.

time

string

Hora del estado.

Sku

Describe una SKU de conjunto de escalado de máquinas virtuales. NOTA: Si la nueva SKU de máquina virtual no se admite en el hardware en el que se encuentra actualmente el conjunto de escalado, debe desasignar las máquinas virtuales del conjunto de escalado antes de modificar el nombre de la SKU.

Nombre Tipo Description
capacity

integer

Especifica el número de máquinas virtuales del conjunto de escalado.

name

string

Nombre de la SKU.

tier

string

Especifica el nivel de máquinas virtuales de un conjunto de escalado.

Valores posibles:

Estándar

Basic

StatusLevelTypes

Código de nivel.

Nombre Tipo Description
Error

string

Info

string

Warning

string

SubResourceReadOnly

Nombre Tipo Description
id

string

Id. de recurso