v2.0.0

2.0.0 (March 30, 2026)

Key Takeaway - What You Need to Know

Nothing changes for you! This release adds internal support for Terraform's Plugin Framework alongside our existing implementation. All your existing Terraform configurations work exactly as before with zero changes required.

Why Version 2.0.0?

We're bumping to v2.0.0 to signal an important internal architectural enhancement: the provider now supports Terraform Plugin Framework in addition to the existing SDKv2 implementation. This is a major milestone that enables future capabilities while maintaining complete backward compatibility.

What This Means for You

For Existing Users:

• ✅ All your existing resources and data sources work unchanged
• ✅ No modifications needed to your Terraform configurations
• ✅ No breaking changes whatsoever
• ✅ Your state files remain fully compatible
• ✅ Simply update the version and continue as normal

For New Users:

• ✅ Same great provider experience
• ✅ Access to all IBM Cloud services
• ✅ Future-ready architecture

What Changed Internally

The provider now runs two implementations side-by-side using terraform-plugin-mux:

1. SDKv2 Provider (existing) - Handles all current resources and data sources
2. Plugin Framework Provider (new) - Enables next-generation features

This dual architecture is completely transparent to you. The provider automatically routes requests to the appropriate implementation.

Why Add Plugin Framework Support?

The Plugin Framework enables us to deliver future enhancements:

• Terraform Actions - Imperative operations on resources (requires Terraform 1.10+)
• Better Type Safety - Improved handling of complex nested structures
• Enhanced Validation - More expressive validation rules
• Improved Error Messages - Clearer diagnostics and actionable guidance
• Modern Features - Access to latest Terraform capabilities

Upgrading from v1.x

Step 1: Update Your Version Constraint

terraform {
  required_providers {
    ibm = {
      source  = "IBM-Cloud/ibm"
      version = "~> 2.0.0"  # Changed from "~> 1.89.0"
    }
  }
}

Step 2: Upgrade the Provider

terraform init -upgrade

Step 3: Verify (Optional)

terraform plan

You should see no changes - everything works exactly as before!

What's Next?

In future releases, we'll gradually:

• Introduce new resources using the Plugin Framework
• Migrate existing resources where it provides clear benefits (depending on the requirements)
• Implement Actions for resources that benefit from imperative operations
• Continue improving the provider experience

All changes will be backward compatible and clearly documented.

FAQ

Q: Do I need to change my Terraform configurations?
A: No! Everything works exactly as before.

Q: Will my state files still work?
A: Yes, state files are fully compatible.

Q: Is this a breaking change?
A: No, this release has zero breaking changes. We're using v2.0.0 to signal the architectural enhancement.

Q: Why bump to v2.0.0 if nothing breaks?
A: To clearly communicate this significant internal milestone and set expectations for future framework-based enhancements.

Q: Can I rollback if needed?
A: Yes, simply change the version constraint back to ~> 1.89.0 and run terraform init -upgrade.

Q: When will I see new features from the Plugin Framework?
A: New capabilities will be introduced incrementally in upcoming 2.x releases.

Support

• Documentation: https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs
• GitHub Issues: https://github.com/IBM-Cloud/terraform-provider-ibm/issues
• IBM Cloud Support: https://cloud.ibm.com/unifiedsupport/supportcenter

Summary

Version 2.0.0 is an internal architectural enhancement that adds Plugin Framework support while maintaining 100% backward compatibility. Your existing Terraform configurations work unchanged - simply update the version constraint and continue managing your IBM Cloud infrastructure as you always have.

- The IBM Cloud Terraform Provider Team

Notes :

Bug Fixes

