aws-sdk-iotsitewise 1.40.0 → 1.43.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9d7add6ebb929f385fb65586d2cbf13b02d3042bab504443f7ac6f9d57ef6aef
4
- data.tar.gz: e1ca19fbc414e296fe3c3421450f0b316b12fdb6ed7a7b2e99f79205f28981c6
3
+ metadata.gz: ce1ae1cfe447159f8152f0145f032762f077e3645865f631db3559ada430c161
4
+ data.tar.gz: a9da693b4bb120dfa50b359ad2da566510537be1f99f7db0917c6f9d8534df84
5
5
  SHA512:
6
- metadata.gz: a6ad51cbeb3d705dc9a5d2972c6655ceacbec6eda677beed42012fd6bd182c0bd6a48466eae4057419a7d584161c5e7e8eaa65d1289ccc2875391c661c79d001
7
- data.tar.gz: 25c887cb9d7c547132e5c274f5f5240801e845c496bb0b5bc9bf6d13406e4318089b688c3af8f4c1af55b43b53e65bdc0dff340c258ccab83215b3385d2eed00
6
+ metadata.gz: a12deef53620d482480e5d4c68dca13daa161120f50d1bd3694277d24c16cc52886d2cca363d7ad26944d69222812e61209b35eac1706c200886394092e481fb
7
+ data.tar.gz: ab8f2cd424e2b8d26edfbba777d3f554d6b2f589c7ef7548f4df394e40648627cda8662a43c21b412fb9bcdaf840f2720a74e98f72688f0e60e2716afc86d819
data/CHANGELOG.md CHANGED
@@ -1,6 +1,21 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.43.0 (2022-07-21)
5
+ ------------------
6
+
7
+ * Feature - Added asynchronous API to ingest bulk historical and current data into IoT SiteWise.
8
+
9
+ 1.42.0 (2022-05-31)
10
+ ------------------
11
+
12
+ * Feature - This release adds the following new optional field to the IoT SiteWise asset resource: assetDescription.
13
+
14
+ 1.41.0 (2022-04-21)
15
+ ------------------
16
+
17
+ * Feature - This release adds 3 new batch data query APIs : BatchGetAssetPropertyValue, BatchGetAssetPropertyValueHistory and BatchGetAssetPropertyAggregates
18
+
4
19
  1.40.0 (2022-02-24)
5
20
  ------------------
6
21
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.40.0
1
+ 1.43.0
@@ -524,6 +524,240 @@ module Aws::IoTSiteWise
524
524
  req.send_request(options)
525
525
  end
526
526
 
