VPC Identity API の変更履歴
IBM Cloud® Virtual Private Cloud （VPC） Identity API の更新内容や改善点については、API 変更履歴をご覧ください。 変更ログの発表は、公開された日付順に並べられています。 既存の API バージョンに対する変更は、既存のクライアント・アプリケーションの互換性が確保されるように設計されています。
設計上、後方非互換の変更が行われた新機能は、その機能のリリース以降の日付のバージョンにのみ適用されます。 古いバージョンの API に適用される変更は、既存のアプリケーションおよびコードとの互換性を維持するように設計されています。 後方互換性のない変更により、API バージョンを使用するためにクライアントコードに相当な変更が必要となる場合、API 変更ログには、クライアントコードを更新するための手順、ヒント、またはベストプラクティスへのリンクが掲載されていることがあります。
新しいレスポンスプロパティや新しいオプションのリクエストパラメータなど、一部の変更は以前のバージョンとの互換性があると見なされます。 その他の変更内容 (新しい必須要求パラメーターなど) は、後方互換性があるとは見なされません。 API の変更による混乱を避けるため、API を呼び出すときには以下のベスト・プラクティスに従ってください。
- HTTP 状況コード
4xxまたは5xxは、含まれているtraceプロパティーと共にキャッチしてログに記録します - HTTP 状況コード
3xxの場合は、HTTP リダイレクト・ルールに従います - アプリケーションの動作に必要なリソースとプロパティのみを使用してください
- 明示的に文書化されていない動作に依存することは避けます
2026年6月23日
すべてのバージョン日付について
サードパーティのライセンスおよび利用権管理サービス。 VPC Identity サービスでは、 インスタンス ID トークンの作成時に、オプションの nonce パラメータがサポートされるようになりました。 リクエストで nonce の値を指定すると、その値は署名付きトークンのレスポンスに含まれるため、ベンダーのソフトウェアは、自身が IBM Cloud 上で実行されていること、およびトークンが最近生成されたものであることを確認できるようになります。 この認証メカニズムにより、ベンダーは自社のソフトウェアが、承認された IBM Cloud 環境で実行されていることを確認することができます。
詳細については、「 インスタンス識別操作 」を参照してください。
2025年8月26日
すべてのバージョン日付について
ベアメタルサーバーのサポート。 ベアメタルサーバーから VPC Identity API にアクセスできるようになった。 new create identity token メソッドを使用してベアメタルサーバーの ID トークンを作成し、そのトークンを new create identity certificate メソッドに渡します。 あるいは、そのトークンを create IAM access token メソッドに渡して、そのトークンを使って IAM 対応のサービスにアクセスすることもできる。 また、仮想サーバーインスタンスからこれらの新しいメソッドを使用することもできます。 詳細については、 VPC Identity API を参照してください。
バージョン 2025-08-26 以降の場合
インスタンス ID メソッド。 クエリパラメータ version または 以降 2025-08-26 が使用された場合、 メソッド /instance_identity が削除されたため 404 、リクエストは の HTTP レスポンスで失敗します。 クライアントは新しい /identity 方法に移行する必要があります。
詳細については、 2025-08-26 APIバージョン移行ガイドを 参照してください。 仮想サーバーインスタンスからバージョンクエリパラメータとして 2025-08-25 またはそれ以前のバージョンが使用された場合、動作は変更されません。
詳細については、 VPC Identity API の既知の 問題を参照してください。