2026-09-01 バージョンへの更新(インスタンスプロファイルの vCPU のカウント変更)

VPC API リファレンスのバージョン管理ポリシーに記載 されているとおり、VPC API に対する変更のほとんどは完全な下位互換性を保っており、クライアントがリクエストする API バージョンにかかわらず、すべてのクライアントが利用できるようになっています。 ただし、VPC APIの 2026-09-01 リリースでは、インスタンスプロファイルの vCPU カウント値のモデル更新に対応するため、互換性のない変更が必要となります。

2026-09-01 以降のリリース版を導入する前に、本移行ガイドに記載されている変更点を確認し、クライアントの更新が必要となる可能性がないかご確認ください。

インスタンスプロファイルのプロパティを変更しました

バージョンクエリパラメータとして「 2026-09-01 」以降を使用するAPIリクエストについては、以下のプロパティが変更されます。

取得 または 掲載情報 のインスタンスプロファイルでは、 version のクエリパラメータとして 2026-09-01 以降を使用するAPIリクエストについて、以下のプロパティが変更されます。

インスタンスプロファイルの取得または一覧表示時のプロパティが変更されました。
変更されたプロパティ 変更
vcpu_count 固定された単一の値は削除され、配列に置き換えられます。
supported_vcpu_count レスポンスから削除されます。

2026-09-01 以前の API バージョンでは、 vcpu_count は固定値として返されることがあり、 supported_vcpu_count にはサポートされている列挙値が記載されています。 APIバージョン 2026-09-01 以降では、プロファイルが列挙型ベースの値を返す場合、レスポンスから supported_vcpu_count が削除され、 vcpu_count には許可された値が直接含まれるようになります。

必要なアクション

2026-09-01 以降のバージョンで「 version 」クエリパラメータを指定する前に、クライアント機能の退行を回避するため、以下の手順に従ってください。

クライアントが supported_vcpu_count.values を参照している場合は、これを vcpu_count.values に変更してください。

クライアントが、 vcpu_count には常に固定の value が含まれていると想定している場合は、 vcpu_count に対するサポートされているレスポンス(列挙型、範囲型、および依存型値を含む)を処理できるよう、これを更新してください。

お客様が引き続き 2026-09-01 より以前のバージョンを指定される場合は、変更は必要ありません。

クライアントの移行

クライアントをAPIバージョン 2026-09-01 以降に移行する前に、以下のメソッドを使用しているコードを確認してください:

  • GET /instance/profiles/{name}
  • GET /instance/profiles

API変更ログで発表される変更内容を確認し、ご使用のプログラミング言語に適した方法で、コードにこれらの変更が反映されていることを確認してください。

以下の例は、 2026-09-01 のAPIバージョン変更前後のレスポンスを示しています。

インスタンスプロファイルの取得

以下の応答は、 2026-09-01 より前の API バージョンを使用したリクエストに対するものです。 vcpu_count プロパティには固定値が格納されており、 supported_vcpu_count にはサポートされている値が格納されています。

{
  "name": "bx2-custom",
  "resource_type": "instance_profile",
  "vcpu_count": {
    "type": "fixed",
    "value": 4
  },
  "supported_vcpu_count": {
    "type": "enum",
    "values": [2, 4]
  }
}