Gerenciando instâncias de servidor virtual

Gerenciamento de instâncias na página “Instâncias do servidor virtual”

Você pode gerenciar suas instâncias do IBM Cloud® Virtual Servers for Virtual Private Cloud na página “Instâncias de servidor virtual” no console do IBM Cloud.

Para gerenciar suas instâncias, conclua as etapas a seguir.

1. No console IBM Cloud, clique no menu Navegação > de infraestrutura > Computação > Instâncias do servidor virtual.
2. Na página Instâncias de servidor virtual, clique no ícone Ações para a instância que você deseja gerenciar. É possível selecionar por meio das ações a seguir:

Renomear uma instância de servidor virtual no console

Você pode renomear uma instância de servidor virtual no console.

1. Na página “Instâncias de servidor virtual ”, clique no ícone “Ações” ( ”) da instância que você deseja renomear e, em seguida, clique em “Renomear ”.
2. Digite o novo nome para a instância do servidor virtual e, em seguida, clique em “Renomear ”.

Listagem de instâncias de servidores virtuais pela CLI

Antes de poder gerenciar uma instância de servidor virtual, você precisa do nome ou do ID dela. Para listar todas as instâncias de servidores virtuais da sua conta, use o comando a seguir.

ibmcloud is instances

Para obter uma lista completa das opções de comando, consulte o [ibmcloud is instances](/docs/vpc?topic=vpc-vpc-reference#instances-list).

Listagem de instâncias de servidores virtuais por meio da API

Antes de poder gerenciar uma instância de servidor virtual, você precisa do ID dela. Para listar todas as instâncias de servidores virtuais da sua conta, faça a seguinte solicitação.

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

Para obter mais informações, consulte “Listar todas as instâncias ” na API da VPC.

Visualizando detalhes da instância pela CLI

É possível visualizar os detalhes da instância de servidor virtual em seu IBM Cloud VPC usando a interface da linha de comandos (CLI).

Para visualizar os detalhes da instância do servidor virtual, use o ibmcloud is instance comando. Especifique o ID ou nome da instância de servidor virtual que você deseja visualizar usando a variável INSTANCE.

ibmcloud is instance INSTANCE

Visualização dos detalhes de uma instância por meio da API

É possível visualizar os detalhes da instância de servidor virtual em seu IBM Cloud VPC usando a API.

O exemplo a seguir exibe os detalhes da instância do servidor virtual para um perfil de instância cujo nome é version=2021-06-22&generation=2.

curl -X GET "$vpc_api_endpoint/v1/instance/profiles/$profile_name?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token"

Para obter mais informações, consulte o Recuperar um perfil da instância na API do VPC

Visualização dos detalhes da instância usando o Terraform

Você pode recuperar informações sobre uma instância de servidor virtual existente usando o Terraform.

O exemplo a seguir recupera informações sobre uma instância de servidor virtual por nome:

data "ibm_is_instance" "example" {
  name        = "my-instance"
}

Para obter mais informações, consulte ibm_is_instance.

Como renomear uma instância de servidor virtual pela CLI

É possível renomear uma instância de servidor virtual no IBM Cloud VPC usando a interface de linha de comando (CLI).

1. Para renomear uma instância de servidor virtual, use o ibmcloud is instance-update INSTANCE comando. Especifique o novo nome da instância com a opção --name NEW_NAME

   O exemplo a seguir renomeia um servidor virtual com o nome de my-instance-name para my-instance-name-new

   ibmcloud is instance-update my-instance-name --name my-instance-name-new
   

   Para obter uma lista completa das opções de comando, consulte ibmcloud é uma atualização de instância.

Renomeando uma instância de servidor virtual por meio da API

É possível renomear a instância de servidor virtual em seu IBM Cloud VPC usando a API.

O exemplo a seguir renomeia uma instância de servidor virtual de name para my-instance.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2021-06-29&generation=2" -H "Authorization: Bearer $iam_token" -d '{"name": "my-instance"}'

Como renomear uma instância de servidor virtual usando o Terraform

Você pode renomear uma instância de servidor virtual no seu IBM Cloud VPC usando o Terraform. Atualize o argumento name no recurso ibm_is_instance .

O exemplo a seguir renomeia uma instância de servidor virtual para my-renamed-instance:

resource "ibm_is_instance" "example" {
  name    = "my-renamed-instance"
  # ... other required arguments
}

Para obter mais informações, consulte o [argumento name](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/is_instance#argument-reference){: external} na documentação do recurso ibm_is_instance .

Interromper e iniciar uma instância de servidor virtual no console

Na página “Instâncias de servidor virtual ” do console do IBM Cloud, clique em “Parar ” ou “Iniciar ”.

Desligar uma instância de servidor virtual pela CLI

É possível parar a instância de servidor virtual em seu IBM Cloud VPC usando a interface da linha de comandos (CLI).

Para parar a instância do servidor virtual, use o ibmcloud is instance-stop comando. Especifique o ID ou o nome da instância de servidor virtual que você deseja parar com a variável INSTANCE.

ibmcloud is instance-stop INSTANCE

No exemplo a seguir, uma instância é parada sem a solicitação de confirmação. A instância de servidor virtual tem um ID 0777_e7af506a-35d4-451d-aa9e-59330e62b77e. A opção --force indica que a solicitação de confirmação é ignorada.

ibmcloud is instance-stop 0777_e7af506a-35d4-451d-aa9e-59330e62b77e --force

Uma ação de parada forçada aciona uma reinicialização com desligamento e religamento da instância do servidor virtual.

Se você tiver uma instância que ficou travada no estado de parada, é possível usar o comando de exemplo a seguir com as opções “ --force ” e “ --no-wait ”, especificadas para parar a instância imediatamente, sem confirmação. A instância tem um ID de 0757_5446c277-3190-48dd-ac67-5f02fab39ed5. A opção --force indica que a solicitação de confirmação é ignorada. A opção --no-wait executa o comando imediatamente, descartando as ações enfileiradas.

ibmcloud is instance-stop 0757_5446c277-3190-48dd-ac67-5f02fab39ed5 --force --no-wait

Para obter uma lista completa das opções de comando, consulte o comando [ibmcloud is instance-stop](/docs/vpc?topic=vpc-vpc-reference#instance-stop).

Iniciando uma instância de servidor virtual pela CLI

É possível iniciar uma instância de servidor virtual que está interrompida em seu IBM Cloud VPC usando a interface da linha de comandos (CLI).

Para iniciar a instância do servidor virtual, use o ibmcloud is instance-start comando. Especifique o ID ou o nome da instância de servidor virtual que deseja iniciar usando a variável INSTANCE.

ibmcloud is instance-start INSTANCE

Para obter uma lista completa de opções de comando, consulte ibmcloud is instance-start na página de referência da CLI do VPC..

Parando uma instância de servidor virtual por meio da API

É possível parar a instância de servidor virtual em seu IBM Cloud VPC usando a API.

O exemplo a seguir interrompe uma instância de servidor virtual com um ID de instância de d6c3902d-1ecf-3a2c-b7ab-eb9143581000.

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/d6c3902d-1ecf-3a2c-b7ab-eb9143581000/actions?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token" -d '{"type": "stop"}'

Para obter mais informações, consulte a ação “Criar uma instância” na API da VPC.

Iniciando uma instância de servidor virtual por meio da API

É possível iniciar uma instância de servidor virtual que está interrompida em seu IBM Cloud VPC usando a API.

O exemplo a seguir inicia uma instância de servidor virtual com o ID de instância d6c3902d-1ecf-3a2c-b7ab-eb9143581000.

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/d6c3902d-1ecf-3a2c-b7ab-eb9143581000/actions?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token" -d '{"type": "start"}'

Para obter mais informações, consulte a ação “Criar uma instância” na API da VPC.

Interromper uma instância de servidor virtual usando o Terraform

Você pode interromper uma instância de servidor virtual usando o Terraform.

O exemplo a seguir interrompe uma instância de servidor virtual:

resource "ibm_is_instance_action" "example" {
  action       = "stop"
  force_action = true
  instance     = ibm_is_instance.example.id
}

Defina force_action como true para forçar a parada imediata e excluir todas as ações em fila.

Para obter mais informações, consulte ibm_is_instance_action.

Iniciar uma instância de servidor virtual usando o Terraform

É possível iniciar uma instância de servidor virtual que esteja parada usando o Terraform.

O exemplo a seguir inicia uma instância de servidor virtual:

resource "ibm_is_instance_action" "example" {
  action   = "start"
  instance = ibm_is_instance.example.id
}

Para obter mais informações, consulte ibm_is_instance_action.

Reinicialização de uma instância de servidor virtual no console

A ação Reinicializar aciona uma reinicialização do sistema operacional guest. A instância de servidor virtual permanece em um estado Em execução enquanto o sistema operacional guest é reiniciado. O faturamento continua.

Uma ação de reinicialização forçada provoca uma reinicialização completa da instância do servidor virtual.

Na página “Instâncias de servidor virtual ” do console do IBM Cloud, clique em “Reiniciar ”.

Reiniciando uma instância de servidor virtual pela CLI

A ação Reinicializar aciona uma reinicialização do sistema operacional guest. A instância de servidor virtual permanece em um estado Em execução enquanto o sistema operacional guest é reiniciado. O faturamento continua.

Uma ação Forçar reinicialização, usando a opção --force, aciona uma reconfiguração do ciclo de energia da instância de servidor virtual

É possível reinicializar a instância de servidor virtual em seu IBM Cloud VPC usando a interface da linha de comandos (CLI).

Para reinicializar a instância do servidor virtual, use o ibmcloud is instance-reboot comando. Especifique o ID ou o nome da instância de servidor virtual que você deseja reinicializar usando a variável INSTANCE.

ibmcloud is instance-reboot INSTANCE

Para obter uma lista completa das opções de comando, consulte o comando [ibmcloud is instance-reboot](/docs/vpc?topic=vpc-vpc-reference#instance-reboot).

Reiniciando uma instância de servidor virtual por meio da API

É possível reinicializar a instância de servidor virtual em seu IBM Cloud VPC usando a API. O exemplo a seguir reinicializa o servidor virtual especificado.

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/d6c3902d-1ecf-3a2c-b7ab-eb9143581000/actions?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token" -d '{"type": "reboot"}'

A ação Reinicializar aciona uma reinicialização do sistema operacional guest. A instância de servidor virtual permanece em um estado Em execução enquanto o sistema operacional guest é reiniciado. O faturamento continua.

Uma ação de reinicialização forçada provoca uma reinicialização completa da instância do servidor virtual.

Para obter mais informações, consulte a ação “Criar uma instância” na API da VPC.

Reinicialização de uma instância de servidor virtual usando o Terraform

Você pode reinicializar uma instância de servidor virtual usando o Terraform.

O exemplo a seguir reinicializa uma instância de servidor virtual:

resource "ibm_is_instance_action" "example" {
  action       = "reboot"
  force_action = true
  instance     = ibm_is_instance.example.id
}

A ação Reinicializar aciona uma reinicialização do sistema operacional guest. A instância de servidor virtual permanece em um estado Em execução enquanto o sistema operacional guest é reiniciado. O faturamento continua.

Uma ação de reinicialização forçada provoca uma reinicialização completa da instância do servidor virtual. Defina force_action como true para forçar a ação imediatamente e excluir todas as ações enfileiradas.

Para obter mais informações, consulte ibm_is_instance_action.

Redimensionamento de uma instância de servidor virtual no console

É possível aumentar ou diminuir a quantidade de memória de vCPU e e de RAM disponível para obter maior flexibilidade no gerenciamento de cargas de trabalho, a fim de atender às mudanças nas necessidades de recursos, otimizar custos ou melhorar o desempenho das cargas de trabalho. Após a conclusão do redimensionamento, você será cobrado pela taxa horária do novo perfil de instância selecionado.

Para conhecer as etapas para redimensionar uma instância de servidor virtual no console, consulte Redimensionamento de uma instância de servidor virtual usando a interface do usuário.

Redimensionamento de uma instância de servidor virtual pela CLI

É possível aumentar ou diminuir a quantidade de memória de vCPU e e de RAM disponível para obter maior flexibilidade no gerenciamento de cargas de trabalho, a fim de atender às mudanças nas necessidades de recursos, otimizar custos ou melhorar o desempenho das cargas de trabalho. Após a conclusão do redimensionamento, será cobrada a tarifa por hora do novo perfil de instância selecionado.

Para conhecer as etapas para redimensionar uma instância de servidor virtual, consulte Redimensionando uma instância de servidor virtual usando a CLI.

Redimensionamento de uma instância de servidor virtual por meio da API

É possível aumentar ou diminuir a quantidade de memória de vCPU e e de RAM disponível para obter maior flexibilidade no gerenciamento de cargas de trabalho, a fim de atender às mudanças nas necessidades de recursos, otimizar custos ou melhorar o desempenho das cargas de trabalho. Após a conclusão do redimensionamento, será cobrada a tarifa por hora do novo perfil de instância selecionado.

Para conhecer as etapas para redimensionar uma instância de servidor virtual, consulte Redimensionando uma instância de servidor virtual usando a API.

Redimensionamento de uma instância de servidor virtual usando o Terraform

É possível aumentar ou diminuir a quantidade de memória de vCPU e e de RAM disponível para obter maior flexibilidade no gerenciamento de cargas de trabalho, atualizando o argumento profile no recurso ibm_is_instance . Após a conclusão do redimensionamento, será cobrada a tarifa por hora do novo perfil de instância.

O exemplo a seguir atualiza o perfil de uma instância de servidor virtual:

resource "ibm_is_instance" "example" {
  name    = "my-instance"
  profile = "bx2-4x16"
  # ... other required arguments
}

Para obter mais informações, consulte o [argumento profile](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/is_instance#argument-reference){: external} na documentação do recurso ibm_is_instance .

Reinicialização do sistema operacional usando a CLI

Você pode reinicializar o sistema operacional usando a CLI. Use o seguinte comando da CLI para recarregar o sistema operacional.

Se você quiser manter seus dados, faça um backup de todos eles antes de reiniciar o sistema operacional.

Este exemplo reinicializa o INSTANCE utilizando o IMAGE com as opções de volume de inicialização contidas em BOOT_VOLUME_JSON. Ele utiliza KEY1 e KEY2 como chaves, DEFAULT_TRUSTED_PROFILE como perfil confiável padrão e DATA como dados do usuário. O perfil confiável padrão é vinculado automaticamente porque --default-trusted-profile-auto-link está definido como true.

ibmcloud is instance-reinitialize INSTANCE --image IMAGE --boot-volume BOOT_VOLUME_JSON --keys KEY1,KEY2 --default-trusted-profile DEFAULT_TRUSTED_PROFILE --default-trusted-profile-auto-link true --user-data DATA

Reinicialização do sistema operacional por meio da API

É possível reiniciar o sistema operacional usando a API. Use a seguinte chamada de API para recarregar o sistema operacional.

Se você quiser manter seus dados, faça um backup de todos eles antes de reiniciar o sistema operacional.

Este exemplo reinicializa a instância instance_id utilizando a imagem image_id com as opções de conexão do volume de inicialização fornecidas. Ele utiliza key_id como chave, some_data para os dados do usuário e profile_id como perfil confiável padrão. O perfil confiável padrão está vinculado porque auto_link está definido como true.

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/instance_id/reinitialize?version=2026-07-01&generation=2" -H "Authorization: Bearer $iam_token" -d
'{
    "image": {
         "id": "image_id"
    },
    "boot_volume_attachment": {
      "volume":  {
        "profile": {
          "name": "general-purpose"
          }
        }
      },"keys": [{
        "id": "key_id"
	}],
	"user_data": "some_data",
	"default_trusted_profile": {
      "target": {
	    "id": "profile_id"
	   },
	   "auto_link": true
	}
}'

Exclusão de uma instância de servidor virtual no console

Você pode excluir a instância do servidor virtual que está no seu IBM Cloud VPC no console.

Se a instância tiver um endereço IP flutuante, ela deverá ser desassociada ou liberada antes que seja excluída. A conta associada ao IP flutuante continuará a ser cobrada se não for liberada.

Na página “Instâncias de servidor virtual ” do console do IBM Cloud, clique em “Excluir ”.

A ação de exclusão remove permanentemente uma instância, seu vNIC, associado e os dados da sua conta. O volume de inicialização da instância também será excluído se a configuração de exclusão automática de volume estiver ativada. Se um volume de inicialização existente for anexado como parte do fornecimento de uma instância de servidor virtual, o volume será preservado por padrão quando a instância for excluída Se um volume de inicialização foi criado como parte do fornecimento de uma instância de servidor virtual, o volume será excluído por padrão quando a instância for excluída. Depois de confirmar a ação de exclusão, o processo para excluir a instância e sua vNIC, volume de inicialização e dados associados é iniciado. A ação de exclusão pode levar até 30 minutos, mas quando o processo é concluído, a instância não aparece mais na página de instâncias de servidor virtual.

Exclusão de uma instância de servidor virtual pela CLI

É possível excluir a instância de servidor virtual em seu IBM Cloud VPC usando a interface da linha de comandos (CLI).

Se a instância tiver um endereço IP flutuante, ela deverá ser desassociada ou liberada antes que seja excluída. A conta associada ao IP flutuante continuará a ser cobrada se não for liberada.

Para excluir a instância do servidor virtual, use o ibmcloud is instance-delete comando. Especifique o ID ou o nome da instância de servidor virtual que deseja excluir usando a variável INSTANCE.

ibmcloud is instance-delete INSTANCE

Para obter uma lista completa das opções de comando, consulte o comando [ibmcloud is instance-delete](/docs/vpc?topic=vpc-vpc-reference#instance-delete).

A ação de exclusão remove permanentemente uma instância, seu vNIC, associado e os dados da sua conta. O volume de inicialização da instância também será excluído se a configuração de exclusão automática de volume estiver ativada. Se um volume de inicialização existente for anexado como parte do fornecimento de uma instância de servidor virtual, o volume será preservado por padrão quando a instância for excluída Se um volume de inicialização foi criado como parte do fornecimento de uma instância de servidor virtual, o volume será excluído por padrão quando a instância for excluída. Depois de confirmar a ação de exclusão, o processo para excluir a instância e sua vNIC, volume de inicialização e dados associados é iniciado. A ação de exclusão pode levar até 30 minutos, mas quando o processo é concluído, a instância não aparece mais na página de instâncias de servidor virtual.

Exclusão de uma instância de servidor virtual por meio da API

É possível excluir a instância de servidor virtual em seu IBM Cloud VPC usando a API.

Se a instância tiver um endereço IP flutuante, ela deverá ser desassociada ou liberada antes que seja excluída. A conta associada ao IP flutuante continuará a ser cobrada se não for liberada.

O exemplo a seguir exclui uma instância.

curl -X DELETE "$vpc_api_endpoint/v1/instances/$instance_id?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token"

A ação de exclusão remove permanentemente uma instância, seu vNIC, associado e os dados da sua conta. O volume de inicialização da instância também será excluído se a configuração de exclusão automática de volume estiver ativada. Se um volume de inicialização existente for anexado como parte do fornecimento de uma instância de servidor virtual, o volume será preservado por padrão quando a instância for excluída Se um volume de inicialização tiver sido criado como parte do fornecimento de uma instância de servidor virtual, o volume será excluído por padrão quando a instância for excluída Depois de confirmar a ação de exclusão, o processo para excluir a instância e sua vNIC, volume de inicialização e dados associados é iniciado. A ação de exclusão pode levar até 30 minutos, mas quando o processo é concluído, a instância não aparece mais na página de instâncias de servidor virtual.

Para obter mais informações, consulte a Excluir uma instância na API do VPC

Gerenciamento de instâncias a partir da página de detalhes da instância

Para exibir a página de detalhes de uma instância, siga as etapas a seguir.

1. No console IBM Cloud, clique no menu Navegação > de infraestrutura > Computação > Instâncias do servidor virtual.

2. Na lista da página “Instâncias de servidor virtual”, localize a instância que você deseja visualizar. Clique no nome da instância para exibir seus detalhes. A página de detalhes da instância está organizada em cinco guias: Visão geral, Rede, Armazenamento, Monitoramento e Integrações.

Visualizando detalhes da instância no console

Clique no nome de uma instância de servidor virtual na página “Instâncias de servidor virtual” para abrir a página de detalhes dela. A página de detalhes está organizada nas seguintes abas.

Alteração da configuração de exclusão automática de volumes anexados a uma instância no console

Durante o provisionamento da instância, um volume de inicialização é criado com a opção de exclusão automática ativada por padrão. Quando esse recurso está ativado, o volume é excluído quando a instância é excluída.

O oposto é verdadeiro para volumes de dados criados durante o provisionamento da instância; o recurso de exclusão automática é desativado para eles. Os volumes de dados devem ser desanexados, mas não excluídos por padrão, para que seus dados possam persistir além do ciclo de vida da instância do servidor virtual.

Você pode alterar essa configuração no painel Editar volume de inicialização ao criar uma instância ou posteriormente na página de detalhes da instância. Para obter mais informações, consulte Criação de instâncias de servidor virtual e Atualização da configuração de exclusão automática de um volume.

Alteração da configuração de exclusão automática de volumes anexados a uma instância a partir da CLI

Durante o provisionamento da instância, um volume de inicialização é criado com a opção de exclusão automática ativada por padrão. Quando esse recurso está ativado, o volume é excluído quando a instância é excluída.

O oposto é verdadeiro para volumes de dados criados durante o provisionamento da instância; o recurso de exclusão automática é desativado para eles. Os volumes de dados devem ser desanexados, mas não excluídos por padrão, para que seus dados possam persistir além do ciclo de vida da instância do servidor virtual.

Você pode alterar essa configuração especificando a propriedade auto_delete ao criar a instância ou atualizar o anexo do volume de inicialização. Para obter mais informações, consulte Criação de instâncias de servidor virtual e Atualização de um anexo de volume na CLI.

Alteração da configuração de exclusão automática de volumes anexados a uma instância com a API

Durante o provisionamento da instância, um volume de inicialização é criado com a opção de exclusão automática ativada por padrão. Quando esse recurso está ativado, o volume é excluído quando a instância é excluída.

O oposto é verdadeiro para volumes de dados criados durante o provisionamento da instância; o recurso de exclusão automática é desativado para eles. Os volumes de dados devem ser desanexados, mas não excluídos por padrão, para que seus dados possam persistir além do ciclo de vida da instância do servidor virtual.

Você pode alterar essa configuração especificando a propriedade delete_volume_on_instance_delete ao criar a instância ou atualizar o anexo de volume. Para obter mais informações, consulte Criação de instâncias de servidor virtual e Atualização de um anexo de volume com a API.

Alteração da configuração de exclusão automática de volumes conectados a uma instância usando o Terraform

Durante o provisionamento da instância, é criado um volume de inicialização com a opção “ auto_delete_volume ” ativada por padrão. Quando essa opção estiver ativada, o volume de inicialização será excluído quando a instância for excluída.

Você pode alterar essa configuração atualizando o argumento auto_delete_volume no recurso ibm_is_instance .

O exemplo a seguir desativa a exclusão automática do volume de inicialização:

resource "ibm_is_instance" "example" {
  name              = "my-instance"
  auto_delete_volume = false
  # ... other required arguments
}

Para obter mais informações, consulte o [argumento auto_delete_volume](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/is_instance#argument-reference){: external} na documentação do recurso ibm_is_instance .

Ajustando a alocação de largura de banda da instância no console

Você pode ajustar a alocação da largura de banda total da sua instância entre a largura de banda de rede e a largura de banda de armazenamento no console.

Para ajustar a largura de banda de uma instância, use as etapas a seguir.

1. Acesse uma instância de serviço virtual.
2. Selecione “Alocação de largura de banda ”.
3. Na tela “Editar alocação de largura de banda ”, ajuste o valor da “Largura de banda de armazenamento ”. Você pode aumentar a largura de banda alocada para a inicialização do Block Storage e para os volumes de dados associados. Para obter mais informações sobre alocação de largura de banda de armazenamento, consulte Alocação de largura de banda para volumes Block Storage. Depois de configurar a largura da banda de armazenamento, a largura da banda da rede é ajustada automaticamente de modo que a largura da banda total da instância seja igual ao valor exibido em Largura da banda total. O valor da largura de banda de rede ou da largura de banda de armazenamento não pode ser definido como inferior a 500 Mbps.

Para visualizar a nova alocação de largura da banda, deve-se parar e iniciar a instância, ou remover e reconectar volumes secundários.

Ajustando a alocação de largura de banda da instância na CLI

Você pode ajustar a alocação da largura de banda total da sua instância entre a largura de banda de rede e a largura de banda de armazenamento usando a CLI.

Para reatribuir a largura de banda da instância, execute o comando instance-update e especifique a largura de banda total de armazenamento em megabits por segundo (Mbps) para o parâmetro total-volume-bandwidth . Use a seguinte sintaxe. Use o ID ou nome da instância para INSTANCE.

ibmcloud is instance-update INSTANCE --total-volume-bandwidth VALUE

A largura de banda total de armazenamento (em megabits por segundo) é a largura de banda total alocada para o volume de inicialização e os volumes de dados conectados. Aumentar a largura da banda de armazenamento total resulta em uma diminuição correspondente na largura da banda da rede. A largura de banda mínima de rede disponível é de 500 Mbps; portanto, ajuste a largura de banda total de armazenamento conforme necessário.

Para visualizar a nova alocação de largura de banda, é necessário parar e reiniciar a instância ou desconectar e reconectar os volumes de dados.

Ajustando a alocação de largura de banda da instância com a API

Você pode ajustar a largura de banda total de armazenamento de uma instância existente com a API. Faça um PATCH /instances solicitar e especificar um novo valor para total_volume_ bandwidth. A largura de banda total de armazenamento (em megabits por segundo) é a largura de banda total alocada para o volume de inicialização primário e os volumes de dados secundários conectados. Aumentar a largura da banda de armazenamento total resulta em uma diminuição correspondente na largura da banda da rede. A largura de banda mínima de rede disponível é de 500 Mbps; portanto, ajuste a largura de banda total de armazenamento conforme necessário. Por exemplo,

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2021-06-22&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
      "total_volume_bandwidth": 500
      }'

Para visualizar a nova alocação de largura de banda, é necessário parar e reiniciar a instância ou desconectar e reconectar os volumes de dados. A alocação de largura de banda para volumes individuais é atualizada quando você adiciona um volume de dados usando o comando POST / volume_attachments método ou excluir um volume usando o DELETE volume_attachments método.

Ajustando a alocação de largura de banda da instância usando o Terraform

Você pode ajustar a alocação da largura de banda total da sua instância entre a largura de banda de rede e a largura de banda de armazenamento atualizando o argumento total_volume_bandwidth no recurso ibm_is_instance . A largura de banda total de armazenamento (em megabits por segundo) é a largura de banda total alocada para o volume de inicialização e os volumes de dados conectados. Aumentar a largura da banda de armazenamento total resulta em uma diminuição correspondente na largura da banda da rede. A largura de banda mínima da rede é de 500 Mbps.

O exemplo a seguir define a largura de banda total de armazenamento para 500 Mbps:

resource "ibm_is_instance" "example" {
  name                   = "my-instance"
  total_volume_bandwidth = 500
  # ... other required arguments
}

Para visualizar a nova alocação de largura de banda, é necessário parar e reiniciar a instância ou desconectar e reconectar os volumes de dados.

Para obter mais informações, consulte o [argumento total_volume_bandwidth](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/is_instance#argument-reference){: external} na documentação do recurso ibm_is_instance .

Ajuste do armazenamento QoS mode in the console

Você pode alterar o modo Storage QoS de uma instância de servidor virtual que usa um dos perfis General purpose - Flex, General purpose Gen 3, Accelerated Gen 3 ou Confidential Computing - Gen 3 para ativar a alocação dinâmica de largura de banda para volumes de dados anexados.

1. Acesse uma instância de serviço virtual.
2. Na página de detalhes da instância do servidor virtual, clique no botão de alternância para alternar o modo QoS de ponderado para agrupado.

Para que a alteração do QoS modo tenha efeito, você deve parar e iniciar a instância do servidor virtual.

Ajuste do armazenamento QoS mode from CLI

Você pode alterar o modo Storage QoS de uma instância de servidor virtual que usa um dos perfis General purpose - Flex, General purpose Gen 3, Accelerated Gen 3 ou Confidential Computing - Gen 3 para ativar a alocação dinâmica de largura de banda para volumes de dados anexados usando o comando ibmcloud is instance-update.

ibmcloud is instance-update INSTANCE --storage_qos_modes pooled

Você pode usar o mesmo comando para reverter para o modo QoS ponderado.

ibmcloud is instance-update INSTANCE --storage_qos_modes weighted

Para que a alteração do QoS modo tenha efeito, você deve primeiro parar a instância do servidor virtual. Execute o comando instance-update . Em seguida, inicie a instância.

Ajuste do armazenamento QoS mode with the API

Você pode alterar programaticamente o modo de armazenamento QoS de uma instância de servidor virtual que usa um dos perfis General purpose - Flex, General purpose Gen 3, Accelerated Gen 3 ou Confidential Computing - Gen 3 chamando o método /instances/{id} na API VPC, conforme mostrado na solicitação de amostra a seguir.

A solicitação de exemplo a seguir permite a alocação dinâmica de largura de banda para volumes de dados anexados a um servidor virtual de terceira geração.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-07-11&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
      "storage_qos_mode": "pooled"
      }'

A solicitação de exemplo a seguir reverte o modo de armazenamento QoS para ponderado.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-07-11&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
      "storage_qos_mode": "weighted"
      }'

Para que a alteração do QoS modo tenha efeito, você deve primeiro parar a instância do servidor virtual. Faça a solicitação de PATCH. Em seguida, inicie a instância.

Visualizando status de instância e lifecycle_state na API

• status
• Esta propriedade fornece o status da instância de servidor virtual por meio da solicitação Recuperar uma instância Os valores retornados pelo ' status são especializados para instâncias de servidor virtual e indicam se ele está em execução, parado ou em transição. Para obter mais informações, consulte a API do Virtual Private Cloud
• lifecycle_state
• Essa propriedade fornece o estado de um recurso por meio da solicitação de Recuperar uma instância Os valores que ' lifecycle_state fornece são genéricos e devem ser aplicados a vários recursos, como grupos de posicionamento. lifecycle_state pode retornar valores que se sobrepõem ao ' status. lifecycle_state também inclui valores que detalham se um recurso está suspenso.

Configurando a reinicialização automática em caso de falha do host no console

Para configurar a reinicialização automática de falha de host para uma instância existente, conclua as etapas a seguir.

1. No IBM Cloud console, clique no ícone Navigation Menu > Infrastructure > Compute > Virtual server instances.
2. Na página Instâncias de servidor virtual, clique no ícone Ações para a instância que você deseja gerenciar.
3. Na página de detalhes da instância, localize 'Reinicialização automática de falha de host'. Clique no ícone Editar e selecione Ativado ou Desativado para ativar ou desativar a política de recuperação do host.

Para obter mais informações, consulte Políticas de recuperação de falha de host.

Configurando a política de recuperação em caso de falha do host pela CLI

É possível atualizar uma instância na sua VPC do IBM Cloud® e alterar a política de disponibilidade em caso de falha do host usando a interface de linha de comando (CLI). Execute o comando ibmcloud instance-update e configure a propriedade --host-failure-policy como start ou stop. O serviço de política de falha de host está configurado como restart por padrão. Aqui, INSTANCE pode ser o ID ou o Nome da Instância..

ibmcloud is instance-update INSTANCE --total-volume-bandwidth VALUE --host-failure-policy stop

Configurando a política de recuperação em caso de falha do host por meio da API

Durante uma atualização de instância, a subpropriedade host_failure pode ser usada para definir o availability_policy de falha do host da instância do servidor virtual.

Configurando a política de recuperação em caso de falha do host usando o Terraform

É possível definir a política de recuperação em caso de falha do host para uma instância de servidor virtual atualizando o argumento availability_policy_host_failure no recurso ibm_is_instance . O valor padrão é restart.

O exemplo a seguir define a política como “ stop ”:

resource "ibm_is_instance" "example" {
  name                              = "my-instance"
  availability_policy_host_failure  = "stop"
  # ... other required arguments
}

Para obter mais informações, consulte o [argumento availability_policy_host_failure](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/is_instance#argument-reference){: external} na documentação do recurso ibm_is_instance .

Definição do valor de computação confidencial na CLI

Selecione a disponibilidade

A computação confidencial com Intel SGX para VPC e a computação confidencial com Intel TDX para VPC estão disponíveis nas regiões de Dallas (us-south), Washington DC (us-east) e Frankfurt (eu-de).

Você pode atualizar uma instância e alterar o " confidential-compute-mode usando a interface de linha de comando (CLI). Use o comando " ibmcloud is instance-update. Para INSTANCE, especifique a ID ou o nome da instância e defina a propriedade --confidential-compute-mode como sgx ou tdx.

ibmcloud is instance-update INSTANCE --confidential-compute-mode sgx

Definição do valor de computação confidencial a partir da API

Selecione a disponibilidade

A computação confidencial com Intel SGX para VPC e a computação confidencial com Intel TDX para VPC estão disponíveis nas regiões de Dallas (us-south), Washington DC (us-east) e Frankfurt (eu-de).

Você pode atualizar uma instância de servidor virtual e alterar a propriedade " confidential_compute_mode usando a API. Use o comando ibmcloud ' update-instance. Faça uma solicitação ' PATCH /instances e especifique um novo valor para a propriedade ' confidential_compute_mode. Para ativar a computação confidencial, altere esse valor para sgx ou tdx.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-10-17&generation=2" -H "Authorization: Bearer $iam_token" -d '{"confidential_compute_mode": "sgx"}'

Para obter mais informações, consulte a ação de atualização de uma instância na API Virtual Servers for VPC API.

Configurando o valor de computação confidencial usando o Terraform

Selecione a disponibilidade

A computação confidencial com Intel SGX para VPC e a computação confidencial com Intel TDX para VPC estão disponíveis nas regiões de Dallas (us-south), Washington DC (us-east) e Frankfurt (eu-de).

É possível atualizar o modo de computação confidencial de uma instância de servidor virtual atualizando o argumento confidential_compute_mode no recurso ibm_is_instance .

O exemplo a seguir habilita a computação confidencial do SGX:

resource "ibm_is_instance" "example" {
  name                     = "my-instance"
  confidential_compute_mode = "sgx"
  # ... other required arguments
}

Para obter mais informações, consulte o [argumento confidential_compute_mode](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/is_instance#argument-reference){: external} na documentação do recurso ibm_is_instance .

Desativar ou ativar a inicialização segura no console

Quando você seleciona um perfil de instância de computação confidencial, a opção de inicialização segura é ativada por padrão. Você pode desativar a inicialização segura na instância do servidor virtual, mas primeiro deve interromper a instância do servidor virtual. Depois de desativar a inicialização segura, você poderá reiniciar a instância do servidor virtual.

1. Na página Instâncias do servidor virtual no console IBM Cloud, selecione a instância do servidor virtual.
2. Em Ações, clique em Parar.
3. Nos detalhes da configuração avançada, alterne a inicialização segura para Desativado.
4. Em Ações, clique em Iniciar.

Se você decidir reativar a inicialização segura, siga estas mesmas etapas e alterne a opção novamente para Enabled

Ativação e desativação da inicialização segura na CLI

Quando você seleciona um perfil de instância de computação confidencial, a opção de inicialização segura é ativada por padrão. Você pode desativar a inicialização segura na instância do servidor virtual, mas primeiro deve interromper a instância do servidor virtual. Depois de desativar a inicialização segura, você poderá reiniciar a instância do servidor virtual.

Você pode atualizar uma instância e alterar o " enable-secure-boot usando a interface de linha de comando (CLI). Use o comando " ibmcloud is instance-update. Para INSTANCE, especifique a ID ou o nome da instância e defina a propriedade ' --enable-secure-boot como ' false.

ibmcloud is instance-update INSTANCE --enable-secure-boot false

Se você decidir reativar a inicialização segura, siga essas mesmas etapas e defina a propriedade --enable-secure-boot como true.

Ativação e desativação do valor de inicialização segura da API

Quando você seleciona um perfil de instância de computação confidencial, a opção de inicialização segura é ativada por padrão. Você pode desativar a inicialização segura na instância do servidor virtual, mas primeiro deve interromper a instância do servidor virtual. Depois de desativar a inicialização segura, você poderá reiniciar a instância do servidor virtual.

Você pode atualizar uma instância de servidor virtual e alterar a propriedade " enable_secure_boot usando a API. Faça uma solicitação do tipo “ PATCH /instances ” e especifique um valor booleano para a propriedade “ enable_secure_boot ”. O exemplo a seguir desativa a inicialização segura:

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-10-17&generation=2" -H "Authorization: Bearer $iam_token" -d '{"enable_secure_boot": false}'

Se você decidir reativar a inicialização segura, siga essas mesmas etapas e defina a propriedade enable_secure_boot como true.

Para obter mais informações, consulte a ação de atualização de uma instância na API Virtual Servers for VPC API.

Desconectando um servidor de uma reserva no console

Você pode desanexar um servidor virtual de uma reserva no console.

1. No IBM Cloud console, clique ícone Menu de navegação > Infraestrutura VPC > Reservas.
2. Em sua lista de servidores virtuais ou na página Detalhes da reserva, clique no servidor que você deseja remover e, em seguida, clique em Ações > Remover.
3. Para confirmar, clique em Remover.

Desvinculando um servidor de uma reserva pela CLI

Para conhecer as etapas para desassociar um servidor virtual de uma reserva usando a CLI, consulte Gerenciamento de uma reserva para VPC.

Desvincular um servidor de uma reserva por meio da API

Para conhecer as etapas necessárias para desassociar um servidor virtual de uma reserva por meio da API, consulte Gerenciamento de uma reserva para VPC.

Adicionar CSPM no console

Quando você seleciona essa opção, uma instância de proteção de carga de trabalho é criada com as configurações para fornecer CSPM a todos os recursos. Se houver uma instância de proteção de carga de trabalho, essa opção não estará disponível. Para obter mais informações, consulte Sobre IBM Cloud Security Posture Management(CSPM).

Você pode adicionar o CSPM (Cloud Security Posture Management ) na página Instâncias de servidor virtual.

1. Na página Instâncias de servidor virtual no console IBM Cloud, clique no nome de uma instância individual para ver os detalhes.
2. Na página de detalhes, acesse a aba “Integrações ”.
3. Em Gerenciamento de postura de segurança na nuvem, clique em Adicionar CSPM.
4. Na seção Adicionar gerenciamento de postura de segurança na nuvem (CSPM), clique em Criar.

Essa configuração adiciona o CSPM a uma instância existente do Workload Protection para sua conta. Para obter mais informações, consulte Implementação do CSPM(Cloud Security Posture Management)para IBM Cloud.

Visualizando os dispositivos de software de uma instância de servidor virtual usando a CLI

É possível visualizar os anexos de software de uma instância de servidor virtual criada a partir de uma imagem de catálogo usando a CLI.

• Para listar todos os anexos de software de uma instância, use [ibmcloud is instance-software-attachments](/docs/vpc?topic=vpc-vpc-reference#instance-software-attachments-list. A variável INSTANCE é o ID ou o nome da instância.

ibmcloud is instance-software-attachments INSTANCE [--output JSON] [-q, --quiet]

O exemplo a seguir lista todos os anexos de software da instância my-instance.

ibmcloud is instance-software-attachments my-instance

• Para visualizar os detalhes de um anexo de software específico de uma instância, use ibmcloud is instance-software-attachment. A variável INSTANCE é o ID ou o nome da instância. A variável SWAC é o ID ou o nome do anexo de software da instância.

ibmcloud is instance-software-attachment INSTANCE SWAC [--output JSON] [-q, --quiet]

O exemplo a seguir mostra os detalhes do anexo de software my-software-attachment para a instância my-instance.

ibmcloud is instance-software-attachment my-instance my-software-attachment

Atualização dos anexos de software de uma instância de servidor virtual usando a CLI

É possível atualizar os anexos de software de uma instância de servidor virtual criada a partir de uma imagem do catálogo usando a CLI.

Para atualizar o nome de um anexo de software de uma instância, use ibmcloud is instance-software-attachment-update. A variável INSTANCE é o ID ou o nome da instância. A variável SWAC é o ID ou o nome do anexo de software da instância. O valor “ --name ” é o novo nome do anexo de software da instância.

ibmcloud is instance-software-attachment-update INSTANCE SWAC --name NEW_NAME [--output JSON] [-q, --quiet]

O exemplo a seguir renomeia o anexo de software $software_attachment_id para my-renamed-software-attachment na instância my-instance.

ibmcloud is instance-software-attachment-update my-instance my-software-attachment --name my-renamed-software-attachment

Visualização dos anexos de software de uma instância de servidor virtual por meio da API

Ao criar uma instância de servidor virtual a partir de uma imagem de catálogo, é possível utilizar uma imagem de catálogo configurada especificamente com um plano de cobrança de software definido. Depois de criar sua instância de servidor virtual, você poderá visualizar os componentes de software que agora fazem parte dessa instância.

Para visualizar os anexos de software usando a API, faça uma solicitação do tipo “ GET /instances/{instance_id}/software_attachments ”.

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/instances/{instance_id}/software_attachments?version=2026-04-21" -H "Authorization: Bearer $iam_token"

Listagem de anexos de software de instâncias por meio da API

É possível listar programaticamente todos os anexos de software associados a uma instância de servidor virtual chamando a API da VPC.

O exemplo a seguir lista todos os anexos de software de uma instância com o ID de instância $instance_id.

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/instances/$instance_id/software_attachments?version=2024-06-23&generation=2" -H "accept: application/json" -H "Authorization: Bearer $iam_token"

Para obter mais informações, consulte “Listar anexos de software de instância associados a uma instância” na API da VPC.

Recuperação de um anexo de software de uma instância por meio da API

É possível recuperar um anexo de software de uma instância específica enviando uma solicitação do tipo “ GET /instances/{instance_id}/software_attachments/{id} ” e especificando o ID do anexo de software da instância e o ID da instância.

O exemplo a seguir recupera um anexo de software específico com o ID $software_attachment_id para uma instância com o ID $instance_id.

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/instances/$instance_id/software_attachments/$software_attachment_id?version=2024-06-23&generation=2" -H "accept: application/json" -H "Authorization: Bearer $iam_token"

Para obter mais informações, consulte “Recuperar um anexo de software de instância ” na API da VPC.

Atualização de um anexo de software de uma instância por meio da API

É possível atualizar um anexo de software de uma instância enviando uma solicitação do tipo “ PATCH /instances/{instance_id}/software_attachments/{id} ” e especificando o ID do anexo de software da instância e o ID da instância.

O exemplo a seguir atualiza um anexo de software com o ID $software_attachment_id para uma instância com o ID $instance_id.

curl -X PATCH "https://us-south.iaas.cloud.ibm.com/v1/instances/$instance_id/software_attachments/$software_attachment_id?version=2024-06-23&generation=2" -H "accept: application/json" -H "Authorization: Bearer $iam_token" -H "Content-Type: application/merge-patch+json" -d "{\"name\":\"my-software-attachment-patch\"}"

Para obter mais informações, consulte “Atualizar um anexo de software de instância ” na API da VPC.

Editando o número de threads por núcleo no console

O número de threads por núcleo oferece a flexibilidade necessária para otimizar sua carga de trabalho. Embora o número de threads por núcleo seja exibido para todos os perfis, você só pode editá-lo na família de perfis de Alta Frequência. Para perfis de alta frequência, o valor padrão é 2. Você pode ajustar esse valor para 1.

Embora o número de threads por núcleo seja exibido para todos os perfis, você só pode editá-lo na família de perfis de Alta Frequência. Antes de alterar a propriedade threads_per_core , é necessário parar a instância do servidor virtual.

1. Na página Instâncias de servidor virtual no console IBM Cloud, clique no nome de uma instância individual para ver os detalhes.
2. Na página de detalhes, acesse Profiles details e, em seguida, Threads per core. Clique em Edit.
3. Na página “Threads por núcleo”, edite o valor de “Threads por núcleo”.
4. Clique em Save.

Editando o número de threads por núcleo usando a CLI

O número de threads por núcleo oferece a flexibilidade necessária para otimizar sua carga de trabalho. Embora o número de threads por núcleo seja exibido para todos os perfis, você só pode editá-lo na família de perfis de Alta Frequência. Para perfis de alta frequência, o valor padrão é 2. Você pode ajustar esse valor para 1.

Antes de alterar a propriedade threads_per_core , é necessário interromper a instância do servidor virtual.

Você pode editar o valor de “ --threads-per-core ” da instância do servidor virtual no seu IBM Cloud VPC usando a interface de linha de comando (CLI). Para atualizar o valor de “ --threads-per-core ”, use o comando “ ibmcloud is instance-update ”. Especifique o ID ou o nome da instância do servidor virtual que você deseja atualizar usando a variável INSTANCE . Para a opção “ --threads-per-core ”, digite 1 ou 2.

ibmcloud is instance-update INSTANCE --threads-per-core [1]

Editando o número de threads por núcleo com a API

O número de threads por núcleo oferece a flexibilidade necessária para otimizar sua carga de trabalho. Embora o número de threads por núcleo seja exibido para todos os perfis, você só pode editá-lo na família de perfis de Alta Frequência. Para perfis de alta frequência, o valor padrão é 2. Você pode ajustar esse valor para 1.

Antes de alterar a propriedade threads_per_core , é necessário parar a instância do servidor virtual.

Você edita a propriedade threads_per_core da instância do servidor virtual no seu IBM Cloud VPC por meio da API. Use o comando " update-instance. Faça uma solicitação ' PATCH /instances e especifique um novo valor para a propriedade ' threads_per_core.

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-10-17&generation=2" -H "Authorization: Bearer $iam_token" -d '{"threads_per_core": "1"}'