创建虚拟服务器实例

准备工作

• 下载、安装并初始化以下 CLI 插件。

  • IBM Cloud CLI
  • infrastructure-service 插件

  有关详细信息，请参阅 设置 API 和 CLI 环境。

• 确保 创建了 VPC。

通过命令行界面（CLI）收集信息以创建实例

准备好创建实例了吗？ 在运行 ibmcloud is instance-create 命令之前，您需要了解该实例的详细信息，例如要使用的配置文件或镜像。

使用相关命令收集以下信息。

您可以从 available、partially_available （图像尚未在所有区域提供）或 deprecated 图像中配置实例。 有关图像生命周期的更多信息，请参阅 自定义图像生命周期。

确认您使用的配置文件在计划创建实例的区域中可用。

使用以下命令来确定创建新实例所需的信息。

ibmcloud is regions

$ ibmcloud is regions
Listing regions under account Test Account as user test.user@ibm.com...
Name       Endpoint                              Status
au-syd     https://au-syd.iaas.cloud.ibm.com     available
br-sao     https://br-sao.iaas.cloud.ibm.com     available
ca-tor     https://ca-tor.iaas.cloud.ibm.com     available
eu-de      https://eu-de.iaas.cloud.ibm.com      available
eu-es      https://eu-es.iaas.cloud.ibm.com      available
eu-gb      https://eu-gb.iaas.cloud.ibm.com      available
jp-osa     https://jp-osa.iaas.cloud.ibm.com     available
jp-tok     https://jp-tok.iaas.cloud.ibm.com     available
us-east    https://us-east.iaas.cloud.ibm.com    available
us-south   https://us-south.iaas.cloud.ibm.com   available

ibmcloud target -r <region-name>

ibmcloud is zones

$ ibmcloud is zones
Listing zones in target region us-south under account Test Account as user test.user@ibm.com...
Name         Region     Status
us-south-1   us-south   available
us-south-2   us-south   available
us-south-3   us-south   available

ibmcloud is vpcs

ID                                        Name       Status     Classic access   Default network ACL              Default security group        Resource group
r006-35b9cf35-616e-462e-a145-cf8db4062fcf my-vpc     available  false            immortality-casing-extoll-exit   enhance-corsage-managing-jinx Default

ibmcloud is subnets

ID                                          Name            Status      Subnet CIDR      Addresses   ACL                              Public Gateway   VPC
Zone         Resource group
0717-198db988-3b9b-4cfa-9dec-0206420d37d0   my-subnet       available   10.240.64.0/28   7/16        immortality-casing-extoll-exit   -               my-vpc
us-south-2   Default

ibmcloud is images

ID                                          Name                               Status       Arch    OS name                   OS version       File size(GB)
Visibility   Encryption   Resource group   Catalog Offering User Data Format   Remote Account ID
r006-24d856e2-6aec-41c2-8f36-5a8a3766f0d6   my-test-image                      available    amd64   centos-7-amd64            7.x - Minimal Install  1             private      none         Default          -                cloud_init
r006-9768bb7f-c75d-4408-ba34-61015632f907   ibm-debian-10-13-minimal-amd64-2   available    amd64   debian-10-amd64           10.x Buster/Stable     1             public       none         Default          -                cloud_init       811f8abfbd32425597dc7ba40da98fa6
r006-f83ce520-00b5-40c5-9938-a5c82a273f91   ibm-debian-11-3-minimal-amd64-4    available    amd64   debian-11-amd64           11.x Bullseye/Stable   1             public       none         Default          -                cloud_init       811f8abfbd32425597dc7ba40da98fa6

   ibmcloud is catalog-image-offerings
   ```
   此命令将返回每个提供的图像的标识符和图像所在的私有目录的标识符。 将 `offering_id` 和 `catalog_id` 保存在变量中，以后用于配置实例。

   ```sh {: pre}
   offering_id=6bf79f7b-de48-4ce8-8cae-866b376f2889
   catalog_id=71306253-8444-4cae-a45d-64d35e5393ec
   ```
- 要获取产品的 `offering_crn` 和产品中每个版本的 `offering_version_crn`，请运行以下命令。

```sh {: pre}
   ibmcloud is catalog-image-offering $catalog_id $offering_id
   ```
当您配置实例时，可通过以下两种方式进行：使用 ` `offering_crn` value` 从目录产品中最新版本的私有目录管理映像配置实例，或使用 ` `offering_version_crn` value` 从目录产品中特定版本配置实例。

   Save the `offering_crn` and `offering_version_crn`in variables, which are used later to provision an instance.
 
   ```sh {: pre}
    offering_crn="crn:v1:bluemix:public:globalcatalog-collection:global:a/a1234567:0b322820-dafd-4b5e-b694-6465da6f008a:offering:136559f6-4588-4af2-8585-f3c625eee09d"
    offering_version_crn="crn:v1:bluemix:public:globalcatalog-collection:global:a/a1234567:0b322820-dafd-4b5e-b694-6465da6f008a:version:136559f6-4588-4af2-8585-f3c625eee09d/8ae92879-e253-4a7c-b09f-8d30af12e518"
    ```
##### 列出所有可用的启动盘 {: #list-available-boot-volumes-images-cli}

列出可用于创建实例的可用启动卷。 要从现有卷创建实例，必须使用与之前选择的实例选项兼容的卷。 兼容卷与正在调配的实例位于同一区域，未连接，且操作系统与步骤 5 中选择的配置文件兼容。 使用 `volumes` 子命令查看兼容卷。 例如，在 `us-south-1` 中查看 x64 操作系统架构的未连接卷：

```sh {: pre}
ibmcloud is volumes --attachment-state unattached --operating-system-architecture amd64 --zone us-south-1

