Criando e anexando um volume Block Storage for VPC ao criar uma instância

1. No IBM Cloud console, clique no ícone Navigation menu > Infrastructure > Compute > Virtual server instances.
2. Na lista de instâncias de servidor virtual, clique em Criar..
3. Na página Servidor virtual para fornecimento de VPC, selecione Tipo de servidor, Local, S.O., Perfil, Grupo de posicionamento e assim por diante. Para obter mais informações sobre o fornecimento da instância, consulte Criando uma instância de servidor virtual com a UI.
4. Os detalhes do volume de inicialização que deve ser criado são exibidos na página. Você pode editar o volume de inicialização clicando no ícone alterar a capacidade, definir a criptografia e adicionar tags de usuário para identificar esse recurso. Você pode alterar o perfil para general-purpose. As contas incluídas na lista de permissões também podem selecionar o perfil “ sdp ”.
5. Para criar um volume de dados e anexá-lo à instância, na seção Volumes de dados seção da página de provisionamento de instância, clique em Criar. No painel lateral, especifique os detalhes do volume.
   1. Você pode criar um volume de dados em branco ou criar um volume com dados importados de um instantâneo. Se você escolher Importar snapshot existente, selecione um snapshot disponível na lista. Se você escolher Importar snapshot por CRN, tenha o CRN do snapshot pronto para ser inserido.
   2. Especifique um nome exclusivo e significativo para o seu volume. Por exemplo, pode ser um nome que descreva a função do seu recurso de computação ou da sua carga de trabalho. O nome do volume deve começar com uma letra minúscula. O nome pode ter até 63 caracteres alfanuméricos em minúsculas e incluir o hífen (-). Os nomes dos volumes devem ser exclusivos de sua VPC. Você pode editar o nome mais tarde, se quiser.
   3. O recurso de exclusão automática está desativado por padrão. Se desejar que o volume seja excluído quando a instância do servidor virtual anexada for excluída, clique no botão de alternância para ativar o recurso.
   4. O grupo de recursos e o local são herdados da instância. Esses valores não podem ser alterados.
   5. Você pode especificar tags de usuário opcionais para associar a esse volume. Para obter mais informações sobre como organizar recursos com tags de usuário, consulte Trabalhando com tags.
   6. Na seção “Criptografia”, a criptografia gerenciada pelo provedor está ativada por padrão. Para usar sua própria chave de criptografia, clique no botão de alternância para ativar a criptografia gerenciada pelo cliente. Se você já tiver uma instância do KMS e uma chave raiz, o sistema as seleciona automaticamente para você. Você pode clicar no ícone para selecionar outra chave ou instância. Para localizar sua chave de criptografia, selecione uma das seguintes opções:
      • Localizar por instância: O painel possui três etapas:
        1. Selecionar instância do KMS: A lista exibe o nome, o ID, o tipo (Padrão ou Dedicado) e a localização de cada instância disponível do Serviço de Gerenciamento de Chaves ( Key Protect ). Selecione uma instância e clique em “Selecionar ”. Se você ainda não tiver uma instância, clique em “Criar” para provisionar uma.
        2. Chave associada: A lista exibe o nome, o ID, a data da última atualização, os aliases e o chaveiro de cada chave raiz disponível. Selecione uma tecla e clique em “Selecionar ”. Se você ainda não tiver uma chave, clique em “Criar nova chave ”.
        3. Revisão: Confirme suas seleções, incluindo o serviço de gerenciamento de chaves, o tipo de instância, o nome da instância e o nome da chave. A seção “Autorização do serviço” mostra se a autorização necessária entre o Block Storage for VPC e a instância do KMS já está em vigor. Caso contrário, você pode permitir que o Key Protect crie a autorização automaticamente ou criá-la manualmente. Para obter mais informações, consulte “Estabelecimento de autorizações entre serviços” em Block Storage for VPC. Clique em “Confirmar” para aplicar sua seleção e retornar à configuração do volume.
      • Locate by CRN: digite o CRN da chave raiz do cliente a ser usada para criptografar o volume. Escolha esta opção se estiver usando o CRK de outra conta. Clique em “Selecionar” para avançar para a etapa “Revisão ”, descrita na opção “Localizar por instância ”.
   7. Selecione o perfil de armazenamento. Se você optar por importar dados de um instantâneo, o valor de geração de armazenamento do instantâneo deverá corresponder ao valor de geração de armazenamento do perfil de volume selecionado.
      • As contas incluídas na lista de permissões podem selecionar o perfil “ sdp ” para especificar uma capacidade de volume de armazenamento de até 32.000 GB, com limites personalizados de IOPS e taxa de transferência. As contas que não constam na lista de permissões não veem essa opção.
      • Quando quiser usar um volume de primeira geração com níveis de IOPS predefinidos, você poderá selecionar um dos perfis em camadas. Quando você seleciona a função geral, 5iops-tier, ou 10iops-tier tudo o que você precisa especificar é a capacidade do volume.
      • Quando os requisitos de desempenho do seu aplicativo não se enquadram em nenhum dos níveis de IOPS, você pode escolher o perfil personalizado. Especifique o tamanho de seu volume e o IOPS no intervalo apropriado para a capacidade do volume. O tamanho do volume pode variar de 10 a 16.000 GB. Conforme você digita o valor de IOPS, a UI mostra o intervalo aceitável. Você também pode clicar no link do tamanho do armazenamento para ver o tamanho e os intervalos de IOPS do perfil de volume personalizado.
   8. Você pode aplicar uma política de backup ao criar o volume. Clique em Aplicar e, em seguida, selecione uma política existente na lista suspensa no painel lateral. Selecione as tags a serem aplicadas ao alvo e clique em Apply policy and tags (Aplicar política e tags ).
   9. Clique em Salvar.
