aws-sdk-databasemigrationservice 1.84.0 → 1.85.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a715e2cf86b16c32bbeb1e991b2f574028e5fcd7efe8f0d9af6c6394694c4d29
-  data.tar.gz: 33f9b801b814bed5c65ee1745a423d3e1a4fddf8395fa68f960f32f239a2cb66
+  metadata.gz: 04ab17d87ec2c89b97a0490cde2d652ab7219e4140a933676e25c7d9848c41f6
+  data.tar.gz: 026a2e18869d2259779bec61a2a20d5661b99c3766a1d80f22e384edc786e379
 SHA512:
-  metadata.gz: 32d3da45b53aa5cfb7eacb0745ca5830e39e7142b5d6d8252fc5c87466fe32237b974b55cc19611f069bab5d5ab57b993457f22dd7c2f9844a1f55d5caaf35af
-  data.tar.gz: 85d3a267baac91192989a2b3f6cd2ac6b97be135b9ea1ae640d2894ee87454a37d2adf7418c5bda56937aaaed43512a0caece094f53df375bef77cec7977f817
+  metadata.gz: 525907edabdab7cac5ba646378b3ff1541833336a0be9d91bcb1d16bbc4d6eacd9fdf2b08f963e25bd446da50cb4bd4a95a0c756e4561ae7cbd1067f5c5e15da
+  data.tar.gz: 99f6698b9b2da44c68d6ce298f0f319a426a6bc0e5120ce58b586d1629cea9f7945d7a5e66fc58e6417c1ccd6f4b78d35f130f3242bbf97b5600e0bdd6e4df58

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.85.0 (2023-08-01)
+------------------
+
+* Feature - Adding new API describe-engine-versions which provides information about the lifecycle of a replication instance's version.
+
 1.84.0 (2023-07-13)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.84.0
+1.85.0

data/lib/aws-sdk-databasemigrationservice/client.rb

@@ -4349,6 +4349,57 @@ module Aws::DatabaseMigrationService
       req.send_request(options)
     end
 
+    # Returns information about the replication instance versions used in
+    # the project.
+    #
+    # @option params [Integer] :max_records
+    #   The maximum number of records to include in the response. If more
+    #   records exist than the specified `MaxRecords` value, a pagination
+    #   token called a marker is included in the response so that the
+    #   remaining results can be retrieved.
+    #
+    # @option params [String] :marker
+    #   An optional pagination token provided by a previous request. If this
+    #   parameter is specified, the response includes only records beyond the
+    #   marker, up to the value specified by `MaxRecords`.
+    #
+    # @return [Types::DescribeEngineVersionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeEngineVersionsResponse#engine_versions #engine_versions} => Array<Types::EngineVersion>
+    #   * {Types::DescribeEngineVersionsResponse#marker #marker} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_engine_versions({
+    #     max_records: 1,
+    #     marker: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.engine_versions #=> Array
+    #   resp.engine_versions[0].version #=> String
+    #   resp.engine_versions[0].lifecycle #=> String
+    #   resp.engine_versions[0].release_status #=> String, one of "beta", "prod"
+    #   resp.engine_versions[0].launch_date #=> Time
+    #   resp.engine_versions[0].auto_upgrade_date #=> Time
+    #   resp.engine_versions[0].deprecation_date #=> Time
+    #   resp.engine_versions[0].force_upgrade_date #=> Time
+    #   resp.engine_versions[0].available_upgrades #=> Array
+    #   resp.engine_versions[0].available_upgrades[0] #=> String
+    #   resp.marker #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/DescribeEngineVersions AWS API Documentation
+    #
+    # @overload describe_engine_versions(params = {})
+    # @param [Hash] params ({})
+    def describe_engine_versions(params = {}, options = {})
+      req = build_request(:describe_engine_versions, params)
+      req.send_request(options)
+    end
+
     # Lists categories for all event source types, or, if specified, for a
     # specified source type. You can see a list of the event categories and
     # source types in [Working with Events and Notifications][1] in the
@@ -9161,7 +9212,7 @@ module Aws::DatabaseMigrationService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-databasemigrationservice'
-      context[:gem_version] = '1.84.0'
+      context[:gem_version] = '1.85.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-databasemigrationservice/client_api.rb

