Gestion d'une réservation pour VPC

Une fois que vous avez mis à disposition votre réservation, vous pouvez la gérer avec les actions suivantes.

Actions de gestion des réservations de serveurs virtuels
Action Description
Répertorier toutes les réservations Répertorier toutes les réservations dans la région.
Créer une réservation Effectuez une réservation dans la région.
Supprimer une réservation Supprimer une réservation inactive. Vous ne pouvez pas supprimer une réservation active. Cette action ne peut pas être annulée.
Extraire une réservation Récupérer une réservation telle que spécifiée par son identifiant dans le site URL.
Mettre à jour une réservation Mettez à jour la réservation avec de nouvelles informations.
Activation d'une réservation Activez une réservation inactive.

Avant de commencer

Vous devez mettre à disposition votre réservation avant de connecter des serveurs virtuels. Pour plus d'informations, voir Mise à disposition de réservations pour des serveurs virtuels.

Si vous ne disposez pas d'un compte administrateur, votre compte utilisateur doit inclure le droit Gérer les capacités réservées. Pour plus d'informations sur la mise à jour des droits, voir Gestion de l'accès IAM pour les services d'infrastructure VPC.

Gestion d'une réservation à l'aide de l'interface utilisateur

Vous pouvez utiliser l'interface utilisateur pour gérer votre réservation et les serveurs associés.

Attacher une instance de serveur virtuel à votre réservation avec l'interface utilisateur

Vous pouvez associer un serveur virtuel à une réservation.

  1. Dans la console d' IBM Cloud, cliquez sur l'icône dumenu de navigation > l'icône VPC de l'infrastructure > Réservations.
  2. Sélectionnez une réservation dans la page Détails de la réservation.
  3. Dans la liste des serveurs virtuels, cliquez sur Actions > Associer.
  4. Sélectionnez le serveur que vous voulez attacher à la réservation et cliquez sur Attacher.

Déconnexion d'un serveur de la réservation à l'aide de l'interface utilisateur

Vous pouvez déconnecter un serveur virtuel de votre réservation.

  1. Dans la console d' IBM Cloud, cliquez sur l'icône dumenu de navigation > l'icône VPC de l'infrastructure > Réservations.
  2. Dans votre liste de serveurs virtuels ou dans la page Détails de la réservation, cliquez sur le serveur que vous souhaitez déconnecter, puis cliquez sur Actions > Déconnecter.
  3. Pour confirmer, cliquez sur Dissocier.

Si l'instance est arrêtée et démarrée, même si elle pointe vers une réservation expirée, elle est autorisée à démarrer et est facturée au prix de l'abonnement.

Considérations particulières pour la suppression d'une réservation

Vous pouvez supprimer une réservation de type " inactive et modifier les champs suivants.

  • politique_affinité
  • capacity.total
  • committed_use.expiration_policy
  • committed_use.term
  • nom
  • profil

Si vous souhaitez modifier d'autres champs, vous devez supprimer la réservation et la recréer.

Toutefois, une fois qu'une réservation est activée et qu'elle a reçu le " active, de nombreux aspects de la réservation sont permanents pendant toute la durée de vie de la réservation. Veillez à vérifier la réservation avant de l'activer afin de vous assurer que la configuration est correcte. Les seuls champs qui peuvent être modifiés pour une réservation " active sont " name et " committed_use.expiration_policy.

Suppression d'une réservation via l'interface utilisateur

Vous pouvez supprimer une réservation.

  1. Dans la console d' IBM Cloud, cliquez sur l'icône dumenu de navigation > l'icône VPC de l'infrastructure > Réservations.
  2. Dans la liste Réservations, cliquez sur Actions > Supprimer la réservation.
  3. Pour confirmer, cliquez sur Supprimer.

Gestion d'une réservation avec l'interface de ligne de commande

Vous pouvez gérer une réservation à l'aide de l'interface de ligne de commande.

Activation d'une réservation

Vous pouvez activer une réservation à l'aide de l'interface de ligne de commande (CLI). Pour activer une réservation spécifique à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is reservation-activate. Vous devez spécifier le nom ou l'ID de la réservation spécifique en utilisant le RESERVATION_NAME pour la réservation spécifique que vous souhaitez obtenir.

