Skip to content

Details for v2.1.0 Release

Jump to bottom
Alaa Shaker edited this page Mar 9, 2018 · 1 revision 
#     ___  ____     _    ____ _     _____
#    / _ \|  _ \   / \  / ___| |   | ____|
#   | | | | |_) | / _ \| |   | |   |  _|
#   | |_| |  _ < / ___ | |___| |___| |___
#    \___/|_| \_/_/   \_\____|_____|_____|

v2.1.0 release

With this release we started using the new official OCI Go SDK. Widespread changes to the source code were needed to make this happen.

See docs for this version here

Added Functionality

Client-side filters

With this release, several data sources that did not support client-side filtering earlier, now support it:

  • oci_database_databases
  • oci_database_db_homes
  • oci_database_db_nodes
  • oci_database_db_system_shapes
  • oci_database_db_systems
  • oci_database_db_versions
  • oci_identity_api_keys
  • oci_load_balancer_backends
  • oci_objectstorage_bucket_summaries
  • oci_objectstorage_objects

Server-side filters

With the release, several data sources now support new server-side filtering.

  • filtering by state was added to the following data sources:

    • oci_core_dhcp_options
    • oci_core_images
    • oci_core_internet_gateways
    • oci_core_route_tables
    • oci_core_security_lists
    • oci_core_subnets
    • oci_core_vcns
    • oci_core_volume_backups
    • oci_core_volumes

  • filtering by display_name was added to the following data sources:

    • oci_core_route_tables
    • oci_core_security_lists
    • oci_core_subnets
    • oci_core_vcns
    • oci_core_volume_backups
    • oci_core_volumes

  • filtering by db_system_shape was added to the following data sources:

    • oci_database_db_versions

New Functionality

New optional parameters and fields have been added to existing resources and data sources to support new functionality added by the services. See the docs for more details

  • New fields in resources:

    • oci_core_vnic_attachment has a new optional parameter nic_index
    • oci_core_ipsec now has the field id
    • oci_core_subnet now has the field subnet_domain_name
    • oci_core_vcn now has the field vcn_domain_name
    • oci_core_volume now has the field is_hydrated
    • oci_database_db_system now has the field last_patch_history_entry_id
    • oci_load_balancer_backend now has the field name
    • oci_objectstorage_bucket now has the field created_by, etag, time_created
    • oci_objectstorage_preauthrequest now has the field time_created

  • New fields in data sources:

    • The result of the oci_database_database data source now has new field db_backup_config
    • The result of the oci_database_db_home data source now has new field last_patch_history_entry_id
    • The result of the oci_database_db_node data source now has new field software_storage_size_in_gb

New client-side validations

We have added some constraints to our resource definitions. These constraints were enforced by the services already.

This implies that some failures that we used see during the apply phase would now be detected at the plan phase.

  • security_list_ids in oci_core_subnet now specifies the MaxItems (5) constraint
  • statements in oci_identity_policy now specifies the MinItems (1) constraint

Deprecated

  • limit and page parameters in data sources have been deprecated. All list data sources loop through all the pages and return one aggregated list.
  • The time_modified field was deprecated from the following resources as it is no longer set by the service:
    • oci_core_internet_gateway
    • oci_core_route_table
    • oci_identity_compartment
    • oci_identity_group
    • oci_identity_policy
    • oci_identity_user

Fixed

  • Updates to fields in oci_objectstorage_preauthrequest resource will force the destruction and recreation of the resource. Updates to fields in this resource had no effect earlier.
  • Updating some fields resulted in nothing happening. This has been fixed.
  • Unexpected destruction and recreation of oci_objectstorage_object was fixed by constraining all keys in the metadata map to be lower case.

General Notes

Identity Resources

The backend APIs for all identity resources actually require a compartment_id value to be passed in. Currently, the APIs require the OCID of the tenancy to be passed in as the compartment_id. However, introducing that requirement (of passing in compartment_id) with this release could have caused some backwards-incompatible changes.

Hence, with this release, we have added compartment_id as an optional field for the Identity resources. If the Terraform configurations do not provide the compartment_id, the OCI Provider code uses the OCID of the tenancy, behind the scenes, to call the services.

We advise our users to start specifying the compartment_id in their Terraform configurations and setting it to the tenancy OCID for their identity resources.

Optional Parameters

Removing optional parameters from a created resource will not result in a difference and the value for that field will remain as it was.

If you want to reset the field to the default value returned by the service you will have to taint the resource to destroy it and recreate it.

Clone this wiki locally