oci 2.10.0 → 2.11.0

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

@@ -18,6 +18,10 @@ module OCI
       OPERATION_TYPE_CREATE_CERTIFICATE = 'CREATE_CERTIFICATE'.freeze,
       OPERATION_TYPE_UPDATE_CERTIFICATE = 'UPDATE_CERTIFICATE'.freeze,
       OPERATION_TYPE_DELETE_CERTIFICATE = 'DELETE_CERTIFICATE'.freeze,
+      OPERATION_TYPE_CREATE_API = 'CREATE_API'.freeze,
+      OPERATION_TYPE_UPDATE_API = 'UPDATE_API'.freeze,
+      OPERATION_TYPE_DELETE_API = 'DELETE_API'.freeze,
+      OPERATION_TYPE_VALIDATE_API = 'VALIDATE_API'.freeze,
       OPERATION_TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 

data/lib/oci/application_migration/application_migration.rb

@@ -42,6 +42,7 @@ require 'oci/application_migration/models/source_details'
 require 'oci/application_migration/models/source_lifecycle_states'
 require 'oci/application_migration/models/source_summary'
 require 'oci/application_migration/models/source_types'
+require 'oci/application_migration/models/target_database_types'
 require 'oci/application_migration/models/update_migration_details'
 require 'oci/application_migration/models/update_source_details'
 require 'oci/application_migration/models/work_request'
@@ -52,6 +53,7 @@ require 'oci/application_migration/models/work_request_summary'
 
 # Require generated clients
 require 'oci/application_migration/application_migration_client'
+require 'oci/application_migration/application_migration_client_composite_operations'
 
 # Require service utilities
 require 'oci/application_migration/util'

data/lib/oci/application_migration/application_migration_client.rb

@@ -6,7 +6,10 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # API for the Application Migration service. Use this API to migrate applications from Oracle Cloud Infrastructure - Classic to Oracle Cloud Infrastructure.
+  # Application Migration simplifies the migration of applications from Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure.
+  # You can use Application Migration API to migrate applications, such as Oracle Java Cloud Service, SOA Cloud Service, and Integration Classic
+  # instances, to Oracle Cloud Infrastructure. For more information, see
+  # [Overview of Application Migration](/iaas/application-migration/appmigrationoverview.htm).
   class ApplicationMigration::ApplicationMigrationClient
     # Client used to make HTTP requests.
     # @return [OCI::ApiClient]
@@ -98,8 +101,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Cancels the specified work request
-    # @param [String] work_request_id The OCID of the work request.
+    # Cancels the specified work request. When you cancel a work request, it causes the in-progress task to be canceled.
+    # For example, if the create migration work request is in the accepted or in progress state for a long time, you can cancel the work request.
+    #
+    # When you cancel a work request, the state of the work request changes to cancelling, and then to the cancelled state.
+    #
+    # @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
@@ -107,7 +114,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @option opts [String] :if_match For optimistic concurrency control. In the `PUT` or `DELETE` call for a resource, set the `if-match`
-    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource.  The resource
+    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource. The resource
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
@@ -157,14 +164,16 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Moves a Migration into a different compartment.
-    # @param [String] migration_id The application OCID
+    # Moves the specified migration into a different compartment within the same tenancy. For information about moving resources between compartments,
+    # see [Moving Resources to a Different Compartment](https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes).
+    #
+    # @param [String] migration_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the migration.
     # @param [OCI::ApplicationMigration::Models::ChangeCompartmentDetails] change_migration_compartment_details The updated compartment details
     # @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] :if_match For optimistic concurrency control. In the `PUT` or `DELETE` call for a resource, set the `if-match`
-    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource.  The resource
+    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource. The resource
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
@@ -226,14 +235,16 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Moves a Source into a different compartment.
-    # @param [String] source_id The source OCID
+    # Moves the specified source into a different compartment within the same tenancy. For information about moving resources
+    # between compartments, see [Moving Resources to a Different Compartment](https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes).
+    #
+    # @param [String] source_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the source.
     # @param [OCI::ApplicationMigration::Models::ChangeCompartmentDetails] change_source_compartment_details The updated compartment details
     # @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] :if_match For optimistic concurrency control. In the `PUT` or `DELETE` call for a resource, set the `if-match`
