oci 2.6.0 → 2.7.0

data/lib/oci/resource_manager/models/update_config_source_details.rb

@@ -8,7 +8,9 @@ module OCI
   #
   # This class has direct subclasses. If you are using this class as input to a service operations then you should favor using a subclass over the base class
   class ResourceManager::Models::UpdateConfigSourceDetails
-    # **[Required]** Terraform configuration file type.
+    # **[Required]** Specifies the `configSourceType` for uploading the Terraform configuration.
+    # Presently, the .zip file type (`ZIP_UPLOAD`) is the only supported `configSourceType`.
+    #
     # @return [String]
     attr_accessor :config_source_type
 

data/lib/oci/resource_manager/models/update_stack_details.rb

@@ -26,6 +26,11 @@ module OCI
     # @return [Hash<String, String>]
     attr_accessor :variables
 
+    # The version of Terraform to use with the stack. Example: `0.12.x`
+    #
+    # @return [String]
+    attr_accessor :terraform_version
+
     # Free-form tags associated with this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace.
     # For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).
     # Example: `{\"Department\": \"Finance\"}`
@@ -48,6 +53,7 @@ module OCI
         'description': :'description',
         'config_source': :'configSource',
         'variables': :'variables',
+        'terraform_version': :'terraformVersion',
         'freeform_tags': :'freeformTags',
         'defined_tags': :'definedTags'
         # rubocop:enable Style/SymbolLiteral
@@ -62,6 +68,7 @@ module OCI
         'description': :'String',
         'config_source': :'OCI::ResourceManager::Models::UpdateConfigSourceDetails',
         'variables': :'Hash<String, String>',
+        'terraform_version': :'String',
         'freeform_tags': :'Hash<String, String>',
         'defined_tags': :'Hash<String, Hash<String, Object>>'
         # rubocop:enable Style/SymbolLiteral
@@ -78,6 +85,7 @@ module OCI
     # @option attributes [String] :description The value to assign to the {#description} property
     # @option attributes [OCI::ResourceManager::Models::UpdateConfigSourceDetails] :config_source The value to assign to the {#config_source} property
     # @option attributes [Hash<String, String>] :variables The value to assign to the {#variables} property
+    # @option attributes [String] :terraform_version The value to assign to the {#terraform_version} property
     # @option attributes [Hash<String, String>] :freeform_tags The value to assign to the {#freeform_tags} property
     # @option attributes [Hash<String, Hash<String, Object>>] :defined_tags The value to assign to the {#defined_tags} property
     def initialize(attributes = {})
@@ -102,6 +110,12 @@ module OCI
 
       self.variables = attributes[:'variables'] if attributes[:'variables']
 
+      self.terraform_version = attributes[:'terraformVersion'] if attributes[:'terraformVersion']
+
+      raise 'You cannot provide both :terraformVersion and :terraform_version' if attributes.key?(:'terraformVersion') && attributes.key?(:'terraform_version')
+
+      self.terraform_version = attributes[:'terraform_version'] if attributes[:'terraform_version']
+
       self.freeform_tags = attributes[:'freeformTags'] if attributes[:'freeformTags']
 
       raise 'You cannot provide both :freeformTags and :freeform_tags' if attributes.key?(:'freeformTags') && attributes.key?(:'freeform_tags')
@@ -130,6 +144,7 @@ module OCI
         description == other.description &&
         config_source == other.config_source &&
         variables == other.variables &&
+        terraform_version == other.terraform_version &&
         freeform_tags == other.freeform_tags &&
         defined_tags == other.defined_tags
     end
@@ -147,7 +162,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [display_name, description, config_source, variables, freeform_tags, defined_tags].hash
+      [display_name, description, config_source, variables, terraform_version, freeform_tags, defined_tags].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/resource_manager/models/work_request.rb

@@ -28,11 +28,11 @@ module OCI
     # @return [String]
     attr_reader :status
 
-    # **[Required]** OCID identifying this work request.
+    # **[Required]** The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) identifying this work request.
     # @return [String]
     attr_accessor :id
 
-    # **[Required]** The OCID of the compartment containing this work request.
+    # **[Required]** The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment containing this work request.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/resource_manager/models/work_request_resource.rb

@@ -27,7 +27,7 @@ module OCI
     # @return [String]
     attr_accessor :entity_type
 
-    # **[Required]** An OCID or other unique identifier for the resource.
+    # **[Required]** An [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) or other unique identifier for the resource.
     # @return [String]
     attr_accessor :identifier
 

data/lib/oci/resource_manager/models/work_request_summary.rb

