Reservierung für VPC verwalten
Nach der Bereitstellung Ihrer Reservierung können Sie die Reservierung mit den folgenden Aktionen verwalten:
| Aktion | Beschreibung |
|---|---|
| Alle Reservierungen auflisten | Listen Sie alle Reservierungen in der Region auf. |
| Reservierung erstellen | Erstellen Sie eine Reservierung in der Region. |
| Reservierung löschen | Löschen Sie eine inactive-Reservierung. Sie können eine active-Reservierung nicht löschen. Diese Aktion kann nicht rückgängig gemacht werden. |
| Reservierung abrufen | Abrufen einer Reservierung, die durch ihre Kennung in URL angegeben ist. |
| Reservierung aktualisieren | Aktualisieren Sie die Reservierung mit neuen Informationen. |
| Reservierung aktivieren | Aktivieren Sie eine inactive-Reservierung. |
Vorbereitende Schritte
Sie müssen Ihre Reservierung bereitstellen, bevor Sie virtuelle Server zuordnen können. Weitere Informationen finden Sie unter Reservierungen für virtuelle Server bereitstellen.
Wenn Sie nicht der Kontoadministrator sind, muss Ihr Benutzerkonto über die Berechtigung Reservierte Kapazitäten verwalten verfügen. Weitere Informationen zum Aktualisieren von Berechtigungen finden Sie unter IAM-Zugriff für VPC-Infrastrukturservices verwalten.
Reservierung über die Benutzerschnittstelle verwalten
Sie können die Benutzerschnittstelle verwenden, um Ihre Reservierung und die zugeordneten Server zu verwalten.
Hinzufügen einer virtuellen Serverinstanz zu Ihrer Reservierung mit der UI
Sie können einen virtuellen Server einer Reservierung zuordnen.
- Klicken Sie in der IBM Cloud-Konsole auf
Navigationsmenü-Symbol >
> Reservierungen.
- Wählen Sie auf der Seite "Reservierungsdetails" eine Reservierung aus.
- Klicken Sie in der Liste der virtuellen Server auf Aktionen > Zuordnen.
- Wählen Sie den Server aus, den Sie an die Reservierung anhängen möchten, und klicken Sie auf Anhängen.
Zuordnung eines Servers zur Reservierung über die Benutzerschnittstelle aufheben
Sie können einen virtuellen Server von Ihrer Reservierung abhängen.
- Klicken Sie in der IBM Cloud-Konsole auf
Navigationsmenü-Symbol >
> Reservierungen.
- Klicken Sie in der Liste der virtuellen Server oder auf der Seite "Reservierungsdetails" auf den Server, den Sie abhängen möchten, und klicken Sie anschließend auf Aktionen > Zuordnung aufheben.
- Klicken Sie zur Bestätigung auf Zuordnung aufheben.
Wenn die Instanz gestoppt und gestartet wird, obwohl sie auf eine abgelaufene Reservierung verweist, darf sie starten und wird zu umlagefinanzierten Preisen abgerechnet.
Besondere Hinweise zum Löschen einer Reservierung
Sie können eine ' inactive löschen und die folgenden Felder ändern.
- affinität_policy
- capacity.total
- committed_use.expiration_policy
- committed_use.term
- Name
- Profil
Wenn Sie andere Felder ändern möchten, müssen Sie die Reservierung löschen und neu anlegen.
Nachdem eine Reservierung aktiviert und mit einem " active versehen wurde, sind jedoch viele Aspekte der Reservierung für die Dauer der Reservierung dauerhaft. Stellen Sie sicher, dass Sie die Reservierung vor der Aktivierung
überprüfen, um sicherzustellen, dass die Konfiguration korrekt ist. Die einzigen Felder, die für eine " active-Buchung geändert werden können, sind " name und " committed_use.expiration_policy.
Eine Reservierung über die Benutzeroberfläche löschen
Sie können eine Reservierung löschen.
- Klicken Sie in der IBM Cloud-Konsole auf
Navigationsmenü-Symbol >
> Reservierungen.
- Klicken Sie in Ihrer Reservierungsliste auf Aktionen > Reservierung löschen.
- Klicken Sie zur Bestätigung auf Löschen.
Reservierung über die Befehlszeilenschnittstelle verwalten
Sie können eine Reservierung über die Befehlszeilenschnittstelle verwalten.
Reservierung aktivieren
Sie können eine Reservierung über die Befehlszeilenschnittstelle (CLI) aktivieren. Verwenden Sie den Befehl ibmcloud is reservation-activate, um eine bestimmte Reservierung über die Befehlszeilenschnittstelle zu aktivieren. Sie
müssen den Namen oder die ID der bestimmten Reservierung angeben, indem Sie die RESERVATION_NAME für die bestimmte Reservierung verwenden, die Sie abrufen wollen.
ibmcloud is reservation-activate RESERVATION
Beispiel:
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.
Dabei werden die folgenden Argumente und Optionswerte verwendet
- RESERVIERUNG: ID oder Name der Reservierung.
- --output: Geben Sie das Ausgabeformat an; es wird nur JSON unterstützt. Option: JSON.
- -q, --quiet: Ausführliche Ausgabe unterdrücken
Abrufen einer Instanz mit Reservierung
Sie können die Instanz mit Reservierung in Ihrer Region über die Befehlszeilenschnittstelle (CLI) abrufen. Verwenden Sie den Befehl ibmcloud is instance, um eine bestimmte Instanzreservierung über die Befehlszeilenschnittstelle
abzurufen. Sie müssen den Namen oder die ID der spezifischen Instanz angeben, indem Sie die INSTANCE_NAME für die spezifische Instanz verwenden, die Sie abrufen möchten.
ibmcloud is instance INSTANCE_NAME
Beispiel:
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 -
Löschung einer Reservierung
Sie können IBM Cloud VPC eine Reservierung in Ihrer Region über die Befehlszeilenschnittstelle löschen. Um eine Reservierung über die CLI zu löschen, verwenden Sie den Befehl ibmcloud is reservation-delete. Sie müssen den Namen
oder die ID der bestimmten Reservierung angeben, indem Sie die RESERVATION_NAME für die zu löschende Reservierung verwenden.
ibmcloud is reservation-delete RESERVATION_NAME
Beispiel:
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.
Dabei werden die folgenden Argumente und Optionswerte verwendet
- RESERVATION1: ID oder Name der Reservierung.
- RESERVATION2: ID oder Name der Reservierung.
- --force, -f: Den Vorgang ohne Bestätigung erzwingen
- --output: Geben Sie das Ausgabeformat an; es wird nur JSON unterstützt. Option: JSON.
- -q, --quiet: Unterdrücken Sie ausführliche Ausgaben.
Auflistung aller Reservierungen
Sie können alle IBM Cloud VPC-Reservierungen in Ihrer Region über die Befehlszeilenschnittstelle (CLI) auflisten. Verwenden Sie den Befehl ibmcloud is reservations, um alle Reservierungen über die CLI aufzulisten.
ibmcloud is reservations
Beispiel:
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
Abrufen einer Reservierung
Sie können eine bestimmte IBM Cloud VPC-Reservierung in Ihrer Region mithilfe der Befehlszeilenschnittstelle abrufen. Verwenden Sie den Befehl ibmcloud is reservation, um eine bestimmte Reservierung über die Befehlszeilenschnittstelle
abzurufen. Sie müssen den Namen oder die ID der bestimmten Reservierung angeben, indem Sie RESERVATION_NAME für die bestimmte Reservierung verwenden, die Sie abrufen möchten.
ibmcloud is reservation RESERVATION_NAME
Beispiel:
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 -
Aktualisieren einer Reservierung
Sie können eine bestimmte IBM Cloud VPC Reservierung in Ihrer Region mit Hilfe der Befehlszeilenschnittstelle (CLI) aktualisieren. Verwenden Sie den Befehl ibmcloud is reservation-update, um eine bestimmte Reservierung über die
Befehlszeilenschnittstelle zu aktualisieren. Sie müssen den Namen oder die ID der bestimmten Reservierung angeben, indem Sie RESERVATION_NAME für die bestimmte Reservierung verwenden, die Sie aktualisieren wollen. Verwenden
Sie die Variable NEW_NAME in der Option --name, um die Reservierung umzubenennen.
ibmcloud is reservation-update RESERVATION_NAME [--name NEW_NAME]
Beispiel:
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 - -
Dabei werden die folgenden Argumente und Optionswerte verwendet
- --name: Neuer Name für die Reservierung.
- --capacity: Die Kapazitätskonfiguration für diese Reservierung.
- --term: Laufzeit der Reservierung. Einer der folgenden Werte: one_year, three_year.
- --profile: Der Name des Profils, das für diese Reservierung verwendet werden soll.
- --profile-resource-type: Der Ressourcentyp des Profils. Einer der folgenden Werte: instance_profile
- ----expiration-policy: Die Richtlinie, die gilt, wenn die festgelegte Nutzungsdauer abläuft. Eine der folgenden Optionen: release, renew.
- --output: Geben Sie das Ausgabeformat an; es wird nur JSON unterstützt. Option: JSON.
- -q, --quiet: Unterdrücken Sie ausführliche Ausgaben.
Auflistung von Instanzprofilen mit Reservierungsbedingungen
Sie können Instanzprofile mit Reservierungsbedingungen in Ihrer Region über die Befehlszeilenschnittstelle (CLI) auflisten. Verwenden Sie den Befehl ibmcloud is instance-profiles, um Instanzprofile mit Reservierungsbedingungen
über die Befehlszeilenschnittstelle aufzulisten.
ibmcloud is instance-profiles
Beispiel:
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
Auflistung von Instanzen mit einer Reservierung
Sie können Instanzen mit Reservierungsbedingungen in Ihrer Region über die Befehlszeilenschnittstelle (CLI) auflisten. Verwenden Sie den Befehl ibmcloud is instances, um Instanzen mit Reservierungsbedingungen über die Befehlszeilenschnittstelle
aufzulisten. Sie müssen den Namen oder die ID der spezifischen Instanz angeben, indem Sie den " INSTANCE_NAME für die spezifischen Instanzen verwenden, die Sie auflisten möchten.
ibmcloud is instances
Beispiel:
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
Abrufen von Instanzprofilen mit Reservierungsbedingungen
Sie können Instanzprofile mit Reservierungsbedingungen in Ihrer Region über die Befehlszeilenschnittstelle (CLI) abrufen. Verwenden Sie den Befehl ibmcloud is instance-profile, um Instanzprofile mit Reservierungsbedingungen über
die Befehlszeilenschnittstelle abzurufen.
ibmcloud is instance-profile PROFILE_NAME
Beispiel:
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 -
Verwaltung von Reservierungen über die API
Um eine Reservierung über die Anwendungsprogrammierschnittstelle (API) zu verwalten, benötigen Sie eine IAM-Rolle, die die folgenden Aktionen umfasst. Weitere Informationen finden Sie unter IAM-Zugriff für VPC-Infrastrukturservices verwalten.
- is.reservation.reservation.list
- is.reservation.reservation.read
- is.reservation.reservation.create
- is.reservation.reservation.delete
- is.reservation.reservation.read
- is.reservation.reservation.update
Auflistung aller Reservierungen
Sie können alle IBM Cloud VPC-Reservierungen in Ihrer Region mithilfe der Anwendungsprogrammierschnittstelle (API) auflisten. Zum Auflisten aller Reservierungen über die API verwenden Sie Alle Bilder auflisten.
Geben Sie eine Anforderung GET /reservations an, um alle Reservierungen aufzulisten. Beispiel:
curl -X GET "$vpc_api_endpoint/v1/reservations?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token"
Die Reservierungen werden zuerst nach ihrem Eigenschaftswert create_at sortiert. Die neuesten Reservierungen werden zuerst aufgelistet. Wenn Reservierungen identische created_at-Eigenschaftswerte haben, werden sie
nach ihren name-Eigenschaftswerten sortiert. Die Liste der Reservierungen enthält standardmäßig 50 Reservierungen, aber Sie können diese Zahl auf bis zu 100 erhöhen.
Sie können die Liste mit den folgenden Eigenschaftswerten weiter filtern.
nameresource_group.idzone.name
Löschung einer Reservierung
Sie können eine IBM Cloud VPC-Reservierung in Ihrer Region mit der Anwendungsprogrammierschnittstelle (API) löschen. Um eine Reservierung über die API zu löschen, verwenden Sie Reservierung löschen.
Geben Sie eine ' DELETE /reservation an, um eine Reservierung zu löschen. Beispiel:
curl -X DELETE "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" - H "Authorization: Bearer $iam_token"
Abrufen einer Reservierung
Sie können eine bestimmte IBM Cloud VPC-Reservierung in Ihrer Region mithilfe der Anwendungsprogrammierschnittstelle (API) abrufen. Wenn Sie eine bestimmte Reservierung über die API abrufen möchten, verwenden Sie Reservierung abrufen.
Geben Sie eine ' GET /reservation/{id} an, um eine bestimmte Reservierung abzurufen, wobei ' id die Reservierungskennung der abzurufenden Reservierung ist. Die Kennung ist in der URL zu finden. Beispiel:
curl -X GET "$vpc_api_endpoint/v1/reservations/$id?version=2024-01-27&generation=2" - H "Authorization: Bearer $iam_token"
Aktualisieren einer Reservierung
Sie aktualisieren eine bestimmte IBM Cloud VPC-Reservierung in Ihrer Region mithilfe der Anwendungsprogrammierschnittstelle (API). Um eine bestimmte Reservierung über die API zu aktualisieren, verwenden Sie Reservierung aktualisieren.
Geben Sie eine PATCH /reservations/{id}-Anforderung zum Aktualisieren einer bestimmten Reservierung an, wobei id die Reservierungskennung der Reservierung ist, die Sie abrufen. Die Kennung ist in der URL zu finden.
Beispiel:
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"
}
}'
Aktivieren einer Reservierung
Sie können eine bestimmte IBM Cloud VPC Reservierung in Ihrer Region mit Hilfe der Programmierschnittstelle (API) aktivieren. Um eine bestimmte Reservierung über die API zu aktivieren, verwenden Sie Reservierung aktivieren.
Geben Sie eine POST /reservations/{id}/activate-Anforderung zum Aktualisieren einer bestimmten Reservierung an, wobei id die Reservierungskennung der Reservierung ist, die Sie abrufen. Die Kennung ist in der URL zu
finden. Beispiel:
curl -X POST "$vpc_api_endpoint/v1/reservations/$id/activate?version=2024-01-27&generation=2" -H "Authorization: Bearer $iam_token"