527
+ # Gets aggregated values (for example, average, minimum, and maximum)
528
+ # for one or more asset properties. For more information, see [Querying
529
+ # aggregates][1] in the *IoT SiteWise User Guide*.
530
+ #
531
+ #
532
+ #
533
+ # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#aggregates
534
+ #
535
+ # @option params [required, Array<Types::BatchGetAssetPropertyAggregatesEntry>] :entries
536
+ # The list of asset property aggregate entries for the batch get
537
+ # request. You can specify up to 16 entries per request.
538
+ #
539
+ # @option params [String] :next_token
540
+ # The token to be used for the next set of paginated results.
541
+ #
542
+ # @option params [Integer] :max_results
543
+ # The maximum number of results to return for each paginated request. A
544
+ # result set is returned in the two cases, whichever occurs first.
545
+ #
546
+ # * The size of the result set is less than 1 MB.
547
+ #
548
+ # * The number of data points in the result set is less than the value
549
+ # of `maxResults`. The maximum value of `maxResults` is 4000.
550
+ #
551
+ # @return [Types::BatchGetAssetPropertyAggregatesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
552
+ #
553
+ # * {Types::BatchGetAssetPropertyAggregatesResponse#error_entries #error_entries} => Array&lt;Types::BatchGetAssetPropertyAggregatesErrorEntry&gt;
554
+ # * {Types::BatchGetAssetPropertyAggregatesResponse#success_entries #success_entries} => Array&lt;Types::BatchGetAssetPropertyAggregatesSuccessEntry&gt;
555
+ # * {Types::BatchGetAssetPropertyAggregatesResponse#skipped_entries #skipped_entries} => Array&lt;Types::BatchGetAssetPropertyAggregatesSkippedEntry&gt;
556
+ # * {Types::BatchGetAssetPropertyAggregatesResponse#next_token #next_token} => String
557
+ #
558
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
559
+ #
560
+ # @example Request syntax with placeholder values
561
+ #
562
+ # resp = client.batch_get_asset_property_aggregates({
563
+ # entries: [ # required
564
+ # {
565
+ # entry_id: "EntryId", # required
566
+ # asset_id: "ID",
567
+ # property_id: "ID",
568
+ # property_alias: "AssetPropertyAlias",
569
+ # aggregate_types: ["AVERAGE"], # required, accepts AVERAGE, COUNT, MAXIMUM, MINIMUM, SUM, STANDARD_DEVIATION
570
+ # resolution: "Resolution", # required
571
+ # start_date: Time.now, # required
572
+ # end_date: Time.now, # required
573
+ # qualities: ["GOOD"], # accepts GOOD, BAD, UNCERTAIN
574
+ # time_ordering: "ASCENDING", # accepts ASCENDING, DESCENDING
575
+ # },
576
+ # ],
577
+ # next_token: "NextToken",
578
+ # max_results: 1,
579
+ # })
580
+ #
581
+ # @example Response structure
582
+ #
583
+ # resp.error_entries #=> Array
584
+ # resp.error_entries[0].error_code #=> String, one of "ResourceNotFoundException", "InvalidRequestException", "AccessDeniedException"
585
+ # resp.error_entries[0].error_message #=> String
586
+ # resp.error_entries[0].entry_id #=> String
587
+ # resp.success_entries #=> Array
588
+ # resp.success_entries[0].entry_id #=> String
589
+ # resp.success_entries[0].aggregated_values #=> Array
590
+ # resp.success_entries[0].aggregated_values[0].timestamp #=> Time
591
+ # resp.success_entries[0].aggregated_values[0].quality #=> String, one of "GOOD", "BAD", "UNCERTAIN"
592
+ # resp.success_entries[0].aggregated_values[0].value.average #=> Float
593
+ # resp.success_entries[0].aggregated_values[0].value.count #=> Float
594
+ # resp.success_entries[0].aggregated_values[0].value.maximum #=> Float
595
+ # resp.success_entries[0].aggregated_values[0].value.minimum #=> Float
596
+ # resp.success_entries[0].aggregated_values[0].value.sum #=> Float
597
+ # resp.success_entries[0].aggregated_values[0].value.standard_deviation #=> Float
598
+ # resp.skipped_entries #=> Array
599
+ # resp.skipped_entries[0].entry_id #=> String
600
+ # resp.skipped_entries[0].completion_status #=> String, one of "SUCCESS", "ERROR"
601
+ # resp.skipped_entries[0].error_info.error_code #=> String, one of "ResourceNotFoundException", "InvalidRequestException", "AccessDeniedException"
602
+ # resp.skipped_entries[0].error_info.error_timestamp #=> Time
603
+ # resp.next_token #=> String
604
+ #
605
+ # @overload batch_get_asset_property_aggregates(params = {})
606
+ # @param [Hash] params ({})
607
+ def batch_get_asset_property_aggregates(params = {}, options = {})
608
+ req = build_request(:batch_get_asset_property_aggregates, params)
609
+ req.send_request(options)
610
+ end
611
+
612
+ # Gets the current value for one or more asset properties. For more
613
+ # information, see [Querying current values][1] in the *IoT SiteWise
614
+ # User Guide*.
615
+ #
616
+ #
617
+ #
618
+ # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#current-values
619
+ #
620
+ # @option params [required, Array<Types::BatchGetAssetPropertyValueEntry>] :entries
621
+ # The list of asset property value entries for the batch get request.
622
+ # You can specify up to 16 entries per request.
623
+ #
624
+ # @option params [String] :next_token
625
+ # The token to be used for the next set of paginated results.
626
+ #
627
+ # @return [Types::BatchGetAssetPropertyValueResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
628
+ #
629
+ # * {Types::BatchGetAssetPropertyValueResponse#error_entries #error_entries} => Array&lt;Types::BatchGetAssetPropertyValueErrorEntry&gt;
630
+ # * {Types::BatchGetAssetPropertyValueResponse#success_entries #success_entries} => Array&lt;Types::BatchGetAssetPropertyValueSuccessEntry&gt;
631
+ # * {Types::BatchGetAssetPropertyValueResponse#skipped_entries #skipped_entries} => Array&lt;Types::BatchGetAssetPropertyValueSkippedEntry&gt;
632
+ # * {Types::BatchGetAssetPropertyValueResponse#next_token #next_token} => String
633
+ #
634
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
635
+ #
636
+ # @example Request syntax with placeholder values
637
+ #
638
+ # resp = client.batch_get_asset_property_value({
639
+ # entries: [ # required
640
+ # {
641
+ # entry_id: "EntryId", # required
642
+ # asset_id: "ID",
643
+ # property_id: "ID",
644
+ # property_alias: "AssetPropertyAlias",
645
+ # },
646
+ # ],
647
+ # next_token: "NextToken",
648
+ # })
649
+ #
650
+ # @example Response structure
651
+ #
652
+ # resp.error_entries #=> Array
653
+ # resp.error_entries[0].error_code #=> String, one of "ResourceNotFoundException", "InvalidRequestException", "AccessDeniedException"
654
+ # resp.error_entries[0].error_message #=> String
655
+ # resp.error_entries[0].entry_id #=> String
656
+ # resp.success_entries #=> Array
657
+ # resp.success_entries[0].entry_id #=> String
658
+ # resp.success_entries[0].asset_property_value.value.string_value #=> String
659
+ # resp.success_entries[0].asset_property_value.value.integer_value #=> Integer
660
+ # resp.success_entries[0].asset_property_value.value.double_value #=> Float
661
+ # resp.success_entries[0].asset_property_value.value.boolean_value #=> Boolean
662
+ # resp.success_entries[0].asset_property_value.timestamp.time_in_seconds #=> Integer
663
+ # resp.success_entries[0].asset_property_value.timestamp.offset_in_nanos #=> Integer
664
+ # resp.success_entries[0].asset_property_value.quality #=> String, one of "GOOD", "BAD", "UNCERTAIN"
665
+ # resp.skipped_entries #=> Array
666
+ # resp.skipped_entries[0].entry_id #=> String
667
+ # resp.skipped_entries[0].completion_status #=> String, one of "SUCCESS", "ERROR"
668
+ # resp.skipped_entries[0].error_info.error_code #=> String, one of "ResourceNotFoundException", "InvalidRequestException", "AccessDeniedException"
669
+ # resp.skipped_entries[0].error_info.error_timestamp #=> Time
670
+ # resp.next_token #=> String
671
+ #
672
+ # @overload batch_get_asset_property_value(params = {})
673
+ # @param [Hash] params ({})
674
+ def batch_get_asset_property_value(params = {}, options = {})
675
+ req = build_request(:batch_get_asset_property_value, params)
676
+ req.send_request(options)
677
+ end
678
+
679
+ # Gets the historical values for one or more asset properties. For more
680
+ # information, see [Querying historical values][1] in the *IoT SiteWise
681
+ # User Guide*.
682
+ #
683
+ #
684
+ #
685
+ # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html#historical-values
686
+ #
687
+ # @option params [required, Array<Types::BatchGetAssetPropertyValueHistoryEntry>] :entries
688
+ # The list of asset property historical value entries for the batch get
689
+ # request. You can specify up to 16 entries per request.
690
+ #
691
+ # @option params [String] :next_token
692
+ # The token to be used for the next set of paginated results.
693
+ #
694
+ # @option params [Integer] :max_results
695
+ # The maximum number of results to return for each paginated request. A
696
+ # result set is returned in the two cases, whichever occurs first.
697
+ #
698
+ # * The size of the result set is less than 1 MB.
699
+ #
700
+ # * The number of data points in the result set is less than the value
701
+ # of `maxResults`. The maximum value of `maxResults` is 4000.
702
+ #
703
+ # @return [Types::BatchGetAssetPropertyValueHistoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
704
+ #
705
+ # * {Types::BatchGetAssetPropertyValueHistoryResponse#error_entries #error_entries} => Array&lt;Types::BatchGetAssetPropertyValueHistoryErrorEntry&gt;
706
+ # * {Types::BatchGetAssetPropertyValueHistoryResponse#success_entries #success_entries} => Array&lt;Types::BatchGetAssetPropertyValueHistorySuccessEntry&gt;
707
+ # * {Types::BatchGetAssetPropertyValueHistoryResponse#skipped_entries #skipped_entries} => Array&lt;Types::BatchGetAssetPropertyValueHistorySkippedEntry&gt;
708
+ # * {Types::BatchGetAssetPropertyValueHistoryResponse#next_token #next_token} => String
709
+ #
710
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
711
+ #
712
+ # @example Request syntax with placeholder values
713
+ #
714
+ # resp = client.batch_get_asset_property_value_history({
715
+ # entries: [ # required
716
+ # {
717
+ # entry_id: "EntryId", # required
718
+ # asset_id: "ID",
719
+ # property_id: "ID",
720
+ # property_alias: "AssetPropertyAlias",
721
+ # start_date: Time.now,
722
+ # end_date: Time.now,
723
+ # qualities: ["GOOD"], # accepts GOOD, BAD, UNCERTAIN
724
+ # time_ordering: "ASCENDING", # accepts ASCENDING, DESCENDING
725
+ # },
726
+ # ],
727
+ # next_token: "NextToken",
728
+ # max_results: 1,
729
+ # })
730
+ #
731
+ # @example Response structure
732
+ #
733
+ # resp.error_entries #=> Array
734
+ # resp.error_entries[0].error_code #=> String, one of "ResourceNotFoundException", "InvalidRequestException", "AccessDeniedException"
735
+ # resp.error_entries[0].error_message #=> String
736
+ # resp.error_entries[0].entry_id #=> String
737
+ # resp.success_entries #=> Array
738
+ # resp.success_entries[0].entry_id #=> String
739
+ # resp.success_entries[0].asset_property_value_history #=> Array
740
+ # resp.success_entries[0].asset_property_value_history[0].value.string_value #=> String
741
+ # resp.success_entries[0].asset_property_value_history[0].value.integer_value #=> Integer
742
+ # resp.success_entries[0].asset_property_value_history[0].value.double_value #=> Float
743
+ # resp.success_entries[0].asset_property_value_history[0].value.boolean_value #=> Boolean
744
+ # resp.success_entries[0].asset_property_value_history[0].timestamp.time_in_seconds #=> Integer
745
+ # resp.success_entries[0].asset_property_value_history[0].timestamp.offset_in_nanos #=> Integer
746
+ # resp.success_entries[0].asset_property_value_history[0].quality #=> String, one of "GOOD", "BAD", "UNCERTAIN"
747
+ # resp.skipped_entries #=> Array
748
+ # resp.skipped_entries[0].entry_id #=> String
749
+ # resp.skipped_entries[0].completion_status #=> String, one of "SUCCESS", "ERROR"
750
+ # resp.skipped_entries[0].error_info.error_code #=> String, one of "ResourceNotFoundException", "InvalidRequestException", "AccessDeniedException"
751
+ # resp.skipped_entries[0].error_info.error_timestamp #=> Time
752
+ # resp.next_token #=> String
753
+ #
754
+ # @overload batch_get_asset_property_value_history(params = {})
755
+ # @param [Hash] params ({})
756
+ def batch_get_asset_property_value_history(params = {}, options = {})
757
+ req = build_request(:batch_get_asset_property_value_history, params)
758
+ req.send_request(options)
759
+ end
760
+
527
761
  # Sends a list of asset property values to IoT SiteWise. Each value is a