@@ -15,11 +15,11 @@ module OCI
     # @return [String]
     attr_accessor :status
 
-    # **[Required]** OCID identifying this work request.
+    # **[Required]** The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) identifying this work request.
     # @return [String]
     attr_accessor :id
 
-    # **[Required]** Unique identifier (OCID) of the compartment that contains the work request.
+    # **[Required]** Unique identifier ([OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)) of the compartment that contains the work request.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/resource_manager/resource_manager.rb

@@ -10,19 +10,36 @@ module OCI
 end
 
 # Require models
+require 'oci/resource_manager/models/apply_job_operation_details'
+require 'oci/resource_manager/models/apply_job_operation_details_summary'
 require 'oci/resource_manager/models/apply_job_plan_resolution'
 require 'oci/resource_manager/models/change_stack_compartment_details'
 require 'oci/resource_manager/models/config_source'
+require 'oci/resource_manager/models/create_apply_job_operation_details'
 require 'oci/resource_manager/models/create_config_source_details'
+require 'oci/resource_manager/models/create_destroy_job_operation_details'
+require 'oci/resource_manager/models/create_import_tf_state_job_operation_details'
 require 'oci/resource_manager/models/create_job_details'
+require 'oci/resource_manager/models/create_job_operation_details'
+require 'oci/resource_manager/models/create_plan_job_operation_details'
 require 'oci/resource_manager/models/create_stack_details'
 require 'oci/resource_manager/models/create_zip_upload_config_source_details'
+require 'oci/resource_manager/models/destroy_job_operation_details'
+require 'oci/resource_manager/models/destroy_job_operation_details_summary'
 require 'oci/resource_manager/models/failure_details'
+require 'oci/resource_manager/models/import_tf_state_job_operation_details'
+require 'oci/resource_manager/models/import_tf_state_job_operation_details_summary'
 require 'oci/resource_manager/models/job'
+require 'oci/resource_manager/models/job_operation_details'
+require 'oci/resource_manager/models/job_operation_details_summary'
 require 'oci/resource_manager/models/job_summary'
 require 'oci/resource_manager/models/log_entry'
+require 'oci/resource_manager/models/plan_job_operation_details'
+require 'oci/resource_manager/models/plan_job_operation_details_summary'
 require 'oci/resource_manager/models/stack'
 require 'oci/resource_manager/models/stack_summary'
+require 'oci/resource_manager/models/terraform_version_collection'
+require 'oci/resource_manager/models/terraform_version_summary'
 require 'oci/resource_manager/models/update_config_source_details'
 require 'oci/resource_manager/models/update_job_details'
 require 'oci/resource_manager/models/update_stack_details'

data/lib/oci/resource_manager/resource_manager_client.rb

@@ -112,7 +112,7 @@ module OCI
     # Cancellation of the job is not immediate, and may be delayed,
     # or may not happen at all.
     #
-    # @param [String] job_id The job OCID.
+    # @param [String] job_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the job.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -171,8 +171,8 @@ module OCI
 
 
     # Moves a Stack and it's associated Jobs into a different compartment.
-    # @param [String] stack_id The stack OCID.
-    # @param [OCI::ResourceManager::Models::ChangeStackCompartmentDetails] change_stack_compartment_details
+    # @param [String] stack_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the stack.
+    # @param [OCI::ResourceManager::Models::ChangeStackCompartmentDetails] change_stack_compartment_details Defines the properties of changeStackCompartment operation.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -303,6 +303,7 @@ module OCI
 
     # Creates a stack in the specified comparment.
     # Specify the compartment using the compartment ID.
+    # For more information, see [Create a Stack](https://docs.cloud.oracle.com/iaas/Content/ResourceManager/Tasks/usingconsole.htm#CreateStack).
     #
     # @param [OCI::ResourceManager::Models::CreateStackDetails] create_stack_details The properties for creating a stack.
     # @param [Hash] opts the optional parameters
@@ -366,7 +367,7 @@ module OCI
 
 
     # Deletes the specified stack object.
-    # @param [String] stack_id The stack OCID.
+    # @param [String] stack_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the stack.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -425,7 +426,7 @@ module OCI
 
 
     # Returns the specified job along with the job details.
-    # @param [String] job_id The job OCID.
+    # @param [String] job_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the job.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -481,7 +482,7 @@ module OCI
 
     # Returns log entries for the specified job in JSON format.
     #
-    # @param [String] job_id The job OCID.
+    # @param [String] job_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the job.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -570,7 +571,7 @@ module OCI
     # Returns raw log file for the specified job in text format.
     # Returns a maximum of 100,000 log entries.
     #
