Definição de expressões de uso permitido usando a interface do usuário

Quando estiver criando uma imagem usando a interface do usuário, você poderá adicionar os detalhes da expressão de uso permitido na área Advanced Options. Se estiver visualizando uma imagem existente, os detalhes da imagem incluem Virtual server expression e Bare metal server expression. Clique em editar em um desses campos para abrir a caixa de texto da expressão de uso permitido.

A seção de expressões de uso permitido é uma caixa de texto na qual é possível adicionar as expressões conforme detalhado na tabela a seguir. Consulte as tabelas a seguir para obter detalhes sobre a expressão de uso permitido para instâncias de servidores virtuais e servidores bare metal.

O exemplo a seguir é uma expressão de uso permitido para uma instância de servidor virtual para contagem de GPU maior que um com a Nvidia como fabricante da GPU. A inicialização segura é necessária.

gpu.count > 1 && gpu.manufacturer == 'nvidia' && enable_secure_boot

Para obter mais informações sobre a Common Expression Language, que é usada para criar a expressão de uso permitido, consulte a referência CEL Language Definition do site Google

Definição de expressões de uso permitido usando a CLI

Consulte as tabelas a seguir para obter detalhes sobre a expressão de uso permitido para instâncias de servidores virtuais e servidores bare metal.

O exemplo de código a seguir mostra como usar as opções de expressão de uso permitido quando você cria uma nova imagem personalizada usando a CLI. O exemplo configura a imagem para exigir a habilitação de inicialização segura para um servidor bare metal e para permitir qualquer fornecimento de uma instância de servidor virtual.

ibmcloud is image-create my-ubuntu-20-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-20-04-amd64 --allowed-use-bare-metal-server "enable_secure_boot==true" --allowed-use-instance true

O exemplo de código a seguir mostra como usar as opções da expressão allowed-use quando você atualiza uma imagem personalizada existente usando a CLI. O exemplo é a atualização de uma imagem para exigir a habilitação de inicialização segura para provisões de um servidor bare metal e de uma instância de servidor virtual.

ibmcloud is image-update r006-c9da1575-20cd-4412-9269-8ed08d3ac278 --allowed-use-bare-metal-server enable_secure_boot==true --allowed-use-instance enable_secure_boot==true

Para obter mais informações sobre as opções e variáveis da expressão de uso permitido da CLI, consulte a referência da CLI do VPC: Imagens. Para obter mais informações sobre a Common Expression Language, que é usada para criar a expressão de uso permitido, consulte a referência CEL Language Definition do site Google

Definição de expressões de uso permitido usando a API

Consulte as tabelas a seguir para obter detalhes sobre a expressão de uso permitido para instâncias de servidores virtuais e servidores bare metal.

Para criar uma nova imagem personalizada com expressões de uso permitido, use o comando da API POST /images. O exemplo a seguir cria uma nova imagem personalizada com uma expressão de uso permitido para uma instância de servidor virtual para contagem de GPU maior que um com a Nvidia como fabricante da GPU. A inicialização segura é necessária. A expressão bare metal server allowed-use é definida como false, o que impede que a imagem seja usada para provisionar um servidor bare metal.

curl -X POST "$vpc_api_endpoint/v1/images?version=$today&generation=2" -H "Authorization: Bearer $iam_token" -d '{
      "name": "my-image",
      "file": {
        "href": "cos://us-south/my-bucket/my-image.qcow2"
      },
      "operating_system": {
        "name": "debian-9-amd64"
      },
      "allowed_use": {
         "instance": "gpu.count > 1 && gpu.manufacturer == \"nvidia\" && enable_secure_boot",
         "bare_metal_server": "false"
      }
    }'

Para atualizar uma imagem personalizada existente com uma expressão de uso permitido, use o comando da API PATCH /images. O exemplo a seguir atualiza uma imagem personalizada existente com uma expressão de uso permitido para uma instância de servidor virtual para contagem de GPU maior que um com a Nvidia como fabricante da GPU. A inicialização segura é necessária. A expressão bare metal server allowed-use é definida como false, o que impede que a imagem seja usada para provisionar um servidor bare metal.

curl -X PATCH "$vpc_api_endpoint/v1/images/$image_id?version=$today&generation=2" -H 'Content-Type: application/json' -H "Authorization: Bearer $iam_token"  -d '{
"allowed_use": {
  "instance": "gpu.count > 1 && gpu.manufacturer == \"nvidia\" && enable_secure_boot",
  "bare_metal_server": "false"
  }
}'

Para obter mais detalhes sobre a propriedade e as subpropriedades da API allowed_use, consulte a API do Virtual Private Cloud: Criar imagem e API de nuvem privada virtual: Atualizar imagem. Para obter mais informações sobre a Common Expression Language, que é usada para criar a expressão de uso permitido, consulte a referência CEL Language Definition do site Google

Definição de expressões de uso permitido usando o Terraform

Consulte as tabelas a seguir para obter detalhes sobre a expressão de uso permitido para instâncias de servidores virtuais e servidores bare metal.

Para criar uma nova imagem personalizada com expressões de uso permitido ou atualizar uma imagem existente, atualize o recurso ibm_is_image. O exemplo a seguir cria uma nova imagem personalizada com uma expressão de uso permitido para uma instância de servidor virtual para contagem de GPU maior que um com a Nvidia como fabricante da GPU. A inicialização segura é necessária. A expressão bare metal server allowed-use é definida como false, o que impede que a imagem seja usada para provisionar um servidor bare metal.

resource "ibm_is_image" "example" {
  name               = "my-image"
  href               = "cos://us-south/buckettesttest/livecd.ubuntu-cpc.azure.vhd"
  operating_system   = "ubuntu-16-04-amd64"
  allowed_use{
    api_version       = "2025-04-03"
    bare_metal_server = “enable_secure_boot == true”
    instance = “gpu.count > 0 && enable_secure_boot == true”
  }
}

Para obter mais informações sobre a Common Expression Language, que é usada para criar as expressões de uso permitido, consulte Google 's CEL Language Definition reference</