528
762
  # timestamp-quality-value (TQV) data point. For more information, see
529
763
  # [Ingesting data using the API][1] in the *IoT SiteWise User Guide*.
@@ -725,6 +959,9 @@ module Aws::IoTSiteWise
725
959
  #
726
960
  # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html
727
961
  #
962
+ # @option params [String] :asset_description
963
+ # A description for the asset.
964
+ #
728
965
  # @return [Types::CreateAssetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
729
966
  #
730
967
  # * {Types::CreateAssetResponse#asset_id #asset_id} => String
@@ -740,6 +977,7 @@ module Aws::IoTSiteWise
740
977
  # tags: {
741
978
  # "TagKey" => "TagValue",
742
979
  # },
980
+ # asset_description: "Description",
743
981
  # })
744
982
  #
745
983
  # @example Response structure
@@ -993,6 +1231,91 @@ module Aws::IoTSiteWise
993
1231
  req.send_request(options)
994
1232
  end
995
1233
 
1234
+ # <note markdown="1"> This API operation is in preview release for IoT SiteWise and is
1235
+ # subject to change. We recommend that you use this operation only with
1236
+ # test data, and not in production environments.
1237
+ #
1238
+ # </note>
1239
+ #
1240
+ # Defines a job to ingest data to IoT SiteWise from Amazon S3. For more
1241
+ # information, see [Create a bulk import job (CLI)][1] in the *Amazon
1242
+ # Simple Storage Service User Guide*.
1243
+ #
1244
+ # You must enable IoT SiteWise to export data to Amazon S3 before you
1245
+ # create a bulk import job. For more information about how to configure
1246
+ # storage settings, see [PutStorageConfiguration][2].
1247
+ #
1248
+ #
1249
+ #
1250
+ # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/CreateBulkImportJob.html
1251
+ # [2]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutStorageConfiguration.html
1252
+ #
1253
+ # @option params [required, String] :job_name
1254
+ # The unique name that helps identify the job request.
1255
+ #
1256
+ # @option params [required, String] :job_role_arn
1257
+ # The [ARN][1] of the IAM role that allows IoT SiteWise to read Amazon
1258
+ # S3 data.
1259
+ #
1260
+ #
1261
+ #
1262
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
1263
+ #
1264
+ # @option params [required, Array<Types::File>] :files
1265
+ # The files in the specified Amazon S3 bucket that contain your data.
1266
+ #
1267
+ # @option params [required, Types::ErrorReportLocation] :error_report_location
1268
+ # The Amazon S3 destination where errors associated with the job
1269
+ # creation request are saved.
1270
+ #
1271
+ # @option params [required, Types::JobConfiguration] :job_configuration
1272
+ # Contains the configuration information of a job, such as the file
1273
+ # format used to save data in Amazon S3.
1274
+ #
1275
+ # @return [Types::CreateBulkImportJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1276
+ #
1277
+ # * {Types::CreateBulkImportJobResponse#job_id #job_id} => String
1278
+ # * {Types::CreateBulkImportJobResponse#job_name #job_name} => String
1279
+ # * {Types::CreateBulkImportJobResponse#job_status #job_status} => String
1280
+ #
1281
+ # @example Request syntax with placeholder values
1282
+ #
1283
+ # resp = client.create_bulk_import_job({
1284
+ # job_name: "Name", # required
1285
+ # job_role_arn: "ARN", # required
1286
+ # files: [ # required
1287
+ # {
1288
+ # bucket: "Bucket", # required
1289
+ # key: "String", # required
1290
+ # version_id: "String",
1291
+ # },
1292
+ # ],
1293
+ # error_report_location: { # required
1294
+ # bucket: "Bucket", # required
1295
+ # prefix: "String", # required
1296
+ # },
1297
+ # job_configuration: { # required
1298
+ # file_format: { # required
1299
+ # csv: {
1300
+ # column_names: ["ALIAS"], # accepts ALIAS, ASSET_ID, PROPERTY_ID, DATA_TYPE, TIMESTAMP_SECONDS, TIMESTAMP_NANO_OFFSET, QUALITY, VALUE
1301
+ # },
1302
+ # },
1303
+ # },
1304
+ # })
1305
+ #
1306
+ # @example Response structure
1307
+ #
1308
+ # resp.job_id #=> String
1309
+ # resp.job_name #=> String
1310
+ # resp.job_status #=> String, one of "PENDING", "CANCELLED", "RUNNING", "COMPLETED", "FAILED", "COMPLETED_WITH_FAILURES"
1311
+ #
1312
+ # @overload create_bulk_import_job(params = {})
1313
+ # @param [Hash] params ({})
1314
+ def create_bulk_import_job(params = {}, options = {})
1315
+ req = build_request(:create_bulk_import_job, params)
1316
+ req.send_request(options)
1317
+ end
1318
+
996
1319
  # Creates a dashboard in an IoT SiteWise Monitor project.