ibmcloud is instance-profiles

Name                         vCPU Manufacturer   Architecture   Family              vCPUs   Memory(GiB)   Bandwidth(Mbps)   Volume bandwidth(Mbps)   GPUs          Storage(GB)   Min NIC Count   Max NIC Count
bx2-2x8                      intel               amd64          balanced            2       8             4000              1000                     -      -                    1               5
bx2a-2x8                     amd                 amd64          balanced            2       8             2000              500                      -      -                    1               5
bx2d-2x8                     intel               amd64          balanced            2       8             4000              1000                     -            1x75          1               5
bx2-4x16                     intel               amd64          balanced            4       16            8000              2000                     -      -                    1               5
bx2a-4x16                    amd                 amd64          balanced            4       16            4000              1000                     -      -                    1               5
bx2d-4x16                    intel               amd64          balanced            4       16            8000              2000                     -            1x150         1               5

FAILED
Response HTTP Status Code: 400
Error code: bad_field
Error message: Image OS IBM Hyper Protect is not supported by the instance profile <profile_name>
Error target name: profile, type: field

ibmcloud is keys

ID                                          Name     Type   Length   FingerPrint          Resource group
r006-89ec781c-9630-4f76-b9c4-a7d204828d61   my-key   rsa    4096     gtnf+pdX2PYI9Ofq..   Default

ibmcloud is placement-groups

ID                                            Name                             State    Strategy       Resource Group
c5f1f366-b92a-4080-991a-aa5c2e33d96b          placement-group-region-us-south   stable   power_spread  Default

通过命令行界面（CLI）创建实例

使用以下信息通过 CLI 创建实例。

从图片库或自定义图片中提供

了解所需数值后，使用它们运行 ibmcloud is instance-create 命令。 您还需要为实例指定一个唯一的名称。

请按照以下步骤，从命令行界面（CLI）使用标准镜像创建基础虚拟服务器实例。 默认情况下，实例创建时会附加一个启动卷。 对于大多数虚拟服务器实例，默认启动卷大小为 100 GB。 z/OS 虚拟服务器实例的默认启动卷大小为 250 GB。