6. Você retorna à página de provisionamento de instância virtual para concluir a definição dos atributos restantes de sua instância de servidor virtual.
7. Quando estiver satisfeito com suas escolhas, clique em Criar servidor virtual.

Um volume do Block Storage for VPC pode ser vinculado a apenas um servidor virtual por vez. Na página de resumo do volume “ Block Storage for VPC ”, é possível visualizar detalhes sobre a instância do servidor virtual selecionando o nome da instância na seção “Instâncias conectadas ”.

Criando e anexando um volume Block Storage for VPC por meio de uma instância existente

É possível criar um volume Block Storage for VPC por meio de uma instância existente.

1. Acesse a lista de instâncias de servidores virtuais. No IBM Cloud console, clique no ícone Navigation menu > Infrastructure > Compute > Virtual server instances.
2. Selecione uma instância da lista.
3. Na página de detalhes da instância, clique na guia Storage (Armazenamento ).
4. Na lista de volumes de armazenamento anexados, clique em Anexar.
5. No painel lateral, clique na seta para baixo em Volumes de bloco e selecione Criar um volume de dados O painel lateral expande com campos para definir o volume.
   1. Se você tiver criado capturas instantâneas de volume anteriormente, a opção para importar uma se tornará disponível Clique no botão de alternância para Importar do instantâneo e selecione um instantâneo na lista ou localize o instantâneo por seu CRN.
   2. Especifique um nome exclusivo e significativo para o seu volume. Por exemplo, pode ser um nome que descreva a função do seu recurso de computação ou da sua carga de trabalho. O nome do volume deve começar com uma letra minúscula. O nome pode ter até 63 caracteres alfanuméricos em minúsculas e incluir o hífen (-). Os nomes dos volumes devem ser exclusivos de sua VPC. Você pode editar o nome mais tarde, se quiser.
   3. O recurso de exclusão automática está desativado por padrão. Se desejar que o volume seja excluído quando a instância do servidor virtual anexada for excluída, clique no botão de alternância para ativar o recurso.
   4. O grupo de recursos e o local são herdados da instância. Esses valores não podem ser alterados.
   5. Você pode especificar tags de usuário opcionais para associar a esse volume. Para obter mais informações sobre como organizar recursos com tags de usuário, consulte Trabalhando com tags.
   6. Na seção “Criptografia”, a criptografia gerenciada pelo provedor está ativada por padrão. Para usar sua própria chave de criptografia, clique no botão de alternância para ativar a criptografia gerenciada pelo cliente. Se você já tiver uma instância do KMS e uma chave raiz, o sistema as seleciona automaticamente para você. Você pode clicar no ícone para selecionar outra chave ou instância. Para localizar sua chave de criptografia, selecione uma das seguintes opções:
      • Localizar por instância: O painel possui três etapas:
        1. Selecionar instância do KMS: A lista exibe o nome, o ID, o tipo (Padrão ou Dedicado) e a localização de cada instância disponível do Serviço de Gerenciamento de Chaves ( Key Protect ). Selecione uma instância e clique em “Selecionar ”. Se você ainda não tiver uma instância, clique em “Criar” para provisionar uma.
        2. Chave associada: A lista exibe o nome, o ID, a data da última atualização, os aliases e o chaveiro de cada chave raiz disponível. Selecione uma tecla e clique em “Selecionar ”. Se você ainda não tiver uma chave, clique em “Criar nova chave ”.
        3. Revisão: Confirme suas seleções, incluindo o serviço de gerenciamento de chaves, o tipo de instância, o nome da instância e o nome da chave. A seção “Autorização do serviço” mostra se a autorização necessária entre o Block Storage for VPC e a instância do KMS já está em vigor. Caso contrário, você pode permitir que o Key Protect crie a autorização automaticamente ou criá-la manualmente. Para obter mais informações, consulte “Estabelecimento de autorizações entre serviços” em Block Storage for VPC. Clique em “Confirmar” para aplicar sua seleção e retornar à configuração do volume.
      • Locate by CRN: digite o CRN da chave raiz do cliente a ser usada para criptografar o volume. Escolha esta opção se estiver usando o CRK de outra conta. Clique em “Selecionar” para avançar para a etapa “Revisão ”, descrita na opção “Localizar por instância ”.
   7. Clique em Avançar.
   8. Selecione o perfil de armazenamento. Se você optar por importar dados de um instantâneo, o valor de geração de armazenamento do instantâneo deverá corresponder ao valor de geração de armazenamento do perfil de volume selecionado.
      • As contas incluídas na lista de permissões podem selecionar o perfil “ sdp ”. Em seguida, especifique a capacidade de seu volume, o limite de largura de banda necessário e o IOPS necessário. O tamanho do volume pode variar de 1 a 32.000 GB. Você pode especificar IOPS no intervalo de 100 a 64.000. O intervalo do limite de throughput é de 1.000 a 8.192 Mbps. As contas que não constam na lista de permissões não veem essa opção.
      • Você pode selecionar um dos perfis em camadas. Depois de selecionar o uso geral, 5iops-tier, ou 10iops-tier a próxima etapa é especificar a capacidade do volume. O tamanho do volume pode variar de 10 a 16.000 GB.
      • Você pode selecionar o perfil personalizado se os requisitos de desempenho do seu aplicativo não se enquadrarem em nenhum dos níveis de IOPS. Em seguida, especifique o tamanho de seu volume e o IOPS no intervalo apropriado para a capacidade do volume. O tamanho do volume pode variar de 10 a 16.000 GB. Conforme você digita o valor de IOPS, a UI mostra o intervalo aceitável. Você também pode clicar no link do tamanho do armazenamento para ver o tamanho e os intervalos de IOPS do perfil de volume personalizado.
   9. Clique em Salvar.