ibmcloud is reservation-activate RESERVATION

Consultez l'exemple suivant.

ibmcloud is reservation-activate b4735ce6-f83d-45d1-b41b-4d47451c8396
Activating reservation b4735ce6-f83d-45d1-b41b-4d47451c8396 under account ACCOUNT as user user@ibm.com...
Successfully activated reservation.

Les valeurs suivantes des arguments et des options sont utilisées

  • RÉSERVATION : identifiant ou nom de la réservation.
  • --output: Précisez le format de sortie; seul le format JSON est pris en charge. Valeur admise : JSON.
  • -q, --quiet: Supprimer les messages de sortie trop détaillés

Obtenir une instance avec réservation

Vous pouvez obtenir une instance avec réservation dans votre région à l'aide de l'interface de ligne de commande (CLI). Pour obtenir une réservation d'instance spécifique à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is instance. Vous devez spécifier le nom ou l'ID de l'instance spécifique en utilisant le site INSTANCE_NAME pour l'instance spécifique que vous souhaitez obtenir.

ibmcloud is instance INSTANCE_NAME

Consultez l'exemple suivant.

ibmcloud is instance instance-cli-test-patch-reservation-1
Getting instance instance-cli-test-patch-reservation-1 under account VPCUI-DEV as user user@ibm.com...
ID                aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name              aaa-default-reservation-2
CRN               crn:v1:bluemix:public:is:jp-tok:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status            active
Zone              us-east-1
Lifecycle state   stable
Affinity Policy   open
Resource group    -
Profile Name      mx2-2x16
Created At        2023-06-05T10:41:51.401+05:30
Expiration        At                         Policy   Term
                  2026-08-28T05:11:51.401Z   renew    three_year
Capacity          Allocated   Available   Total   Used   Status
                  8           8           8       0      -

Suppression d'une réservation

Vous pouvez supprimer IBM Cloud VPC une réservation dans votre région à l'aide de l'interface de ligne de commande. Pour supprimer une réservation à l'aide de l'interface de ligne de commande (CLI), utilisez la commande ibmcloud is reservation-delete. Vous devez spécifier le nom ou l'ID de la réservation spécifique à l'aide de la RESERVATION_NAME pour la réservation spécifique que vous souhaitez supprimer.

ibmcloud is reservation-delete RESERVATION_NAME

Consultez l'exemple suivant.

ibmcloud is reservation-delete e9e537f0-59f5-4759-b06e-86bb5cd4068e
This will delete reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e and cannot be undone. Continue [y/N] ?> y
Deleting reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e under account ACCOUNT as user user@ibm.com...
OK
Reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e is deleted.

Les valeurs suivantes des arguments et des options sont utilisées

  • RESERVATION1: Identifiant ou nom de la réservation.
  • RESERVATION2: Identifiant ou nom de la réservation.
  • --force, -f: Forcer l'opération sans confirmation
  • --output: Précisez le format de sortie; seul le format JSON est pris en charge. Valeur admise : JSON.
  • -q, --quiet: Supprimer les messages de sortie trop détaillés.

Liste de toutes les réservations

Vous pouvez répertorier toutes les réservations IBM Cloud VPC dans votre région à l'aide de l'interface de ligne de commande. Pour répertorier toutes les réservations à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is reservations.

ibmcloud is reservations

Consultez l'exemple suivant.

ibmcloud is reservations
Listing reservations in all resource groups and region us-south under account VPCUI-DEV as user user@ibm.com...
ID                                          Name                     Status    Zone         Profile    Resource group
0735_73b1e3e5-10a2-44b0-a113-c8d6cd8c42e7   reservation-cli-test-1   active    us-south-3   cx2-2x4    Default
0735_4e245881-c9c8-49f3-a21b-d890a13835bb   reservation-cli-test-3   active    us-south-3   cx2-2x4    Default

Récupération d'une réservation