1. 使用以下命令创建一个实例。

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --image IMAGE \
       --keys KEYS \
   

   例如，下面的 instance-create 命令使用了“收集信息”部分中的示例值。

   ibmcloud is instance-create \
       my-instance \
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf \
       us-south-2 \
       bx2-2x8 \
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0 \
       --image r006-f83ce520-00b5-40c5-9938-a5c82a273f91 \
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61 \
   

   使用以下参数和选项值

   • INSTANCE_NAME：my-instance
   • VPC： r006-35b9cf35-616e-462e-a145-cf8db4062fcf
   • ZONE_NAME：us-south-2
   • PROFILE_NAME：bx2-2x8
   • 子网： 0717-198db988-3b9b-4cfa-9dec-0206420d37d0
   • 图像：Debian 11 图像 r006-f83ce520-00b5-40c5-9938-a5c82a273f91
   • 钥匙 r006-89ec781c-9630-4f76-b9c4-a7d204828d61

   响应的不同取决于您使用的选项值。

   ID                                    0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Name                                  my-instance
   CRN                                   crn:v1:public:is:us-south-2:a/a1234567::instance:0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Status                                pending
   Availability policy on host failure   restart
   Startable                             true
   Profile                               bx2-2x8
   Architecture                          amd64
   vCPU Manufacturer                     intel
   vCPUs                                 2
   Memory(GiB)                           8
   Bandwidth(Mbps)                       4000
   Volume bandwidth(Mbps)                1000
   Network bandwidth(Mbps)               3000
   Lifecycle Reasons                     Code   Message
                                          -      -
   Lifecycle State                       pending
   Metadata service                      Enabled   Protocol   Response hop limit
                                         false     http       1
   Image                                 ID                                          Name
                                         r006-f83ce520-00b5-40c5-9938-a5c82a273f91   ibm-debian-11-3-minimal-amd64-4
   VPC                                   ID                                          Name
                                         r006-35b9cf35-616e-462e-a145-cf8db4062fcf   my-vpc
   Zone                                  us-south-2
   Resource group                        ID                                 Name
                                         cdc21b72d4e647b195de988b175e3d82   Default
   Created                               2023-03-23T21:50:24+00:00
   Boot volume                           ID   Name   Attachment ID                               Attachment name
                                         -    -      0717-7ccd4284-e59d-45d8-932a-9e52f62f187a   landing-faucet-prankish-sprout
   

   创建实例后，不会返回为新实例创建的网络接口信息。 您可以使用 ibmcloud is instance INSTANCE 命令查看信息，具体步骤如下。 在实例创建完成之前，状态将显示为“待处理”。

   有关可作为 instance-create 命令选项的一些附加功能的更多信息，请参阅以下主题：创建卷附件 JSON、启用或禁用元数据服务，以及 创建放置组。

   有关命令选项的完整列表，请参阅 ibmcloud is instance-create。

2. 接下来，运行以下 instance details 命令，验证是否可以看到新实例，并查看为新实例创建的网络接口。0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0 是虚拟服务器实例 ID，在上一步创建实例时已分配给该 ID。

   ibmcloud is instance 0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   

   在此示例中，您将看到以下响应。 现在状态显示为正在运行。 检查网络接口部分，查找网络接口的 ID。

   ID                                    0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Name                                  my-instance
   CRN                                   crn:v1:public:is:us-south-2:a/a1234567::instance:0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0
   Status                                running
   Availability policy on host failure   restart
   Startable                             true
   Profile                               bx2-2x8
   Architecture                          amd64
   vCPU Manufacturer                     intel
   vCPUs                                 2
   Memory(GiB)                           8
   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-f83ce520-00b5-40c5-9938-a5c82a273f91   ibm-debian-11-3-minimal-amd64-4
   VPC                                   ID                                          Name
                                         r006-35b9cf35-616e-462e-a145-cf8db4062fcf   my-vpc
   Zone                                  us-south-2
   Resource group                        ID                                 Name
                                         cdc21b72d4e647b195de988b175e3d82   Default
   Created                               2023-03-23T21:50:24+00:00
   Network Interfaces                    Interface   Name      ID                                          Subnet            Subnet ID                                   Floating IP   Security Groups                 Allow source IP spoofing   Reserved IP
                                         Primary     primary   0717-4db768bb-65c3-4045-8712-523e62eeabd2   my-subnet   0717-198db988-3b9b-4cfa-9dec-0206420d37d0         -             enhance-corsage-managing-jinx   false                      10.240.64.10
   Boot volume                           ID                                          Name                           Attachment ID                                    Attachment name
                                         r006-7a1d72d1-56ac-438e-bf85-6c0173e3f9a6   expend-anger-whiff-jackknife   0717-7ccd4284-e59d-45d8-932a-9e52f62f187a        landing-faucet-prankish-sprout
   

3. 使用以下命令申请一个浮动 IP 地址与实例关联。 为浮动 IP 指定的名称是 my-floatingip。0717-4db768bb-65c3-4045-8712-523e62eeabd2 是上一步中显示的虚拟服务器实例的网络接口 ID。

   ibmcloud is floating-ip-reserve \
       my-floatingip \
       --nic 0717-4db768bb-65c3-4045-8712-523e62eeabd2
   

   在此示例中，您会看到与以下输出类似的响应。

   ID               r006-9b79b9bc-a2dc-4337-865a-57d9b9198b76
   Address          169.59.214.164
   Name             my-floatingip
   CRN              crn:v1:public:is:us-south-2:a/a1234567::floating-ip:r006-9b79b9bc-a2dc-4337-865a-57d9b9198b76
   Status           available
   Zone             us-south-2
   Created          2023-03-23T22:13:07+00:00
   Target           ID                                          Target type         Instance ID                                 Target interface name   Target interface private IP
                    0717-4db768bb-65c3-4045-8712-523e62eeabd2   network_interface   0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0   primary                 -
   Resource group   ID                                 Name
                    cdc21b72d4e647b195de988b175e3d82   Default
   

   记录浮动 IP Address，以便以后使用。

   有关命令选项的完整列表，请参阅 ibmcloud is floating-ip-reserve。

