Antes de Iniciar

1. Certifique-se de que você tenha transferido por download, instalado e inicializado os plug-ins da CLI a seguir:

   • CLI da IBM Cloud
   • O plug-in do serviço de infraestrutura

   Para obter mais informações, consulte Referência de CLI.

2. Certifique-se de ter criado um IBM Cloud VPC.

Criar uma imagem a partir de um volume de inicialização conectado a uma instância

1. Para localizar a instância da qual você deseja criar uma imagem, liste as instâncias na região. Tome nota do ID da instância na saída de comando..

   ibmcloud is instances
   

2. Pare a instância em execução antes de criar a imagem do volume.

   ibmcloud is instance-stop INSTANCE_ID
   

3. Execute o [comando image-create](/docs/vpc?topic=vpc-vpc-reference#image-create) para criar uma imagem de um volume de inicialização. Especifique o ID do volume de origem.

   ibmcloud is image-create IMAGE_NAME [--source-volume VOLUME_ID]
   

   Consulte o seguinte exemplo:

   $ ibmcloud is image-create test-ifv-vol1 --source-volume ecc68c2f-96a1-4862-bc86-14f47e5d9ed8
   Creating image test-ifv-vol1 in resource group  under account Test Account as user test.user@ibm.com...
   ID                 5b2fd4ee-c636-44c4-9673-453fca36832e
   Name               test-ifv-vol1
   CRN                crn:v1:bluemix:public:is:us-south:a/a123456::image:5b2fd4ee-c636-44c4-9673-453fca36832e
   Status             pending
   Status reason      Code                   Message                                                More info
                      image_request_queued   The image request is accepted and waiting for system   -
                                             resources to become available.
   Operating system   Name             Architecture   Vendor   Version                 Dedicated host only
                      centos-8-amd64   amd64          CentOS   8.x - Minimal Install   false
   Source volume      ID                                     Name
                      ecc68c2f-96a1-4862-bc86-14f47e5d9ed8   aa-1-bx-boot-1617035447000
   Created            2021-05-20T09:43:16+08:00
   Visibility         private
   File size(GB)      -
   Encryption         none
   Resource group     f22cf48f-8836-4527-9131-1d7c73ba85e9
   

Planejar mudanças de status do ciclo de vida da imagem customizada usando a CLI

Ao criar uma imagem personalizada, você também pode programar as alterações de status do ciclo de vida da imagem personalizada IBM Cloud VPC ao mesmo tempo, usando as opções --deprecate-at ou --obsolete-at do comando ibmcloud is image-create.

Para planejar as propriedades deprecate-at ou obsolete-at, especifique uma data no formato de data e hora ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).

• YYYY é o ano com quatro dígitos.
• MM é o mês com dois dígitos.
• DD é o dia com dois dígitos.
• T separa as informações de data e hora..
• hh é as horas de dois dígitos.
• mm são os minutos com dois dígitos.
• +hh:mm ou -hh:mm é o fuso horário Universal Coordenado.

Por exemplo, a data de 30 de setembro de 2025 às 20:00 no fuso horário padrão central da América do Norte (CST) é 2025-09-30T20:00:00-06:00

Quando você agenda a data e a hora, não pode usar a data e a hora atuais. A data e a hora programadas devem ser futuras. Se você definir as datas e horas deprecate-at e obsolete-at, a data deprecate-at deverá ser posterior à data e à hora obsolete-at

