Creazione delle istanze del server virtuale

Prima di iniziare

• Scaricare, installare e inizializzare i seguenti plug-in CLI.

  • CLI IBM Cloud
  • Il plugin infrastructure-service

  Per ulteriori informazioni, vedere Impostazione dell'ambiente API e CLI.

• Assicurarsi di aver creato una VPC.

Raccogliere le informazioni per creare un'istanza dalla CLI

Pronto a creare un'istanza? Prima di poter eseguire il comando ibmcloud is instance-create, è necessario conoscere i dettagli dell'istanza, come il profilo o l'immagine che si desidera utilizzare.

Raccogliere le seguenti informazioni utilizzando i comandi associati.

Utilizza i seguenti comandi per determinare le informazioni necessarie per creare una nuova istanza.

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

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

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

Creare un'istanza dalla CLI

Utilizzare le seguenti informazioni per creare un'istanza con la CLI.

Prelievo da un'immagine stock o personalizzata

Una volta conosciuti i valori necessari, usarli per eseguire il comando ibmcloud is instance-create per eseguire il comando. È inoltre necessario specificare un nome univoco per l'istanza.

Utilizza i seguenti passaggi per creare un'istanza di server virtuale di base da un'immagine stock dalla CLI. Per impostazione predefinita, un volume di avvio viene collegato all'istanza quando questa viene creata. Per la maggior parte delle istanze di server virtuale, la dimensione predefinita del volume di avvio è di 100 GB. La dimensione predefinita del volume di avvio per un'istanza di server virtuale z/OS è di 250 GB.

1. Creare un'istanza con il seguente comando.

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

   Ad esempio, il seguente comando instance-create utilizza i valori di esempio che si trovano nella sezione Raccolta di informazioni.

   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 \
   

   Dove vengono utilizzati i seguenti valori di argomenti e opzioni

   • NOME ISTANZA: my-instance
   • VPC: r006-35b9cf35-616e-462e-a145-cf8db4062fcf
   • NOME ZONA: us-south-2
   • NOME PROFILO: bx2-2x8
   • Sottorete: 0717-198db988-3b9b-4cfa-9dec-0206420d37d0
   • IMMAGINE: Debian 11 immagine r006-f83ce520-00b5-40c5-9938-a5c82a273f91
   • TASTI: r006-89ec781c-9630-4f76-b9c4-a7d204828d61

   La risposta varia a seconda dei valori delle opzioni utilizzate.

   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
   

   Le informazioni sulle interfacce di rete create per la nuova istanza non vengono restituite dopo la creazione dell'istanza. È possibile visualizzare le informazioni utilizzando il comando ibmcloud is instance INSTANCE come descritto nel passo seguente. Lo stato viene visualizzato in sospeso fino alla creazione dell'istanza.

   Per ulteriori informazioni su alcune funzioni aggiuntive che è possibile includere come opzioni di comando nel comando instance-create, vedere i seguenti argomenti: Creare un allegato di volume JSON, Abilitare o disabilitare il servizio di metadati e Creare un gruppo di collocamento.

   Per un elenco completo delle opzioni di comando, vedere ibmcloud is instance-create.

2. Quindi, eseguire il seguente comando instance details per verificare che sia possibile vedere la nuova istanza e visualizzare le interfacce di rete create per la nuova istanza. 0726_67b1179a-8b25-4ac9-8bc0-7f3027466ed0 è l'ID dell'istanza del server virtuale assegnato al momento della creazione dell'istanza nel passaggio precedente.

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

   Per questo esempio, viene visualizzata la seguente risposta. Lo stato è ora in esecuzione. Controllare la sezione Interfacce di rete per individuare l'ID dell'interfaccia di rete.

   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. Richiedere un indirizzo IP flottante da associare all'istanza utilizzando il seguente comando. Il nome specificato per l'IP flottante è my-floatingip. 0717-4db768bb-65c3-4045-8712-523e62eeabd2 è l'ID dell'interfaccia di rete per l'istanza del server virtuale visualizzata nel passaggio precedente.

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

   In questo esempio, la risposta è simile al seguente output.

   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
   

   Registrare l'IP flottante Address per utilizzarlo in seguito.

   Per un elenco completo delle opzioni del comando, vedere ibmcloud is floating-ip-reserve.