需要更多帮助吗？ 您可以随时运行 ibmcloud is instance-create --help 来显示有关创建实例的帮助。

从私人目录图像中提供

了解所需数值后，使用它们运行 ibmcloud is instance-create 命令。 您还需要为实例指定一个唯一的名称。

请按照以下步骤，通过命令行界面（CLI）从私有目录产品或目录产品版本创建虚拟服务器实例。

1. 使用以下命令创建一个实例。

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --catalog-offering <CRN for the IBM Cloud catalog offering> or --catalog-offering-version <The CRN for the version of an IBM Cloud catalog offering> \
       --keys KEYS \
       --placement-group PLACEMENT_GROUP_NAME \
   

   例如，如果您在 us-south-2 创建一个名为 my-instance 的实例，并使用 bx2-2x8 配置文件和目录产品，则您的 instance-create 命令看起来类似于以下示例。

   ibmcloud is instance-create\
       my-instance\
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf\
       us-south-2\
       bx2-2x8\
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0\
       --catalog-offering crn:v1:public:globalcatalog-collection:global:a/a1234567:0b322820-dafd-4b5e-b694-6465da6f008a:offering:136559f6-4588-4af2-8585-f3c625eee09d
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61\
       --placement-group c5f1f366-b92a-4080-991a-aa5c2e33d96b\
   

   其中使用了以下参数和选项值。

   • INSTANCE_NAME：my-instance
   • VPC： r006-35b9cf35-616e-462e-a145-cf8db4062fcf
   • ZONE_NAME：us-south-2
   • PROFILE_NAME：bx2-2x8
   • 子网： 0717-198db988-3b9b-4cfa-9dec-0206420d37d0
   • 提供目录：是 crn:v1:public:globalcatalog-collection:global:a/a1234567:0b322820-dafd-4b5e-b694-6465da6f008a:offering:136559f6-4588-4af2-8585-f3c625eee09d
   • 钥匙 r006-89ec781c-9630-4f76-b9c4-a7d204828d61
   • 安置组：c5f1f366-b92a-4080-991a-aa5c2e33d96b

   创建实例后，不会返回为新实例创建的网络接口信息。 您可以使用 ibmcloud is instance INSTANCE 命令查看信息，具体步骤如下。

   在创建实例之前，虚拟服务器实例的状态显示为待定。

   有关命令选项的完整列表，请参阅 ibmcloud is instance-create。

2. 接下来，运行以下 instance details 命令，验证是否能看到新实例，并查看为新实例创建的网络接口。 INSTANCE，指定上一步中分配给新虚拟服务器实例的 ID。

   ibmcloud is instance INSTANCE
   

   现在状态显示为正在运行。 检查网络接口部分，查找网络接口的 ID。

3. 使用以下命令申请一个浮动 IP 地址与实例关联。 FLOATING_IP_NAME 指定浮动 IP 的名称，TARGET_INTERFACE 指定上一步中确定的网络接口 ID。

   ibmcloud is floating-ip-reserve \
       FLOATING_IP_NAME \
       --nic TARGET_INTERFACE
   

   记录浮动 IP Address，以便以后使用。

   有关命令选项的完整列表，请参阅 ibmcloud is floating-ip-reserve。

需要更多帮助吗？ 您可以随时运行 ibmcloud is instance-create --help 来显示有关创建实例的帮助。

从现有卷中提供

在确定所需值后，请使用这些值运行 instance-create 命令。 您还需要为实例指定一个唯一的名称。

使用以下步骤从可启动卷创建虚拟服务器实例，其中包括卷附件。