Vous pouvez extraire une réservation IBM Cloud VPC spécifique dans votre région à l'aide de l'interface de ligne de commande (CLI). Pour extraire une réservation spécifique à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is reservation. Vous devez spécifier le nom ou l'ID de la réservation spécifique à l'aide du RESERVATION_NAME pour la réservation spécifique que vous souhaitez extraire.

ibmcloud is reservation RESERVATION_NAME

Consultez l'exemple suivant.

ibmcloud is reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Getting reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa under account ACCOUNT as user user@ibm.com...
ID                aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name              aaa-default-reservation-2
CRN               crn:v1:bluemix:public:is:jp-tok:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status            active
Zone              us-east-1
Lifecycle state   stable
Affinity Policy   open
Resource group    -
Profile Name      mx2-2x16
Created At        2023-06-05:10:41:51.401+05:30
Expiration        At                         Policy   Term
                  2026-08-28T05:11:51.401Z   renew    three_year
Capacity          Allocated   Available   Total   Used   Status
                  8           8           8       0      -

Mise à jour d'une réservation

Vous pouvez mettre à jour une réservation IBM Cloud VPC spécifique dans votre région en utilisant l'interface de ligne de commande (CLI). Pour mettre à jour une réservation spécifique à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is reservation-update. Vous devez spécifier le nom ou l'ID de la réservation spécifique en utilisant le RESERVATION_NAME pour la réservation spécifique que vous souhaitez mettre à jour. Utilisez la variable NEW_NAME dans l'option --name pour renommer la réservation.

ibmcloud is reservation-update RESERVATION_NAME [--name NEW_NAME]

Consultez l'exemple suivant.

ibmcloud is reservation-update aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa --name aaa-default-reservation-2-renamed
Updating reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa under account ACCOUNT as user user@ibm.com...
ID                aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name              aaa-default-reservation-2-renamed
CRN               crn:v1:bluemix:public:is:us-east:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Status            active
Zone              us-east-1
Lifecycle state   stable
Affinity Policy   open
Resource group    -
Profile Name      mx2-2x16
Created At        2023-06-14T10:58:17.92+05:30
Expiration        At                         Policy    Term
                  2026-08-28T05:28:17.920Z   release   three_year
Capacity          Allocated   Available   Total   Used   Status
                  5           -           5       -      -

Les valeurs suivantes des arguments et des options sont utilisées

  • --name: nouveau nom de la réservation.
  • --capacity: configuration de capacité pour cette réservation.
  • --term: Durée de la réservation. L'un des éléments suivants: one_year, three_year.
  • --profile: nom du profil à utiliser pour cette réservation.
  • --profile-resource-type: le type de ressource du profil. L'un des éléments suivants: instance_profile.
  • ----expiration-policy: La politique qui s'applique à l'expiration de la période d'utilisation engagée. L'un des éléments suivants: release, renew.
  • --output: Précisez le format de sortie; seul le format JSON est pris en charge. Valeur admise : JSON.
  • -q, --quiet: Supprimer les messages de sortie trop détaillés.

Liste des profils d'instance avec conditions de réservation

Vous pouvez répertorier les profils d'instance avec des termes de réservation dans votre région à l'aide de l'interface de ligne de commande (CLI). Pour répertorier les profils d'instance avec des termes de réservation à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is instance-profiles.

ibmcloud is instance-profiles

Consultez l'exemple suivant.

ibmcloud is instance-profiles
Listing instance profiles in region us-south under account VPCUI-DEV as user user@ibm.com...
Name               vCPU Manufacturer   Architecture   Family             vCPUs   Memory(GiB)   Bandwidth(Mbps)   Volume bandwidth(Mbps)   GPUs   Storage(GB)   Min NIC Count   Max NIC Count   Status     Reservation Terms
bx2-2x8            intel               amd64          balanced           2       8             4000              1000                     -      -             1               5               current    -
bx2-2x8-sriov      intel               amd64          balanced           2       8             4000              1000                     -      -             1               5               current    -
bx2a-2x8           amd                 amd64          balanced           2       8             2000              500                      -      -             1               5               current    -
bx2d-2x8           intel               amd64          balanced           2       8             4000              1000                     -      1x75          1               5               previous   one_year,three_year
bx3-2x10           intel               amd64          balanced           2       10            4000              1000                     -      -             1               5               current    -
bx3d-2x10          intel               amd64          balanced           2       10            4000              1000                     -      1x65          1               5               current    one_year,three_year

