Reservierung für VPC verwalten

Nach der Bereitstellung Ihrer Reservierung können Sie die Reservierung mit den folgenden Aktionen verwalten:

Aktionen zur Verwaltung von Reservierungen für virtuelle Server
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.

  1. Klicken Sie in der IBM Cloud-Konsole auf dasNavigationsmenü-Symbol > das Infrastruktur-VPC-Symbol > Reservierungen.
  2. Wählen Sie auf der Seite "Reservierungsdetails" eine Reservierung aus.
  3. Klicken Sie in der Liste der virtuellen Server auf Aktionen > Zuordnen.
  4. 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.

  1. Klicken Sie in der IBM Cloud-Konsole auf dasNavigationsmenü-Symbol > das Infrastruktur-VPC-Symbol > Reservierungen.
  2. 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.
  3. 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.

  1. Klicken Sie in der IBM Cloud-Konsole auf dasNavigationsmenü-Symbol > das Infrastruktur-VPC-Symbol > Reservierungen.
  2. Klicken Sie in Ihrer Reservierungsliste auf Aktionen > Reservierung löschen.
  3. 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.

  • name
  • resource_group.id
  • zone.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"