@@ -25,6 +25,7 @@ module Aws::DatabaseMigrationService
     AuthTypeValue = Shapes::StringShape.new(name: 'AuthTypeValue')
     AvailabilityZone = Shapes::StructureShape.new(name: 'AvailabilityZone')
     AvailabilityZonesList = Shapes::ListShape.new(name: 'AvailabilityZonesList')
+    AvailableUpgradesList = Shapes::ListShape.new(name: 'AvailableUpgradesList')
     BatchStartRecommendationsErrorEntry = Shapes::StructureShape.new(name: 'BatchStartRecommendationsErrorEntry')
     BatchStartRecommendationsErrorEntryList = Shapes::ListShape.new(name: 'BatchStartRecommendationsErrorEntryList')
     BatchStartRecommendationsRequest = Shapes::StructureShape.new(name: 'BatchStartRecommendationsRequest')
@@ -106,6 +107,8 @@ module Aws::DatabaseMigrationService
     DescribeEndpointTypesResponse = Shapes::StructureShape.new(name: 'DescribeEndpointTypesResponse')
     DescribeEndpointsMessage = Shapes::StructureShape.new(name: 'DescribeEndpointsMessage')
     DescribeEndpointsResponse = Shapes::StructureShape.new(name: 'DescribeEndpointsResponse')
+    DescribeEngineVersionsMessage = Shapes::StructureShape.new(name: 'DescribeEngineVersionsMessage')
+    DescribeEngineVersionsResponse = Shapes::StructureShape.new(name: 'DescribeEngineVersionsResponse')
     DescribeEventCategoriesMessage = Shapes::StructureShape.new(name: 'DescribeEventCategoriesMessage')
     DescribeEventCategoriesResponse = Shapes::StructureShape.new(name: 'DescribeEventCategoriesResponse')
     DescribeEventSubscriptionsMessage = Shapes::StructureShape.new(name: 'DescribeEventSubscriptionsMessage')
@@ -170,6 +173,8 @@ module Aws::DatabaseMigrationService
     EndpointSettingEnumValues = Shapes::ListShape.new(name: 'EndpointSettingEnumValues')
     EndpointSettingTypeValue = Shapes::StringShape.new(name: 'EndpointSettingTypeValue')
     EndpointSettingsList = Shapes::ListShape.new(name: 'EndpointSettingsList')
+    EngineVersion = Shapes::StructureShape.new(name: 'EngineVersion')
+    EngineVersionList = Shapes::ListShape.new(name: 'EngineVersionList')
     Event = Shapes::StructureShape.new(name: 'Event')
     EventCategoriesList = Shapes::ListShape.new(name: 'EventCategoriesList')
     EventCategoryGroup = Shapes::StructureShape.new(name: 'EventCategoryGroup')
@@ -402,6 +407,8 @@ module Aws::DatabaseMigrationService
 
     AvailabilityZonesList.member = Shapes::ShapeRef.new(shape: String)
 
+    AvailableUpgradesList.member = Shapes::ShapeRef.new(shape: String)
+
     BatchStartRecommendationsErrorEntry.add_member(:database_id, Shapes::ShapeRef.new(shape: String, location_name: "DatabaseId"))
     BatchStartRecommendationsErrorEntry.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
     BatchStartRecommendationsErrorEntry.add_member(:code, Shapes::ShapeRef.new(shape: String, location_name: "Code"))
@@ -769,6 +776,14 @@ module Aws::DatabaseMigrationService
     DescribeEndpointsResponse.add_member(:endpoints, Shapes::ShapeRef.new(shape: EndpointList, location_name: "Endpoints"))
     DescribeEndpointsResponse.struct_class = Types::DescribeEndpointsResponse
 