1. 使用以下命令创建一个实例。

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --boot-volume BOOT_VOLUME_JSON | @BOOT_VOLUME_JSON_FILE \
       --keys KEYS \
       --volume-attach VOLUME_ATTACH_JSON \
   

   例如，如果您在 us-south-1 创建一个名为 my-instance 的实例，并使用 bx2-2x8 配置文件和现有的启动卷，则您的 instance-create 命令看起来类似于以下示例。

   ibmcloud is instance-create\
       my-instance\
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf\
       us-south-1\
       bx2-2x8\
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0\
       --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"id": "r006-feec3e99-995e-4e8f-896b-48b42c7d05a7"}}'\
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61\
       --volume-attach @/Users/myname/myvolume-attachment_create.json\
   

   有关示例卷连接 JSON 文件，请参阅创建卷连接 JSON。 您还可以在卷附件中包含 卷的用户标签。

   创建实例后，不会返回为新实例创建的网络接口信息。 您可以使用 ibmcloud is instance INSTANCE 命令查看信息，具体方法将在下一步中介绍。

   在实例创建完成之前，状态将显示为“待处理”。

   有关命令选项的完整列表，请参阅 ibmcloud is instance-create。

2. 接下来，运行以下 instance details 命令，验证是否能看到新实例，并查看为新实例创建的网络接口。 INSTANCE，指定上一步中分配给新虚拟服务器实例的 ID。

   ibmcloud is instance INSTANCE
   

   现在状态显示为正在运行。 检查网络接口部分，查找网络接口的 ID。

3. 使用以下命令申请一个浮动 IP 地址与实例关联。 FLOATING_IP_NAME 指定浮动 IP 的名称，TARGET_INTERFACE 指定上一步中确定的网络接口 ID。

   ibmcloud is floating-ip-reserve \
       FLOATING_IP_NAME \
       --nic TARGET_INTERFACE
   

   记录浮动 IP Address，以便以后使用。

   有关命令选项的完整列表，请参阅 ibmcloud is floating-ip-reserve。

   需要更多帮助吗？ 您可以随时运行 ibmcloud is instance-create --help 来显示有关创建实例的帮助。

通过 CLI 创建具有多个数据卷和动态卷带宽分配的实例

选择 计算配置文件 支持数据卷的池带宽分配。 对于大多数计算配置文件，--volume-bandwidth-qos-mode 属性默认为 weighted。 使用 weighted 时，卷带宽在数据卷之间按比例分配。 通过指定 pooled 值，可以启用动态带宽分配。

下面的示例使用 ibmcloud is instance-create 命令创建虚拟服务器实例，并指定了值为 pooled 的选项 --volume-bandwidth-qos-mode。

ibmcloud is instance-create my-virtual-server my-vpc us-south-2 cx3d-8x20 my-subnet --image r006-534ef2ac-6158-45b3-9657-57629fa85305 --keys r006-68f8333a-1169-42da-ba01-75268bac8362 --volume-attach @/Users/myname/myvolume-attachment.json --volume-bandwidth-qos-mode pooled

myvolume-attachments.json 文件最多可包括 12 个要附加到虚拟服务器的数据卷。 请参阅以下示例：