-    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource.  The resource
+    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource. The resource
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
@@ -295,8 +306,27 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates an application migration in the specified compartment.
-    # Specify the compartment using the compartment ID.
+    # Creates a migration. A migration represents the end-to-end workflow of moving an application from a source environment to Oracle Cloud
+    # Infrastructure. Each migration moves a single application to Oracle Cloud Infrastructure. For more information,
+    # see [Manage Migrations](https://docs.cloud.oracle.com/iaas/application-migration/manage_migrations.htm).
+    #
+    # When you create a migration, provide the required information to let Application Migration access the source environment.
+    # Application Migration uses this information to access the application in the source environment and discover application artifacts.
+    #
+    # All Oracle Cloud Infrastructure resources, including migrations, get an Oracle-assigned, unique ID called an Oracle Cloud Identifier (OCID).
+    # When you create a resource, you can find its OCID in the response. You can also retrieve a resource's OCID by using a List API operation on
+    # that resource type, or by viewing the resource in the Console. For more information, see Resource Identifiers.
+    #
+    # After you send your request, a migration is created in the compartment that contains the source. The new migration's lifecycle state
+    # will temporarily be <code>CREATING</code> and the state of the migration will be <code>DISCOVERING_APPLICATION</code>. During this phase,
+    # Application Migration sets the template for the <code>serviceConfig</code> and <code>applicationConfig</code> fields of the migration.
+    # When this operation is complete, the state of the migration changes to <code>MISSING_CONFIG_VALUES</code>.
+    # Next, you'll need to update the migration to provide configuration values. Before updating the
+    # migration, ensure that its state has changed to <code>MISSING_CONFIG_VALUES</code>.
+    #
+    # To track the progress of this operation, you can monitor the status of the Create Migration and Discover Application work requests
+    # by using the <code>{#get_work_request get_work_request}</code> REST API operation on the work request or by viewing the status of the work request in
+    # the console.
     #
     # @param [OCI::ApplicationMigration::Models::CreateMigrationDetails] create_migration_details The properties for creating a migration.
     # @param [Hash] opts the optional parameters
@@ -359,8 +389,23 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a migration source in the specified compartment.
-    # Specify the compartment using the compartment ID.
+    # Creates a source in the specified compartment. In Application Migration, a source refers to the environment from which the application
+    # is being migrated. For more information, see [Manage Sources](https://docs.cloud.oracle.com/iaas/application-migration/manage_sources.htm).
+    #
+    # All Oracle Cloud Infrastructure resources, including sources, get an Oracle-assigned, unique ID called an Oracle Cloud Identifier (OCID).
+    # When you create a resource, you can find its OCID in the response. You can also retrieve a resource's OCID by using a List API operation
+    # on that resource type, or by viewing the resource in the Console.
+    #
+    # After you send your request, a source is created in the specified compartment. The new source's lifecycle state will temporarily be
+    # <code>CREATING</code>. Application Migration connects to the source environment with the authentication credentials that you have provided.
+    # If the connection is established, the status of the source changes to <code>ACTIVE</code> and Application Migration fetches the list of
+    # applications that are available for migration in the source environment.
+    #
+    # To track the progress of the operation, you can monitor the status of the Create Source work request by using the
+    # <code>{#get_work_request get_work_request}</code> REST API operation on the work request or by viewing the status of the work request in the console.
+    #
+    # Ensure that the state of the source has changed to <code>ACTIVE</code>, before you retrieve the list of applications from
+    # the source environment using the <code>{#list_source_applications list_source_applications}</code> REST API call.
     #
     # @param [OCI::ApplicationMigration::Models::CreateSourceDetails] create_source_details The properties for creating a source.
     # @param [Hash] opts the optional parameters
@@ -423,8 +468,13 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the specified Application object.
-    # @param [String] migration_id The application OCID
+    # Deletes the specified migration.
+    #
+    # If you have migrated the application or for any other reason if you no longer require a migration, then you can delete the
+    # relevant migration. You can delete a migration, irrespective of its state. If any work request is being processed for the migration
+    # that you want to delete, then the associated work requests are cancelled and then the migration is deleted.
+    #
+    # @param [String] migration_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the migration.
     # @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
@@ -432,7 +482,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @option opts [String] :if_match For optimistic concurrency control. In the `PUT` or `DELETE` call for a resource, set the `if-match`
-    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource.  The resource
+    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource. The resource
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
@@ -482,8 +532,13 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the specified Source object.
-    # @param [String] source_id The source OCID
+    # Deletes the specified source.
+    #
+    # Before deleting a source, you must delete all the migrations associated with the source.
+    # If you have migrated all the required applications in a source or for any other reason you no longer require a source, then you can
+    # delete the relevant source.
+    #
+    # @param [String] source_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the source.
     # @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
@@ -491,7 +546,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @option opts [String] :if_match For optimistic concurrency control. In the `PUT` or `DELETE` call for a resource, set the `if-match`
-    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource.  The resource
+    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource. The resource
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
@@ -541,8 +596,8 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets an application migration using the ID.
-    # @param [String] migration_id The application OCID
+    # Retrieves details of the specified migration.
+    # @param [String] migration_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the migration.
     # @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
