Mise à disposition d'une réservation pour VPC
Vous pouvez mettre à disposition une réservation via l'interface utilisateur, l'interface de ligne de commande ou l'API.
Avant de commencer
Assurez-vous que votre compte dispose des autorisations utilisateur requises. Le rôle Administrator ou Editor doit être affecté à votre compte pour le service VPC Infrastructure Services et le type de ressource Réservations
pour VPC. Vous devez disposer de l'une de ces autorisations utilisateur pour créer une réservation. Des rôles supplémentaires sont disponibles.
Pour plus d'informations sur la gestion de l'accès IAM, voir Gestion de l'accès IAM pour VPC Infrastructure Services.
Lorsque vous créez une réservation, la ressource de réservation est créée, mais elle n'est pas approvisionnée ni utilisable. L'état de la réservation est " inactive. Pour provisionner la réservation, vous devez l'activer. Lorsqu'elle
est active, l'état de la réservation est " active.
Mise à disposition d'une réservation avec l'interface utilisateur
Dans l' IBM Cloud (portail de gestion des réservations), suivez les étapes suivantes pour activer votre réservation.
- Dans la console d' IBM Cloud, cliquez sur l'icône
menu de navigation >
> Réservations.
- Pour créer une nouvelle réservation, cliquez sur Créer.
- Sur la page Nouvelle réservation pour VPC, entrez ou sélectionnez les informations suivantes:
| Zone | Valeur |
|---|---|
| Zone géographique | Sélectionnez l'emplacement spécifique de votre charge de travail. Les lieux sont composés de régions. Chaque région est une zone géographique distincte. Gardez à l'esprit que vous ne pouvez pas sélectionner des emplacements individuels pour chaque serveur virtuel que vous mettez à disposition dans cette réservation. Votre sélection correspond à l'emplacement de toutes les instances de serveurs virtuels que vous provisionnez dans le cadre de cette réservation. |
| Nom | Saisissez un nom pour votre réservation. |
| Groupe de ressources | Sélectionnez un groupe de ressources. |
| Balises | Entrez les étiquettes applicables. |
| Etiquettes de gestion des accès | Entrez les balises de gestion des accès applicables. |
| Type de réservation | Disponible pour les serveurs virtuels et les serveurs en métal nu. |
| Nombre de serveurs | Saisissez le nombre d'instances que vous souhaitez attribuer à cette réservation (limite de 200 vCPUs). |
| Durée de l'engagement | Choisissez une durée de 1 ou 3 ans. |
| Profil de serveur | Sélectionnez un profil pour votre réservation. Gardez à l'esprit les règles suivantes lorsque vous réservez de la capacité. Vous ne pouvez pas modifier de profil une fois votre réservation effectuée. Vous ne pouvez pas combiner des tailles de profil différentes. Vos serveurs virtuels réservés doivent tous avoir la même taille (toutes les ressources doivent être identiques). |
| Stratégie de connexion de réservation | Choisissez une politique de rattachement automatique ou restreint. |
| Options avancées | Activez l'option Renouvellement automatique sur Activé si vous souhaitez continuer votre réservation une fois la durée de validité sélectionnée terminée. |
- Cliquez sur Créer une réservation.
À l'expiration d'une réservation, les serveurs qui y sont attachés passent au tarif à la demande non escompté à l'expiration ou au non-renouvellement de la durée de la réservation et toute consommation est facturée mensuellement.
Association d'un serveur virtuel existant à une réservation à l'aide de l'interface utilisateur
Vous pouvez attacher des serveurs virtuels existants à votre réservation si la réservation a une politique d'attachement restreinte. N'oubliez pas que tous les serveurs virtuels existants doivent avoir le même profil, la même taille, le même emplacement et la même politique d'attachement manuel.
Les serveurs virtuels dotés d'une politique d'attachement automatique s'attachent automatiquement à une réservation dotée d'une politique d'attachement automatique.
Suivez les étapes suivantes pour attacher un serveur virtuel existant à une réservation.
- Dans la liste des serveurs virtuels, cliquez sur Associer.
- Sélectionnez la réservation à laquelle attacher le serveur et cliquez sur Attach.
Attacher un serveur bare metal existant à une réservation avec l'interface utilisateur
Vous pouvez attacher un serveur bare metal existant à votre réservation. N'oubliez pas que tous les serveurs nus existants qui sont attachés à une réservation doivent avoir le même profil, la même taille, le même emplacement et la même politique d'attachement manuel.
Les serveurs nus dotés d'une politique d'attachement automatique s'attachent automatiquement aux réservations dotées d'une politique d'attachement automatique.
Suivez les étapes suivantes pour rattacher un serveur bare metal existant à une réservation dotée d'une politique d'attachement automatique.
- Dans la liste de vos serveurs bare metal, cliquez sur Attach.
- Sélectionnez la réservation à laquelle attacher le serveur et cliquez sur Attach.
Mise à disposition d'une réservation avec l'interface de ligne de commande
Vous pouvez mettre à disposition une réservation à l'aide de l'interface de ligne de commande (CLI). Si vous souhaitez utiliser des balises utilisateur ou des balises de gestion des accès pour gérer vos ressources, voir Utilisation des balises.
ObsolèteIBM Cloud L'interface CLI n'est pas prise en charge sur ( LinuxONEs390x architecture de processeur). Cependant, vous pouvez installer cette interface sur une autre plateforme prise en charge et l'utiliser avec des instances de serveur virtuel LinuxONE (architecture de processeur s390x).
Avant de commencer
-
Téléchargez, installez et initialisez les plug-ins CLI suivants.
- CLI IBM Cloud
- Le plug-in infrastructure-service
Pour plus d'informations, voir Configuration de votre environnement d'API et d'interface de ligne de commande.
-
Vérifiez que vous avez créé un VPC.
Collecte d'informations pour créer une réservation à l'aide de l'interface de ligne de commande (CLI)
Prêt à créer une réservation avec l'interface de ligne de commande? Avant d'exécuter la commande is.reservation-create, vous devez connaître les détails de la réservation que vous souhaitez réserver, tels que le type de réservation
et la quantité de serveur.
Récupérez les informations suivantes à l'aide des commandes associées.
| Détails de la réservation | Options de liste |
|---|---|
| Capacité | Quantité de capacité à réserver (limite de 200 vCPUs). |
| Durée de l'engagement | (durée d'un ou de trois ans) |
| Profil de serveur | Gardez à l'esprit les règles suivantes lorsque vous mettez à disposition une réservation. -Vous ne pouvez pas modifier les profils après la création de votre réservation. -Vous ne pouvez pas combiner des tailles de profil différentes. -Vos serveurs virtuels réservés doivent tous avoir la même taille (toutes les ressources doivent être identiques). |
| Zone | Sélectionnez l'emplacement spécifique de votre charge de travail. Les emplacements sont composés de régions ; chaque région est une zone géographique séparée. Gardez à l'esprit que vous ne pouvez pas sélectionner des emplacements individuels pour chaque serveur virtuel que vous provisionnez au sein de cette capacité réservée. Votre sélection correspond à l'emplacement de toutes les instances de serveurs virtuels que vous provisionnez dans le cadre de cette réservation. |
| Nom | Nom de votre réservation. |
| Stratégie de connexion de réservation | Choisissez si vous voulez une politique de pièces jointes automatique ou restreinte. |
Mise à disposition d'une réservation à l'aide de l'interface CLI
Vous pouvez créer une réservation IBM Cloud VPC dans votre région à l'aide de l'interface de ligne de commande. Pour créer une réservation à l'aide de l'interface de ligne de commande (CLI), utilisez la commande ibmcloud is reservation-create.
- Mettez à disposition une réservation à l'aide de la commande suivante avec les détails associés.
ibmcloud is reservation-create --capacity NUMBER --term TIME --profile PROFILE --profile-resource-type PROFILE_TYPE --zone ZONE --name NAME
Consultez l'exemple suivant.
ibmcloud is reservation-create --capacity 10 --term one_year --profile ba2-2x8 --profile-resource-type instance_profile --zone us-east-1 --name reservation-mock-test-1
Creating reservation with name reservation-mock-test-1 under account ACCOUNT as user user@ibm.com...
ID 22d3ec3b-d798-454a-ad88-fe608ae86ad6
Name reservation-mock-test-1
CRN crn:v1:bluemix:public:is:us-east:a/823bd195e9fd4f0db40ac2e1bffef3e0::reservation:22d3ec3b-d798-454a-ad88-fe608ae86ad6
Status active
Zone us-east-1
Lifecycle state stable
Affinity Policy open
Resource group -
Profile Name ba2-2x8
Created At 2023-07-21T10:54:46.29+05:30
Expiration At Policy Term
- - one_year
Capacity Allocated Available Total Used Status
10 - 10 - -
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.
- --zone: Nom de la zone
- ----affinity-policy: La politique d'affinité pour cette réservation.
- --expiration-policy: la politique à appliquer à l'expiration de la période d'engagement d'utilisation. L'un des éléments suivants: release, renew.
- --resource-group-id: identifiant du groupe de ressources. Cet identifiant est mutuellement exclusif avec --resource-group-name.
- --resource-group-name: nom du groupe de ressources. Ce nom est incompatible avec --resource-group-id.
- --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.
Etapes suivantes
Une fois votre réservation mise à disposition et active, vous pouvez Connecter ou Créer des serveurs virtuels à l'aide de la console IBM Cloud, de l'interface de ligne de commande ou de l'API. Pour plus d'informations sur la création d'un serveur virtuel, voir Création d'instances de serveur virtuel.
Attacher un serveur virtuel existant à une réservation avec le CLI
Vous pouvez attacher un serveur virtuel existant à une réservation avec une politique d'affinité restreinte en utilisant le CLI. Pour attacher une réservation réservée à l'aide de la CLI, utilisez la commande ibmcloud is instance-update.
- Connectez un serveur virtuel à une réservation à l'aide de la commande suivante avec les détails associés.
ibmcloud is instance-update <instance-name> --reservation-affinity-policy manual --reservation-affinity-pool <reservation-name>
Attacher un serveur bare metal existant à une réservation avec le CLI
Vous pouvez attacher un serveur bare metal existant à une réservation avec une politique d'affinité restreinte en utilisant la CLI. Pour créer une réservation à l'aide de la CLI, utilisez la commande ibmcloud is bare-metal-server-update.
- Attachez un serveur bare metal à une réservation en utilisant la commande suivante avec les détails associés.
ibmcloud is bare-metal-server-update SERVER [--name NEW_NAME] [--enable-secure-boot false | true] [--tpm-mode tpm_2 | disabled] [--bandwidth BANDWIDTH] [--reservation-affinity-policy disabled | manual] [--reservation-affinity-pool RESERVATION_AFFINITY_POOL] [--output JSON] [-q, --quiet]
Création d'une réservation à l'aide de l'API
Vous pouvez créer une réservation IBM Cloud VPC dans votre région à l'aide de l'interface de programme d'application (API). Pour créer une réservation à l'aide de l'API, utilisez Créer une réservation.
Spécifiez une demande Post /reservations pour créer une nouvelle réservation. Consultez l'exemple suivant.
curl -X POST "$vpc_api_endpoint/v1/reservations?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token" -d '{
"capacity": {
"total": 10
},
"committed_use": {
"expiration_policy": "renew",
"term": "one_year"
},
"name": "my-reservation",
"profile": {
"name": "bx2-4x16",
"resource_type": "instance_profile"
},
"zone": {
"name": "us-south-1"
}
}'
Etapes suivantes
Une fois que votre réservation est provisionnée et active, vous pouvez attacher un serveur existant à votre réservation. Vous pouvez également créer des serveurs dans votre réservation en utilisant la console IBM Cloud, l'interface de programmation (CLI) ou l'interface de programmation (API). Pour plus d'informations sur la création de serveurs, voir Création d'instances de serveurs virtuels et Création de Bare Metal Servers sur VPC.
Création d'une réservation avec Terraform
Vous pouvez créer une réservation à l'aide de Terraform.
Avant de commencer
Assurez-vous de configurer Terraform pour le VPC
Création d'une réservation à l'aide de Terraform
Créez une réservation à l'aide de l'un des exemples suivants. Pour plus d'informations, consultez la documentation Terraform relative à ibm_is_reservation.
Exécutez les commandes Terraform suivantes pour créer une réservation.
Les réservations sont spécifiques à une région et sont basées sur le noeud final. Par défaut, la région cible est us-south. Si votre VPC se trouve dans une autre région que us-south, veillez à cibler la région appropriée
dans le fournisseur provider.tf.
- Définissez la région cible.
provider "ibm" {
region = "us-south"
}
- Créez une réservation.
resource "ibm_is_reservation" "example" {
capacity {
total = 5
}
committed_use {
term = "one_year"
}
profile {
name = "ba2-2x8"
resource_type = "instance_profile"
}
zone = "us-east-3"
name = "reservation-terraform-1"
}