Partager via


Capacity Reservations - Create Or Update

Opération permettant de créer ou de mettre à jour une réservation de capacité. Notez que certaines propriétés peuvent être définies uniquement lors de la création de la réservation de capacité. Pour plus d’informations, reportez-vous à https://aka.ms/CapacityReservation .

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

Paramètres URI

Nom Dans Obligatoire Type Description
capacityReservationGroupName
path True

string

Nom du groupe de réservations de capacité.

capacityReservationName
path True

string

Nom de la réservation de capacité.

resourceGroupName
path True

string

Nom du groupe de ressources.

subscriptionId
path True

string

Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

api-version
query True

string

Version de l’API cliente.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement de la ressource

sku True

Sku

Référence SKU de la ressource pour laquelle la capacité doit être réservée. Le nom et la capacité de la référence SKU doivent être définis. Actuellement, les références SKU de machine virtuelle avec la fonctionnalité appelée « CapacityReservationSupported » définie sur true sont prises en charge. Reportez-vous à Répertorier les références SKU Microsoft.Compute dans une région (https://docs.microsoft.com/rest/api/compute/resourceskus/list) pour connaître les valeurs prises en charge.

tags

object

Balises de ressource

zones

string[]

Zone de disponibilité à utiliser pour cette réservation de capacité. La zone doit être une valeur unique et doit également faire partie de la liste des zones spécifiées lors de la création du groupe de réservations de capacité. La zone peut être affectée uniquement lors de la création. Si elle n’est pas fournie, la réservation prend uniquement en charge les déploiements non zonaux. S’il est fourni, applique la machine virtuelle/VMSS à l’aide de cette réservation de capacité à se trouver dans la même zone.

Réponses

Nom Type Description
200 OK

CapacityReservation

Ok

201 Created

CapacityReservation

Date de création

Other Status Codes

CloudError

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Create or update a capacity reservation .

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
ApiError

Erreur d’API.

ApiErrorBase

Base d’erreurs d’API.

CapacityReservation

Spécifie des informations sur la réservation de capacité.

CapacityReservationInstanceView

Le instance vue d’une réservation de capacité qui fournit en tant que instantané des propriétés d’exécution de la réservation de capacité gérée par la plateforme et qui peut changer en dehors des opérations du plan de contrôle.

CapacityReservationUtilization

Représente l’utilisation des réservations de capacité en termes de ressources allouées.

CloudError

Réponse d’erreur du service de calcul.

InnerError

Détails de l’erreur interne.

InstanceViewStatus

Vue d’instance status.

Sku

Décrit une référence SKU de groupe de machines virtuelles identiques. REMARQUE : Si la nouvelle référence SKU de machine virtuelle n’est pas prise en charge sur le matériel sur lequel se trouve actuellement le groupe identique, vous devez libérer les machines virtuelles du groupe identique avant de modifier le nom de la référence SKU.

StatusLevelTypes

Code de niveau.

SubResourceReadOnly

ApiError

Erreur d’API.

Nom Type Description
code

string

Code d'erreur.

details

ApiErrorBase[]

Détails de l’erreur api

innererror

InnerError

Erreur interne de l’API

message

string

Message d’erreur.

target

string

Cible de l’erreur particulière.

ApiErrorBase

Base d’erreurs d’API.

Nom Type Description
code

string

Code d'erreur.

message

string

Message d’erreur.

target

string

Cible de l’erreur particulière.

CapacityReservation

Spécifie des informations sur la réservation de capacité.

Nom Type Description
id

string

ID de ressource

location

string

Emplacement de la ressource

name

string

Nom de la ressource

properties.instanceView

CapacityReservationInstanceView

Vue instance réservation de capacité.

properties.platformFaultDomainCount

integer

Spécifie la valeur du nombre de domaines d’erreur pris en charge par la réservation de capacité pour la taille de machine virtuelle demandée. Note: Le nombre de domaines d’erreur spécifié pour une ressource (comme le groupe de machines virtuelles identiques) doit être inférieur ou égal à cette valeur s’il est déployé à l’aide d’une réservation de capacité. Version d’API minimale : 01/08/2022.

properties.provisioningState

string

État d’approvisionnement, qui apparaît uniquement dans la réponse.

properties.provisioningTime

string

Date de la dernière mise à jour de la réservation de capacité.

properties.reservationId

string

ID unique généré et affecté à la réservation de capacité par la plateforme qui ne change pas tout au long de la durée de vie de la ressource.

properties.timeCreated

string

Spécifie l’heure à laquelle la ressource de réservation de capacité a été créée. Version minimale de l’API : 01/11/2021.

properties.virtualMachinesAssociated

SubResourceReadOnly[]

Liste de tous les ID de ressource de machine virtuelle associés à la réservation de capacité.

sku

Sku

Référence SKU de la ressource pour laquelle la capacité doit être réservée. Le nom et la capacité de la référence SKU doivent être définis. Actuellement, les références SKU de machine virtuelle avec la fonctionnalité appelée « CapacityReservationSupported » définie sur true sont prises en charge. Reportez-vous à Répertorier les références SKU Microsoft.Compute dans une région (https://docs.microsoft.com/rest/api/compute/resourceskus/list) pour connaître les valeurs prises en charge.

tags

object

Balises de ressource

type

string

Type de ressource

zones

string[]

Zone de disponibilité à utiliser pour cette réservation de capacité. La zone doit être une valeur unique et doit également faire partie de la liste des zones spécifiées lors de la création du groupe de réservations de capacité. La zone peut être affectée uniquement lors de la création. Si elle n’est pas fournie, la réservation prend uniquement en charge les déploiements non zonaux. S’il est fourni, applique la machine virtuelle/VMSS à l’aide de cette réservation de capacité à se trouver dans la même zone.

CapacityReservationInstanceView

Le instance vue d’une réservation de capacité qui fournit en tant que instantané des propriétés d’exécution de la réservation de capacité gérée par la plateforme et qui peut changer en dehors des opérations du plan de contrôle.

Nom Type Description
statuses

InstanceViewStatus[]

La ressource status informations.

utilizationInfo

CapacityReservationUtilization

Capacité non utilisée de la réservation de capacité.

CapacityReservationUtilization

Représente l’utilisation des réservations de capacité en termes de ressources allouées.

Nom Type Description
currentCapacity

integer

La valeur fournit la capacité actuelle de la taille de machine virtuelle qui a été réservée avec succès et pour laquelle le client est facturé. Version d’API minimale : 01/08/2022.

virtualMachinesAllocated

SubResourceReadOnly[]

Liste de tous les ID de ressource de machines virtuelles alloués par rapport à la réservation de capacité.

CloudError

Réponse d’erreur du service de calcul.

Nom Type Description
error

ApiError

Erreur d’API.

InnerError

Détails de l’erreur interne.

Nom Type Description
errordetail

string

Message d’erreur interne ou vidage d’exception.

exceptiontype

string

Type d'exception.

InstanceViewStatus

Vue d’instance status.

Nom Type Description
code

string

Code d'état.

displayStatus

string

Étiquette courte localisable pour le status.

level

StatusLevelTypes

Code de niveau.

message

string

Message de status détaillé, y compris pour les alertes et les messages d’erreur.

time

string

Heure du status.

Sku

Décrit une référence SKU de groupe de machines virtuelles identiques. REMARQUE : Si la nouvelle référence SKU de machine virtuelle n’est pas prise en charge sur le matériel sur lequel se trouve actuellement le groupe identique, vous devez libérer les machines virtuelles du groupe identique avant de modifier le nom de la référence SKU.

Nom Type Description
capacity

integer

Spécifie le nombre de machines virtuelles dans le groupe identique.

name

string

Nom de la référence SKU.

tier

string

Spécifie le niveau des machines virtuelles dans un groupe identique.

Valeurs possibles :

Standard

De base

StatusLevelTypes

Code de niveau.

Nom Type Description
Error

string

Info

string

Warning

string

SubResourceReadOnly

Nom Type Description
id

string

ID de ressource