@@ -596,8 +651,9 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets a migration source using the source ID.
-    # @param [String] source_id The source OCID
+    # Retrieves details of the specified source. Specify the OCID of the source for which you want to retrieve details.
+    #
+    # @param [String] source_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the source.
     # @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
@@ -651,8 +707,8 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets the details of a work request.
-    # @param [String] work_request_id The OCID of the work request.
+    # Gets the details of the specified 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
@@ -706,16 +762,16 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Returns a list of migrations in a given compartment.
+    # Retrieves details of all the migrations that are available in the specified compartment.
     #
-    # @param [String] compartment_id The compartment OCID on which to filter.
+    # @param [String] compartment_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of a compartment. Retrieves details of objects in the specified compartment.
     # @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] :id The OCID on which to query for an application.
+    # @option opts [String] :id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) on which to query for a migration.
     #
     # @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).
@@ -731,7 +787,7 @@ module OCI
     #    (default to DISPLAYNAME)
     #   Allowed values are: TIMECREATED, DISPLAYNAME
     # @option opts [String] :display_name Display name on which to query.
-    # @option opts [String] :lifecycle_state The lifecycle state on which to filter.
+    # @option opts [String] :lifecycle_state This field is not supported. Do not use.
     # @return [Response] A Response object with data of type Array<{OCI::ApplicationMigration::Models::MigrationSummary MigrationSummary}>
     def list_migrations(compartment_id, opts = {})
       logger.debug 'Calling operation ApplicationMigrationClient#list_migrations.' if logger
@@ -798,10 +854,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Returns a list of applications running in the source environment. This list is generated dynamically by interrogating the source and changes as applications are started or stopped in that environment.
+    # Retrieves details of all the applications associated with the specified source.
+    # This list is generated dynamically by interrogating the source and the list changes as applications are started or
+    # stopped in the source environment.
     #
-    # @param [String] source_id The source OCID
-    # @param [String] compartment_id The compartment OCID on which to filter.
+    # @param [String] source_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the source.
+    # @param [String] compartment_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of a compartment. Retrieves details of objects in the specified compartment.
     # @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
@@ -884,16 +942,19 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Returns a list of migration sources in a specified compartment.
+    # Retrieves details of all the sources that are available in the specified compartment and match the specified query criteria.
+    # If you don't specify any query criteria, then details of all the sources are displayed.
+    # To filter the retrieved results, you can pass one or more of the following query parameters, by appending them to the URI
+    # as shown in the following example.
     #
-    # @param [String] compartment_id The compartment OCID on which to filter.
+    # @param [String] compartment_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of a compartment. Retrieves details of objects in the specified compartment.
     # @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] :id The OCID on which to query for a source.
+    # @option opts [String] :id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) on which to query for a source.
     #
     # @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).
@@ -909,7 +970,7 @@ module OCI
     #    (default to DISPLAYNAME)
     #   Allowed values are: TIMECREATED, DISPLAYNAME
     # @option opts [String] :display_name Display name on which to query.
-    # @option opts [String] :lifecycle_state The lifecycle state on which to filter.
+    # @option opts [String] :lifecycle_state Retrieves details of sources in the specified lifecycle state.
     # @return [Response] A Response object with data of type Array<{OCI::ApplicationMigration::Models::SourceSummary SourceSummary}>
     def list_sources(compartment_id, opts = {})
       logger.debug 'Calling operation ApplicationMigrationClient#list_sources.' if logger
@@ -976,9 +1037,9 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets the errors for a work request.
+    # Retrieves details of the errors encountered while executing an operation that is tracked by the specified 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
@@ -1047,9 +1108,9 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets the logs for a work request.
+    # Retrieves logs for the specified 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
@@ -1118,13 +1179,13 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Lists the work requests in a compartment or for a specified resource.
+    # Retrieves details of all the work requests and match the specified query criteria. To filter the retrieved results, you can pass one or more of the following query parameters, by appending them to the URI as shown in the following example.
     #
-    # @param [String] compartment_id The compartment OCID on which to filter.
+    # @param [String] compartment_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of a compartment. Retrieves details of objects in the specified compartment.
     # @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) for a resource. Retrieves details of the specified resource.
     # @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.
     #
@@ -1184,15 +1245,35 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Validates target configuration and migrates a PaaS application running in a Source environment into the customers Oracle Cloud Infrastructure tenancy. This an optional action and only required if automatic start of migration was not selected when creating the migration.
+    # Starts migrating the specified application to Oracle Cloud Infrastructure.
+    #
+    # Before sending this request, ensure that you have provided configuration details to update the migration and the state of the migration
+    # is <code>READY</code>.
+    #
+    # After you send this request, the migration's state will temporarily be <code>MIGRATING</code>.
     #