6. Ao concluir a definição do volume, clique em Salvar. O volume é criado e vinculado à instância. Você retornou à página de detalhes da instância. O novo volume aparece na lista de volumes de armazenamento.

Criando um volume Block Storage for VPC independente

É possível criar um volume “ Block Storage for VPC ” independentemente do provisionamento do servidor virtual e, posteriormente, associar o volume a uma instância.

1. No IBM Cloud console, clique no ícone Navigation menu > Infrastructure > Storage > Block Storage volumes.

2. Clique em Criar.

3. NoBlock Storage for VPC página de provisionamento, revise a Localização Informação. A geografia, a região e a zona são herdadas da VPC (por exemplo, América do Norte, Dallas,Dallas-1 ). Você pode selecionar uma zona diferente em sua localização no menu clicando no botão Editar ícone.

4. No Detalhes seção, você deve especificar o nome do volume e o grupo de recursos ao qual o volume será incluído. Opcionalmente, é possível incluir tags de usuário e de gerenciamento de acesso

   1. Especifique um nome significativo para o volume. Por exemplo, forneça um nome que descreva sua função de cálculo ou de carga de trabalho.

      O nome do volume deve começar com uma letra minúscula. O nome do volume pode ter até 63 caracteres alfanuméricos minúsculos e incluir o hífen (-). Os nomes dos volumes devem ser exclusivos em toda a infraestrutura da VPC. Você pode editar o nome mais tarde.

   2. Especifique um grupo de recursos.

   3. Especifique tags de usuário para organizar seus recursos e para uso por políticas de backup

   4. Especifique tags de gerenciamento de acesso que foram criadas no IAM para ajudar a gerenciar o acesso aos seus volumes.

5. No Configurações opcionais seção, você pode especificar se deseja criar o volume com dados de um instantâneo. Para mais informações, veja Crie um autônomoBlock Storage for VPC volume de um instantâneo. Além disso, você pode optar por aplicar uma política de backup. Clique em “Aplicar” para ver as apólices e os planos disponíveis.

6. Na seção Profile (Perfil ), é possível especificar o perfil de desempenho do seu volume, seus limites de desempenho e capacidade. Se você optar por importar dados de um instantâneo, o valor de geração de armazenamento do instantâneo deverá corresponder ao valor de geração de armazenamento do perfil de volume selecionado.

   • As contas incluídas na lista de permissões podem selecionar o perfil “ sdp ”. Em seguida, especifique a capacidade de seu volume, o limite de throughput solicitado e o IOPS necessário. O tamanho do volume pode variar de 1 a 32.000 GB. Você pode especificar IOPS no intervalo de 100 a 64.000. O intervalo do limite de throughput é de 1.000 a 8.192 Mbps. As contas que não constam na lista de permissões não veem essa opção.
   • Você pode selecionar um dos perfis em camadas. Depois de selecionar o uso geral, 5iops-tier, ou 10iops-tier a próxima etapa é especificar a capacidade do volume. O tamanho do volume pode variar de 10 a 16.000 GB.
   • Você pode selecionar o perfil personalizado se os requisitos de desempenho do seu aplicativo não se enquadrarem em nenhum dos níveis de IOPS. Em seguida, especifique o tamanho de seu volume e o IOPS no intervalo apropriado para a capacidade do volume. Conforme você digita o valor de IOPS, a UI mostra o intervalo aceitável. Você também pode clicar no link do tamanho do armazenamento para ver o tamanho e os intervalos de IOPS do perfil de volume personalizado.