• Power Systems: CCNA Error Msg Refactor (#6711)
• Power Systems: Capture Error Msg Refactor (#6712)
• VPC Infrastructure: Update size validation range for RFS (#6709)
• General: Fix the missing read env for provider (#6704)
• VPC Infrastructure: fixed document for is_images datasource (#6689)
• Transit Gateway: handle create timeout by checking existing connec… (#6703)
• Cloud Internet Services: handle null timestamps in CIS custom page resource (#6702)
• Cloud Logs: add Computed to alert filter_type and incident_settings fields (#6716)
• Partner Center Sell: Add id to composite children plan updatable flag is editable parnercentersellv1 (#6698)

Enhancements

• Code Engine: Add ibm_code_engine_build_run action with Plugin Framework support (#6611)
• Power Systems: Add externalIP attribute for network_interface (#6705)
• Power Systems: Add Asaps To SAP Profile/s (#6708)
• Cloud Databases: Refactor ibm_database resource and datasource to introduce backend abstraction (#6667)
• Transit Gateway: support Secrets Manager CRNs in authentication_key (#6713)
• Cloud Logs: Logs Routing Default Private CSE endpoint and write_status (#6710)
• Cloud Logs: Update Views API for PR #164 (#164)
• Secrets Manager: Private path support for Code Engine (#6699)
• Configuration Aggregator: Add IBM Account Management API Support (#6701)
• Cloud Logs: Add IBM Cloud Logs Extensions API support (#6700)
• Secrets Manager: SM event notification datasource should not fail when no registration exists (#6692)

v1.89.0

1.89.0 (March 2, 2026)

Bug Fixes

• CIS: Fixed mTLS empty hostnames issue (#6669)
• Global Tagging: Fixed tagging error (#6681)
• Activity Tracker: Removed redundant checks to fix build on Go 1.26 (#6682)
• Cloud Databases: Added nil check on response in ibm_database resource (#6660)

Enhancements

• CD Tekton Pipeline: Fixed multiline properties handling (#6680)
• Cloud Object Storage: Updated documentation for COS cross-account access (#6685)
• IAM: Terraform no longer plans an update-in-place when no resources exist for a template assignment (#6664)
• Power Systems: Refactored host group update logic (#6677)
• Toolchain: Added region discontinuation warnings for Continuous Delivery (CD) (#6687)

v1.88.3

1.88.3 (February 23, 2026)

Bug Fixes

• Backup/Recovery: update connection schema (#6645)

Enhancements

• General: updated code owners (#6674)

v1.88.2

What's Changed

• Fix: Instance ruleset rule handling for OWASP logging #6644
• Update unit wording to conform to new standard (#285) #6652
• remove managed by example #6659
• Fix: prevent duplicate user invite API calls causing 409 error #666

v1.88.1

What's Changed

• Add expires_at to service_api_key #6654
• fix(instance-group): fixed error on instance group wait #6655
• Fix the docs related to COS backup vault policies #6650

v1.88.0

1.88.0 (February 6, 2026)

Bug Fixes

• Catalog Management: fix import of ibm_cm_offering (#6636)
• Cloud Logs: change inclusion_filters to optional (#6649)
• IAM: Fix policy creation when resourceType is set to 'resource-group' (#6621)

Enhancements

• Code Engine: add support for code engine pds, hmac secrets and trusted profiles (#6610)
• Schematics: extend template type validation regex (#6593)
• Cloud Databases: Add async_restore field for fast PG restore (#6630)
• Cloud Logs: add terraform support for logs router v3 (#6627)
• IAM: add api key expiration field (#6640)
• Platform Notifications: Platform Notification Distribution List API: Terraform support (#6628)
• Power Systems: Update DHCP status check for polling (#6642)
• VPC Infrastructure: Added an empty check on allowed_use for is_instance and is_volume (#6631)
• VPC Infrastructure: added support for spot virtual server instances (#6637)
• VPC Infrastructure: add network-bandwidth-mode support (#6648)
• General: Update MR in-che endpoint (#6647)

v1.87.3

1.87.3 (January 28, 2026)

Bug Fixes

• Global Catalog: issue 6085 - fix import of ibm_cm_offering (#6636)

Enhancements

• Cloud Databases: Add async_restore field for fast PG restore (#6630)

v1.87.2

1.87.2 (January 19, 2026)

Bug Fixes

• Enterprise Management: fix the redhat regex length range and add - to allowed strings (#6623)
• Transit Gateway: fix update logic of vpn gateway connection peer (#6622)

Enhancements

• VPC Infrastructure: added name field in other protocols (#6602)
• General: Bump up version to 1.87.2 (#6632)

v1.87.1

1.87.1 (January 13, 2026)

Enhancements

• Enterprise Management: support redhat regex expression to owner id validation (#6617)

v1.87.0

1.87.0 (January 12, 2026)

Bug Fixes

• Power Systems: Add dumprestart action to ibm_pi_instance_action resource (#6560)
• Configuration Aggregator: Dra terraform apis (#6582)
• IAM: Fix role templates and add policy template to support role templates (#6591)

Cloud Databases

• Fix the attribute in backup_id parameter (6567)

IAM

• fix(IAM Policy Management): Fix subject stringExists (6598)

Cloud Logs

• prevent panic when before list contains nil element (6580)

DR AutomationService

• Dra terraform apis- fmt issue fixed (6612)
• Dra terraform apis (6600)

VPC Infrastructure

• added validation for public address range name (6608)

Enhancements

• VPC Infrastructure: support for endpoint gateway resource bindings (#6568)
• VPC Infrastructure: Add support for all ipv4 protocol in security group rule and network acl rule (#6586)
• VPC Infrastructure: adding security group rule name (#6587)
• VPC Infrastructure: added VCPU models support for instance resources (#6595)
• Power Systems: [R][D] vPMEM (#6561)
• Power Systems: Add PowerVS data sources: ibm_pi_instance_network and ibm_pi_instance_networks (#6564)
• Power Systems: Increase NSG action timeout (#6576)
• Power Systems: [D] Add missing image attributes to data sources (#6558)
• Power Systems: Update Workspace Arg (#6559)
• Power Systems: Parameter option and corresponding tests with shared image (#6584)
• Power Systems: Update Power Go Client (#6592)
• Backup/Recovery: Helios reporting apis support (#6309)
• Backup/Recovery: update code for latest iks-roks changes in v7.2.16 (#6572)
• Activity Tracker: support for managed_by property in iac. (#6581)
• General: support managed_by field (#6583)

Backup/Recovery

• add auto_proetction_group_id (6607)

Documentation

• Toolchain: EOS SCC-CSPM: removing the SCC Docs related to resources and Datasources