aws-sdk-appflow 1.43.0 → 1.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 78c7f091c25fd616fcc54213d79c2df1a5f2c5184aa3728c522f44cf10d74481
-  data.tar.gz: f0e29f65f044ee251a72572b017d69c56b4a02e98beb4128a0a38d965316ddaa
+  metadata.gz: 04a3f5ededad875ff95fc38b621dfd1d21babe2d2a76e95e8b933fa3649a5898
+  data.tar.gz: 07cc24d22696777f627b15c98fc974b0d24a91896c9add2cda4e3aa81ce94d47
 SHA512:
-  metadata.gz: 6953a50113d9930cd5ad873977ab7426c4fa181c1c6b5e2ac122fb412a4f2aecc233d1fd6a4d68d4d344e17cd6637e7c013369f6b9bff784e7eb4537aa64cfba
-  data.tar.gz: 81f9d0e0b93111540d1096fb160bbc0a1a45460e1deb34d1284182304264e9dacf5b0bf82bba960f9a2c0202de31597bd5bcaf2c6523c1c8f899e2eca2ab8475
+  metadata.gz: 0b0628e9689c3382d0f7f6b51b9f0e71db0830b16f43994017877f63b06564960da9932406e1c8eea991ba00dd76e1f09b54bf42005175f8b2bcb7323080e814
+  data.tar.gz: 1a01d052e3d92de172a5592346a36d1a816b2d715e37311fbed9261aca7d170c22955aeb25b4893fc56c482e48df9ddd0968877ea589f6c170eaff1d7bdeed11

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.44.0 (2023-06-20)
+------------------
+
+* Feature - This release adds new API to reset connector metadata cache
+
 1.43.0 (2023-06-15)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.43.0
+1.44.0

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

@@ -2219,6 +2219,96 @@ module Aws::Appflow
       req.send_request(options)
     end
 
+    # Resets metadata about your connector entities that Amazon AppFlow
+    # stored in its cache. Use this action when you want Amazon AppFlow to
+    # return the latest information about the data that you have in a source
+    # application.
+    #
+    # Amazon AppFlow returns metadata about your entities when you use the
+    # ListConnectorEntities or DescribeConnectorEntities actions. Following
+    # these actions, Amazon AppFlow caches the metadata to reduce the number
+    # of API requests that it must send to the source application. Amazon
+    # AppFlow automatically resets the cache once every hour, but you can
+    # use this action when you want to get the latest metadata right away.
+    #
+    # @option params [String] :connector_profile_name
+    #   The name of the connector profile that you want to reset cached
+    #   metadata for.
+    #
+    #   You can omit this parameter if you're resetting the cache for any of
+    #   the following connectors: Amazon Connect, Amazon EventBridge, Amazon
+    #   Lookout for Metrics, Amazon S3, or Upsolver. If you're resetting the
+    #   cache for any other connector, you must include this parameter in your
+    #   request.
+    #
+    # @option params [String] :connector_type
+    #   The type of connector to reset cached metadata for.
+    #
+    #   You must include this parameter in your request if you're resetting
+    #   the cache for any of the following connectors: Amazon Connect, Amazon
+    #   EventBridge, Amazon Lookout for Metrics, Amazon S3, or Upsolver. If
+    #   you're resetting the cache for any other connector, you can omit this
+    #   parameter from your request.
+    #
+    # @option params [String] :connector_entity_name
+    #   Use this parameter if you want to reset cached metadata about the
+    #   details for an individual entity.
+    #
+    #   If you don't include this parameter in your request, Amazon AppFlow
+    #   only resets cached metadata about entity names, not entity details.
+    #
+    # @option params [String] :entities_path
+    #   Use this parameter only if you’re resetting the cached metadata about
+    #   a nested entity. Only some connectors support nested entities. A
+    #   nested entity is one that has another entity as a parent. To use this
+    #   parameter, specify the name of the parent entity.
+    #
+    #   To look up the parent-child relationship of entities, you can send a
+    #   ListConnectorEntities request that omits the entitiesPath parameter.
+    #   Amazon AppFlow will return a list of top-level entities. For each one,
+    #   it indicates whether the entity has nested entities. Then, in a
+    #   subsequent ListConnectorEntities request, you can specify a parent
+    #   entity name for the entitiesPath parameter. Amazon AppFlow will return
+    #   a list of the child entities for that parent.
+    #
+    # @option params [String] :api_version
+    #   The API version that you specified in the connector profile that
+    #   you’re resetting cached metadata for. You must use this parameter only
+    #   if the connector supports multiple API versions or if the connector
+    #   type is CustomConnector.
+    #
+    #   To look up how many versions a connector supports, use the
+    #   DescribeConnectors action. In the response, find the value that Amazon
+    #   AppFlow returns for the connectorVersion parameter.
+    #
+    #   To look up the connector type, use the DescribeConnectorProfiles
+    #   action. In the response, find the value that Amazon AppFlow returns
+    #   for the connectorType parameter.
+    #
+    #   To look up the API version that you specified in a connector profile,
+    #   use the DescribeConnectorProfiles action.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.reset_connector_metadata_cache({
+    #     connector_profile_name: "ConnectorProfileName",
+    #     connector_type: "Salesforce", # accepts Salesforce, Singular, Slack, Redshift, S3, Marketo, Googleanalytics, Zendesk, Servicenow, Datadog, Trendmicro, Snowflake, Dynatrace, Infornexus, Amplitude, Veeva, EventBridge, LookoutMetrics, Upsolver, Honeycode, CustomerProfiles, SAPOData, CustomConnector, Pardot
+    #     connector_entity_name: "EntityName",
+    #     entities_path: "EntitiesPath",
+    #     api_version: "ApiVersion",
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appflow-2020-08-23/ResetConnectorMetadataCache AWS API Documentation
+    #
+    # @overload reset_connector_metadata_cache(params = {})
+    # @param [Hash] params ({})
+    def reset_connector_metadata_cache(params = {}, options = {})
+      req = build_request(:reset_connector_metadata_cache, params)
+      req.send_request(options)
+    end
+
     # Activates an existing flow. For on-demand flows, this operation runs
     # the flow immediately. For schedule and event-triggered flows, this
     # operation activates the flow.
@@ -3124,7 +3214,7 @@ module Aws::Appflow
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-appflow'
-      context[:gem_version] = '1.43.0'
+      context[:gem_version] = '1.44.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -296,6 +296,8 @@ module Aws::Appflow
     RegisterConnectorResponse = Shapes::StructureShape.new(name: 'RegisterConnectorResponse')
     RegisteredBy = Shapes::StringShape.new(name: 'RegisteredBy')
     RegistrationOutput = Shapes::StructureShape.new(name: 'RegistrationOutput')
+    ResetConnectorMetadataCacheRequest = Shapes::StructureShape.new(name: 'ResetConnectorMetadataCacheRequest')
+    ResetConnectorMetadataCacheResponse = Shapes::StructureShape.new(name: 'ResetConnectorMetadataCacheResponse')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     RoleArn = Shapes::StringShape.new(name: 'RoleArn')
     S3ConnectorOperator = Shapes::StringShape.new(name: 'S3ConnectorOperator')
@@ -1218,6 +1220,15 @@ module Aws::Appflow
     RegistrationOutput.add_member(:status, Shapes::ShapeRef.new(shape: ExecutionStatus, location_name: "status"))
     RegistrationOutput.struct_class = Types::RegistrationOutput
 
+    ResetConnectorMetadataCacheRequest.add_member(:connector_profile_name, Shapes::ShapeRef.new(shape: ConnectorProfileName, location_name: "connectorProfileName"))
+    ResetConnectorMetadataCacheRequest.add_member(:connector_type, Shapes::ShapeRef.new(shape: ConnectorType, location_name: "connectorType"))
+    ResetConnectorMetadataCacheRequest.add_member(:connector_entity_name, Shapes::ShapeRef.new(shape: EntityName, location_name: "connectorEntityName"))
+    ResetConnectorMetadataCacheRequest.add_member(:entities_path, Shapes::ShapeRef.new(shape: EntitiesPath, location_name: "entitiesPath"))
+    ResetConnectorMetadataCacheRequest.add_member(:api_version, Shapes::ShapeRef.new(shape: ApiVersion, location_name: "apiVersion"))
+    ResetConnectorMetadataCacheRequest.struct_class = Types::ResetConnectorMetadataCacheRequest
+
+    ResetConnectorMetadataCacheResponse.struct_class = Types::ResetConnectorMetadataCacheResponse
+
     ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
     ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
 
@@ -1827,6 +1838,18 @@ module Aws::Appflow
         o.errors << Shapes::ShapeRef.new(shape: ConnectorAuthenticationException)
       end)
 
+      api.add_operation(:reset_connector_metadata_cache, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ResetConnectorMetadataCache"
+        o.http_method = "POST"
+        o.http_request_uri = "/reset-connector-metadata-cache"
+        o.input = Shapes::ShapeRef.new(shape: ResetConnectorMetadataCacheRequest)
+        o.output = Shapes::ShapeRef.new(shape: ResetConnectorMetadataCacheResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+      end)
+
       api.add_operation(:start_flow, Seahorse::Model::Operation.new.tap do |o|
         o.name = "StartFlow"
         o.http_method = "POST"

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

@@ -236,6 +236,20 @@ module Aws::Appflow
       end
     end
 
+    class ResetConnectorMetadataCache
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::Appflow::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 StartFlow
       def self.build(context)
         unless context.config.regional_endpoint

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

@@ -88,6 +88,8 @@ module Aws::Appflow
             Aws::Appflow::Endpoints::ListTagsForResource.build(context)
           when :register_connector
             Aws::Appflow::Endpoints::RegisterConnector.build(context)
+          when :reset_connector_metadata_cache
+            Aws::Appflow::Endpoints::ResetConnectorMetadataCache.build(context)
           when :start_flow
             Aws::Appflow::Endpoints::StartFlow.build(context)
           when :stop_flow

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

@@ -3897,6 +3897,84 @@ module Aws::Appflow
       include Aws::Structure
     end
 
+    # @!attribute [rw] connector_profile_name
+    #   The name of the connector profile that you want to reset cached
+    #   metadata for.
+    #
+    #   You can omit this parameter if you're resetting the cache for any
+    #   of the following connectors: Amazon Connect, Amazon EventBridge,
+    #   Amazon Lookout for Metrics, Amazon S3, or Upsolver. If you're
+    #   resetting the cache for any other connector, you must include this
+    #   parameter in your request.
+    #   @return [String]
+    #
+    # @!attribute [rw] connector_type
+    #   The type of connector to reset cached metadata for.
+    #
+    #   You must include this parameter in your request if you're resetting
+    #   the cache for any of the following connectors: Amazon Connect,
+    #   Amazon EventBridge, Amazon Lookout for Metrics, Amazon S3, or
+    #   Upsolver. If you're resetting the cache for any other connector,
+    #   you can omit this parameter from your request.
+    #   @return [String]
+    #
+    # @!attribute [rw] connector_entity_name
+    #   Use this parameter if you want to reset cached metadata about the
+    #   details for an individual entity.
+    #
+    #   If you don't include this parameter in your request, Amazon AppFlow
+    #   only resets cached metadata about entity names, not entity details.
+    #   @return [String]
+    #
+    # @!attribute [rw] entities_path
+    #   Use this parameter only if you’re resetting the cached metadata
+    #   about a nested entity. Only some connectors support nested entities.
+    #   A nested entity is one that has another entity as a parent. To use
+    #   this parameter, specify the name of the parent entity.
+    #
+    #   To look up the parent-child relationship of entities, you can send a
+    #   ListConnectorEntities request that omits the entitiesPath parameter.
+    #   Amazon AppFlow will return a list of top-level entities. For each
+    #   one, it indicates whether the entity has nested entities. Then, in a
+    #   subsequent ListConnectorEntities request, you can specify a parent
+    #   entity name for the entitiesPath parameter. Amazon AppFlow will
+    #   return a list of the child entities for that parent.
+    #   @return [String]
+    #
+    # @!attribute [rw] api_version
+    #   The API version that you specified in the connector profile that
+    #   you’re resetting cached metadata for. You must use this parameter
+    #   only if the connector supports multiple API versions or if the
+    #   connector type is CustomConnector.
+    #
+    #   To look up how many versions a connector supports, use the
+    #   DescribeConnectors action. In the response, find the value that
+    #   Amazon AppFlow returns for the connectorVersion parameter.
+    #
+    #   To look up the connector type, use the DescribeConnectorProfiles
+    #   action. In the response, find the value that Amazon AppFlow returns
+    #   for the connectorType parameter.
+    #
+    #   To look up the API version that you specified in a connector
+    #   profile, use the DescribeConnectorProfiles action.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appflow-2020-08-23/ResetConnectorMetadataCacheRequest AWS API Documentation
+    #
+    class ResetConnectorMetadataCacheRequest < Struct.new(
+      :connector_profile_name,
+      :connector_type,
+      :connector_entity_name,
+      :entities_path,
+      :api_version)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appflow-2020-08-23/ResetConnectorMetadataCacheResponse AWS API Documentation
+    #
+    class ResetConnectorMetadataCacheResponse < Aws::EmptyStructure; end
+
     # The resource specified in the request (such as the source or
     # destination connector profile) is not found.
     #

data/lib/aws-sdk-appflow.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-appflow/customizations'
 # @!group service
 module Aws::Appflow
 
-  GEM_VERSION = '1.43.0'
+  GEM_VERSION = '1.44.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-appflow
 version: !ruby/object:Gem::Version
-  version: 1.43.0
+  version: 1.44.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-15 00:00:00.000000000 Z
+date: 2023-06-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core