7. Na seção “Criptografia em repouso”, você pode optar por manter a criptografia com chaves gerenciadas pel IBM, que está ativada por padrão em todos os volumes. Ou você pode optar por usar sua própria chave de criptografia. Para alterar a chave ou a instância, clique no ícone Editar abrir o painel lateral “Configurar criptografia ”. Selecione uma das opções a seguir para localizar sua chave de criptografia:

   • Localizar por instância: O painel possui três etapas:
     1. Selecionar instância do KMS: A lista exibe o nome, o ID, o tipo (Padrão ou Dedicado) e a localização de cada instância disponível do Serviço de Gerenciamento de Chaves ( Key Protect ). Selecione uma instância e clique em “Selecionar ”. Se você ainda não tiver uma instância, clique em “Criar” para provisionar uma.
     2. Chave associada: A lista exibe o nome, o ID, a data da última atualização, os aliases e o chaveiro de cada chave raiz disponível. Selecione uma tecla e clique em “Selecionar ”. Se você ainda não tiver uma chave, clique em “Criar nova chave ”.
     3. Revisão: Confirme suas seleções, incluindo o serviço de gerenciamento de chaves, o tipo de instância, o nome da instância e o nome da chave. A seção “Autorização do serviço” mostra se a autorização necessária entre o Block Storage for VPC e a instância do KMS já está em vigor. Caso contrário, você pode permitir que o Key Protect crie a autorização automaticamente ou criá-la manualmente. Para obter mais informações, consulte “Estabelecimento de autorizações entre serviços” em Block Storage for VPC. Clique em “Confirmar” para aplicar sua seleção e retornar à página de provisionamento de volume.
   • Locate by CRN: digite o CRN da chave raiz do cliente a ser usada para criptografar o volume. Escolha esta opção se estiver usando o CRK de outra conta. Clique em “Selecionar” para avançar para a etapa “Revisão ”, descrita na opção “Localizar por instância ”.

   Se você selecionou um snapshot de segunda geração para criar o volume, o tipo de criptografia do volume deverá corresponder ao tipo de criptografia do snapshot. Se o snapshot tiver chaves gerenciadas pelo provedor, não especifique uma chave de um serviço de gerenciamento de chaves.

8. Quando terminar, clique em Criar volume de armazenamento em bloco.

   • Se você ainda não estiver pronto para encomendar ou apenas procurando informações de precificação, será possível incluir as informações que você vê no painel lateral em uma Estimativa. Para obter mais informações sobre como esse recurso funciona, consulte Estimando seus custos.

9. Você será redirecionado para a página de volumes do Block Storage for VPC, onde uma mensagem indica que o volume está sendo criado (o status do volume é “pendente” ). Uma segunda mensagem é exibida quando o volume é criado (o status do volume está disponível ).

10. Para ver os detalhes do novo volume, selecione o link Visualizar recurso na segunda mensagem para acessar a página de detalhes Volume.

Ao atualizar a lista de volumes do Block Storage no console, o novo volume aparece no início da lista de volumes. Para volumes independentes, a coluna “Tipo de anexo” fica em branco (-). O menu “ Ações ” ( ) no final de uma linha da tabela fornece um link para conectar um volume do Block Storage a uma instância.

Criando um autônomoBlock Storage for VPC volume de um instantâneo no console

Ao criar um Block Storage for VPC volume, é possível selecionar uma captura instantânea e usar seus dados para criar o novo volume. As capturas instantâneas apresentadas estão em um estado estável. O volume de dados que é criado a partir da captura instantânea não está anexado a uma instância e aparece na lista de Block Storage for VPC volumes. Mais tarde, você poderá associar o volume a uma instância.

É possível restaurar um volume de inicialização de uma captura instantânea "inicializável". O volume de inicialização é restaurado quando você cria uma instância de servidor virtual

1. No IBM Cloud console, clique no ícone Navigation menu > Infrastructure > Storage > Block Storage volumes.
2. Selecione Criar.
3. Especifique o local do volume, o nome do volume, o grupo de recursos opcional e as tags.
4. No Configurações opcionais seção, clique Importar do instantâneo. Selecione uma das opções a seguir
   • Clique em Importar snapshot existente para ver a lista de snapshots disponíveis. Todos os snapshots apresentados estão em um estado estável. Por padrão, a guia Não inicializável é selecionada e lista todos os instantâneos de volume de dados. Para restaurar um volume de inicialização, clique na guia Bootable. Anexar volume à nova instância de servidor virtual é selecionado por padrão. O volume de inicialização é restaurado quando a instância é criada
   • Clique em Import snapshot by CRN e forneça o CRN do snapshot que você deseja usar.
5. Clique em Salvar. Informações sobre a captura instantânea são mostradas na página de fornecimento de volume, incluindo o nome, seu tamanho, a data em que ela foi criada, seu volume de origem e se é uma captura instantânea inicializável. As informações de captura instantânea inicializáveis incluem o sistema operacional e a imagem A criptografia é herdada da captura instantânea e mostrada na seção de criptografia.
6. Clique em “Criar volume de armazenamento em bloco ”.

Os perfis de volume de primeira e segunda geração não são intercambiáveis. É possível usar um instantâneo de um volume de segunda geração para criar outro volume de segunda geração, mas não é possível alternar o perfil de volume para um perfil de volume de primeira geração. Da mesma forma, você pode usar um instantâneo de um volume de primeira geração para criar outro volume de primeira geração com os mesmos dados, mas não pode alternar o novo volume para o perfil sdp.

