UIを使用した使用許可式の定義

UIを使用して画像を作成する場合、 Advanced Options 領域に使用許可表現の詳細を追加できます。 既存の画像を表示している場合、画像の詳細には Virtual server expression と Bare metal server expression が含まれます。 これらのフィールドのいずれかを編集をクリックすると、使用許可式のテキストボックスが開きます。

使用許可式セクションはテキストボックスで、以下の表に示す式を追加することができます。 仮想サーバーインスタンスとベアメタルサーバーの使用許可表現の詳細については、以下の表を参照してください。

次の例は、GPUの製造元がNvidiaで、GPUカウントが1より大きい仮想サーバーインスタンスに対する使用許可式です。 セキュアブートが必要です。

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

使用許可式の作成に使用されるCommon Expression Languageの詳細については、 Google 's CEL Language Definition referenceを参照のこと

CLIを使用した使用許可式の定義

仮想サーバーインスタンスとベアメタルサーバーの使用許可表現の詳細については、以下の表を参照してください。

次のコード例は、CLI を使用して新しいカスタム・イメージを作成する際に allowed-use expression オプションを使用する方法を示しています。 この例では、ベアメタルサーバーに対してセキュアブートの有効化を要求し、仮想サーバーインスタンスのあらゆるプロビジョニングを許可するようにイメージを設定しています。

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

次のコード例は、CLI を使用して既存のカスタム・イメージを更新する際に、allowed-use expression オプションを使用する方法を示しています。 この例では、ベアメタルサーバーと仮想サーバーインスタンスの両方のプロビジョニングにセキュアブート有効化を要求するようにイメージを更新しています。

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

CLI で使用できる式オプションと変数の詳細については、 VPC CLI リファレンス「イメージ」を 参照してください。 使用許可式の作成に使用されるCommon Expression Languageの詳細については、 Google 's CEL Language Definition referenceを参照のこと

APIを使用した使用許可式の定義

仮想サーバーインスタンスとベアメタルサーバーの使用許可表現の詳細については、以下の表を参照してください。

使用許可表現を使って新しいカスタム画像を作成するには、 POST /images APIコマンドを使用します。 次の例では、GPU 数が 1 より大きく、GPU 製造元が Nvidia である仮想サーバーインスタンス用に、使用許可 式を持つ新しいカスタムイメージを作成します。 セキュアブートが必要です。 ベアメタルサーバーの使用許可式が false に設定されているため、このイメージはベアメタルサーバーのプロビジョニングに使用できません。

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"
      }
    }'

使用許可式を使って既存のカスタム画像を更新するには、 PATCH /images APIコマンドを使用します。 次の例では、GPU 数が 1 より大きく、GPU 製造元が Nvidia である仮想サーバーインスタンスの使用許可 式を使用して、既存のカスタムイメージを更新します。 セキュアブートが必要です。 ベアメタルサーバーの使用許可式が false に設定されているため、このイメージはベアメタルサーバーのプロビジョニングに使用できません。

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"
  }
}'

APIの詳細については allowed_use プロパティとサブプロパティの詳細については、「 Virtual Private Cloud API: イメージの作成」 および 「Virtual Private Cloud API: イメージの更新」を 参照してください。 使用許可式の作成に使用されるCommon Expression Languageの詳細については、 Google 's CEL Language Definition referenceを参照のこと

Terraformを使った使用許可式の定義

仮想サーバーインスタンスとベアメタルサーバーの使用許可表現の詳細については、以下の表を参照してください。

使用許可表現を使って新しいカスタム画像を作成したり、既存の画像を更新したりするには、 ibm_is_image リソースを更新します。 次の例では、GPU 数が 1 より大きく、GPU 製造元が Nvidia である仮想サーバーインスタンス用に、使用許可 式を持つ新しいカスタムイメージを作成します。 セキュアブートが必要です。 ベアメタルサーバーの使用許可式が false に設定されているため、このイメージはベアメタルサーバーのプロビジョニングに使用できません。

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”
  }
}

使用許可式の作成に使用されるCommon Expression Languageの詳細については、 Google のCEL言語定義リファレンス</>を参照のこと