997
1320
  #
998
1321
  # @option params [required, String] :project_id
@@ -1688,6 +2011,7 @@ module Aws::IoTSiteWise
1688
2011
  # * {Types::DescribeAssetResponse#asset_creation_date #asset_creation_date} => Time
1689
2012
  # * {Types::DescribeAssetResponse#asset_last_update_date #asset_last_update_date} => Time
1690
2013
  # * {Types::DescribeAssetResponse#asset_status #asset_status} => Types::AssetStatus
2014
+ # * {Types::DescribeAssetResponse#asset_description #asset_description} => String
1691
2015
  #
1692
2016
  # @example Request syntax with placeholder values
1693
2017
  #
@@ -1734,6 +2058,7 @@ module Aws::IoTSiteWise
1734
2058
  # resp.asset_status.error.details #=> Array
1735
2059
  # resp.asset_status.error.details[0].code #=> String, one of "INCOMPATIBLE_COMPUTE_LOCATION", "INCOMPATIBLE_FORWARDING_CONFIGURATION"
1736
2060
  # resp.asset_status.error.details[0].message #=> String
2061
+ # resp.asset_description #=> String
1737
2062
  #
1738
2063
  #
1739
2064
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -1954,6 +2279,65 @@ module Aws::IoTSiteWise
1954
2279
  req.send_request(options)
