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.
| 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.
- Dans la console d' IBM Cloud, cliquez sur l'icône
menu de navigation >
> Réservations.
- Sélectionnez une réservation dans la page Détails de la réservation.
- Dans la liste des serveurs virtuels, cliquez sur Actions > Associer.
- 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.
- Dans la console d' IBM Cloud, cliquez sur l'icône
menu de navigation >
> Réservations.
- 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.
- 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.
- Dans la console d' IBM Cloud, cliquez sur l'icône
menu de navigation >
> Réservations.
- Dans la liste Réservations, cliquez sur Actions > Supprimer la réservation.
- 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.
nameresource_group.idzone.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"