Ao atualizar a página de volumes do Block Storage for VPC, o novo volume aparece no início da lista de volumes. Se o volume foi criado com êxito, ele mostra um status de Disponível. Para volumes independentes, a coluna Tipo de Anexo está em branco (-) O menu Ações no final de uma linha da tabela fornece um link para anexar um volume Block Storage for VPC a uma instância.

Antes de Iniciar

Para usar a CLI, deve-se instalar a CLI da IBM Cloud e o plug-in da CLI da VPC. Para obter mais informações, consulte os Pré-requisitos da CLI.

1. Efetue login no IBM Cloud.

   ibmcloud login --sso -a cloud.ibm.com
   

   Esse comando retorna uma URL e solicita uma senha. Acesse essa URL em seu navegador e efetue login. Se bem-sucedido, você receberá uma senha descartável. Copie essa senha e cole-a como uma resposta no prompt. Após a autenticação bem-sucedida, você é solicitado a escolher a sua conta Se você tiver acesso a várias contas, selecione a conta com a qual deseja fazer login. Responda a quaisquer prompts restantes para concluir o login.

Criando um volume do Block Storage for VPC por meio da CLI

Execute o comando a seguir para criar um volume do tipo “ Block Storage for VPC ”. Forneça um nome de volume, um nome de perfil e o nome da zona de disponibilidade em sua região. Para obter mais informações sobre os perfis do Block Storage for VPC, consulte Perfis. As opções extras são mostradas entre colchetes.

Os nomes de volume válidos podem incluir uma combinação de caracteres alfanuméricos minúsculos (a-z, 0-9) e o hífen (-), até 63 caracteres. Os nomes de volume devem começar com letra minúscula. Os nomes de volume devem ser exclusivos em toda a infraestrutura da VPC. Por exemplo, se você criar dois volumes com o mesmo nome na mesma conta e na mesma região, será gerado um erro “ volume name duplicate ”.

ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--tags  TAG_NAME1,TAG_NAME2,...] [--json]

Consulte o exemplo a seguir.

ibmcloud is volume-create demovolume1 custom us-east-1 --capacity 500 --iops 3000 --tags env:test,env:prod

Creating volume demovolume1 in resource group Default under account Test Account as user test.user@ibm.com...
ID                                     r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Name                                   demovolume1
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Status                                 pending
Attachment state                       unattached
Capacity                               500
IOPS                                   3000
Bandwidth(Mbps)                        6291
Profile                                custom
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2023-07-24T16:20:52+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   env:test,env:prod
Storage Generation                     1

A capacidade, expressa em megabytes, pode variar de 10 a 16.000 GBs. Se não for especificada, a capacidade padrão será 100 GBs. Os valores das IOPS podem ser de 100 a 48.000 IOPS, dependendo do perfil e do tamanho do volume. Se não for especificado, o valor de IOPS será padronizado para a configuração válida por perfil de volume. Para obter mais informações, consulte a tabela de IOPS customizadas.

O nome do volume pode ter até 63 caracteres alfanuméricos minúsculos e incluir o hífen (-) e deve começar com uma letra minúscula. Os nomes de volume devem ser exclusivos em toda a infraestrutura da VPC.

Observe o ID do volume. É necessário especificar o ID ao associar um volume do Block Storage for VPC a uma instância de servidor virtual, ao visualizar os detalhes de um volume em Block Storage for VPC ou ao excluir volumes.

O estado de funcionamento do volume mostra inapplicable, enquanto o status do volume é pending Após o volume ser criado, o estado de funcionamento mostra OK, a menos que a criação tenha falhado. Para obter mais informações, consulte Block Storage for VPC estados de funcionamento do volume.

As tags do usuário são incluídas para identificar o recurso de volume. Quando essas tags são correspondidas com as tags em uma política de backup, o volume é submetido a backup de acordo com o planejamento no plano de backup. Para obter mais informações, consulte Criando uma política de backup.

Para criar um volume autônomo, execute o comando ibmcloud is volume-create e especifique o perfil sdp, o tamanho e os requisitos de desempenho do volume. O exemplo a seguir cria um volume de dados na região us-east com capacidade de 200 MB e 100 IOPS.

ibmcloud is volume-create defined-performance-vol sdp us-east-3 --capacity 200 --iops 3000 --bandwidth 2000

Creating volume defined-performance-vol under account Test Account as user test.user@ibm.com...
ID                                     r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Name                                   defined-performance-vol
CRN                                    crn:v1:bluemix:public:is:us-east-3:a/a1234567::volume:r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Status                                 pending
Attachment state                       unattached
Capacity                               200
IOPS                                   3000
Bandwidth(Mbps)                        2000
Profile                                sdp
Encryption key                         -
Encryption                             provider_managed
Resource group                         Default
Created                                2025-03-25T09:59:26+05:30
Zone                                   us-east-3
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Adjustable IOPS                        true
Busy                                   false
Tags                                   -
Storage Generation                     2

Criando um volume Block Storage for VPC independente com a criptografia gerenciada pelo cliente por meio da CLI