ibmcloud is image-create IMAGE_NAME [--source-volume VOLUME_ID] [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

Antes de Iniciar

Antes de iniciar, certifique-se de configurar o ambiente da API.

Criando uma imagem por meio de uma inicialização de uma instância com a API.

1. Localize a instância e o volume de inicialização dos quais você deseja criar uma imagem. Obtenha a lista das instâncias disponíveis com o método list instance.

   curl -X GET "$vpc_api_endpoint/v1/instances?version=2024-06-11&generation=2" -H "Authorization: Bearer $iam_token"
   

2. Anote o ID da instância e use-o para recuperar os detalhes da instância.

   curl -X GET "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-06-11&generation=2" -H "Authorization: Bearer $iam_token"
   

   A resposta contém o nome, o ID e outros detalhes do volume de inicialização na seção volume_attachments.

   "volume_attachments": [
    {
     "device": {
       "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
       },
     "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
     "id": "a8a15363-a6f7-4f01-af60-715e85b28141",
     "name": "my-boot-volume-attachment",
     "volume": {
       "crn": "crn:[...]",
       "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
       "id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
       "name": "my-boot-volume"
       }
     }
   ]
   

3. Se a instância estiver em execução, pare-a especificando a ação stop em uma chamada POST /instances:

   curl -X POST \
   "$vpc_api_endpoint/v1/instances/{instance-id}/gen/actions?ersion=2024-06-11&generation=2"
   -H "Authorization: Bearer $iam_token"\
   -d '{"type":"stop"}'
   

4. Usando o ID do volume de inicialização, crie uma imagem. Consulte o seguinte exemplo:

    curl -X POST "$vpc_api_endpoint/v1/images?version=2024-06-11&generation=2"
    -H "Authorization: Bearer $iam_token"
    -d '{
         "name": "my-image",
         "source_volume": {"id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"}
         }`
   

   Na resposta de exemplo, source_volume indica o volume de inicialização usado para criar a imagem. Além disso, observe que a criptografia da imagem aparece como “ none ”, pois o volume de origem utilizou a criptografia gerenciada pelo IBM por padrão. Se você usar sua própria chave raiz, a resposta mostrará user-managed.

   {
    "created_at": "2021-05-20T00:05:13.873893Z",
    "crn": "crn:[...]",
    "encryption": "none",
    "file": {},
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "name": "test-ifv-boot-volume",
    "operating_system": {
      "architecture": "amd64",
      "display_name": "CentOS 8.x - Minimal Install (amd64)",
      "family": "CentOS",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/centos-8-amd64",
      "name": "centos-8-amd64",
      "vendor": "CentOS",
      "version": "8.x - Minimal Install"
      },
    "resource_group": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/resource_groups/3fad3f2204eb4998c3964d254ffcd771",
      "id": "3fad3f2204eb4998c3964d254ffcd771",
      "name": "Default"
      },
    "status": "pending",
    "status_reasons": [],
    "visibility": "private",
    "source_volume":  {
      "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
      "crn": "crn:[...]",
      "href": "",
      "name": "my-boot-volume"
      }
    }
   

Criação de uma imagem a partir de um volume e especificação de sua própria chave de criptografia

1. Conforme descrito na seção anterior. Localize a instância e as informações do volume de inicialização Pare a instância do .

2. Obtenha seu ID da instância de serviço de gerenciamento de chave e CRN da chave raiz.

   • Key Protect-Recuperando seu ID da instância e o nome do recurso em nuvem(CRN).

3. Faça uma solicitação API para criar uma imagem. Especifique a ID do volume e o CRN da chave raiz, conforme mostrado no exemplo a seguir.

   curl -X POST "$vpc_api_endpoint/v1/images?version=2024-06-11&generation=2"
   -H "Authorization: Bearer $iam_token"
       -d '{
            "name": "my-encrypted-image",
            "source_volume": {"id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"}
            "encryption_key":{"crn":"crn:[...key:...]"
           },
   

   A resposta inclui informações sobre a chave raiz.

   {
    "created_at": "2021-05-20T00:05:13.873893Z",
    "crn": "crn:[...]",
    "encryption_key": {
      "crn": "crn:[...key:...]"
      },
    "encryption": "user_managed",
    "file": {},
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "name": "test-ifv-boot-volume",
    "operating_system": {
      "architecture": "amd64",
      "display_name": "CentOS 8.x - Minimal Install (amd64)",
      "family": "CentOS",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/centos-8-amd64",
      "name": "centos-8-amd64",
      "vendor": "CentOS",
      "version": "8.x - Minimal Install"
      },
    "resource_group": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/resource_groups/3fad3f2204eb4998c3964d254ffcd771",
      "id": "3fad3f2204eb4998c3964d254ffcd771",
      "name": "Default"
      },
    "status": "pending",
    "status_reasons": [],
    "visibility": "private",
    "source_volume":  {
      "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
      "crn": "crn:[...]",
      "href": "",
      "name": "ifv-boot-vol"
      }
    }
   

Planejando mudanças de status de ciclo de vida de imagem customizada com a API...

Ao criar uma imagem a partir de um volume, você pode programar as alterações de status do ciclo de vida da imagem personalizada ao mesmo tempo.

Para planejar as propriedades deprecation_at ou obsolescence_at, especifique uma data no formato de data e hora ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm).

• YYYY é o ano com quatro dígitos
• MM é o mês com dois dígitos
• DD é o dia de dois dígitos
• T separa as informações de data e hora
• hh é as horas de dois dígitos
• mm são os minutos com dois dígitos
• +hh:mm ou -hh:mm é o fuso horário da Hora Universal Coordenada

Por exemplo, a data de 30 de setembro de 2023 às 20:00 no fuso horário padrão central da América do Norte (CST) é 2023-09-30T20:00:00-06:00

Quando você agenda a data e a hora, não pode usar a data e a hora atuais. A data e a hora programadas devem ser futuras. Se você definir as datas e horas deprecation_at e obsolescence_at, a data obsolescence_at deverá ser posterior à data e à hora deprecation_at

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
      "name": "test-ifv-boot-volume",
      "source_volume": {
    	  "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"
      },
      "deprecation_at": "2025-11-28T06:11:28+05:30",
      "obsolescence_at": "2025-12-28T06:11:28+05:30"
    }'