Hai bisogno di più aiuto? Puoi sempre eseguire ibmcloud is instance-create --help per visualizzare la guida per creare un'istanza.

Fornitura da un'immagine di catalogo privata

Una volta conosciuti i valori necessari, usarli per eseguire il comando ibmcloud is instance-create per eseguire il comando. È inoltre necessario specificare un nome univoco per l'istanza.

Procedere come segue per creare un'istanza di server virtuale da un'offerta di catalogo privato o da una versione di offerta di catalogo dalla CLI.

1. Creare un'istanza con il seguente comando.

   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 \
   

   Per esempio, se si crea un'istanza chiamata my-instance in us-south-2 e si utilizza il profilo bx2-2x8 e l'offerta di catalogo, il comando instance-create sarà simile all'esempio seguente.

   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/efe5afc483594adaa8325e2b4d1290df: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\
   

   Dove vengono utilizzati i seguenti valori di argomenti e opzioni.

   • NOME ISTANZA: my-instance
   • VPC: r006-35b9cf35-616e-462e-a145-cf8db4062fcf
   • NOME ZONA: us-south-2
   • NOME PROFILO: bx2-2x8
   • Sottorete: 0717-198db988-3b9b-4cfa-9dec-0206420d37d0
   • OFFERTA CATALOGO: è crn:v1:public:globalcatalog-collection:global:a/efe5afc483594adaa8325e2b4d1290df:0b322820-dafd-4b5e-b694-6465da6f008a:offering:136559f6-4588-4af2-8585-f3c625eee09d
   • TASTI: r006-89ec781c-9630-4f76-b9c4-a7d204828d61
   • GRUPPO DI COLLOCAMENTO: c5f1f366-b92a-4080-991a-aa5c2e33d96b

   Le informazioni sulle interfacce di rete create per la nuova istanza non vengono restituite dopo la creazione dell'istanza. È possibile visualizzare le informazioni utilizzando il comando ibmcloud is instance INSTANCE come descritto nel passo seguente.

   Lo stato dell'istanza del server virtuale viene visualizzato in sospeso fino alla creazione dell'istanza.

   Per un elenco completo delle opzioni di comando, vedere ibmcloud is instance-create.

2. Quindi, eseguire il seguente comando instance details per verificare che sia possibile vedere la nuova istanza e visualizzare le interfacce di rete create per la nuova istanza. Per INSTANCE, specificare l'ID assegnato alla nuova istanza del server virtuale nel passaggio precedente.

   ibmcloud is instance INSTANCE
   

   Lo stato è ora in esecuzione. Controllare la sezione Interfacce di rete per individuare l'ID dell'interfaccia di rete.

3. Richiedere un indirizzo IP flottante da associare all'istanza utilizzando il seguente comando. Per FLOATING_IP_NAME specificare un nome per l'IP flottante e per TARGET_INTERFACE specificare l'ID dell'interfaccia di rete identificata nel passaggio precedente.

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

   Registrare l'IP flottante Address per utilizzarlo in seguito.

   Per un elenco completo delle opzioni del comando, vedere ibmcloud is floating-ip-reserve.

Hai bisogno di più aiuto? Puoi sempre eseguire ibmcloud is instance-create --help per visualizzare la guida per creare un'istanza.

Fornitura da un volume esistente

Una volta conosciuti i valori necessari, usarli per eseguire il comando instance-create. È inoltre necessario specificare un nome univoco per l'istanza.

Procedere come segue per creare un'istanza di server virtuale da un volume avviabile che include un allegato al volume.

1. Creare un'istanza con il seguente comando.

   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 \
   

   Per esempio, se si crea un'istanza chiamata my-instance in us-south-1 e si utilizza il profilo bx2-2x8 e un volume di avvio esistente, il comando instance-create sarà simile all'esempio seguente.

   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\
   

   Per un file JSON di collegamenti volumi di esempio, vedi Crea un JSON di collegamenti volumi. È inoltre possibile includere i tag utente per i volumi nell'allegato del volume.

   Le informazioni sulle interfacce di rete create per la nuova istanza non vengono restituite dopo la creazione dell'istanza. È possibile visualizzare le informazioni utilizzando il comando ibmcloud is instance INSTANCE, come descritto nel passo successivo.

   Lo stato viene visualizzato in sospeso fino alla creazione dell'istanza.

   Per un elenco completo delle opzioni di comando, vedere ibmcloud is instance-create.