Liste des instances avec réservation

Vous pouvez répertorier les instances avec des termes de réservation dans votre région à l'aide de l'interface de ligne de commande (CLI). Pour répertorier les instances avec des termes de réservation à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is instances. Vous devez spécifier le nom ou l'ID de l'instance spécifique en utilisant le " INSTANCE_NAME pour les instances spécifiques que vous souhaitez répertorier.

ibmcloud is instances

Consultez l'exemple suivant.

ibmcloud is instance instance-cli-test-patch-reservation-1
Getting instance instance-cli-test-patch-reservation-1 under account VPCUI-DEV as user user@ibm.com...
ID                                    0735_78c1b310-6dc3-45d4-9c01-0335dc526135
Name                                  instance-cli-test-patch-reservation-1
CRN                                   crn:v1:bluemix:public:is:us-south-3:a/a1234567::instance:0735_78c1b310-6dc3-45d4-9c01-0335dc526135
Status                                running
Availability policy on host failure   restart
Startable                             true
Profile                               cx2-2x4
Architecture                          amd64
vCPU Manufacturer                     intel
vCPUs                                 2
Memory(GiB)                           4
Bandwidth(Mbps)                       4000
Volume bandwidth(Mbps)                1000
Network bandwidth(Mbps)               3000
Lifecycle Reasons                     Code   Message
                                      -      -
Lifecycle State                       stable
Metadata service                      Enabled   Protocol   Response hop limit
                                      false     http       1
Image                                 ID                                          Name
                                      r006-f47cc24c-e020-4db5-ad96-1e5be8b5853b   ibm-centos-7-9-minimal-amd64-11
Numa Count                            1
VPC                                   ID                                          Name
                                      r006-832aa717-816d-4351-8c44-65399dbfe069   test
Zone                                  us-south-3
Resource group                        ID                                 Name
                                      11caaa983d9c4beb82690daab08717e9   Default
Created                               2023-10-18T18:39:48+05:30
Network Interfaces                    Interface   Name      ID                                          Subnet           Subnet ID                                   Floating IP   Security Groups              Allow source IP spoofing   Reserved IP
                                      Primary     primary   0735-a51439ba-9a96-4f17-867c-89cffcd76c31   sn-20231006-01   0735-3edc7506-bece-4ee6-9c5c-916c750dab57   -             dream-grove-spleen-tinwork   false                      10.240.128.18
Boot volume                           ID                                          Name                              Attachment ID                               Attachment name
                                      r006-4ca2ad61-98c8-4182-a095-82cbd5db2f1f   dynastic-thyself-hunter-compile   0735-7cd56e60-025d-4dda-ab17-003457d2df30   sterilize-handlebar-transpire-blender
Reservation Affinity Policy           manual
Reservation Affinity Pool             ID                                          Name                     CRN                                                                                                                             Resource type
                                      0735-4d504e68-b22b-41ed-9a13-6df324301a9f   reservation-cli-test-1   crn:v1:bluemix:public:is:us-south-3:a/a1234567::reservation:0735-4d504e68-b22b-41ed-9a13-6df324301a9f   reservation
Reservation                           ID                                          Name                     CRN                                                                                                                             Resource type
                                      0735-4d504e68-b22b-41ed-9a13-6df324301a9f   reservation-cli-test-1   crn:v1:bluemix:public:is:us-south-3:a/a1234567::reservation:0735-4d504e68-b22b-41ed-9a13-6df324301a9f   reservation
Health State                          ok

Obtenir des profils d'instance avec des conditions de réservation

Vous pouvez obtenir des profils d'instance avec des termes de réservation dans votre région à l'aide de l'interface de ligne de commande (CLI). Pour obtenir des profils d'instance avec des termes de réservation à l'aide de l'interface de ligne de commande, utilisez la commande ibmcloud is instance-profile.

ibmcloud is instance-profile PROFILE_NAME

Consultez l'exemple suivant.

