---
name: vpc-api-metadata-beta-change-log
title: Beta VPC Metadata API change log
description: Read the API change log to learn about updates and improvements to the IBM Cloud® Virtual Private Cloud (VPC) Beta Metadata API. Change log announcements are ordered by the date that they were released.
last-updated: 2025-07-15
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/vpc?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Beta VPC Metadata API change log
{: #metadata-beta-api-change-log}

Read the API change log to learn about updates and improvements to the IBM Cloud® Virtual Private Cloud (VPC) [Beta Metadata API](https://cloud.ibm.com/docs/apis/vpc-metadata-beta). Change log announcements are ordered by the date that they were released.
{: shortdesc}

Some beta features are for accounts that have special approval to preview a particular beta feature. Contact your IBM sales representative if you are interested in getting access.
{: beta}

Compatibility with earlier versions is not guaranteed as a feature progresses through its beta phase or from the final beta release to its initial GA release. Using non-GA-mature features might introduce the risk of corrupting resources in your account. IBM strongly recommends that you do not use non-GA-mature features on production accounts.
{: important}

To review the change log of generally available metadata API features, see the [VPC Metadata API change log](https://cloud.ibm.com/docs/vpc?topic=vpc-metadata-api-change-log&format=markdown).

## 15 July 2025
{: #15-july-2025-metadata-beta}

This feature is now generally available. See the [VPC API change log](https://cloud.ibm.com/docs/vpc?topic=vpc-api-change-log&format=markdown#26-august-2025).

### For all version dates
{: #15-july-2025-all-version-dates-metadata-beta}

**Access tokens and Certificates methods.** The existing access tokens and certificates methods in the [Beta VPC Metadata API](https://cloud.ibm.com/docs/apis/vpc-metadata-beta) are documented in the new [Beta VPC Identity API](https://cloud.ibm.com/docs/apis/vpc-identity-beta). For details, see the [Beta VPC Identity change log](https://cloud.ibm.com/docs/vpc?topic=vpc-identity-beta-api-change-log&format=markdown#15-july-2025-identity-beta).

## 17 December 2024
{: #17-december-2024-metadata-beta}

### For all version dates
{: #17-december-2024-all-version-dates-metadata-beta}

**Enhanced confidential computing capabilities.** If [Intel® Trust Domain Extensions](https://cloud.ibm.com/docs/vpc?topic=vpc-about-confidential-computing-vpc&format=markdown) are enabled on an instance or instance template, you can view the `confidential_compute_mode` property new value `tdx`, which indicates that confidential compute mode is enabled for this virtual server instance. For more information, see the [Beta VPC API change log](https://cloud.ibm.com/docs/vpc?topic=vpc-api-change-log-beta&format=markdown#17-december-2024-beta).

## 11 July 2023
{: #11-july-2023-metadata-beta}

### For all version dates
{: #11-july-2023-all-version-dates-metadata-beta}

**Instance identity certificates.** You can now use the instance identity access token and a Certificate Signing Request (CSR) to [create](https://cloud.ibm.com/docs/apis/vpc-metadata-beta/latest#create-certificate) an instance identity certificate. For more information, see [Generating an instance identity certificate by using an instance identity access token](https://cloud.ibm.com/docs/vpc?topic=vpc-imd-identity-operations&interface=api&format=markdown#imd-acquire-certificate). Instance identity certificates can be used when the traffic between an authorized client and the mounted file share is [encrypted in transit](https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-vpc-eit&format=markdown). For more information, see [Data encryption in transit for file shares](https://cloud.ibm.com/docs/vpc?topic=vpc-api-change-log-beta&format=markdown#11-july-2023-beta).

This feature is now generally available. See the [VPC Metadata API change log](https://cloud.ibm.com/docs/vpc?topic=vpc-metadata-api-change-log&format=markdown#15-august-2023-metadata).

## 16 August 2022
{: #16-august-2022-metadata-beta}

### For all version dates
{: #16-august-2022-all-version-dates-metadata-beta}

**Sharing images across an enterprise account.** For accounts that have special approval to preview this feature, if a virtual server instance was provisioned from a catalog offering, [retrieving the instance](https://cloud.ibm.com/docs/apis/vpc-metadata#get-instance) will now include a `catalog_offering` property in the response. For more information, see the [Virtual Private Cloud Metadata API](https://cloud.ibm.com/docs/apis/vpc-metadata).

See also [Onboarding a virtual server image for VPC](https://cloud.ibm.com/docs/account?topic=account-catalog-vsivpc-tutorial&format=markdown) and the [Import offering](https://cloud.ibm.com/docs/apis/resource-catalog/private-catalog#import-offering){: external} method in the Catalog Management API.

This feature is now generally available. See the [VPC Metadata API change log](https://cloud.ibm.com/docs/vpc?topic=vpc-metadata-api-change-log&format=markdown#27-september-2022-metadata).

## 1 March 2022
{: #1-march-2022-metadata-beta}

### For all version dates
{: #1-march-2022-all-version-dates-metadata-beta}

**VPC Metadata service.** The [VPC Metadata API](https://cloud.ibm.com/docs/apis/vpc-metadata) is now generally available in all regions. See [About VPC Metadata](https://cloud.ibm.com/docs/vpc?topic=vpc-imd-about&format=markdown) and [Known issues](https://cloud.ibm.com/docs/vpc?topic=vpc-known-issues&format=markdown).

## 2 November 2021
{: #2-november-2021-metadata-beta}

### For all version dates
{: #2-november-2021-all-version-dates-metadata-beta}

The VPC Metadata service introduces a [new method](https://cloud.ibm.com/docs/apis/vpc-metadata-beta/latest#create-iam-token) (`POST /instance_identity/v1/iam_token`) to [generate an IAM token](https://cloud.ibm.com/docs/vpc?topic=vpc-imd-identity-operations&interface=api&format=markdown#imd-token-exchange) from an instance identity access token. This method uses the instance identity access token and a trusted profile linked to a virtual server instance to generate an IAM access token. Beta users should migrate to this new method. Using the IAM API to pass the instance identity access token and generate an IAM token is deprecated.