2. Quindi, eseguire il seguente comando instance details per verificare che sia possibile vedere la nuova istanza e visualizzare le interfacce di rete create per la nuova istanza. Per INSTANCE, specificare l'ID assegnato alla nuova istanza del server virtuale nel passaggio precedente.

   ibmcloud is instance INSTANCE
   

   Lo stato è ora in esecuzione. Controllare la sezione Interfacce di rete per individuare l'ID dell'interfaccia di rete.

3. Richiedere un indirizzo IP flottante da associare all'istanza utilizzando il seguente comando. Per FLOATING_IP_NAME specificare un nome per l'IP flottante e per TARGET_INTERFACE specificare l'ID dell'interfaccia di rete identificata nel passaggio precedente.

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

   Registrare l'IP flottante Address per utilizzarlo in seguito.

   Per un elenco completo delle opzioni del comando, vedere ibmcloud is floating-ip-reserve.

   Hai bisogno di più aiuto? Puoi sempre eseguire ibmcloud is instance-create --help per visualizzare la guida per creare un'istanza.

Creazione di un'istanza con più volumi di dati e allocazione dinamica della larghezza di banda del volume dalla CLI

Alcuni profili di calcolo supportano l'allocazione della larghezza di banda in pool per i volumi di dati. Per la maggior parte dei profili di calcolo, la proprietà --volume-bandwidth-qos-mode è predefinita a weighted. Quando si utilizza weighted, la larghezza di banda del volume viene allocata proporzionalmente tra i volumi di dati. Specificando il valore pooled, si abilita l'allocazione dinamica della larghezza di banda.

L'esempio seguente utilizza il comando ibmcloud is instance-create per creare l'istanza del server virtuale e specifica l'opzione --volume-bandwidth-qos-mode con il valore pooled.

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

Il file myvolume-attachments.json può includere fino a 12 volumi di dati da collegare al server virtuale. Vedi il seguente esempio:

[
  {"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}
]

Creare un'istanza con calcolo riservato

Seleziona disponibilità

Il computing riservato con Intel SGX per VPC e il computing riservato con Intel TDX per VPC sono disponibili nelle regioni Dallas (us-south), Washington DC (us-east) e Francoforte (eu-de).

I volumi di avvio di seconda generazione con il profilo di volume sdp non supportano ancora l'avvio sicuro. Se è richiesto l'avvio sicuro, utilizzare un volume di avvio con un profilo di volume di prima generazione.

Una volta conosciuti i valori necessari, usarli per eseguire il comando ibmcloud is instance-create. È inoltre necessario specificare un nome univoco per l'istanza.

Per confidential-compute-mode è necessario specificare l'opzione sgx o tdx.

Procedere come segue per creare un'istanza di server virtuale di base che abilita l'elaborazione riservata.

Creare un'istanza con il seguente comando.

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

Ad esempio, il seguente comando instance-create utilizza i valori di esempio che si trovano nella sezione Raccolta di informazioni.

   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 \

Dove vengono utilizzati i seguenti valori di argomenti e opzioni

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

Creare un'istanza con avvio sicuro

Seleziona disponibilità

Il calcolo riservato con Intel SGX per VPC è disponibile solo nelle regioni di Dallas (us-south) e Francoforte (eu-de). I volumi di avvio di seconda generazione con il profilo di volume sdp non supportano ancora l'avvio sicuro. Se è richiesto l'avvio sicuro, utilizzare un volume di avvio con un profilo di volume di prima generazione.

Una volta conosciuti i valori necessari, usarli per eseguire il comando ibmcloud is instance-create. È inoltre necessario specificare un nome univoco per l'istanza.

Per enable-secure-boot, è necessario specificare true o false. Il valore predefinito è false.

Procedere come segue per creare un'istanza di server virtuale di base che abiliti l'avvio sicuro.

Creare un'istanza con il seguente comando.

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

Ad esempio, il seguente comando instance-create utilizza i valori di esempio che si trovano nella sezione Raccolta di informazioni.

   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 \

Dove vengono utilizzati i seguenti valori di argomenti e opzioni

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

Prima di iniziare

Assicuratevi di avere l'accesso richiesto. Per richiamare questi metodi, è necessario assegnare uno o più ruoli di accesso IAM che includono le seguenti azioni, a seconda delle condizioni elencate. È possibile verificare il proprio accesso accedendo alla pagina Utenti della dashboard di Cloud Identity and Access Management.

Raccogliere le informazioni per creare un'istanza con l'API

Prima di creare un'istanza, è necessario conoscere i dettagli dell'istanza, come il profilo dell'istanza o l'immagine che si desidera utilizzare. Raccogliere informazioni effettuando le seguenti chiamate API:

Se si intende utilizzare uno snapshot da un altro account, assicurarsi prima che siano presenti le giuste autorizzazioni IAM. Quindi, contattare il proprietario dell'istantanea per ottenere il CRN dell'istantanea.

Alcuni profili potrebbero non essere disponibili per uno dei seguenti motivi:

• Il numero di interfacce di rete del server virtuale supera i limiti del profilo. È possibile rimuovere le interfacce di rete per selezionare più profili. Per ulteriori informazioni, vedere Ridimensionamento di un server virtuale.
• L'immagine selezionata contiene un'espressione di utilizzo consentito che non è compatibile con il profilo. In questi casi, selezionare un'immagine con un'espressione di uso consentito compatibile con il profilo desiderato. Per ulteriori informazioni, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.

Creare un'istanza con l'API

Dopo aver recuperato le informazioni necessarie, è possibile eseguire il metodo POST /instances per creare un'istanza.

Fornire un'istanza da un'immagine stock o personalizzata con l'API

È possibile dotare un'istanza di un'immagine stock o personalizzata specificando la sottoproprietà id dell'immagine come valore della proprietà 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'"
            }
           }'

