Gestión de una reserva para VPC

Después de suministrar la reserva, puede gestionar la reserva con las acciones siguientes.

Acciones para gestionar las reservas de servidores virtuales
Acción Descripción
Listar todas las reservas Enumera todas las reservas de la región.
Crear una reserva Realizar una reserva en la región.
Suprimir una reserva Suprimir una reserva de inactive. No puede suprimir una reserva de active. Esta acción no se puede revertir.
Recuperar una reserva Recupere una reserva especificada por su identificador en URL.
Actualizar una reserva Actualice la reserva con nueva información.
Activar una reserva Active una reserva de inactive.

Antes de empezar

Debe suministrar su reserva antes de adjuntar servidores virtuales. Para obtener más información, consulte Suministro de reservas para servidores virtuales.

Si no es el administrador de la cuenta, su cuenta de usuario debe incluir el permiso Gestionar capacidades reservadas. Para obtener más información sobre la actualización de permisos, consulte Gestión del acceso de IAM para VPC Infrastructure Services.

Gestión de una reserva con la interfaz de usuario

Puede utilizar la interfaz de usuario para gestionar la reserva y los servidores adjuntos.

Adjuntar una instancia de servidor virtual a su reserva con la interfaz de usuario

Puede conectar un servidor virtual a una reserva.

  1. En la consola de IBM Cloud, haz clic en el icono delmenú de navegación > el icono de VPC de infraestructura > Reservas.
  2. Seleccione una reserva en la página Detalles de reserva.
  3. En la lista de servidores virtuales, pulse Acciones > Adjuntar.
  4. Seleccione el servidor que desea adjuntar a la reserva y haga clic en Adjuntar.

Desconexión de un servidor de la reserva con la interfaz de usuario

Puede desconectar un servidor virtual de la reserva.

  1. En la consola de IBM Cloud, haz clic en el icono delmenú de navegación > el icono de VPC de infraestructura > Reservas.
  2. En la lista de servidores virtuales o en la página de detalles de reserva, pulse el servidor que desea desconectar y, a continuación, pulse Acciones > Desconectar.
  3. Para confirmar, pulse Desconectar.

Si la instancia se detiene y se inicia, aunque apunte a una reserva caducada, se permite su inicio y se factura a precios de pago.

Consideraciones especiales para borrar una reserva

Puede eliminar una reserva ' inactive ' y puede parchear los siguientes campos.

  • política_de_afinidad
  • capacity.total
  • committed_use.expiration_policy
  • committed_use.term
  • nombre
  • perfil

Si desea modificar algún otro campo, deberá eliminar la reserva y volver a crearla.

Sin embargo, una vez que una reserva se activa y se " active, muchos aspectos de la reserva son permanentes durante toda la vida de la misma. Asegúrese de revisar la reserva antes de activarla para comprobar que la configuración es correcta. Los únicos campos que pueden parchearse para una reserva " active " son " name y " committed_use.expiration_policy.

Cómo eliminar una reserva mediante la interfaz de usuario

Puedes eliminar una reserva.

  1. En la consola de IBM Cloud, haz clic en el icono delmenú de navegación > el icono de VPC de infraestructura > Reservas.
  2. En la lista Reservas, pulse Acciones > Suprimir reserva.
  3. Para confirmar, pulse Suprimir.

Gestión de una reserva con la CLI

Puede gestionar una reserva utilizando la CLI.

Activar una reserva

Puede activar una reserva utilizando la interfaz de línea de mandatos (CLI). Para activar una reserva específica utilizando la CLI, utilice el mandato ibmcloud is reservation-activate. Debe especificar el nombre o el ID de la reserva específica utilizando RESERVATION_NAME para la reserva específica que desea obtener.

ibmcloud is reservation-activate RESERVATION

Vea el ejemplo siguiente.

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.

Cuando se utilizan los siguientes valores de argumentos y opciones

  • RESERVA: ID o nombre de la reserva.
  • --output o: Especifica el formato de salida; solo se admite JSON. Valores posibles: JSON.
  • -q, --quiet: Suprimir la salida detallada

Obtener una instancia con reserva

Puede obtener la instancia con reserva en la región utilizando la interfaz de línea de mandatos (CLI). Para obtener una reserva de instancia específica utilizando la CLI, utilice el mandato ibmcloud is instance. Debe especificar el nombre o ID de la instancia específica utilizando INSTANCE_NAME para la instancia específica que desea obtener.

ibmcloud is instance INSTANCE_NAME

Vea el ejemplo siguiente.

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      -

Suprimir una reserva

Puede suprimir IBM Cloud VPC una reserva en su región utilizando la interfaz de línea de mandatos (CLI). Para eliminar una reserva mediante la CLI, utiliza el comando ibmcloud is reservation-delete. Debe especificar el nombre o el ID de la reserva específica utilizando RESERVATION_NAME para la reserva específica que desea suprimir.

ibmcloud is reservation-delete RESERVATION_NAME

Vea el ejemplo siguiente.

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.

Cuando se utilizan los siguientes valores de argumentos y opciones

  • RESERVATION1: ID o nombre de la reserva.
  • RESERVATION2: ID o nombre de la reserva.
  • --force, -f: Forzar la operación sin confirmación
  • --output o: Especifica el formato de salida; solo se admite JSON. Valores posibles: JSON.
  • -q, --quiet: Suprimir la salida detallada.

Listado de todas las reservas

Puede listar todas las reservas de IBM Cloud VPC en su región utilizando la interfaz de línea de mandatos (CLI). Para listar todas las reservas utilizando la CLI, utilice el mandato ibmcloud is reservations.