1955
2280
  end
1956
2281
 
2282
+ # <note markdown="1"> This API operation is in preview release for IoT SiteWise and is
2283
+ # subject to change. We recommend that you use this operation only with
2284
+ # test data, and not in production environments.
2285
+ #
2286
+ # </note>
2287
+ #
2288
+ # Retrieves information about a bulk import job request. For more
2289
+ # information, see [Describe a bulk import job (CLI)][1] in the *Amazon
2290
+ # Simple Storage Service User Guide*.
2291
+ #
2292
+ #
2293
+ #
2294
+ # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/DescribeBulkImportJob.html
2295
+ #
2296
+ # @option params [required, String] :job_id
2297
+ # The ID of the job.
2298
+ #
2299
+ # @return [Types::DescribeBulkImportJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2300
+ #
2301
+ # * {Types::DescribeBulkImportJobResponse#job_id #job_id} => String
2302
+ # * {Types::DescribeBulkImportJobResponse#job_name #job_name} => String
2303
+ # * {Types::DescribeBulkImportJobResponse#job_status #job_status} => String
2304
+ # * {Types::DescribeBulkImportJobResponse#job_role_arn #job_role_arn} => String
2305
+ # * {Types::DescribeBulkImportJobResponse#files #files} => Array&lt;Types::File&gt;
2306
+ # * {Types::DescribeBulkImportJobResponse#error_report_location #error_report_location} => Types::ErrorReportLocation
2307
+ # * {Types::DescribeBulkImportJobResponse#job_configuration #job_configuration} => Types::JobConfiguration
2308
+ # * {Types::DescribeBulkImportJobResponse#job_creation_date #job_creation_date} => Time
2309
+ # * {Types::DescribeBulkImportJobResponse#job_last_update_date #job_last_update_date} => Time
2310
+ #
2311
+ # @example Request syntax with placeholder values
2312
+ #
2313
+ # resp = client.describe_bulk_import_job({
2314
+ # job_id: "ID", # required
2315
+ # })
2316
+ #
2317
+ # @example Response structure
2318
+ #
2319
+ # resp.job_id #=> String
2320
+ # resp.job_name #=> String
2321
+ # resp.job_status #=> String, one of "PENDING", "CANCELLED", "RUNNING", "COMPLETED", "FAILED", "COMPLETED_WITH_FAILURES"
2322
+ # resp.job_role_arn #=> String
2323
+ # resp.files #=> Array
2324
+ # resp.files[0].bucket #=> String
2325
+ # resp.files[0].key #=> String
2326
+ # resp.files[0].version_id #=> String
2327
+ # resp.error_report_location.bucket #=> String
2328
+ # resp.error_report_location.prefix #=> String
2329
+ # resp.job_configuration.file_format.csv.column_names #=> Array
2330
+ # resp.job_configuration.file_format.csv.column_names[0] #=> String, one of "ALIAS", "ASSET_ID", "PROPERTY_ID", "DATA_TYPE", "TIMESTAMP_SECONDS", "TIMESTAMP_NANO_OFFSET", "QUALITY", "VALUE"
2331
+ # resp.job_creation_date #=> Time
2332
+ # resp.job_last_update_date #=> Time
2333
+ #
2334
+ # @overload describe_bulk_import_job(params = {})
2335
+ # @param [Hash] params ({})
2336
+ def describe_bulk_import_job(params = {}, options = {})
2337
+ req = build_request(:describe_bulk_import_job, params)
2338
+ req.send_request(options)
2339
+ end
2340
+
1957
2341
  # Retrieves information about a dashboard.