Fornire un'istanza da un'immagine del catalogo privato con l'API

È possibile eseguire il provisioning di un'istanza con un'immagine del catalogo privato specificando il valore dell'immagine offering_crn o la sottoproprietà version_crn come valore della proprietà catalog_offering.

• Creare un'istanza utilizzando un'immagine del catalogo privato dalla versione più recente di un'offerta di prodotti del catalogo.

  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'"
           },
          "catalog_offering": {
            "offering": {
              "crn": "'$offering_crn'"
           }
          }'
  

• Creare un'istanza utilizzando un'immagine di catalogo privata da una versione specifica di un'offerta di prodotti di catalogo.

  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'"
           },
          "catalog_offering": {
            "version": {
              "crn": "'$version_crn'"
           }
          }'
  

Fornitura da un volume esistente

Il riutilizzo di un volume avviabile esistente è più veloce della creazione di un nuovo volume da un'istantanea o da un'immagine.

È possibile eseguire il provisioning di un'istanza con un volume esistente specificando la sottoproprietà id o crn del volume esistente come valore della proprietà boot_volume_attachment.

Il volume avviabile esistente deve essere un volume avviabile non collegato con la stessa architettura del profilo di istanza. Utilizzare il filtro Elenco volumi e fare riferimento alle proprietà attachment_state e operating_system per visualizzare l'idoneità di un volume.

Ad esempio, per vedere i volumi non collegati in us-south-1 con un sistema operativo x86.

curl -X GET "$vpc_api_endpoint/v1/volumes?version=2023-02-08&generation=2?attachment_state=unattached&zone.name=us-south-1&operating_system.architecture=amd64"
-H "Authorization: Bearer $iam_token"

Per impostazione predefinita, un volume di avvio creato come parte del provisioning di un'istanza di server virtuale viene eliminato quando l'istanza viene cancellata. È possibile modificare questo comportamento impostando la proprietà delete_volume_on_instance_delete su false quando si crea l'istanza o si aggiorna l'allegato del volume di avvio.

Utilizzare il metodo POST /instances per creare un'istanza con le informazioni raccolte. La seguente chiamata è un esempio di provisioning di un'istanza utilizzando un volume di avvio esistente.