Para criar um volume do tipo “ Block Storage ” com criptografia gerenciada pelo cliente a partir da CLI, use o comando “ ibmcloud is volume-create ” com a opção “ --encryption-key ”. A opção “ encryption_key ” requer um CRN válido para a chave raiz no serviço de gerenciamento de chaves.

ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--encryption-key ENCRYPTION_KEY] [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON]

O exemplo a seguir mostra um volume com IOPS customizado e capacidade que é criado com criptografia gerenciada pelo cliente.

ibmcloud is volume-create demo-cli-volume custom us-east-1 --capacity 300 --iops 1500 --encryption-key crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9

Creating volume demo-cli-volume under account Test Account as user test.user@ibm.com...
ID                                     r014-3984600c-6f4d-4940-82de-519a867fa3c0
Name                                   demo-cli-volume
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-3984600c-6f4d-4940-82de-519a867fa3c0
Status                                 pending
Attachment state                       unattached
Capacity                               300
IOPS                                   1500
Bandwidth(Mbps)                        3145
Profile                                custom
Encryption key                         crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9
Encryption                             user_managed
Resource group                         defaults
Created                                2023-06-29T20:10:52+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   -
Storage Generation                     1

Criando um volume independente do Block Storage for VPC por meio de uma captura instantânea da CLI

Execute o comando " ibmcloud is volume-create e especifique a opção " --snapshot com o nome, a ID ou o CRN do instantâneo que você está usando para criar o novo volume. O volume é desanexado, conforme indicado pelo estado de anexo na resposta

Este exemplo cria o novo volume a partir de uma captura instantânea especificada por nome.

ibmcloud is volume-create volume-4 general-purpose us-south-1 --snapshot r006-4602b3de-3885-4b49-8d46-65aacb72a1d6

Creating volume volume-4 under account Test Account as user test.user@ibm.com...
ID                                     r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Name                                   volume-4
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Status                                 pending
Attachment state                       unattached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2023-06-29T16:14:59+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   -
Storage Generation                     1

Para obter mais informações, consulte ibmcloud is volume-create na referência da CLI.

Os perfis de volume de primeira e segunda geração não são intercambiáveis. É possível usar um instantâneo de um volume de segunda geração para criar outro volume de segunda geração, mas não é possível alternar o perfil de volume para um perfil de volume de primeira geração. Da mesma forma, você pode usar um instantâneo de um volume de primeira geração para criar outro volume de primeira geração com os mesmos dados, mas não pode alternar o novo volume para o perfil sdp.

Antes de Iniciar

Defina variáveis ​​para o token do IAM e para o terminal e a versão da API. Para obter instruções, consulte Configurando seu ambiente da API e da CLI.

Criação de um volume de dados como parte do provisionamento de instâncias por meio da API

Faça uma solicitação POST /instances para criar uma instância, e defina o volume usando o parâmetro volume_attachments. Especifique um nome de volume, capacidade e perfil.

Os nomes de volume válidos podem incluir uma combinação de caracteres alfanuméricos minúsculos (a-z, 0-9) e o hífen (-), até 63 caracteres. Os nomes de volume devem começar com letra minúscula. Os nomes de volume devem ser exclusivos em toda a infraestrutura da VPC. Por exemplo, se você criar dois volumes com o mesmo nome na mesma conta e na mesma região, será gerado um erro “ volume name duplicate ”.

Este exemplo especifica a criptografia gerenciada pelo cliente e as tags do usuário para os volumes de inicialização e de dados

curl -X POST "$vpc_api_endpoint/v1/instances?version=2022-06-14&generation=2" -H "Authorization: Bearer $iam_token" -d '{
  "boot_volume_attachment": {
    "volume": {
      "encryption_key": {"crn": "crn:[...]"},
      "name": "my-boot-volume",
      "profile": {"name": "general-purpose"},
      "storage_generation": 1,
      "user_tags": {"env:test","env:prod"}}},
  "image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
  "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"},
        "storage_generation": 1,
        "user_tags": {"env:test","env:prod"}}
    }],
  "vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
  "zone": {"name": "us-south-1"}
}'

Uma resposta bem-sucedida é semelhante a esta:

{
  "bandwidth": 4000,
  "boot_volume_attachment": {
    "device": {
      "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0/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"
    }
  },
  "created_at": "2022-06-15T16:11:57Z",
  "crn": "crn:[...]",
  "dedicated_host": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "name": "test-new",
    "resource_type": "dedicated_host"
  },
  "disks": [],
  "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
  "id": "eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
  "image": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
    "id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
    "name": "my-image"
  },
  "memory": 8,
  "name": "my-instance",
  "network_interfaces": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
      "id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
      "name": "my-network-interface",
      "primary_ipv4_address": "10.0.0.32",
      "resource_type": "network_interface",
      "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/7389-bea6a632-5e13-42a4-b4b8-31dc877abfe4",
        "id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
        "name": "my-subnet"
      }
    }
  ],
  "placement_target": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "name": "test-new",
    "resource_type": "dedicated_host"
  },
  "primary_network_interface": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
    "id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
    "name": "my-network-interface",
    "primary_ipv4_address": "10.0.0.32",
    "resource_type": "network_interface",
    "subnet": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/bea6a632-5e13-42a4-b4b8-31dc877abfe4",
      "id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
      "name": "my-subnet"
    }
  },
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instance/profiles/bx2-2x8",
    "name": "bx2-2x8"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "running",
  "status_reasons": [],
  "vcpu": {
    "architecture": "amd64",
    "count": 2
  },
  "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"
      }
    },
    {
      "device": {
        "id": "e77125cb-4df0-4988-a878-531ae0ae0b70"
      },
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-e77125cb-4df0-4988-a878-531ae0ae0b70",
      "id": "e77125cb-4df0-4988-a878-531ae0ae0b70",
      "name": "my-volume-attachment-1",
      "volume": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2cc091f5-4d46-48f3-99b7-3527ae3f4392",
        "id": "2cc091f5-4d46-48f3-99b7-3527ae3f4392",
        "name": "my-data-volume"
      }
    }
  ],
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/f0aae929-7047-46d1-92e1-9102b07a7f6f",
    "id": "f0aae929-7047-46d1-92e1-9102b07a7f6f",
    "name": "my-vpc"
  },
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Criação de um volume de inicialização sdp como parte do provisionamento da instância com a API