+    DescribeEngineVersionsMessage.add_member(:max_records, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "MaxRecords"))
+    DescribeEngineVersionsMessage.add_member(:marker, Shapes::ShapeRef.new(shape: String, location_name: "Marker"))
+    DescribeEngineVersionsMessage.struct_class = Types::DescribeEngineVersionsMessage
+
+    DescribeEngineVersionsResponse.add_member(:engine_versions, Shapes::ShapeRef.new(shape: EngineVersionList, location_name: "EngineVersions"))
+    DescribeEngineVersionsResponse.add_member(:marker, Shapes::ShapeRef.new(shape: String, location_name: "Marker"))
+    DescribeEngineVersionsResponse.struct_class = Types::DescribeEngineVersionsResponse
+
     DescribeEventCategoriesMessage.add_member(:source_type, Shapes::ShapeRef.new(shape: String, location_name: "SourceType"))
     DescribeEventCategoriesMessage.add_member(:filters, Shapes::ShapeRef.new(shape: FilterList, location_name: "Filters"))
     DescribeEventCategoriesMessage.struct_class = Types::DescribeEventCategoriesMessage
@@ -1086,6 +1101,18 @@ module Aws::DatabaseMigrationService
 
     EndpointSettingsList.member = Shapes::ShapeRef.new(shape: EndpointSetting)
 
+    EngineVersion.add_member(:version, Shapes::ShapeRef.new(shape: String, location_name: "Version"))
+    EngineVersion.add_member(:lifecycle, Shapes::ShapeRef.new(shape: String, location_name: "Lifecycle"))
+    EngineVersion.add_member(:release_status, Shapes::ShapeRef.new(shape: ReleaseStatusValues, location_name: "ReleaseStatus"))
+    EngineVersion.add_member(:launch_date, Shapes::ShapeRef.new(shape: TStamp, location_name: "LaunchDate"))
+    EngineVersion.add_member(:auto_upgrade_date, Shapes::ShapeRef.new(shape: TStamp, location_name: "AutoUpgradeDate"))
+    EngineVersion.add_member(:deprecation_date, Shapes::ShapeRef.new(shape: TStamp, location_name: "DeprecationDate"))
+    EngineVersion.add_member(:force_upgrade_date, Shapes::ShapeRef.new(shape: TStamp, location_name: "ForceUpgradeDate"))
+    EngineVersion.add_member(:available_upgrades, Shapes::ShapeRef.new(shape: AvailableUpgradesList, location_name: "AvailableUpgrades"))
+    EngineVersion.struct_class = Types::EngineVersion
+
+    EngineVersionList.member = Shapes::ShapeRef.new(shape: EngineVersion)
+
     Event.add_member(:source_identifier, Shapes::ShapeRef.new(shape: String, location_name: "SourceIdentifier"))
     Event.add_member(:source_type, Shapes::ShapeRef.new(shape: SourceType, location_name: "SourceType"))
     Event.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
@@ -2517,6 +2544,20 @@ module Aws::DatabaseMigrationService
         )
       end)
 
+      api.add_operation(:describe_engine_versions, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeEngineVersions"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeEngineVersionsMessage)
+        o.output = Shapes::ShapeRef.new(shape: DescribeEngineVersionsResponse)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_records",
+          tokens: {
+            "marker" => "marker"
+          }
+        )
+      end)
+
       api.add_operation(:describe_event_categories, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeEventCategories"
         o.http_method = "POST"

data/lib/aws-sdk-databasemigrationservice/endpoints.rb

@@ -418,6 +418,20 @@ module Aws::DatabaseMigrationService
       end
     end
 
+    class DescribeEngineVersions
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::DatabaseMigrationService::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class DescribeEventCategories
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-databasemigrationservice/plugins/endpoints.rb

@@ -114,6 +114,8 @@ module Aws::DatabaseMigrationService
             Aws::DatabaseMigrationService::Endpoints::DescribeEndpointTypes.build(context)
           when :describe_endpoints
             Aws::DatabaseMigrationService::Endpoints::DescribeEndpoints.build(context)
+          when :describe_engine_versions
+            Aws::DatabaseMigrationService::Endpoints::DescribeEngineVersions.build(context)
           when :describe_event_categories
             Aws::DatabaseMigrationService::Endpoints::DescribeEventCategories.build(context)
           when :describe_event_subscriptions

data/lib/aws-sdk-databasemigrationservice/types.rb

@@ -2350,6 +2350,48 @@ module Aws::DatabaseMigrationService
       include Aws::Structure
     end
 
+    # @!attribute [rw] max_records
+    #   The maximum number of records to include in the response. If more
+    #   records exist than the specified `MaxRecords` value, a pagination
+    #   token called a marker is included in the response so that the
+    #   remaining results can be retrieved.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] marker
+    #   An optional pagination token provided by a previous request. If this
+    #   parameter is specified, the response includes only records beyond
+    #   the marker, up to the value specified by `MaxRecords`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/DescribeEngineVersionsMessage AWS API Documentation
+    #
+    class DescribeEngineVersionsMessage < Struct.new(
+      :max_records,
+      :marker)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] engine_versions
+    #   Returned `EngineVersion` objects that describe the replication
+    #   instance engine versions used in the project.
+    #   @return [Array<Types::EngineVersion>]
+    #
+    # @!attribute [rw] marker
+    #   An optional pagination token provided by a previous request. If this
+    #   parameter is specified, the response includes only records beyond
+    #   the marker, up to the value specified by `MaxRecords`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/DescribeEngineVersionsResponse AWS API Documentation
+    #
+    class DescribeEngineVersionsResponse < Struct.new(
+      :engine_versions,
+      :marker)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] source_type
     #   The type of DMS resource that generates events.
     #
