oci 2.10.0 → 2.11.0

data/lib/oci/application_migration/models/migration_summary.rb

@@ -6,7 +6,7 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # An application being migrated from a source environment to OCI.
+  # Details about the migration. Each migration moves a single application from a specified source to Oracle Cloud Infrastructure.
   #
   class ApplicationMigration::Models::MigrationSummary
     APPLICATION_TYPE_ENUM = [
@@ -19,16 +19,38 @@ module OCI
       APPLICATION_TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # Unique identifier (OCID) for the application
+    LIFECYCLE_STATE_ENUM = [
+      LIFECYCLE_STATE_CREATING = 'CREATING'.freeze,
+      LIFECYCLE_STATE_ACTIVE = 'ACTIVE'.freeze,
+      LIFECYCLE_STATE_INACTIVE = 'INACTIVE'.freeze,
+      LIFECYCLE_STATE_UPDATING = 'UPDATING'.freeze,
+      LIFECYCLE_STATE_SUCCEEDED = 'SUCCEEDED'.freeze,
+      LIFECYCLE_STATE_DELETING = 'DELETING'.freeze,
+      LIFECYCLE_STATE_DELETED = 'DELETED'.freeze,
+      LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
+    MIGRATION_STATE_ENUM = [
+      MIGRATION_STATE_DISCOVERING_APPLICATION = 'DISCOVERING_APPLICATION'.freeze,
+      MIGRATION_STATE_DISCOVERY_FAILED = 'DISCOVERY_FAILED'.freeze,
+      MIGRATION_STATE_MISSING_CONFIG_VALUES = 'MISSING_CONFIG_VALUES'.freeze,
+      MIGRATION_STATE_READY = 'READY'.freeze,
+      MIGRATION_STATE_MIGRATING = 'MIGRATING'.freeze,
+      MIGRATION_STATE_MIGRATION_FAILED = 'MIGRATION_FAILED'.freeze,
+      MIGRATION_STATE_MIGRATION_SUCCEEDED = 'MIGRATION_SUCCEEDED'.freeze,
+      MIGRATION_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
+    # The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the migration.
     # @return [String]
     attr_accessor :id
 
-    # Unique idenfifier (OCID) for the compartment where the Source is located.
+    # The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment that contains the migration.
     #
     # @return [String]
     attr_accessor :compartment_id
 
-    # Human-readable name of the migration.
+    # User-friendly name of the migration.
     # @return [String]
     attr_accessor :display_name
 
@@ -36,15 +58,15 @@ module OCI
     # @return [String]
     attr_accessor :description
 
-    # The date and time at which the migration was created.
+    # The date and time at which the migration was created, in the format defined by RFC3339.
     # @return [DateTime]
     attr_accessor :time_created
 
-    # Unique identifier (OCID) of the source.
+    # The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the source.
     # @return [String]
     attr_accessor :source_id
 
-    # Name of the application being migrated from the source.
+    # Name of the application which is being migrated from the source environment.
     # @return [String]
     attr_accessor :application_name
 
@@ -52,26 +74,26 @@ module OCI
     # @return [String]
     attr_reader :application_type
 
-    # The current state of the Migration
+    # The current state of the migration.
     # @return [String]
-    attr_accessor :lifecycle_state
+    attr_reader :lifecycle_state
 
-    # Details about the current lifecycle state
+    # Details about the current lifecycle state.
     # @return [String]
     attr_accessor :lifecycle_details
 
-    # The current state of the overall Migration process
+    # The current state of the overall migration process.
     # @return [String]
-    attr_accessor :migration_state
+    attr_reader :migration_state
 
-    # Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only.
-    # Example: `{\"bar-key\": \"value\"}`
+    # Free-form tags for 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/Content/General/Concepts/resourcetags.htm). Example: `{\"Department\": \"Finance\"}`
     #
     # @return [Hash<String, String>]
     attr_accessor :freeform_tags
 
     # Defined tags for this resource. Each key is predefined and scoped to a namespace.
-    # Example: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`
+    # For more information, see [Resource Tags](https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm). Example: `{\"Operations\": {\"CostCenter\": \"42\"}}`
     #
     # @return [Hash<String, Hash<String, Object>>]
     attr_accessor :defined_tags
@@ -229,6 +251,32 @@ module OCI
       # rubocop:enable Style/ConditionalAssignment
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] lifecycle_state Object to be assigned
+    def lifecycle_state=(lifecycle_state)
+      # rubocop:disable Style/ConditionalAssignment
+      if lifecycle_state && !LIFECYCLE_STATE_ENUM.include?(lifecycle_state)
+        OCI.logger.debug("Unknown value for 'lifecycle_state' [" + lifecycle_state + "]. Mapping to 'LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @lifecycle_state = LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE
+      else
+        @lifecycle_state = lifecycle_state
+      end
+      # rubocop:enable Style/ConditionalAssignment
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] migration_state Object to be assigned
+    def migration_state=(migration_state)
+      # rubocop:disable Style/ConditionalAssignment
+      if migration_state && !MIGRATION_STATE_ENUM.include?(migration_state)
+        OCI.logger.debug("Unknown value for 'migration_state' [" + migration_state + "]. Mapping to 'MIGRATION_STATE_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @migration_state = MIGRATION_STATE_UNKNOWN_ENUM_VALUE
+      else
+        @migration_state = migration_state
+      end
+      # rubocop:enable Style/ConditionalAssignment
+    end
+
     # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
 
 

data/lib/oci/application_migration/models/oac_discovery_details.rb

@@ -6,14 +6,14 @@ require_relative 'discovery_details'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Specifies the credentials to access the source OAC instance
+  # Details about the Oracle Analytics Cloud - Classic application in the source environment.
   #
   class ApplicationMigration::Models::OacDiscoveryDetails < ApplicationMigration::Models::DiscoveryDetails
-    # **[Required]** The OAC instance admin user
+    # **[Required]** This field is currently not supported. You must enter a value, such as <code>unused</code>. However, the value that you enter is ignored.
     # @return [String]
     attr_accessor :service_instance_user
 
-    # **[Required]** The OAC instance admin password
+    # **[Required]** This field is currently not supported. You must enter a value, such as <code>unused</code>. However, the value that you enter is ignored.
     # @return [String]
     attr_accessor :service_instance_password
 

data/lib/oci/application_migration/models/ocic_authorization_details.rb

@@ -6,7 +6,7 @@ require_relative 'authorization_details'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Specifies the credentials to access the source Oracle Cloud Infrastructure - Classic environment.
+  # Credentials to access Oracle Cloud Infrastructure - Classic, which is the source environment from which you want to migrate the application.
   #
   class ApplicationMigration::Models::OcicAuthorizationDetails < ApplicationMigration::Models::AuthorizationDetails
     # **[Required]** User with Compute Operations role in Oracle Cloud Infrastructure - Classic.

data/lib/oci/application_migration/models/ocic_source_details.rb

@@ -6,14 +6,19 @@ require_relative 'source_details'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Specifies configuration specific to the source environment.
+  # Details about the Oracle Cloud Infrastructure Classic account, the source environment from which you want to migrate the application.
   #
   class ApplicationMigration::Models::OcicSourceDetails < ApplicationMigration::Models::SourceDetails
-    # **[Required]** The Oracle Cloud Infrastructure - Classic region name (e.g. us2-z11 or uscom-central-1)
+    # **[Required]** The Oracle Cloud Infrastructure - Classic region from which you want to migrate your applications. For example, uscom-east-1 or uscom-central-1.
     # @return [String]
     attr_accessor :region
 
-    # **[Required]** The compute account id
+    # **[Required]** If you are using a Oracle Cloud Infrastructure - Classic account with Identity Cloud Service (IDCS), enter the service instance ID.
+    # For example, if Compute-567890123 is the account name of your Oracle Cloud Infrastructure Classic Compute service entitlement,
+    # then enter 567890123.
+    #
+    # If you are using a traditional Oracle Cloud Infrastructure - Classic account, enter your identity domain ID.
+    #
     # @return [String]
     attr_accessor :compute_account
 

data/lib/oci/application_migration/models/oic_discovery_details.rb

@@ -6,14 +6,15 @@ require_relative 'discovery_details'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Specifies the credentials to access the source OIC instance
+  # Credentials to access the Oracle Integration application in the source environment. Application Migration connects to the
+  # application in the source environment with the supplied credentials.
   #
   class ApplicationMigration::Models::OicDiscoveryDetails < ApplicationMigration::Models::DiscoveryDetails
-    # **[Required]** The OIC instance admin user
+    # **[Required]** Application administrator username to access the Oracle Integration Classic instance in the source environment.
     # @return [String]
     attr_accessor :service_instance_user
 
-    # **[Required]** The OIC instance admin password
+    # **[Required]** Password for this user.
     # @return [String]
     attr_accessor :service_instance_password
 

data/lib/oci/application_migration/models/pcs_discovery_details.rb

@@ -6,14 +6,15 @@ require_relative 'discovery_details'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Specifies the credentials to access the source PCS instance
+  # Credentials to access the Oracle Process Cloud Service application in the source environment. Application Migration connects to the
+  # application in the source environment with the supplied credentials.
   #
   class ApplicationMigration::Models::PcsDiscoveryDetails < ApplicationMigration::Models::DiscoveryDetails
-    # **[Required]** The PCS instance admin user
+    # **[Required]** Application administrator username to access the Oracle Process Cloud Service application in the source environment.
     # @return [String]
     attr_accessor :service_instance_user
 
-    # **[Required]** The PCS instance admin password
+    # **[Required]** Password for this user.
     # @return [String]
     attr_accessor :service_instance_password
 

data/lib/oci/application_migration/models/soacs_discovery_details.rb

@@ -6,14 +6,16 @@ require_relative 'discovery_details'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Specifies the credentials to access the source SOACS instance
+  # Credentials to access the Oracle SOA Cloud Service application in the source environment. When you create and update a migration,
+  # Application Migration connects to the application in the source environment with the supplied credentials and exports the domain
+  # configuration.
   #
   class ApplicationMigration::Models::SoacsDiscoveryDetails < ApplicationMigration::Models::DiscoveryDetails
-    # **[Required]** The SOACS instance weblogic admin user
+    # **[Required]** WebLogic administrator username for the Oracle SOA Cloud Service application in the source environment.
     # @return [String]
     attr_accessor :weblogic_user
 
-    # **[Required]** The SOACS instance weblogic admin password
+    # **[Required]** Password for this user.
     # @return [String]
     attr_accessor :weblogic_password
 

data/lib/oci/application_migration/models/source.rb

@@ -2,53 +2,68 @@
 # This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
+require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # The Source object. Sources represent external locations from which
-  # applications may be imported into an OCI tenancy.
+  # The properties that define a source. Source refers to the source environment from which you migrate an application to Oracle Cloud
+  # Infrastructure. For more information, see [Manage Sources](https://docs.cloud.oracle.com/iaas/application-migration/manage_sources.htm).
+  #
+  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator. If you're
+  # an administrator who needs to write policies to give users access, see [Getting Started with
+  # Policies](https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm).
   #
   class ApplicationMigration::Models::Source
-    # Unique identifier (OCID) for the source
+    LIFECYCLE_STATE_ENUM = [
+      LIFECYCLE_STATE_CREATING = 'CREATING'.freeze,
+      LIFECYCLE_STATE_DELETING = 'DELETING'.freeze,
+      LIFECYCLE_STATE_UPDATING = 'UPDATING'.freeze,
+      LIFECYCLE_STATE_ACTIVE = 'ACTIVE'.freeze,
+      LIFECYCLE_STATE_INACTIVE = 'INACTIVE'.freeze,
+      LIFECYCLE_STATE_DELETED = 'DELETED'.freeze,
+      LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
+    # The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the source.
     # @return [String]
     attr_accessor :id
 
-    # Unique idenfifier (OCID) for the compartment where the Source is located.
+    # The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment that contains the source.
     #
     # @return [String]
     attr_accessor :compartment_id
 
-    # Human-readable name of the source.
+    # Name of the source. This helps you to identify the appropriate source environment when you have multiple sources defined.
     # @return [String]
     attr_accessor :display_name
 
-    # Description of the source.
+    # Description of the source. This helps you to identify the appropriate source environment when you have multiple sources defined.
     # @return [String]
     attr_accessor :description
 
-    # The date and time at which the source was created
+    # The date and time at which the source was created, in the format defined by RFC3339.
     # @return [DateTime]
     attr_accessor :time_created
 
-    # The current state of the Source
+    # The current state of the source.
     # @return [String]
-    attr_accessor :lifecycle_state
+    attr_reader :lifecycle_state
 
-    # Details about the current lifecycle state
+    # Details about the current lifecycle state of the source.
     # @return [String]
     attr_accessor :lifecycle_details
 
     # @return [OCI::ApplicationMigration::Models::SourceDetails]
     attr_accessor :source_details
 
-    # Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only.
-    # Example: `{\"bar-key\": \"value\"}`
+    # Free-form tags for 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/Content/General/Concepts/resourcetags.htm). Example: `{\"Department\": \"Finance\"}`
     #
     # @return [Hash<String, String>]
     attr_accessor :freeform_tags
 
     # Defined tags for this resource. Each key is predefined and scoped to a namespace.
-    # Example: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`
+    # For more information, see [Resource Tags](https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm). Example: `{\"Operations\": {\"CostCenter\": \"42\"}}`
     #
     # @return [Hash<String, Hash<String, Object>>]
     attr_accessor :defined_tags
@@ -166,6 +181,19 @@ module OCI
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
     # rubocop:enable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] lifecycle_state Object to be assigned
+    def lifecycle_state=(lifecycle_state)
+      # rubocop:disable Style/ConditionalAssignment
+      if lifecycle_state && !LIFECYCLE_STATE_ENUM.include?(lifecycle_state)
+        OCI.logger.debug("Unknown value for 'lifecycle_state' [" + lifecycle_state + "]. Mapping to 'LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @lifecycle_state = LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE
+      else
+        @lifecycle_state = lifecycle_state
+      end
+      # rubocop:enable Style/ConditionalAssignment
+    end
+
     # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
 
 

data/lib/oci/application_migration/models/source_application.rb

@@ -5,7 +5,7 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # An application running in the source environment that is available for export.
+  # Details about an application running in the source environment that you can migrate to Oracle Cloud Infrastructure.
   #
   class ApplicationMigration::Models::SourceApplication
     TYPE_ENUM = [
@@ -17,23 +17,23 @@ module OCI
       TYPE_PCS = 'PCS'.freeze
     ].freeze
 
-    # The name of the application
+    # The name of the application.
     # @return [String]
     attr_accessor :name
 
-    # The type of application
+    # The type of application.
     # @return [String]
     attr_reader :type
 
-    # Unique identifier (OCID) for the Source to which the application belongs
+    # The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the source to which the application belongs.
     # @return [String]
     attr_accessor :source_id
 
-    # The version of the application server
+    # The version of the application.
     # @return [String]
     attr_accessor :version
 
-    # The current application running state
+    # The current state of the application.
     # @return [String]
     attr_accessor :state
 

data/lib/oci/application_migration/models/source_application_summary.rb

@@ -6,7 +6,8 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # An application running in the source environment that is available for export.
+  # The properties that define an application, that is running in the source environment and which can be migrated to Oracle
+  # Cloud Infrastructure.
   #
   class ApplicationMigration::Models::SourceApplicationSummary
     TYPE_ENUM = [
@@ -19,23 +20,23 @@ module OCI
       TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # The name of the application
+    # The name of the application.
     # @return [String]
     attr_accessor :name
 
-    # The type of application
+    # The type of the application.
     # @return [String]
     attr_reader :type
 
-    # Unique identifier (OCID) for the Source to which the application belongs
+    # The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the source to which the application belongs.
     # @return [String]
     attr_accessor :source_id
 
-    # The version of the application server
+    # The version of the application.
     # @return [String]
     attr_accessor :version
 
-    # The current application running state
+    # The current state of the application.
     # @return [String]
     attr_accessor :state
 

data/lib/oci/application_migration/models/source_details.rb

@@ -6,7 +6,14 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Base model for different source environment types
+  # Specify one of the following values depending for the 'type' attribute based on the application that you want to migrate.
+  #
+  # Specify `OCIC` if you want to migrate Oracle Java Cloud Service, Oracle Analytics Cloud - Classic, Oracle Integration, and Oracle
+  # SOA Cloud Service applications from Oracle Cloud Infrastructure - Classic.
+  #
+  # Specify `INTERNAL_COMPUTE` if you have a traditional Oracle Cloud Infrastructure - Classic account and you want to migrate Oracle
+  # Process Cloud Service or Oracle Integration Cloud Service applications.
+  #
   # 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 ApplicationMigration::Models::SourceDetails
     TYPE_ENUM = [
@@ -15,7 +22,8 @@ module OCI
       TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # **[Required]** The type of source environment
+    # **[Required]** The type of source environment.
+    #
     # @return [String]
     attr_reader :type