Além da capacidade e do IOPS, você também pode especificar o limite de throughput personalizado com a propriedade bandwidth. Consulte o exemplo a seguir.

curl -X POST "$vpc_api_endpoint/v1/instances?version=2024-09-24&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
  "boot_volume_attachment": {
    "volume": {
      "encryption_key": {"crn": "crn:[...]"},
      "name": "my-defined-performance-boot-volume",
      "profile": {"name": "sdp"},
      "boot_capacity": 250,
      "iops": 3000,
      "bandwidth": 1000
      "storage_generation": 2,
      "user_tags": {"env:test","env:prod"}},
  "image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
  "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": "bx3dc-2x10"},
  "vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
  "zone": {"name": "us-east-1"}
  }
}

Para obter mais informações sobre a criação de volumes com a API, consulte Criação de volumes Block Storage e a referência da API para criar uma instância

Criando um volume Block Storage for VPC independente com a API

Faça uma solicitação POST /volumes para criar um volume. Especifique um nome, o IOPS, a capacidade, o perfil e a zona.

O exemplo a seguir criou um volume custom com capacidade de 50 MB e 100 IOPS na região us-south. A solicitação também especifica uma chave raiz do cliente para a criptografia gerenciada pelo cliente e um grupo de recursos

curl -X POST "$vpc_api_endpoint/v1/volumes?version=2022-06-14&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-volume-4",
      "iops": 100,
      "capacity": 50,
      "zone": {"name": "us-south-2"},
      "profile": {"name": "custom"},
      "encryption_key":{"crn":"crn:[...]"},
      "resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
    }'

Uma resposta bem-sucedida se parece com o exemplo a seguir.

{
  "capacity": 50,
  "created_at": "2022-06-14T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "iops": 100,
  "name": "my-volume-4",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
    "name": "custom"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "volume_attachments": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
    "name": "us-south-2"
  }
}

Ao usar o perfil sdp, você pode criar um volume de dados com capacidade e IOPS personalizados e também pode especificar um limite de throughput personalizado com a propriedade bandwidth. O exemplo a seguir cria um volume de dados autônomo na região us-east.

curl -X POST "$vpc_api_endpoint/v2/volumes?version=2024-09-27&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-special-volume-1",
      "iops": 3000,
      "capacity": 250,
      "bandwidth": 5000,
      "zone": {"name": "us-east-2"},
      "profile": {"name": "sdp"},
      "encryption_key":{"crn":"crn:[...]"},
      "resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
    }'

Uma resposta bem-sucedida se parece com o exemplo a seguir.