curl -X POST "$vpc_api_endpoint/v1/instances?version=2023-02-08&generation=2"
-H "Authorization: Bearer $iam_token"
-d '{
  "boot_volume_attachment": {
    "volume": {
      "id": "r006-feec3e99-995e-4e8f-896b-48b42c7d05a7"
    }
  },
  "keys": [
    {
      "id": "363f6d70-0000-0001-0000-00000013b96c"
    }
  ],
  "name": "my-instance",
  "placement_target": {
    "id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"
  },
  "primary_network_interface": {
    "name": "my-network-interface",
    "subnet": {
      "id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"
    }
  },
  "profile": {
    "name": "bx2-2x8"
  },
  "volume_attachments": [
    {
      "volume": {
        "capacity": 1000,
        "encryption_key": {
          "crn": "crn:[...]"
        },
        "name": "my-data-volume",
        "profile": {
          "name": "5iops-tier"
        }
      }
    }
  ],
  "vpc": {
    "id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"
  },
  "zone": {
    "name": "us-south-1"
  }
}'

I volumi di avvio di seconda generazione con il profilo di volume sdp non supportano ancora l'avvio sicuro. Se è richiesto l'avvio sicuro, utilizzare un volume di avvio con un profilo di volume di prima generazione.

Per ulteriori informazioni, vedere Creare un'istanza.

Ripristinare un volume di avvio da una snapshot e utilizzarlo per il provisioning di una nuova istanza

È possibile ripristinare un volume di avvio da una snapshot avviabile e quindi utilizzare quel volume di avvio quando si esegue il provisioning di un'istanza. Lo snapshot avviabile deve avere lo stesso sistema operativo e la stessa architettura del profilo dell'istanza.

Nella richiesta POST /instances, specificare la proprietà boot_volume_attachment e l'ID dello snapshot avviabile nella sottoproprietà source_snapshot. In alternativa, è possibile utilizzare il nome o il CRN dello snapshot. Vedi il seguente esempio.

curl -X POST \
"$vpc_api_endpoint/v1/instances?version=2023-03-07&generation=2" \
-H "Authorization: $iam_token" \
-H "Content-Type: application/json" \
-d '{
      "boot_volume_attachment": {
        "delete_volume_on_instance_delete": true,
        "volume": {
            "profile": {
                "name": "general-purpose"
            },
            "source_snapshot": {
                "id": "eb373975-4171-4d91-81d2-c49efb033753"
            }
        }
     },
     .
     .
     .
  }'

Per ulteriori informazioni sul ripristino di un volume con l'API, vedere Ripristino di un volume da un'istantanea con l'API.

Creazione di un'istanza con più volumi di dati e allocazione dinamica della larghezza di banda del volume con l'API

Alcuni profili di calcolo supportano l'allocazione della larghezza di banda in pool per i volumi di dati. È possibile eseguire il provisioning programmatico di un'istanza di server virtuale con più volumi di dati chiamando il metodo instances, come mostrato nella seguente richiesta di esempio. L'esempio crea un server virtuale in us-south-2 con un volume di avvio da 250 GB e tre volumi di dati da 3 TB. storage_qos_mode è impostato su pooled per abilitare l'allocazione dinamica della larghezza di banda del volume.

curl -X POST "$vpc_api_endpoint/v1/instances?version=2024-07-12&generation=2" \
-H "Authorization: $iam_token" \
-H "Content-Type: application/json" \
-d '{
  "zone": {"name": "us-south-2"},
  "resource_group": {"id": "db8e8d865a83e0aae03f25a492c5b39e"},
  "name": "my-gen3-instance",
  "vpc": {"id": "r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b"},
  "user_data": "",
  "profile": {"name": "cx3d-8x20"},
  "keys": [{"id": "r006-68f8333a-1169-42da-ba01-75268bac8362"}],
  "volume_attachments": [
    {"volume": {
        "name": "my-data-volume-a",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
      "delete_volume_on_instance_delete": false},
    {"volume": {
        "name": "my-data-volume-b",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
      "delete_volume_on_instance_delete": false
    },
    {"volume": {
        "name": "my-data-volume-c",
        "capacity": 3000,
        "profile": {"name": "5iops-tier"},
        "user_tags": []},
      "delete_volume_on_instance_delete": false
      }],
  "boot_volume_attachment": {
    "volume": {
      "name": "my-gen3-instance-boot-1720810915000",
      "capacity": 250,
      "profile": {"name": "general-purpose"},
      "user_tags": []},
    "delete_volume_on_instance_delete": true
  },
  "metadata_service": {"enabled": false},
  "primary_network_attachment": {
    "name": "eth0",
    "virtual_network_interface": {
      "allow_ip_spoofing": false,
      "auto_delete": true,
      "enable_infrastructure_nat": true,
      "primary_ip": {"auto_delete": true},
      "subnet": {"id": "0726-298acd6c-e71e-4204-a04f-fe4a4dd89805"},
      "security_groups": [{"id": "r006-ccdd1f58-f0f2-4ea0-8774-a24bbe61b5d9"}],
      "protocol_state_filtering_mode": "auto"}
  },
  "network_attachments": [],
  "image": {"id": "r006-534ef2ac-6158-45b3-9657-57629fa85305"},
  "enable_secure_boot": false
  "storage_qos_mode": pooled
}'

Creare un'istanza con calcolo riservato

Seleziona disponibilità

Il computing riservato con Intel SGX per VPC e il computing riservato con Intel TDX per VPC sono disponibili nelle regioni Dallas (us-south), Washington DC (us-east) e Francoforte (eu-de).

I volumi di avvio di seconda generazione con il profilo di volume sdp non supportano ancora l'avvio sicuro. Se è richiesto l'avvio sicuro, utilizzare un volume di avvio con un profilo di volume di prima generazione.

Per fornire un'istanza con calcolo riservato, aggiungere la proprietà confidential_compute_mode e impostarla su sgx o tdx.

   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'"
            },
            "confidential_compute_mode": "sgx"
           }'

