使用用户界面在预订中附加虚拟服务器实例

您可以将虚拟服务器附加到预留。

1. 在 IBM Cloud 控制台中，单击 导航菜单图标 > 基础架构 预订。
2. 在“预留详细信息”页面中选择预留。
3. 从虚拟服务器列表中，单击 操作 > 连接。
4. 选择要附加到预订的服务器，然后单击附加。

使用 UI 从预留中拆离服务器

您可以从预留中拆离虚拟服务器。

1. 在 IBM Cloud 控制台中，单击 导航菜单图标 > 基础架构 预订。
2. 从虚拟服务器列表或“预留详细信息”页面中，单击要拆离的服务器，然后单击 操作 > 拆离。
3. 要确认，请单击 拆离。

如果实例被停止并启动，即使指向的是已过期的预订，也允许启动并按付费价格计费。

使用用户界面删除预订

您可以删除预留。

1. 在 IBM Cloud 控制台中，单击 导航菜单图标 > 基础架构 预订。
2. 从“预留”列表中，单击 操作 > 删除预留。
3. 要确认，请单击 删除。

激活预留

您可以使用命令行界面 (CLI) 来激活预留。 要使用 CLI 激活特定预留，请使用 ibmcloud is reservation-activate 命令。 您必须通过对要获取的特定预留使用 RESERVATION_NAME 来指定特定预留的名称或标识。

ibmcloud is reservation-activate

请参阅以下示例。

ibmcloud is reservation-activate b4735ce6-f83d-45d1-b41b-4d47451c8396
Activating reservation b4735ce6-f83d-45d1-b41b-4d47451c8396 under account VPCUI-DEMO as user Sreekar.B.V@ibm.com...
Successfully activated reservation.

使用以下参数和选项值

• 预订：预订的 ID 或名称。
• --output：指定输出格式，仅支持 JSON。 其中一个 :JSON。
• -q, --quiet: 禁止冗长输出

获取有保留的实例

您可以使用命令行界面 (CLI) 在区域中获取具有预留的实例。 要使用 CLI 获取特定实例预留，请使用 ibmcloud is instance 命令。 您必须通过对要获取的特定预留使用 RESERVATION_NAME 来指定特定预留的名称或标识。 使用 --name 选项中的 NEW_NAME 变量来重命名预留。

ibmcloud is instance RESERVATION_NAME

请参阅以下示例。

ibmcloud is reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Getting reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa under account VPCUI-DEMO as user Sreekar.B.V@ibm.com...

ID                aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name              aaa-default-reservation-2
CRN               crn:v1:staging: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      -

删除预订

您可以使用命令行界面 (CLI) 在区域中删除 IBM Cloud VPC 预留。 要使用 CLI 删除预留，请使用 ibmcloud is reservation-delete 命令。 必须通过对要删除的特定预留使用 RESERVATION_NAME 来指定特定预留的名称或标识。

ibmcloud is reservation-delete RESERVATION_NAME

请参阅以下示例。

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 VPCUI-DEMO as user Sreekar.B.V@ibm.com...
OK
Reservation e9e537f0-59f5-4759-b06e-86bb5cd4068e is deleted.

使用以下参数和选项值

• RESERVATION1:保留的 ID 或名称。
• RESERVATION2:保留的 ID 或名称。
• ---force,-f：强制操作，无需确认
• --output：指定输出格式，仅支持 JSON。 其中一个 :JSON。
• -q, --quiet: 禁止冗长输出。

列出所有预订

您可以使用命令行界面 (CLI) 列出区域中的所有 IBM Cloud VPC 预留。 要使用 CLI 列出所有预留，请使用 ibmcloud is reservation 命令。

ibmcloud is reservation

请参阅以下示例。

ibmcloud is instances
Listing instances in all resource groups and region us-south under account VPCUI-DEV as user Sreekar.B.V@ibm.com...
ID                                          Name               Status    Reserved IP     Floating IP   Profile   Image                             VPC    Zone         Resource group   Reservation Name
0735_73b1e3e5-10a2-44b0-a113-c8d6cd8c42e7   cli-in-test-1      pending   0.0.0.0         -             cx2-2x4   ibm-centos-7-9-minimal-amd64-11   test   us-south-3   Default          reservation-cli-test-1
0735_4e245881-c9c8-49f3-a21b-d890a13835bb   i4                 running   10.240.128.30   -             cx2-2x4   ibm-centos-7-9-minimal-amd64-11   test   us-south-3   Default          reservation-cli-test-3
0735_83748ac9-dffc-4ec0-9914-27c9b7e4a5f3   test-unattached2   running   10.240.128.20   -             cx2-2x4   ibm-centos-7-9-minimal-amd64-11   test   us-south-3   Default          -