{
  "adjustable_capacity_states:": "attached, unattached",
  "adjustable_iops_states": "attached, unattached",
  "bandwidth": 5000,
  "capacity": 250,
  "created_at": "2024-09-27T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-east.iaas.cloud.ibm.com/v2/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "iops": 3000,
  "name": "my-special-volume-1",
  "profile": {
    "href": "https://us-east.iaas.cloud.ibm.com/v2/volume/profiles/sdp",
    "name": "sdp"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "volume_attachments": [],
  "zone": {
    "href": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-east/zones/us-east-2",
    "name": "us-east-2"
  }
}

Para obter mais informações sobre a criação de volume com a API, consulte Criando Block Storage e a referência de API para criar um volume..

Criação de um volume de dados a partir de um snapshot usando a API

Você pode especificar um ID, nome ou CRN de instantâneo em uma chamada POST /volumes para criar um volume de dados autônomo. Quando você especifica um snapshot cujo valor da propriedade storage_generation é 1, o novo volume de armazenamento em bloco é criado com o mesmo valor storage_generation e somente perfis de volume da mesma geração podem ser aplicados a ele.

Os dados são totalmente restaurados ao conectar o volume de dados a uma instância de servidor virtual. Para mais informações, veja Sobre a restauração de um volume a partir de um snapshot. Para ver um exemplo de chamada de API, consulte Restaurando um volume de dados a partir de uma captura instantânea de um volume não anexado.

Criando volumes Block Storage for VPC independentes com o Terraform

Para criar um volume Block Storage for VPC, use o recurso ibm_is_volume. O exemplo a seguir cria um volume de primeira geração com capacidade de 4 TB e o perfil de desempenho 10iops-tier.

resource "ibm_is_volume" "10iops_volume_example" {
  name     = "example-volume-10iops"
  profile  = "10iops-tier"
  zone     = "us-south-1"
  capacity = 4000
}

O exemplo a seguir cria um volume de primeira geração com um perfil custom. O volume criado tem capacidade de 200 MB e pode executar 1000 IOPS.

resource "ibm_is_volume" "custom_volume_example" {
  name           = "example-volume-custom"
  profile        = "custom"
  zone           = "us-south-1"
  iops           = 1000
  capacity       = 200
  encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}

O exemplo a seguir cria um volume de segunda geração com o perfil sdp. O volume criado tem capacidade de 250 MB, pode executar 3000 IOPS com o limite máximo de largura de banda de 1000 Mbps.

resource "ibm_is_volume" "sdp_volume_example" {
  name           = "example-volume-sdp"
  profile        = "sdp"
  zone           = "us-south-1"
  iops           = 3000
  capacity       = 250
  bandwidth      = 1000
  encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}

Para obter mais informações sobre argumentos e atributos, consulte ibm_is_volume.

Criando um volume Block Storage for VPC independente por meio de uma captura instantânea com o Terraform

Para criar um volume Block Storage for VPC a partir de uma captura instantânea, use o recurso ibm_is_volume. O exemplo a seguir cria um volume com base em uma captura instantânea identificada por seu ID. Você também pode usar o nome ou o CRN para identificar o snapshot.

resource "ibm_is_volume" "example-volume-from-snapshot" {
  name            = "example-volume"
  profile         = "general-purpose"
  zone            = "us-south-1"
  source_snapshot = ibm_is_snapshot.example.id
}

Para obter mais informações sobre argumentos e atributos, consulte ibm_is_volume.

Os perfis de volume de primeira e segunda geração não são intercambiáveis. É possível usar um instantâneo de um volume de segunda geração para criar outro volume de segunda geração, mas não é possível alternar o perfil de volume para um perfil de volume de primeira geração. Da mesma forma, você pode usar um instantâneo de um volume de primeira geração para criar outro volume de primeira geração com os mesmos dados, mas não pode alternar o novo volume para o perfil sdp.

Criação de um volume de inicialização como parte do provisionamento de instâncias com o Terraform

Para criar um volume de dados de uma captura instantânea ao criar uma instância de servidor virtual, use o recurso ibm_is_instance. O exemplo a seguir cria uma instância de servidor virtual com um volume de inicialização que usa o perfil de volume sdp e é protegido por uma chave de criptografia gerenciada pelo cliente. Ao especificar o perfil sdp para o volume de inicialização, você pode especificar limites personalizados de capacidade, IOPS e largura de 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"
      }
   }

Para obter mais informações sobre argumentos e atributos, consulte ibm_is_instance.

Criando um volume de inicialização por meio de uma captura instantânea como parte do fornecimento de instância com Terraform

Para criar um volume de dados de uma captura instantânea ao criar uma instância de servidor virtual, use o recurso ibm_is_instance. O exemplo a seguir cria uma instância de servidor virtual com o nome "example-vsi-restore". O volume de inicialização é definido no argumento boot_volume com seu nome, sua captura instantânea de origem e tags do usuário..

resource "ibm_is_snapshot" "example" {
  name          = "example-snapshot"
  source_volume = ibm_is_instance.example.volume_attachments[0].volume_id
}
resource "ibm_is_instance" "example" {
  name    = "example-vsi-restore"
  profile = "cx2-2x4"
  boot_volume {
    name     = "boot-restore"
    snapshot = ibm_is_snapshot.example.id
    tags     = ["tags-0"]
  }
  primary_network_interface {
    subnet = ibm_is_subnet.example.id
  }
  vpc  = ibm_is_vpc.example.id
  zone = "us-south-1"
  keys = [ibm_is_ssh_key.example.id]
  network_interfaces {
    subnet = ibm_is_subnet.example.id
    name   = "eth1"
  }
}

Se quiser restaurar um volume a partir de um instantâneo de outra conta, você poderá usar o argumento " source_snapshot_crn para identificar o instantâneo pelo CRN, em vez do ID.

Para obter mais informações sobre argumentos e atributos, consulte ibm_is_instance.

Criando um volume de dados para incluir em uma instância existente com o Terraform

Para criar um volume de dados e conectá-lo a uma instância de servidor virtual, use o recurso ibm_is_instance_volume_attachment.. O exemplo a seguir cria um volume de dados de 20 MB com um perfil de volume general-purpose e o anexa à instância ibm_is_instance.example.id.

rresource "ibm_is_instance_volume_attachment" "example" {
  instance = ibm_is_instance.example.id
  name                               = "example-vol-att-1"
  profile                            = "general-purpose"
  capacity                           = "20"
  delete_volume_on_attachment_delete = true
  delete_volume_on_instance_delete   = true
  volume_name                        = "example-vol-1"
}

Para obter mais informações sobre argumentos e atributos, consulte ibm_is_instance_volume_attachment.