Creazione di un'istanza con avvio sicuro

Per eseguire il provisioning di un'istanza con avvio sicuro, aggiungere la proprietà enable_secure_boot e impostarla su true.

   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'"
            },
            "enable_secure_boot": "true"
           }'

I volumi di avvio di seconda generazione con il profilo di volume sdp non supportano ancora l'avvio sicuro. Se è richiesto l'avvio sicuro, utilizzare un volume di avvio con un profilo di volume di prima generazione.

Prima di iniziare

Assicurarsi di aver impostato Terraform per VPC.

Creare un catalogo privato

Questo passo è facoltativo. Se si intende condividere immagini da un catalogo privato, è necessario creare prima il catalogo privato. Se si seleziona un'immagine del catalogo che appartiene a un account diverso, si consiglia di consultare la sezione Utilizzo di riferimenti a immagini di più account in un catalogo privato in Terraform per ulteriori considerazioni e limitazioni.

Raccogliere informazioni per creare un'istanza utilizzando Terraform

Pronto a creare un'istanza? Prima di poter eseguire il comando ibm_is_instance, è necessario conoscere i dettagli dell'istanza, come il profilo o l'immagine che si desidera utilizzare.

Raccogliere le seguenti informazioni utilizzando il comando DataSource.

1. Raccogliere i dettagli del profilo dell'istanza. Eseguire il seguente comando per il profilo selezionato. Per un elenco dei profili disponibili, vedere i profili delle istanze x86. Per ulteriori informazioni, vedere la documentazione di Terraform su ibm_is_instance_profiles. Utilizzare un profilo di istanza facendo riferimento all'origine dati del profilo di istanza. Per ulteriori informazioni, vedere la documentazione di Terraform su ibm_is_instance_profile.

   • Raccogliere i dettagli del profilo di istanza per un profilo specifico

   data "ibm_is_instance_profile" "example_profile" {
      name = "bx2-2x8"
   }
   