检索预订

您可以使用命令行界面 (CLI) 在区域中检索特定 IBM Cloud VPC 预留。 要使用 CLI 检索特定预留，请使用 ibmcloud is reservation 命令。 对于要检索的特定预留，必须使用 RESERVATION_NAME 来指定特定预留的名称或标识。

ibmcloud is reservation RESERVATION_NAME

请参阅以下示例。

ibmcloud is reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Getting reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa under account VPCUI-DEMO as user Sreekar.B.V@ibm.com...

ID                aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name              aaa-default-reservation-2
CRN               crn:v1:staging: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      -

更新预订

您可以使用命令行界面 (CLI) 更新区域内的特定IBM Cloud VPC预留。 要使用 CLI 更新特定预留，请使用 ibmcloud is reservation-update 命令。 必须通过对要更新的特定预留使用 RESERVATION_NAME 来指定特定预留的名称或标识。 使用 --name 选项中的 NEW_NAME 变量来重命名预留。

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

请参阅以下示例。

ibmcloud is reservation-update aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa --name aaa-default-reservation-2-renamed
Updating reservation aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa under account VPCUI-DEMO as user Sreekar.B.V@ibm.com...

ID                aaaaaaaa-aaaa-default-reservation2-aaaaaaaaaaaa
Name              aaa-default-reservation-2-renamed
CRN               crn:v1:staging: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       -      -

使用以下参数和选项值

• ---name：保留的新名称。
• ---capacity：该预订的容量配置。
• ---term：保留的期限。 其中之一 :one_year，three_year。
• --profile：此预订要使用的配置文件名称。
• ---profile-resource-type）：配置文件的资源类型。 其中之一 :instance_profile。
• ---expiration-policy：承诺使用期限到期时适用的策略。 其中之一: 发布，更新。
• --output：指定输出格式，仅支持 JSON。 其中一个 :JSON。
• -q, --quiet: 禁止冗长输出。

列出所有预订

您可以使用应用程序编程接口 (API) 列出区域中的所有 IBM Cloud VPC 预留。 要使用 API 列出所有预留，请使用 列出所有映像。

指定 GET /reservations 请求以列出所有预留。 请参阅以下示例。

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

预留首先按其 create_at 属性值进行排序。 将首先列出最新的预留。 如果预留具有相同的 created_at 属性值，那么将按其 name 属性值对其进行排序。 预订列表默认为 50 个预订，但您可以将其增加到 100 个。

您可以使用以下属性值进一步过滤列表。

• name
• resource_group.id
• zone.name

删除预订

您可以使用应用程序编程接口 (API) 在区域中删除 IBM Cloud VPC 预留。 要使用 API 删除预留，请使用 删除预留。

指定 "DELETE /reservation 请求以删除预订。 请参阅以下示例。

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

检索预订

您可以使用应用程序编程接口 (API) 在区域中检索特定 IBM Cloud VPC 预留。 要使用 API 检索特定预留，请使用 检索预留。

指定“GET /reservation/{id} 请求以检索特定预订，其中”id 是要检索的预订的预订标识符。 该标识位于 URL 中。 请参阅以下示例。

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

更新预订

使用应用程序编程接口 (API) 更新区域中的特定 IBM Cloud VPC 预留。 要使用 API 更新特定预留，请使用 更新预留。

指定 PATCH /reservations/{id} 请求以更新特定预留，其中 id 是要检索的预留的预留标识。 该标识位于 URL 中。 请参阅以下示例。

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

激活预订

您可以使用应用程序编程接口 (API) 激活您所在地区的特定IBM Cloud VPC预约。 要使用 API 激活特定预订，请使用激活 预订。

指定 POST /reservations/{id}/activate 请求以更新特定预留，其中 id 是要检索的预留的预留标识。 该标识位于 URL 中。 请参阅以下示例。

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