VPC Identity API 更改日志

阅读 API 变更日志，了解针对 IBM Cloud® Virtual Private Cloud (VPC) 身份 API 的更新与改进。 变更日志公告按其发布日期排序。 对现有 API 版本的更改旨在与现有客户端应用程序兼容。

根据设计，不向后兼容更改的新功能仅适用于等于和晚于功能发布日期的版本日期。 应用于较低版本 API 的更改旨在保持与现有应用程序和代码的兼容性。 若向后不兼容的变更需要对客户端代码进行非微小的修改才能使用某个 API 版本，则 API 变更日志可能会提供更新客户端代码的说明、技巧或最佳实践的链接。

某些变更（例如新增响应属性或新增可选请求参数）被视为与早期版本兼容。 其他更改，如新的所需请求参数，不被视为向后兼容。 为避免因更改 API 而造成中断，请在调用 API 时使用以下最佳实践：

  • 捕获并记录任何 4xx 或 5xx HTTP 状态码以及包含的 trace 属性
  • 遵循任何 3xx HTTP 状态码的 HTTP 重定向规则
  • 仅使用应用程序运行所需的资源和属性
  • 避免依赖于未明确记录的行为

2026年6月23日

所有版本日期

第三方许可和授权服务。 VPC Identity 服务现在在创建实例身份令牌时，支持可选的 nonce 参数。 当您在请求中指定 nonce 值时，该值会被包含在带签名的令牌响应中，从而使供应商软件能够验证其是否正在 IBM Cloud 上运行，以及该令牌是否为最近生成的。 该认证机制有助于供应商确保其软件在经过授权的 IBM Cloud 环境中运行。

如需了解更多信息，请参阅“实例身份操作”。

2025 年 8 月 26 日

所有版本日期

支持裸机服务器。 现在您可以从裸机服务器访问 VPC Identity API。 使用新的 创建身份令牌 方法为裸机服务器创建身份令牌，并将该令牌传递给新的 创建身份证书 方法。 或者，您可以将该令牌传递给 创建 IAM 访问令牌 方法，然后使用该令牌访问支持 IAM 的服务。 您还可以在虚拟服务器实例中使用这些新方法。 更多信息，请参阅 VPC Identity API。

适用于 2025-08-26 或更高版本

实例身份识别方法。 当使用 或 2025-08-26 更高版本的查询 version 参数时，请求将 404 因 方法 /instance_identity 已被移除而失败，并返回 状态码的 HTTP 响应。 客户需要迁移到新的 /identity 方法。 有关详细信息，请参阅 2025-08-26 API 版本迁移指南。 当从虚拟服务器实例使用版本查询参数为 2025-08-25 或更早时，该行为保持不变。

更多信息，请参阅 VPC Identity API 已知问题。