2. Elenca le immagini disponibili per la creazione della tua istanza. È possibile utilizzare un'immagine stock, un'immagine personalizzata dal proprio account o un'immagine condivisa con l'account da un catalogo privato. Per ulteriori informazioni, vedere la documentazione di Terraform su ibm_is_image. Se si intende usare un'immagine condivisa da un catalogo privato, consultare la documentazione di Terraform su ibm_cm_version o ibm_cm_offering_instance.

   Espressioni di uso consentito: L'immagine selezionata determina i profili disponibili per creare l'istanza del server virtuale. Durante la creazione di un'istanza di server virtuale con immagini che utilizzano un'espressione di uso consentito, le informazioni fornite nelle proprietà di uso consentito vengono valutate rispetto a una potenziale istanza di server virtuale per determinare se l'immagine può essere utilizzata per creare l'istanza di server virtuale. Le immagini stock utilizzano espressioni definite di uso consentito. È necessario definire le espressioni di uso consentito per le immagini personalizzate. Per ulteriori informazioni, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.

   • Selezionare un'immagine stock o un'immagine personalizzata dal proprio account per l'istanza.

     data "ibm_is_image" "example_image" {
        name = "ibm-centos-7-6-minimal-amd64-2"
     }
     

   • Selezionare un'immagine condivisa da un catalogo privato per l'istanza. Per ulteriori informazioni, vedere la documentazione di Terraform su ibm_is_images. È possibile selezionare un'immagine dall'elenco per creare l'istanza, come mostrato nella sezione Vai alla sezione Creare un'istanza usando Terraform.

   Se si seleziona un'immagine di catalogo appartenente a un altro account, è necessario esaminare ulteriori considerazioni e limitazioni. Vedere Utilizzo di riferimenti di immagini tra account in un catalogo privato in Terraform.

   • Per elencare tutte le offerte di immagini del catalogo privato disponibili, eseguire il seguente comando.

     data "ibm_is_images" "example_images" {
     catalog_managed = true
     }
     

   • Elencare i profili e le immagini compatibili utilizzando le espressioni di uso consentito

     • Elenco dei profili di istanza compatibili con un'immagine

       data "ibm_is_image_instance_profiles" "testacc_image_instance_profiles" {
       identifier = "r134-0950e619-325e-446e-b895-e0bdd21dd1ea"
       }
       

     • Elenco dei profili di istanza compatibili con un volume

       data "ibm_is_volume_instance_profiles" "testacc_volume_instance_profiles" {
       identifier = "r134-0950e619-325e-446e-b895-e0bdd21dd1ea"
       }
       

     • Elenco dei profili di istanza compatibili con un'istantanea

       data "ibm_is_snapshot_instance_profiles" "testacc_snapshot_instance_profiles" {
       identifier = "r134-0950e619-325e-446e-b895-e0bdd21dd1ea"
       }
       

3. Creare una risorsa VPC o utilizzare una VPC esistente facendo riferimento all'origine dati VPC. Per ulteriori informazioni, consultare la documentazione di Terraform su ibm_is_vpc.

   resource "ibm_is_vpc" "example_vpc" {
      name = "example-vpc"
   }
   

4. Creare una risorsa di sottorete o utilizzare una sottorete esistente facendo riferimento all'origine dati della sottorete. Per ulteriori informazioni, vedere la documentazione di Terraform su ibm_is_subnet.

   resource "ibm_is_subnet" "example_subnet" {
      name            = "example-subnet"
      vpc             = ibm_is_vpc.example_vpc.id
      zone            = "us-south-1"
      ipv4_cidr_block = "10.240.0.0/24"
   }
   

5. Creare una risorsa ssh-key o utilizzare una chiave ssh esistente facendo riferimento all'origine dati ssh-key. Per ulteriori informazioni, vedere la documentazione di Terraform su ibm_is_ssh_keys.

   resource "ibm_is_ssh_key" "example_sshkey" {
      name       = "example-sshkey"
      type       = "rsa"
      public_key = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCKVmnMOlHKcZK8tpt3MP1lqOLAcqcJzhsvJcjscgVERRN7/9484SOBJ3HSKxxNG5JN8owAjy5f9yYwcUg+JaUVuytn5Pv3aeYROHGGg+5G346xaq3DAwX6Y5ykr2fvjObgncQBnuU5KHWCECO/4h8uWuwh/kfniXPVjFToc+gnkqA+3RKpAecZhFXwfalQ9mMuYGFxn+fwn8cYEApsJbsEmb0iJwPiZ5hjFC8wREuiTlhPHDgkBLOiycd20op2nXzDbHfCHInquEe/gYxEitALONxm0swBOwJZwlTDOB7C6y2dzlrtxr1L59m7pCkWI4EtTRLvleehBoj3u7jB4usR"
   }
   

   Le chiavi SSH possono essere RSA o Ed25519. È possibile generare nuove coppie di chiavi RSA utilizzando l'interfaccia utente. È possibile caricare chiavi RSA e ED25519 SSH preesistenti. Ed25519 può essere utilizzato solo se il sistema operativo supporta questo tipo di chiave. Ed25519 non può essere utilizzato con immagini Windows o VMware.