-    # @param [String] job_id The job OCID.
+    # @param [String] job_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the job.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -627,7 +628,7 @@ module OCI
     # Returns the Terraform configuration file for the specified job in .zip format.
     # Returns an error if no zip file is found.
     #
-    # @param [String] job_id The job OCID.
+    # @param [String] job_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the job.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -728,7 +729,7 @@ module OCI
 
 
     # Returns the Terraform state for the specified job.
-    # @param [String] job_id The job OCID.
+    # @param [String] job_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the job.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -829,7 +830,7 @@ module OCI
 
 
     # Gets a stack using the stack ID.
-    # @param [String] stack_id The stack OCID.
+    # @param [String] stack_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the stack.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -886,7 +887,7 @@ module OCI
     # Returns the Terraform configuration file in .zip format for the specified stack.
     # Returns an error if no zip file is found.
     #
-    # @param [String] stack_id The stack OCID.
+    # @param [String] stack_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the stack.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -986,8 +987,109 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Returns the Terraform state for the specified stack.
+    # @param [String] stack_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the stack.
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #
+    # @option opts [String, IO] :response_target Streaming http body into a file (specified by file name or File object) or IO object if the block is not given
+    # @option [Block] &block Streaming http body to the block
+    # @return [Response] A Response object with data of type String if response_target and block are not given, otherwise with nil data
+    def get_stack_tf_state(stack_id, opts = {}, &block)
+      logger.debug 'Calling operation ResourceManagerClient#get_stack_tf_state.' if logger
+
+      raise "Missing the required parameter 'stack_id' when calling get_stack_tf_state." if stack_id.nil?
+      raise "Parameter value for 'stack_id' must not be blank" if OCI::Internal::Util.blank_string?(stack_id)
+
+      path = '/stacks/{stackId}/tfState'.sub('{stackId}', stack_id.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = opts[:accept] if opts[:accept]
+      header_params[:accept] ||= 'application/octet-stream'
+      header_params[:'accept-encoding'] = opts[:accept_encoding] if opts[:accept_encoding]
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ResourceManagerClient#get_stack_tf_state') do
+        if !block.nil?
+          @api_client.call_api(
+            :GET,
+            path,
+            endpoint,
+            header_params: header_params,
+            query_params: query_params,
+            operation_signing_strategy: operation_signing_strategy,
+            body: post_body,
+            return_type: 'Stream',
+            &block
+          )
+        elsif opts[:response_target]
+          if opts[:response_target].respond_to? :write
+            @api_client.call_api(
+              :GET,
+              path,
+              endpoint,
+              header_params: header_params,
+              query_params: query_params,
+              operation_signing_strategy: operation_signing_strategy,
+              body: post_body,
+              return_type: 'Stream',
+              &proc { |chunk, _response| opts[:response_target].write(chunk) }
+            )
+          elsif opts[:response_target].is_a?(String)
+            File.open(opts[:response_target], 'wb') do |output|
+              return @api_client.call_api(
+                :GET,
+                path,
+                endpoint,
+                header_params: header_params,
+                query_params: query_params,
+                operation_signing_strategy: operation_signing_strategy,
+                body: post_body,
+                return_type: 'Stream',
+                &proc { |chunk, _response| output.write(chunk) }
+              )
+            end
+          end
+        else
+          @api_client.call_api(
+            :GET,
+            path,
+            endpoint,
+            header_params: header_params,
+            query_params: query_params,
+            operation_signing_strategy: operation_signing_strategy,
+            body: post_body,
+            return_type: 'String'
+          )
+        end
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
     # Return the given work request.
-    # @param [String] work_request_id The OCID of the work request.
+    # @param [String] work_request_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the work request.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -1043,9 +1145,9 @@ module OCI
 
     # Returns a list of jobs in a stack or compartment, ordered by time created.
     #
-    # - To list all jobs in a stack, provide the stack OCID.
-    # - To list all jobs in a compartment, provide the compartment OCID.
-    # - To return a specific job, provide the job OCID.
+    # - To list all jobs in a stack, provide the stack [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm).
+    # - To list all jobs in a compartment, provide the compartment [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm).
+    # - To return a specific job, provide the job [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm).
     #
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
@@ -1053,10 +1155,10 @@ module OCI
     # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
     #   particular request, please provide the request ID.
     #
-    # @option opts [String] :compartment_id The compartment OCID on which to filter.
-    # @option opts [String] :stack_id The stack OCID on which to filter.
+    # @option opts [String] :compartment_id The compartment [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) on which to filter.
+    # @option opts [String] :stack_id The stack [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) on which to filter.
     #
-    # @option opts [String] :id The OCID on which to query for jobs.
+    # @option opts [String] :id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) on which to query for jobs.
     #
     # @option opts [String] :lifecycle_state A filter that returns all resources that match the specified lifecycle state.
     #   The state value is case-insensitive.
@@ -1160,8 +1262,8 @@ module OCI
     # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
     #   particular request, please provide the request ID.
     #
-    # @option opts [String] :compartment_id The compartment OCID on which to filter.
-    # @option opts [String] :id The OCID on which to query for a stack.
+    # @option opts [String] :compartment_id The compartment [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) on which to filter.
+    # @option opts [String] :id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) on which to query for a stack.
     #
     # @option opts [String] :lifecycle_state A filter that returns only those resources that match the specified
     #   lifecycle state. The state value is case-insensitive.
@@ -1172,7 +1274,6 @@ module OCI
     #   - DELETING
     #   - DELETED
     #
-    #
     # @option opts [String] :display_name Display name on which to query.
     # @option opts [String] :sort_by Specifies the field on which to sort.
     #   By default, `TIMECREATED` is ordered descending.
@@ -1253,13 +1354,68 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Returns a list of supported Terraform versions for use with stacks.
+    #
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #
+    # @option opts [String] :compartment_id The compartment [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) on which to filter.
+    # @return [Response] A Response object with data of type {OCI::ResourceManager::Models::TerraformVersionCollection TerraformVersionCollection}
+    def list_terraform_versions(opts = {})
+      logger.debug 'Calling operation ResourceManagerClient#list_terraform_versions.' if logger
+
+
+      path = '/terraformVersions'
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:compartmentId] = opts[:compartment_id] if opts[:compartment_id]
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ResourceManagerClient#list_terraform_versions') do
+        @api_client.call_api(
+          :GET,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::ResourceManager::Models::TerraformVersionCollection'
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
     # Return a (paginated) list of errors for a given work request.
     #
-    # @param [String] work_request_id The OCID of the work request.
+    # @param [String] work_request_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the work request.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
-    # @option opts [String] :compartment_id The compartment OCID on which to filter.
+    # @option opts [String] :compartment_id The compartment [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) on which to filter.
     # @option opts [Integer] :limit The number of items returned in a paginated `List` call. For information about pagination, see
     #   [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
@@ -1329,11 +1485,11 @@ module OCI
 
     # Return a (paginated) list of logs for a given work request.
     #
-    # @param [String] work_request_id The OCID of the work request.
+    # @param [String] work_request_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the work request.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
-    # @option opts [String] :compartment_id The compartment OCID on which to filter.
+    # @option opts [String] :compartment_id The compartment [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) on which to filter.
     # @option opts [Integer] :limit The number of items returned in a paginated `List` call. For information about pagination, see
     #   [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
@@ -1403,11 +1559,11 @@ module OCI
 
     # Lists the work requests in a given compartment or for a given resource.
     #
-    # @param [String] compartment_id The compartment OCID on which to filter.
+    # @param [String] compartment_id The compartment [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) on which to filter.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
-    # @option opts [String] :resource_id The OCID of the resource.
+    # @option opts [String] :resource_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the resource.
     # @option opts [Integer] :limit The number of items returned in a paginated `List` call. For information about pagination, see
     #   [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
@@ -1468,7 +1624,7 @@ module OCI
 
 
     # Updates the specified job.
-    # @param [String] job_id The job OCID.
+    # @param [String] job_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the job.
     # @param [OCI::ResourceManager::Models::UpdateJobDetails] update_job_details Updates properties for the specified job.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
@@ -1532,8 +1688,10 @@ module OCI
     # Updates the specified stack object.
     # Use `UpdateStack` when you update your Terraform configuration
     # and want your changes to be reflected in the execution plan.
+    # For more information, see [Update a Stack](https://docs.cloud.oracle.com/iaas/Content/ResourceManager/Tasks/usingconsole.htm#UpdateStack) and
+    # [Edit or Delete a Stack](https://docs.cloud.oracle.com/iaas/Content/ResourceManager/Tasks/usingconsole.htm#EditStack).
     #
-    # @param [String] stack_id The stack OCID.
+    # @param [String] stack_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the stack.
     # @param [OCI::ResourceManager::Models::UpdateStackDetails] update_stack_details Updated information provided for the stack.
     #
     # @param [Hash] opts the optional parameters