ibmcloud is reservations

Vea el ejemplo siguiente.

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

Recuperar una reserva

Puede recuperar una reserva de IBM Cloud VPC específica en su región utilizando la interfaz de línea de mandatos (CLI). Para recuperar una reserva específica utilizando la CLI, utilice el mandato ibmcloud is reservation. Debe especificar el nombre o el ID de la reserva específica utilizando RESERVATION_NAME para la reserva específica que desea recuperar.

ibmcloud is reservation RESERVATION_NAME

Vea el ejemplo siguiente.

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      -

Actualizar una reserva

Puede actualizar una reserva IBM Cloud VPC específica de su región mediante la interfaz de línea de comandos (CLI). Para actualizar una reserva específica utilizando la CLI, utilice el mandato ibmcloud is reservation-update. Debe especificar el nombre o el ID de la reserva específica utilizando RESERVATION_NAME para la reserva específica que desea actualizar. Utilice la variable NEW_NAME en la opción --name para cambiar el nombre de la reserva.

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

Vea el ejemplo siguiente.

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       -      -

Cuando se utilizan los siguientes valores de argumentos y opciones

  • --name o: nuevo nombre para la reserva.
  • --capacity o: La configuración de capacidad para esta reserva.
  • --term o: Plazo de la reserva. Uno de: one_year, three_year.
  • --profile: El nombre del perfil que se va a utilizar para esta reserva.
  • --profile-resource-type o: El tipo de recurso del perfil. Uno de: instance_profile.
  • ---expiration-policy: La política que se aplica cuando expira el plazo de uso comprometido. Uno de: liberar, renovar.
  • --output o: Especifica el formato de salida; solo se admite JSON. Valores posibles: JSON.
  • -q, --quiet: Suprimir la salida detallada.

Listado de perfiles de instancia con condiciones de reserva

Puede listar perfiles de instancia con términos de reserva en su región utilizando la interfaz de línea de mandatos (CLI). Para listar perfiles de instancia con términos de reserva utilizando la CLI, utilice el mandato ibmcloud is instance-profiles.

ibmcloud is instance-profiles

Vea el ejemplo siguiente.

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

Listado de instancias con una reserva

Puede listar instancias con términos de reserva en su región utilizando la interfaz de línea de mandatos (CLI). Para listar las instancias con términos de reserva utilizando la CLI, utilice el mandato ibmcloud is instances. Debe especificar el nombre o ID de la instancia específica utilizando el " INSTANCE_NAME " para las instancias específicas que desee listar.

ibmcloud is instances

Vea el ejemplo siguiente.

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

Obtener perfiles de instancia con condiciones de reserva

Puede obtener perfiles de instancia con términos de reserva en su región utilizando la interfaz de línea de mandatos (CLI). Para obtener perfiles de instancia con términos de reserva utilizando la CLI, utilice el mandato ibmcloud is instance-profile.

ibmcloud is instance-profile PROFILE_NAME

Vea el ejemplo siguiente.

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    -

Gestión de reservas con la API

Para gestionar una reserva mediante la interfaz de programación de aplicaciones (API), necesita un rol IAM que incluya las siguientes acciones. Para obtener más información, consulte Gestión del acceso de IAM para servicios de infraestructura de VPC.

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

Listado de todas las reservas

Puede listar todas las reservas de IBM Cloud VPC en su región utilizando la interfaz de programación de aplicaciones (API). Para listar todas las reservas utilizando la API, utilice Listar todas las imágenes.

Especifique una solicitud GET /reservations para listar todas las reservas. Vea el ejemplo siguiente.

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

Las reservas se ordenan en primer lugar por su valor de propiedad create_at. Las reservas más recientes se listan en primer lugar. Si las reservas tienen valores de propiedad created_at idénticos, se ordenan por sus valores de propiedad name. La lista de reservas tiene por defecto 50 reservas, pero puede aumentar esta cantidad hasta 100.

Puede filtrar más la lista con los siguientes valores de propiedad.

  • name
  • resource_group.id
  • zone.name

Suprimir una reserva

Puede suprimir una reserva de IBM Cloud VPC en su región utilizando la interfaz de programación de aplicaciones (API). Para suprimir una reserva utilizando la API, utilice Suprimir una reserva.

Especifique una solicitud " DELETE /reservation " para eliminar una reserva. Vea el ejemplo siguiente.

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

Recuperar una reserva

Puede recuperar una reserva de IBM Cloud VPC específica en su región utilizando la interfaz de programación de aplicaciones (API). Para recuperar una reserva específica utilizando la API, utilice Recuperar una reserva.

Especifique una solicitud de " GET /reservation/{id} " para recuperar una reserva específica donde " id " es el identificador de la reserva que está recuperando. El identificador está en URL. Vea el ejemplo siguiente.

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

Actualizar una reserva

Actualice una reserva IBM Cloud VPC específica en su región utilizando la interfaz de programación de aplicaciones (API). Para actualizar una reserva específica utilizando la API, utilice Actualizar una reserva.

Especifique una solicitud PATCH /reservations/{id} para actualizar una reserva específica donde id es el identificador de reserva de la reserva que está recuperando. El identificador está en URL. Vea el ejemplo siguiente.

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"
      }
    }'

Activar una reserva

Puede activar una reserva específica IBM Cloud VPC en su región utilizando la interfaz de programación de aplicaciones (API). Para activar una reserva específica mediante la API, utilice Activar una reserva.

Especifique una solicitud POST /reservations/{id}/activate para actualizar una reserva específica donde id es el identificador de reserva de la reserva que está recuperando. El identificador está en URL. Vea el ejemplo siguiente.

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