6. Creare una risorsa subnet_reserved_ip o utilizzare una subnet_reserved_ip esistente facendo riferimento all'origine dati subnet_reserved_ip. Per ulteriori informazioni, vedere la documentazione di Terraform su ibm_is_subnet_reserved_ip.

   resource "ibm_is_subnet_reserved_ip" "example_reserved_ip" {
      subnet    = ibm_is_subnet.example_subnet.id
      name      = "example-reserved-ip1"
      address   = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "13")}"
   }
   

Creare un'istanza utilizzando Terraform

Per utilizzare Terraform, scarica la CLI Terraform e configura il IBM Cloud plug-in Provider. Per ulteriori informazioni, si veda Iniziare con Terraform.

Creare l'istanza utilizzando uno dei seguenti esempi. Per ulteriori informazioni, vedere la documentazione di Terraform su ibm_is_instance.

Espressioni di uso consentito: L'immagine selezionata determina i profili disponibili per creare l'istanza del server virtuale. Durante la creazione di un'istanza di server virtuale con immagini che utilizzano un'espressione di uso consentito, le informazioni fornite nelle proprietà di uso consentito vengono valutate rispetto a una potenziale istanza di server virtuale per determinare se l'immagine può essere utilizzata per creare l'istanza di server virtuale. Le immagini stock utilizzano espressioni definite di uso consentito. È necessario definire le espressioni di uso consentito per le immagini personalizzate. Per ulteriori informazioni, vedere Aggiunta di espressioni di uso consentito alle immagini personalizzate.

Eseguire uno dei seguenti comandi di Terraform in base all'immagine che si intende utilizzare.

• Creare un'istanza utilizzando un'immagine stock o un'immagine personalizzata dal proprio account per l'istanza.

  resource "ibm_is_instance" "example_instance" {
    name    = "example-instance-reserved-ip"
    image   = data.ibm_is_image.example_image.id
    profile = data.ibm_is_instance_profile.example_profile.name
  
    primary_network_interface {
      name   = "eth0"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        reserved_ip = ibm_is_subnet_reserved_ip.example_reserved_ip.reserved_ip
      }
    }
    network_interfaces {
      name   = "eth1"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        name = "example-reserved-ip1"
        auto_delete = true
        address = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "14")}"
      }
    }
  
    vpc  = ibm_is_vpc.example_vpc.id
    zone = "us-south-1"
    keys = [ibm_is_ssh_key.example_sshkey.id]
  }
  

• Creare un'istanza che utilizzi un'immagine gestita da un catalogo privato. Quando si specifica il profilo di volume di seconda generazione per il volume di avvio, è possibile specificare limiti personalizzati di capacità, IOPS e larghezza di banda.

  resource "ibm_is_instance" "example_instance" {
    name    = "example-instance-reserved-ip"
    image   = data.ibm_is_image.example_image.id
    profile = data.ibm_is_instance_profile.example_profile.name
  
    primary_network_interface {
      name   = "eth0"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        reserved_ip = ibm_is_subnet_reserved_ip.example_reserved_ip.reserved_ip
      }
    }
    network_interfaces {
      name   = "eth1"
      subnet = ibm_is_subnet.example_subnet.id
      primary_ip {
        name = "example-reserved-ip1"
        auto_delete = true
        address = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "14")}"
      }
    }
  
    vpc  = ibm_is_vpc.example_vpc.id
    zone = "us-south-1"
    keys = [ibm_is_ssh_key.example_sshkey.id]
  
    boot_volume {
      name           = "example-boot-volume"
      profile        = "sdp"
      size           = 250
      iops           = 3000
      bandwidth      = 1000
      encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
     }
  }
  

  • Creare un'istanza utilizzando uno snapshot con un'espressione di uso consentito dal proprio account per la propria istanza.

  resource "ibm_is_instance" "testacc_instance" {
    name    = "example-instance"
    profile = "cx2-2x4"
    primary_network_interface {
      subnet = ibm_is_subnet.testacc_subnet.id
    }
    vpc  = ibm_is_vpc.testacc_vpc.id
    zone = "us-south-1"
    keys = [ibm_is_ssh_key.testacc_sshkey.id]
    boot_volume {
      name     = "example-boot-volume"
      snapshot = ibm_is_snapshot.testacc_snapshot.id
      allowed_use {
        api_version       = "2025-06-05"
        bare_metal_server = "true"
        instance          = "true"
      }
    }
  }