ibmcloud is instance-profile bx2-2x8
Getting instance profile bx2-2x8 under account VPCUI-DEV as user user@ibm.com...
Name               vCPU Manufacturer   Architecture   Family             vCPUs   Memory(GiB)   Bandwidth(Mbps)   Volume bandwidth(Mbps)   GPUs   Storage(GB)   Min NIC Count   Max NIC Count   Status     Reservation Terms
bx2-2x8            intel               amd64          balanced           2       8             4000              1000                     -      -             1               5               current    -

Gestion des réservations via l'API

Pour gérer une réservation à l'aide de l'interface de programmation d'applications (API), vous avez besoin d'un rôle IAM qui comprend les actions suivantes. Pour plus d'informations, voir Gestion de l'accès IAM pour VPC Infrastructure Services.

  • is.reservation.reservation.list
  • is.reservation.reservation.read
  • is.reservation.reservation.create
  • is.reservation.reservation.delete
  • is.reservation.reservation.read
  • is.reservation.reservation.update

Liste de toutes les réservations

Vous pouvez répertorier toutes les réservations IBM Cloud VPC dans votre région à l'aide de l'interface de programme d'application (API). Pour répertorier toutes les réservations à l'aide de l'API, utilisez Répertorier toutes les images.

Spécifiez une demande GET /reservations pour répertorier toutes les réservations. Consultez l'exemple suivant.

curl -X GET "$vpc_api_endpoint/v1/reservations?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token"

Les réservations sont d'abord triées en fonction de leur valeur de propriété create_at. Les réservations les plus récentes sont répertoriées en premier. Si les réservations ont des valeurs de propriété created_at identiques, elles sont triées en fonction de leurs valeurs de propriété name. La liste des réservations contient par défaut 50 réservations, mais vous pouvez augmenter ce nombre jusqu'à 100.

Vous pouvez filtrer davantage la liste avec les valeurs de propriété suivantes.

  • name
  • resource_group.id
  • zone.name

Suppression d'une réservation

Vous pouvez supprimer une réservation IBM Cloud VPC dans votre région à l'aide de l'interface de programme d'application (API). Pour supprimer une réservation à l'aide de l'API, utilisez Supprimer une réservation.

Spécifiez une demande de " DELETE /reservation pour supprimer une réservation. Consultez l'exemple suivant.

curl -X DELETE "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" - H "Authorization: Bearer $iam_token"

Récupération d'une réservation

Vous pouvez extraire une réservation IBM Cloud VPC spécifique dans votre région à l'aide de l'interface de programme d'application (API). Pour extraire une réservation spécifique à l'aide de l'API, utilisez Extraire une réservation.

Spécifiez une demande " GET /reservation/{id} pour récupérer une réservation spécifique où " id est l'identifiant de la réservation que vous récupérez. L'identifiant se trouve sur le site URL. Consultez l'exemple suivant.

curl -X GET "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" - H "Authorization: Bearer $iam_token"

Mise à jour d'une réservation

Vous mettez à jour une réservation IBM Cloud VPC spécifique dans votre région à l'aide de l'interface de programme d'application (API). Pour mettre à jour une réservation spécifique à l'aide de l'API, utilisez Mettre à jour une réservation.

Spécifiez une demande PATCH /reservations/{id} pour mettre à jour une réservation spécifique où id est l'identificateur de la réservation que vous extrayez. L'identifiant se trouve sur le site URL. Consultez l'exemple suivant.

curl -X PATCH "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "committed_use": {
        "expiration_policy": "release"
      }
    }'

Activation d'une réservation

Vous pouvez activer une réservation IBM Cloud VPC spécifique dans votre région en utilisant l'interface de programmation d'applications (API). Pour activer une réservation spécifique à l'aide de l'API, utilisez l'option Activer une réservation.

Spécifiez une demande POST /reservations/{id}/activate pour mettre à jour une réservation spécifique où id est l'identificateur de la réservation que vous extrayez. L'identifiant se trouve sur le site URL. Consultez l'exemple suivant.

curl -X POST "$vpc_api_endpoint/v1/reservations/$id/activate?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token"