1958
2342
  #
1959
2343
  # @option params [required, String] :dashboard_id
@@ -3101,6 +3485,7 @@ module Aws::IoTSiteWise
3101
3485
  # resp.asset_summaries[0].hierarchies #=> Array
3102
3486
  # resp.asset_summaries[0].hierarchies[0].id #=> String
3103
3487
  # resp.asset_summaries[0].hierarchies[0].name #=> String
3488
+ # resp.asset_summaries[0].description #=> String
3104
3489
  # resp.next_token #=> String
3105
3490
  #
3106
3491
  # @overload list_assets(params = {})
@@ -3192,6 +3577,7 @@ module Aws::IoTSiteWise
3192
3577
  # resp.asset_summaries[0].hierarchies #=> Array
3193
3578
  # resp.asset_summaries[0].hierarchies[0].id #=> String
3194
3579
  # resp.asset_summaries[0].hierarchies[0].name #=> String
3580
+ # resp.asset_summaries[0].description #=> String
3195
3581
  # resp.next_token #=> String
3196
3582
  #
3197
3583
  # @overload list_associated_assets(params = {})
@@ -3201,6 +3587,60 @@ module Aws::IoTSiteWise
3201
3587
  req.send_request(options)
3202
3588
  end
3203
3589
 
3590
+ # <note markdown="1"> This API operation is in preview release for IoT SiteWise and is
3591
+ # subject to change. We recommend that you use this operation only with
3592
+ # test data, and not in production environments.
3593
+ #
3594
+ # </note>
3595
+ #
3596
+ # Retrieves a paginated list of bulk import job requests. For more
3597
+ # information, see [List bulk import jobs (CLI)][1] in the *Amazon
3598
+ # Simple Storage Service User Guide*.
3599
+ #
3600
+ #
3601
+ #
3602
+ # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/ListBulkImportJobs.html
3603
+ #
3604
+ # @option params [String] :next_token
3605
+ # The token to be used for the next set of paginated results.
3606
+ #
3607
+ # @option params [Integer] :max_results
3608
+ # The maximum number of results to return for each paginated request.
3609
+ #
3610
+ # @option params [String] :filter
3611
+ # You can use a filter to select the bulk import jobs that you want to
3612
+ # retrieve.
3613
+ #
3614
+ # @return [Types::ListBulkImportJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3615
+ #
3616
+ # * {Types::ListBulkImportJobsResponse#job_summaries #job_summaries} => Array&lt;Types::JobSummary&gt;
3617
+ # * {Types::ListBulkImportJobsResponse#next_token #next_token} => String
3618
+ #
3619
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3620
+ #
3621
+ # @example Request syntax with placeholder values
3622
+ #
3623
+ # resp = client.list_bulk_import_jobs({
3624
+ # next_token: "NextToken",
3625
+ # max_results: 1,
3626
+ # filter: "ALL", # accepts ALL, PENDING, RUNNING, CANCELLED, FAILED, COMPLETED_WITH_FAILURES, COMPLETED
3627
+ # })
3628
+ #
3629
+ # @example Response structure
3630
+ #
3631
+ # resp.job_summaries #=> Array
3632
+ # resp.job_summaries[0].id #=> String
3633
+ # resp.job_summaries[0].name #=> String
3634
+ # resp.job_summaries[0].status #=> String, one of "PENDING", "CANCELLED", "RUNNING", "COMPLETED", "FAILED", "COMPLETED_WITH_FAILURES"
3635
+ # resp.next_token #=> String
3636
+ #
3637
+ # @overload list_bulk_import_jobs(params = {})
3638
+ # @param [Hash] params ({})
3639
+ def list_bulk_import_jobs(params = {}, options = {})
3640
+ req = build_request(:list_bulk_import_jobs, params)
3641
+ req.send_request(options)
3642
+ end
3643
+
3204
3644
  # Retrieves a paginated list of dashboards for an IoT SiteWise Monitor