[
  {"volume": {
        "name": "my-data-volume-1",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
   "delete_volume_on_instance_delete": false},
  {"volume": {
        "name": "my-data-volume-2",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
   "delete_volume_on_instance_delete": false},
  {"volume": {
        "name": "my-data-volume-3",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
   "delete_volume_on_instance_delete": false}
]

创建具有保密计算功能的实例

选择可用性

基于英特尔SGX的VPC机密计算和基于英特尔TDX的VPC机密计算已在达拉斯（us-south）、华盛顿特区（us-east）和法兰克福（eu-de）区域开放使用。

使用 sdp 卷配置文件的第二代启动卷还不支持安全启动。 如果需要安全启动，请使用带有第一代卷配置文件的启动卷。

在确定所需值后，请使用这些值运行 ibmcloud is instance-create 命令。 您还需要为实例指定一个唯一的名称。

对于 confidential-compute-mode，需要为选项指定 sgx 或 tdx。

使用以下步骤创建启用保密计算的基本虚拟服务器实例。

使用以下命令创建一个实例。

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --image IMAGE \
       --confidential-compute-mode sgx \
       --keys KEYS \

例如，下面的 instance-create 命令使用了“收集信息”部分中的示例值。

   ibmcloud is instance-create \
       my-instance \
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf \
       us-south-2 \
       bx2-2x8 \
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0 \
       --image r006-f83ce520-00b5-40c5-9938-a5c82a273f91 \
       --confidential-compute-mode sgx \
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61 \

使用以下参数和选项值

  * INSTANCE_NAME: `my-instance`
  * VPC: `r006-35b9cf35-616e-462e-a145-cf8db4062fcf`
  * ZONE_NAME: `us-south-2`
  * PROFILE_NAME: `bx2-2x8`
  * SUBNET: `0717-198db988-3b9b-4cfa-9dec-0206420d37d0`
  * IMAGE: Debian 11 image `r006-f83ce520-00b5-40c5-9938-a5c82a273f91`
  * KEYS: `r006-89ec781c-9630-4f76-b9c4-a7d204828d61`

创建安全启动实例

选择可用性

使用英特尔 SGX for VPC 的保密计算仅在达拉斯（美国南部）和法兰克福（欧洲东部）地区提供。 使用 sdp 卷配置文件的第二代启动卷还不支持安全启动。 如果需要安全启动，请使用带有第一代卷配置文件的启动卷。

在确定所需值后，请使用这些值运行 ibmcloud is instance-create 命令。 您还需要为实例指定一个唯一的名称。

对于 enable-secure-boot，需要指定 true 或 false。 缺省值为 false。

使用以下步骤创建启用安全启动的基本虚拟服务器实例。

使用以下命令创建一个实例。

   ibmcloud is instance-create \
       INSTANCE_NAME \
       VPC \
       ZONE_NAME \
       PROFILE_NAME \
       SUBNET \
       --image IMAGE \
       --enable-secure-boot true \
       --keys KEYS \

例如，下面的 instance-create 命令使用了“收集信息”部分中的示例值。

   ibmcloud is instance-create \
       my-instance \
       r006-35b9cf35-616e-462e-a145-cf8db4062fcf \
       us-south-2 \
       bx2-2x8 \
       0717-198db988-3b9b-4cfa-9dec-0206420d37d0 \
       --image r006-f83ce520-00b5-40c5-9938-a5c82a273f91 \
       --enable-secure-boot true \
       --keys r006-89ec781c-9630-4f76-b9c4-a7d204828d61 \

使用以下参数和选项值

  * INSTANCE_NAME: `my-instance`
  * VPC: `r006-35b9cf35-616e-462e-a145-cf8db4062fcf`
  * ZONE_NAME: `us-south-2`
  * PROFILE_NAME: `bx2-2x8`
  * SUBNET: `0717-198db988-3b9b-4cfa-9dec-0206420d37d0`
  * IMAGE: Debian 11 image `r006-f83ce520-00b5-40c5-9938-a5c82a273f91`
  * KEYS: `r006-89ec781c-9630-4f76-b9c4-a7d204828d61`

准备工作

请确保您拥有所需的访问权限。 要调用这些方法，必须分配一个或多个 IAM 访问角色，其中包括以下操作（取决于任何列出的条件）。 您可以访问 Cloud Identity and Access Management 控制面板的“用户”页面检查访问权限。

通过API收集信息以创建实例

创建实例前，需要了解实例的详细信息，如实例配置文件或要使用的映像。 通过调用以下 API 来收集信息：

您可以通过 available、partially_available （图像尚未在所有区域提供）或 deprecated 图像提供实例。 有关图像生命周期的更多信息，请参阅 自定义图像生命周期。

确认您使用的配置文件在计划创建实例的区域中可用。

如果计划使用其他账户的快照，请首先确保已获得正确的 IAM 授权。 然后，联系快照的所有者，获取快照的 CRN。

由于以下原因，某些配置文件可能无法使用：

• 虚拟服务器中的网络接口数量超出了配置文件限制。 您可以删除网络接口，从更多配置文件中进行选择。 有关详细信息，请参阅 调整虚拟服务器的大小。
• 所选图像包含的许可使用条款与该配置文件不兼容。 在这种情况下，请选择具有与所需配置文件兼容的允许使用表达式的图像。 有关更多信息，请参阅 为自定义图像添加允许使用表达式。

使用API创建实例

检索到所需信息后，您可以运行 POST /instances 方法创建一个实例。

通过API从库存或自定义映像中提供实例

您可以将图片的 id 子属性指定为 image 属性的值，从而为实例提供库存图片或自定义图片。

   curl -X POST "$vpc_api_endpoint/v1/instances?version=$api_version&generation=2" \
     -H "Authorization:$iam_token" \
     -d '{
           "name": "my-instance",
           "zone": {
             "name": "us-south-3"
           },
           "vpc": {
             "id": "'$vpc'"
           },
           "primary_network_interface": {
             "subnet": {
               "id": "'$subnet'"
             }
           },
           "keys":[{"id": "'$key'"}],
           "profile": {
             "name": "'$profile_name'"
            },
           "image": {
             "id": "'$image_id'"
            }
           }'