@@ -4188,6 +4230,62 @@ module Aws::DatabaseMigrationService
       include Aws::Structure
     end
 
+    # Provides information about a replication instance version.
+    #
+    # @!attribute [rw] version
+    #   The version number of the replication instance.
+    #   @return [String]
+    #
+    # @!attribute [rw] lifecycle
+    #   The lifecycle status of the replication instance version. Valid
+    #   values are `DEPRECATED`, `DEFAULT_VERSION`, and `ACTIVE`.
+    #   @return [String]
+    #
+    # @!attribute [rw] release_status
+    #   The release status of the replication instance version.
+    #   @return [String]
+    #
+    # @!attribute [rw] launch_date
+    #   The date when the replication instance version became publicly
+    #   available.
+    #   @return [Time]
+    #
+    # @!attribute [rw] auto_upgrade_date
+    #   The date when the replication instance will be automatically
+    #   upgraded. This setting only applies if the `auto-minor-version`
+    #   setting is enabled.
+    #   @return [Time]
+    #
+    # @!attribute [rw] deprecation_date
+    #   The date when the replication instance version will be deprecated
+    #   and can no longer be requested.
+    #   @return [Time]
+    #
+    # @!attribute [rw] force_upgrade_date
+    #   The date when the replication instance will have a version upgrade
+    #   forced.
+    #   @return [Time]
+    #
+    # @!attribute [rw] available_upgrades
+    #   The list of valid replication instance versions that you can upgrade
+    #   to.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/EngineVersion AWS API Documentation
+    #
+    class EngineVersion < Struct.new(
+      :version,
+      :lifecycle,
+      :release_status,
+      :launch_date,
+      :auto_upgrade_date,
+      :deprecation_date,
+      :force_upgrade_date,
+      :available_upgrades)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes an identifiable significant activity that affects a
     # replication instance or task. This object can provide the message, the
     # available event categories, the date and source of the event, and the
@@ -7319,9 +7417,8 @@ module Aws::DatabaseMigrationService
     #   @return [String]
     #
     # @!attribute [rw] database_mode
-    #   Specifies whether to use default or custom replication behavior for
-    #   PostgreSQL-compatible endpoints. You can use this setting to specify
-    #   replication behavior for endpoints that require additional
+    #   Specifies the default behavior of the replication's handling of
+    #   PostgreSQL- compatible endpoints that require some additional
     #   configuration, such as Babelfish endpoints.
     #   @return [String]
     #

data/lib/aws-sdk-databasemigrationservice.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-databasemigrationservice/customizations'
 # @!group service
 module Aws::DatabaseMigrationService
 
-  GEM_VERSION = '1.84.0'
+  GEM_VERSION = '1.85.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-databasemigrationservice
 version: !ruby/object:Gem::Version
-  version: 1.84.0
+  version: 1.85.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-13 00:00:00.000000000 Z
+date: 2023-08-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core