3205
3645
  # project.
3206
3646
  #
@@ -3592,7 +4032,7 @@ module Aws::IoTSiteWise
3592
4032
  # hot tier. The hot tier is a service-managed database.
3593
4033
  #
3594
4034
  # * `MULTI_LAYER_STORAGE` – IoT SiteWise saves your data in both the
3595
- # cold tier and the cold tier. The cold tier is a customer-managed
4035
+ # cold tier and the hot tier. The cold tier is a customer-managed
3596
4036
  # Amazon S3 bucket.
3597
4037
  #
3598
4038
  # @option params [Types::MultiLayerStorage] :multi_layer_storage
@@ -3820,6 +4260,9 @@ module Aws::IoTSiteWise
3820
4260
  # **A suitable default value is auto-generated.** You should normally
3821
4261
  # not need to pass this option.**
3822
4262
  #
4263
+ # @option params [String] :asset_description
4264
+ # A description for the asset.
4265
+ #
3823
4266
  # @return [Types::UpdateAssetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3824
4267
  #
3825
4268
  # * {Types::UpdateAssetResponse#asset_status #asset_status} => Types::AssetStatus
@@ -3830,6 +4273,7 @@ module Aws::IoTSiteWise
3830
4273
  # asset_id: "ID", # required
3831
4274
  # asset_name: "Name", # required
3832
4275
  # client_token: "ClientToken",
4276
+ # asset_description: "Description",
3833
4277
  # })
3834
4278
  #
3835
4279
  # @example Response structure
@@ -4429,7 +4873,7 @@ module Aws::IoTSiteWise
4429
4873
  params: params,
4430
4874
  config: config)
4431
4875
  context[:gem_name] = 'aws-sdk-iotsitewise'
4432
- context[:gem_version] = '1.40.0'
4876
+ context[:gem_version] = '1.43.0'
4433
4877
  Seahorse::Client::Request.new(handlers, context)
4434
4878
  end
4435
4879