1.15.0-upgrade-guide.html.markdown

layout	page_title	sidebar_current	description	MongoDB Atlas Provider 1.15.0
mongodbatlas	MongoDB Atlas Provider 1.15.0: Upgrade and Information Guide	docs-mongodbatlas-guides-1150-upgrade-guide		Upgrade and Information Guide

MongoDB Atlas Provider 1.15.0: Upgrade and Information Guide

The Terraform MongoDB Atlas Provider version 1.15.0 has a number of new and exciting features.

New Resources, Data Sources, and Features:

Breaking Changes:

Deprecations and Removals:

• Removal of page_num and items_per_page attributes in mongodbatlas_search_indexes data source.
• Format of IdP Id that uniquely identifies the identity provider when importing mongodbatlas_federated_settings_identity_provider resource and mongodbatlas_federated_settings_identity_provider data source now accepts a different format to align with the Atlas Admin API. Details and upgrade guide can be found below:

Both the current and new IdP Id format are accepted in terraform-provider version 1.15.x. New features for mongodbatlas_federated_settings_identity_provider resource and data source will only be available when using the new Id format.

WARNING: Old IdP Id format will no longer be accepted starting in terraform-provider 1.16.0 version and onwards. We recommend to update to the new format as soon as possible. A warning will appear if old Id is still being used. Follow the guide below to start using the new Id format.

Note: The old IdP Id format was a 20-hex characters long string. The new IdP Id format is a 24-hex characters long string.

Update Guide:

1. How to get the new IdP Id 24-hex characters string ID value
   • Option 1: Use Atlas API v20231001, both of the following endpoints include the new id in the response:
     • Use Return all identity providers from the specified federation endpoint.
     • Use Return one identity provider from the specified federation by id endpoint
   • Option 2: Use mongodbatlas_federated_settings_identity_providers data source:

      data "mongodbatlas_federated_settings_identity_providers" "identity_provider" {
      	federation_settings_id = <federation_settings_id>
      }

     This will return the list of mongodbatlas_federated_settings_identity_providers with both okta_idp_id (20-hex characters Id) and idp_id (24-hex characters Id)
   • Option 3: Use mongodbatlas_federated_settings_identity_provider data source:

      data "mongodbatlas_federated_settings_identity_provider" "identity_provider" {
      	federation_settings_id = <federation_settings_id>
      	identity_provider_id   = <okta_idp_id>
      }

     This will return the specific mongodbatlas_federated_settings_identity_provider with both okta_idp_id (20-hex characters Id) and idp_id (24-hex characters Id)
2. What to do with the new IdP 24-hex characters string ID value
   • If you use mongodbatlas_federated_settings_identity_provider data source:
     • Replace all occurrences of the old Id in mongodbatlas_federated_settings_identity_provider data source in identity_provider_id attribute
   • If you use mongodbatlas_federated_settings_identity_provider resource:
     • Re-import all mongodbatlas_federated_settings_identity_provider resources using the new Id: terraform import mongodbatlas_federated_settings_identity_provider.identity_provider <federation_settings_id>-<new_idp_id>
3. Run terraform plan
4. Run terraform apply

Helpful Links

• Report bugs

• Request Features

• Contact Support covered by MongoDB Atlas support plans, Developer and above.