Gestión de una reserva para VPC
Después de suministrar la reserva, puede gestionar la reserva con las acciones siguientes.
| 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.
- En la consola de IBM Cloud, haz clic en el icono
menú de navegación >
> Reservas.
- Seleccione una reserva en la página Detalles de reserva.
- En la lista de servidores virtuales, pulse Acciones > Adjuntar.
- 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.
- En la consola de IBM Cloud, haz clic en el icono
menú de navegación >
> Reservas.
- 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.
- 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.
- En la consola de IBM Cloud, haz clic en el icono
menú de navegación >
> Reservas.
- En la lista Reservas, pulse Acciones > Suprimir reserva.
- 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.
nameresource_group.idzone.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"