-    # @param [String] migration_id The application OCID
+    # To track the progress of the operation, you can monitor the status of the Migrate Application work request by using the
+    # <code>{#get_work_request get_work_request}</code> REST API operation on the work request or by viewing the status of the work request in the console.
+    # When this work request is processed successfully, Application Migration creates the required resources in the target environment
+    # and the state of the migration changes to <code>MIGRATION_SUCCEEDED</code>.
+    #
+    # @param [String] migration_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the migration.
     # @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] :if_match For optimistic concurrency control. In the `PUT` or `DELETE` call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource. The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of retrying the same action. Retry tokens expire after
+    #   24 hours, but can be invalidated before then due to conflicting operations. For example,
+    #   if a resource has been deleted and purged from the system, then a retry of the original
+    #   creation request may be rejected.
+    #
     # @return [Response] A Response object with data of type nil
     def migrate_application(migration_id, opts = {})
       logger.debug 'Calling operation ApplicationMigrationClient#migrate_application.' if logger
@@ -1212,7 +1293,10 @@ module OCI
       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]
+      header_params[:'if-match'] = opts[:if_match] if opts[:if_match]
+      header_params[:'opc-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
       # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
 
       post_body = nil
 
@@ -1239,8 +1323,37 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Update the configuration for an application migration.
-    # @param [String] migration_id The application OCID
+    # Updates the configuration details for the specified migration.
+    #
+    # When you create a migration, Application Migration sets the template for the <code>serviceConfig</code> and <code>applicationConfig</code>
+    # attributes of the migration.
+    # When you update the migration, you must provide values for these fields to specify configuration information for the application in the
+    # target environment.
+    #
+    #
+    #
+    # Before updating the migration, complete the following tasks:
+    # <ol>
+    # <li>Identify the migration that you want to update and ensure that the migration is in the <code>MISSING_CONFIG_VALUES</code> state.</li>
+    # <li>Get details of the migration using the <code>GetMigration</code> command. This returns the  template for the <code>serviceConfig</code>
+    # and <code>applicationConfig</code> attributes of the migration.</li>
+    # <li>You must fill out the required details for the <code>serviceConfig</code> and <code>applicationConfig</code> attributes.
+    # The <code>isRequired</code> attribute of a configuration property indicates whether it is mandatory to provide a value.</li>
+    # <li>You can provide values for the optional configuration properties or you can delete the optional properties for which you do not
+    # provide values. Note that you cannot add any property that is not present in the template.</li>
+    # </ol>
+    #
+    # To update the migration, pass the configuration values in the request body. The information that you must provide depends on the type
+    # of application that you are migrating. For reference information about configuration fields, see
+    # [Provide Configuration Information](https://docs.cloud.oracle.com/iaas/application-migration/manage_migrations.htm#provide_configuration_details).
+    #
+    # To track the progress of the operation, you can monitor the status of the Update Migration work request by using the
+    # <code>{#get_work_request get_work_request}</code> REST API operation on the work request or by viewing the status of the work request in the console.
+    #
+    # When the migration has been updated, the state of the migration changes to <code>READY</code>. After updating the migration,
+    # you can start the migration whenever you are ready.
+    #
+    # @param [String] migration_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the migration.
     # @param [OCI::ApplicationMigration::Models::UpdateMigrationDetails] update_migration_details Updated configuration for the migration.
     #
     # @param [Hash] opts the optional parameters
@@ -1256,7 +1369,7 @@ module OCI
     #   creation request may be rejected.
     #
     # @option opts [String] :if_match For optimistic concurrency control. In the `PUT` or `DELETE` call for a resource, set the `if-match`
-    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource.  The resource
+    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource. The resource
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
@@ -1309,8 +1422,12 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Update source details.
-    # @param [String] source_id The source OCID
+    # You can update the authorization details to access the source environment from which you want to migrate applications to Oracle Cloud
+    # Infrastructure. You can also update the description and tags of a source.
+    #
+    # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+    #
+    # @param [String] source_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the source.
     # @param [OCI::ApplicationMigration::Models::UpdateSourceDetails] update_source_details Updated configuration for the source.
     #
     # @param [Hash] opts the optional parameters
@@ -1320,7 +1437,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @option opts [String] :if_match For optimistic concurrency control. In the `PUT` or `DELETE` call for a resource, set the `if-match`
-    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource.  The resource
+    #   parameter to the value of the etag from a previous `GET` or `POST` response for that resource. The resource
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil