aws-sdk-iotanalytics 1.24.0 → 1.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f4f988f56056f7fcfc11dc4b68e33a7a6453a551
-  data.tar.gz: 478b411526f7b15deb6d83658a6d9650966bd8ad
+  metadata.gz: f0088d9f160fedf8826b240b4a3675f42a606325
+  data.tar.gz: 63f31e8173e3178cdb58fc7d0b45adfcca61d07c
 SHA512:
-  metadata.gz: 427b2374e0ccf2b61467bd146d4551001979360a38e7d8c1fdc39733d8506039b1c840e34ec23812d5f8fea9af18488af28329691caad7301240deea6287b4ed
-  data.tar.gz: 86b0ea7cb5ca475f60af3659bbf961c9fe8b638291944c7986fe5e2b1ed4925a5eb4e678192fdbf88ac9009f1691d99ef0a24ea95e936c31b867eb2cda761a20
+  metadata.gz: 9fe7c04077cfe7d1a72f4269e36a5304aa82162675ac4696b97c73236210b1b2ad2bb98f0dd7424e54b69bd0ddf78499c1e507ebccb4aee59e64d44f6409b694
+  data.tar.gz: 83f69150f3e8fed54e5026d3365bb904c4c105208a2d817c6425fdaf953e9ae67c164c19e23e557e5882e78af90f96443c9295f3e1f4c9bd20b8ad1a9aa04bb6

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

@@ -348,10 +348,14 @@ module Aws::IoTAnalytics
     #   The name of the channel.
     #
     # @option params [Types::ChannelStorage] :channel_storage
-    #   Where channel data is stored.
+    #   Where channel data is stored. You may choose one of
+    #   "serviceManagedS3" or "customerManagedS3" storage. If not
+    #   specified, the default is "serviceManagedS3". This cannot be changed
+    #   after creation of the channel.
     #
     # @option params [Types::RetentionPeriod] :retention_period
-    #   How long, in days, message data is kept for the channel.
+    #   How long, in days, message data is kept for the channel. When
+    #   "customerManagedS3" storage is selected, this parameter is ignored.
     #
     # @option params [Array<Types::Tag>] :tags
     #   Metadata which can be used to manage the channel.
@@ -584,10 +588,14 @@ module Aws::IoTAnalytics
     #   The name of the data store.
     #
     # @option params [Types::DatastoreStorage] :datastore_storage
-    #   Where data store data is stored.
+    #   Where data store data is stored. You may choose one of
+    #   "serviceManagedS3" or "customerManagedS3" storage. If not
+    #   specified, the default is "serviceManagedS3". This cannot be changed
+    #   after the data store is created.
     #
     # @option params [Types::RetentionPeriod] :retention_period
-    #   How long, in days, message data is kept for the data store.
+    #   How long, in days, message data is kept for the data store. When
+    #   "customerManagedS3" storage is selected, this parameter is ignored.
     #
     # @option params [Array<Types::Tag>] :tags
     #   Metadata which can be used to manage the data store.
@@ -637,10 +645,10 @@ module Aws::IoTAnalytics
       req.send_request(options)
     end
 
-    # Creates a pipeline. A pipeline consumes messages from one or more
-    # channels and allows you to process the messages before storing them in
-    # a data store. You must specify both a `channel` and a `datastore`
-    # activity and, optionally, as many as 23 additional activities in the
+    # Creates a pipeline. A pipeline consumes messages from a channel and
+    # allows you to process the messages before storing them in a data
+    # store. You must specify both a `channel` and a `datastore` activity
+    # and, optionally, as many as 23 additional activities in the
     # `pipelineActivities` array.
     #
     # @option params [required, String] :pipeline_name
@@ -870,7 +878,8 @@ module Aws::IoTAnalytics
     #
     # @option params [Boolean] :include_statistics
     #   If true, additional statistical information about the channel is
-    #   included in the response.
+    #   included in the response. This feature cannot be used with a channel
+    #   whose S3 storage is customer-managed.
     #
     # @return [Types::DescribeChannelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -974,8 +983,9 @@ module Aws::IoTAnalytics
     #   The name of the data store
     #
     # @option params [Boolean] :include_statistics
-    #   If true, additional statistical information about the datastore is
-    #   included in the response.
+    #   If true, additional statistical information about the data store is
+    #   included in the response. This feature cannot be used with a data
+    #   store whose S3 storage is customer-managed.
     #
     # @return [Types::DescribeDatastoreResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1228,6 +1238,7 @@ module Aws::IoTAnalytics
     #   resp.dataset_content_summaries[0].status.reason #=> String
     #   resp.dataset_content_summaries[0].creation_time #=> Time
     #   resp.dataset_content_summaries[0].schedule_time #=> Time
+    #   resp.dataset_content_summaries[0].completion_time #=> Time
     #   resp.next_token #=> String
     #
     # @overload list_dataset_contents(params = {})
@@ -1653,10 +1664,15 @@ module Aws::IoTAnalytics
     #   The name of the channel to be updated.
     #
     # @option params [Types::ChannelStorage] :channel_storage
-    #   Where channel data is stored.
+    #   Where channel data is stored. You may choose one of
+    #   "serviceManagedS3" or "customerManagedS3" storage. If not
+    #   specified, the default is "serviceManagedS3". This cannot be changed
+    #   after creation of the channel.
     #
     # @option params [Types::RetentionPeriod] :retention_period
-    #   How long, in days, message data is kept for the channel.
+    #   How long, in days, message data is kept for the channel. The retention
+    #   period cannot be updated if the channel's S3 storage is
+    #   customer-managed.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1809,10 +1825,15 @@ module Aws::IoTAnalytics
     #   The name of the data store to be updated.
     #
     # @option params [Types::RetentionPeriod] :retention_period
-    #   How long, in days, message data is kept for the data store.
+    #   How long, in days, message data is kept for the data store. The
+    #   retention period cannot be updated if the data store's S3 storage is
+    #   customer-managed.
     #
     # @option params [Types::DatastoreStorage] :datastore_storage
-    #   Where data store data is stored.
+    #   Where data store data is stored. You may choose one of
+    #   "serviceManagedS3" or "customerManagedS3" storage. If not
+    #   specified, the default is "serviceManagedS3". This cannot be changed
+    #   after the data store is created.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1952,7 +1973,7 @@ module Aws::IoTAnalytics
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-iotanalytics'
-      context[:gem_version] = '1.24.0'
+      context[:gem_version] = '1.25.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -415,6 +415,7 @@ module Aws::IoTAnalytics
     DatasetContentSummary.add_member(:status, Shapes::ShapeRef.new(shape: DatasetContentStatus, location_name: "status"))
     DatasetContentSummary.add_member(:creation_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "creationTime"))
     DatasetContentSummary.add_member(:schedule_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "scheduleTime"))
+    DatasetContentSummary.add_member(:completion_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "completionTime"))
     DatasetContentSummary.struct_class = Types::DatasetContentSummary
 
     DatasetContentVersionValue.add_member(:dataset_name, Shapes::ShapeRef.new(shape: DatasetName, required: true, location_name: "datasetName"))

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

@@ -162,7 +162,10 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] storage
-    #   Where channel data is stored.
+    #   Where channel data is stored. You may choose one of
+    #   "serviceManagedS3" or "customerManagedS3" storage. If not
+    #   specified, the default is "serviceManagedS3". This cannot be
+    #   changed after creation of the channel.
     #   @return [Types::ChannelStorage]
     #
     # @!attribute [rw] arn
@@ -238,7 +241,10 @@ module Aws::IoTAnalytics
       include Aws::Structure
     end
 
-    # Where channel data is stored.
+    # Where channel data is stored. You may choose one of
+    # "serviceManagedS3" or "customerManagedS3" storage. If not
+    # specified, the default is "serviceManagedS3". This cannot be changed
+    # after creation of the channel.
     #
     # @note When making an API call, you may pass ChannelStorage
     #   data as a hash:
@@ -255,11 +261,17 @@ module Aws::IoTAnalytics
     #
     # @!attribute [rw] service_managed_s3
     #   Use this to store channel data in an S3 bucket managed by the AWS
-    #   IoT Analytics service.
+    #   IoT Analytics service. The choice of service-managed or
+    #   customer-managed S3 storage cannot be changed after creation of the
+    #   channel.
     #   @return [Types::ServiceManagedChannelS3Storage]
     #
     # @!attribute [rw] customer_managed_s3
-    #   Use this to store channel data in an S3 bucket that you manage.
+    #   Use this to store channel data in an S3 bucket that you manage. If
+    #   customer managed storage is selected, the "retentionPeriod"
+    #   parameter is ignored. The choice of service-managed or
+    #   customer-managed S3 storage cannot be changed after creation of the
+    #   channel.
     #   @return [Types::CustomerManagedChannelS3Storage]
     #
     class ChannelStorage < Struct.new(
@@ -409,11 +421,16 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] channel_storage
-    #   Where channel data is stored.
+    #   Where channel data is stored. You may choose one of
+    #   "serviceManagedS3" or "customerManagedS3" storage. If not
+    #   specified, the default is "serviceManagedS3". This cannot be
+    #   changed after creation of the channel.
     #   @return [Types::ChannelStorage]
     #
     # @!attribute [rw] retention_period
-    #   How long, in days, message data is kept for the channel.
+    #   How long, in days, message data is kept for the channel. When
+    #   "customerManagedS3" storage is selected, this parameter is
+    #   ignored.
     #   @return [Types::RetentionPeriod]
     #
     # @!attribute [rw] tags
@@ -663,11 +680,16 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] datastore_storage
-    #   Where data store data is stored.
+    #   Where data store data is stored. You may choose one of
+    #   "serviceManagedS3" or "customerManagedS3" storage. If not
+    #   specified, the default is "serviceManagedS3". This cannot be
+    #   changed after the data store is created.
     #   @return [Types::DatastoreStorage]
     #
     # @!attribute [rw] retention_period
-    #   How long, in days, message data is kept for the data store.
+    #   How long, in days, message data is kept for the data store. When
+    #   "customerManagedS3" storage is selected, this parameter is
+    #   ignored.
     #   @return [Types::RetentionPeriod]
     #
     # @!attribute [rw] tags
@@ -820,7 +842,11 @@ module Aws::IoTAnalytics
       include Aws::Structure
     end
 
-    # Use this to store channel data in an S3 bucket that you manage.
+    # Use this to store channel data in an S3 bucket that you manage. If
+    # customer managed storage is selected, the "retentionPeriod"
+    # parameter is ignored. The choice of service-managed or
+    # customer-managed S3 storage cannot be changed after creation of the
+    # channel.
     #
     # @note When making an API call, you may pass CustomerManagedChannelS3Storage
     #   data as a hash:
@@ -836,10 +862,10 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] key_prefix
-    #   The prefix used to create the keys of the channel data objects. Each
-    #   object in an Amazon S3 bucket has a key that is its unique
-    #   identifier within the bucket (each object in a bucket has exactly
-    #   one key).
+    #   \[Optional\] The prefix used to create the keys of the channel data
+    #   objects. Each object in an Amazon S3 bucket has a key that is its
+    #   unique identifier within the bucket (each object in a bucket has
+    #   exactly one key). The prefix must end with a '/'.
     #   @return [String]
     #
     # @!attribute [rw] role_arn
@@ -861,10 +887,10 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] key_prefix
-    #   The prefix used to create the keys of the channel data objects. Each
-    #   object in an Amazon S3 bucket has a key that is its unique
-    #   identifier within the bucket (each object in a bucket has exactly
-    #   one key).
+    #   \[Optional\] The prefix used to create the keys of the channel data
+    #   objects. Each object in an Amazon S3 bucket has a key that is its
+    #   unique identifier within the bucket (each object in a bucket has
+    #   exactly one key). The prefix must end with a '/'.
     #   @return [String]
     #
     # @!attribute [rw] role_arn
@@ -880,6 +906,10 @@ module Aws::IoTAnalytics
     end
 
     # Use this to store data store data in an S3 bucket that you manage.
+    # When customer managed storage is selected, the "retentionPeriod"
+    # parameter is ignored. The choice of service-managed or
+    # customer-managed S3 storage cannot be changed after creation of the
+    # data store.
     #
     # @note When making an API call, you may pass CustomerManagedDatastoreS3Storage
     #   data as a hash:
@@ -895,10 +925,10 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] key_prefix
-    #   The prefix used to create the keys of the data store data objects.
-    #   Each object in an Amazon S3 bucket has a key that is its unique
-    #   identifier within the bucket (each object in a bucket has exactly
-    #   one key).
+    #   \[Optional\] The prefix used to create the keys of the data store
+    #   data objects. Each object in an Amazon S3 bucket has a key that is
+    #   its unique identifier within the bucket (each object in a bucket has
+    #   exactly one key). The prefix must end with a '/'.
     #   @return [String]
     #
     # @!attribute [rw] role_arn
@@ -920,10 +950,10 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] key_prefix
-    #   The prefix used to create the keys of the data store data objects.
-    #   Each object in an Amazon S3 bucket has a key that is its unique
-    #   identifier within the bucket (each object in a bucket has exactly
-    #   one key).
+    #   \[Optional\] The prefix used to create the keys of the data store
+    #   data objects. Each object in an Amazon S3 bucket has a key that is
+    #   its unique identifier within the bucket (each object in a bucket has
+    #   exactly one key). The prefix must end with a '/'.
     #   @return [String]
     #
     # @!attribute [rw] role_arn
@@ -1201,11 +1231,17 @@ module Aws::IoTAnalytics
     #   start.
     #   @return [Time]
     #
+    # @!attribute [rw] completion_time
+    #   The time the dataset content status was updated to SUCCEEDED or
+    #   FAILED.
+    #   @return [Time]
+    #
     class DatasetContentSummary < Struct.new(
       :version,
       :status,
       :creation_time,
-      :schedule_time)
+      :schedule_time,
+      :completion_time)
       include Aws::Structure
     end
 
@@ -1321,7 +1357,10 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] storage
-    #   Where data store data is stored.
+    #   Where data store data is stored. You may choose one of
+    #   "serviceManagedS3" or "customerManagedS3" storage. If not
+    #   specified, the default is "serviceManagedS3". This cannot be
+    #   changed after the data store is created.
     #   @return [Types::DatastoreStorage]
     #
     # @!attribute [rw] arn
@@ -1345,7 +1384,9 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] retention_period
-    #   How long, in days, message data is kept for the data store.
+    #   How long, in days, message data is kept for the data store. When
+    #   "customerManagedS3" storage is selected, this parameter is
+    #   ignored.
     #   @return [Types::RetentionPeriod]
     #
     # @!attribute [rw] creation_time
@@ -1403,7 +1444,10 @@ module Aws::IoTAnalytics
       include Aws::Structure
     end
 
-    # Where data store data is stored.
+    # Where data store data is stored. You may choose one of
+    # "serviceManagedS3" or "customerManagedS3" storage. If not
+    # specified, the default is "serviceManagedS3". This cannot be changed
+    # after the data store is created.
     #
     # @note When making an API call, you may pass DatastoreStorage
     #   data as a hash:
@@ -1420,11 +1464,17 @@ module Aws::IoTAnalytics
     #
     # @!attribute [rw] service_managed_s3
     #   Use this to store data store data in an S3 bucket managed by the AWS
-    #   IoT Analytics service.
+    #   IoT Analytics service. The choice of service-managed or
+    #   customer-managed S3 storage cannot be changed after creation of the
+    #   data store.
     #   @return [Types::ServiceManagedDatastoreS3Storage]
     #
     # @!attribute [rw] customer_managed_s3
     #   Use this to store data store data in an S3 bucket that you manage.
+    #   When customer managed storage is selected, the "retentionPeriod"
+    #   parameter is ignored. The choice of service-managed or
+    #   customer-managed S3 storage cannot be changed after creation of the
+    #   data store.
     #   @return [Types::CustomerManagedDatastoreS3Storage]
     #
     class DatastoreStorage < Struct.new(
@@ -1621,7 +1671,8 @@ module Aws::IoTAnalytics
     #
     # @!attribute [rw] include_statistics
     #   If true, additional statistical information about the channel is
-    #   included in the response.
+    #   included in the response. This feature cannot be used with a channel
+    #   whose S3 storage is customer-managed.
     #   @return [Boolean]
     #
     class DescribeChannelRequest < Struct.new(
@@ -1683,8 +1734,9 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] include_statistics
-    #   If true, additional statistical information about the datastore is
-    #   included in the response.
+    #   If true, additional statistical information about the data store is
+    #   included in the response. This feature cannot be used with a data
+    #   store whose S3 storage is customer-managed.
     #   @return [Boolean]
     #
     class DescribeDatastoreRequest < Struct.new(
@@ -2898,7 +2950,12 @@ module Aws::IoTAnalytics
     # @!attribute [rw] key
     #   The key of the data set contents object. Each object in an Amazon S3
     #   bucket has a key that is its unique identifier within the bucket
-    #   (each object in a bucket has exactly one key).
+    #   (each object in a bucket has exactly one key). To produce a unique
+    #   key, you can use "!\\\{iotanalytics:scheduledTime\\}" to insert
+    #   the time of the scheduled SQL query run, or
+    #   "!\\\{iotanalytics:versioned\\} to insert a unique hash identifying
+    #   the data set, for example:
+    #   "/DataSet/!\\\{iotanalytics:scheduledTime\\}/!\\\{iotanalytics:versioned\\}.csv".
     #   @return [String]
     #
     # @!attribute [rw] glue_configuration
@@ -3021,7 +3078,8 @@ module Aws::IoTAnalytics
     end
 
     # Use this to store channel data in an S3 bucket managed by the AWS IoT
-    # Analytics service.
+    # Analytics service. The choice of service-managed or customer-managed
+    # S3 storage cannot be changed after creation of the channel.
     #
     # @api private
     #
@@ -3033,7 +3091,9 @@ module Aws::IoTAnalytics
     class ServiceManagedChannelS3StorageSummary < Aws::EmptyStructure; end
 
     # Use this to store data store data in an S3 bucket managed by the AWS
-    # IoT Analytics service.
+    # IoT Analytics service. The choice of service-managed or
+    # customer-managed S3 storage cannot be changed after creation of the
+    # data store.
     #
     # @api private
     #
@@ -3254,11 +3314,16 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] channel_storage
-    #   Where channel data is stored.
+    #   Where channel data is stored. You may choose one of
+    #   "serviceManagedS3" or "customerManagedS3" storage. If not
+    #   specified, the default is "serviceManagedS3". This cannot be
+    #   changed after creation of the channel.
     #   @return [Types::ChannelStorage]
     #
     # @!attribute [rw] retention_period
-    #   How long, in days, message data is kept for the channel.
+    #   How long, in days, message data is kept for the channel. The
+    #   retention period cannot be updated if the channel's S3 storage is
+    #   customer-managed.
     #   @return [Types::RetentionPeriod]
     #
     class UpdateChannelRequest < Struct.new(
@@ -3416,11 +3481,16 @@ module Aws::IoTAnalytics
     #   @return [String]
     #
     # @!attribute [rw] retention_period
-    #   How long, in days, message data is kept for the data store.
+    #   How long, in days, message data is kept for the data store. The
+    #   retention period cannot be updated if the data store's S3 storage
+    #   is customer-managed.
     #   @return [Types::RetentionPeriod]
     #
     # @!attribute [rw] datastore_storage
-    #   Where data store data is stored.
+    #   Where data store data is stored. You may choose one of
+    #   "serviceManagedS3" or "customerManagedS3" storage. If not
+    #   specified, the default is "serviceManagedS3". This cannot be
+    #   changed after the data store is created.
     #   @return [Types::DatastoreStorage]
     #
     class UpdateDatastoreRequest < Struct.new(

data/lib/aws-sdk-iotanalytics.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-iotanalytics/customizations'
 # @service
 module Aws::IoTAnalytics
 
-  GEM_VERSION = '1.24.0'
+  GEM_VERSION = '1.25.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-iotanalytics
 version: !ruby/object:Gem::Version
-  version: 1.24.0
+  version: 1.25.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-25 00:00:00.000000000 Z
+date: 2019-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core