aws-sdk-datasync 1.102.0 → 1.104.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.
@@ -476,92 +476,6 @@ module Aws::DataSync
476
476
 
477
477
  # @!group API Operations
478
478
 
479
- # Creates an Amazon Web Services resource for an on-premises storage
480
- # system that you want DataSync Discovery to collect information about.
481
- #
482
- # @option params [required, Types::DiscoveryServerConfiguration] :server_configuration
483
- # Specifies the server name and network port required to connect with
484
- # the management interface of your on-premises storage system.
485
- #
486
- # @option params [required, String] :system_type
487
- # Specifies the type of on-premises storage system that you want
488
- # DataSync Discovery to collect information about.
489
- #
490
- # <note markdown="1"> DataSync Discovery currently supports NetApp Fabric-Attached Storage
491
- # (FAS) and All Flash FAS (AFF) systems running ONTAP 9.7 or later.
492
- #
493
- # </note>
494
- #
495
- # @option params [required, Array<String>] :agent_arns
496
- # Specifies the Amazon Resource Name (ARN) of the DataSync agent that
497
- # connects to and reads from your on-premises storage system's
498
- # management interface. You can only specify one ARN.
499
- #
500
- # @option params [String] :cloud_watch_log_group_arn
501
- # Specifies the ARN of the Amazon CloudWatch log group for monitoring
502
- # and logging discovery job events.
503
- #
504
- # @option params [Array<Types::TagListEntry>] :tags
505
- # Specifies labels that help you categorize, filter, and search for your
506
- # Amazon Web Services resources. We recommend creating at least a name
507
- # tag for your on-premises storage system.
508
- #
509
- # @option params [String] :name
510
- # Specifies a familiar name for your on-premises storage system.
511
- #
512
- # @option params [required, String] :client_token
513
- # Specifies a client token to make sure requests with this API operation
514
- # are idempotent. If you don't specify a client token, DataSync
515
- # generates one for you automatically.
516
- #
517
- # **A suitable default value is auto-generated.** You should normally
518
- # not need to pass this option.**
519
- #
520
- # @option params [required, Types::Credentials] :credentials
521
- # Specifies the user name and password for accessing your on-premises
522
- # storage system's management interface.
523
- #
524
- # @return [Types::AddStorageSystemResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
525
- #
526
- # * {Types::AddStorageSystemResponse#storage_system_arn #storage_system_arn} => String
527
- #
528
- # @example Request syntax with placeholder values
529
- #
530
- # resp = client.add_storage_system({
531
- # server_configuration: { # required
532
- # server_hostname: "DiscoveryServerHostname", # required
533
- # server_port: 1,
534
- # },
535
- # system_type: "NetAppONTAP", # required, accepts NetAppONTAP
536
- # agent_arns: ["AgentArn"], # required
537
- # cloud_watch_log_group_arn: "LogGroupArn",
538
- # tags: [
539
- # {
540
- # key: "TagKey", # required
541
- # value: "TagValue",
542
- # },
543
- # ],
544
- # name: "Name",
545
- # client_token: "PtolemyUUID", # required
546
- # credentials: { # required
547
- # username: "PtolemyUsername", # required
548
- # password: "PtolemyPassword", # required
549
- # },
550
- # })
551
- #
552
- # @example Response structure
553
- #
554
- # resp.storage_system_arn #=> String
555
- #
556
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/AddStorageSystem AWS API Documentation
557
- #
558
- # @overload add_storage_system(params = {})
559
- # @param [Hash] params ({})
560
- def add_storage_system(params = {}, options = {})
561
- req = build_request(:add_storage_system, params)
562
- req.send_request(options)
563
- end
564
-
565
479
  # Stops an DataSync task execution that's in progress. The transfer of
566
480
  # some files are abruptly interrupted. File contents that're
567
481
  # transferred to the destination might be incomplete or inconsistent
@@ -677,18 +591,18 @@ module Aws::DataSync
677
591
 
678
592
  # Creates a transfer *location* for a Microsoft Azure Blob Storage
679
593
  # container. DataSync can use this location as a transfer source or
680
- # destination.
594
+ # destination. You can make transfers with or without a [DataSync
595
+ # agent][1] that connects to your container.
681
596
  #
682
597
  # Before you begin, make sure you know [how DataSync accesses Azure Blob
683
- # Storage][1] and works with [access tiers][2] and [blob types][3]. You
684
- # also need a [DataSync agent][4] that can connect to your container.
598
+ # Storage][2] and works with [access tiers][3] and [blob types][4].
685
599
  #
686
600
  #
687
601
  #
688
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access
689
- # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers
690
- # [3]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#blob-types
691
- # [4]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-creating-agent
602
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-creating-agent
603
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access
604
+ # [3]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers
605
+ # [4]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#blob-types
692
606
  #
693
607
  # @option params [required, String] :container_url
694
608
  # Specifies the URL of the Azure Blob Storage container involved in your
@@ -703,6 +617,13 @@ module Aws::DataSync
703
617
  # Specifies the SAS configuration that allows DataSync to access your
704
618
  # Azure Blob Storage.
705
619
  #
620
+ # <note markdown="1"> If you provide an authentication token using `SasConfiguration`, but
621
+ # do not provide secret configuration details using `CmkSecretConfig` or
622
+ # `CustomSecretConfig`, then DataSync stores the token using your Amazon
623
+ # Web Services account's secrets manager secret.
624
+ #
625
+ # </note>
626
+ #
706
627
  # @option params [String] :blob_type
707
628
  # Specifies the type of blob that you want your objects or files to be
708
629
  # when transferring them into Azure Blob Storage. Currently, DataSync
@@ -727,13 +648,21 @@ module Aws::DataSync
727
648
  # Specifies path segments if you want to limit your transfer to a
728
649
  # virtual directory in your container (for example, `/my/images`).
729
650
  #
730
- # @option params [required, Array<String>] :agent_arns
731
- # Specifies the Amazon Resource Name (ARN) of the DataSync agent that
732
- # can connect with your Azure Blob Storage container.
651
+ # @option params [Array<String>] :agent_arns
652
+ # (Optional) Specifies the Amazon Resource Name (ARN) of the DataSync
653
+ # agent that can connect with your Azure Blob Storage container. If you
654
+ # are setting up an agentless cross-cloud transfer, you do not need to
655
+ # specify a value for this parameter.
733
656
  #
734
657
  # You can specify more than one agent. For more information, see [Using
735
658
  # multiple agents for your transfer][1].
736
659
  #
660
+ # <note markdown="1"> Make sure you configure this parameter correctly when you first create
661
+ # your storage location. You cannot add or remove agents from a storage
662
+ # location after you create it.
663
+ #
664
+ # </note>
665
+ #
737
666
  #
738
667
  #
739
668
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html
@@ -743,6 +672,41 @@ module Aws::DataSync
743
672
  # Amazon Web Services resources. We recommend creating at least a name
744
673
  # tag for your transfer location.
745
674
  #
675
+ # @option params [Types::CmkSecretConfig] :cmk_secret_config
676
+ # Specifies configuration information for a DataSync-managed secret,
677
+ # which includes the authentication token that DataSync uses to access a
678
+ # specific AzureBlob storage location, with a customer-managed KMS key.
679
+ #
680
+ # When you include this paramater as part of a `CreateLocationAzureBlob`
681
+ # request, you provide only the KMS key ARN. DataSync uses this KMS key
682
+ # together with the authentication token you specify for
683
+ # `SasConfiguration` to create a DataSync-managed secret to store the
684
+ # location access credentials.
685
+ #
686
+ # Make sure the DataSync has permission to access the KMS key that you
687
+ # specify.
688
+ #
689
+ # <note markdown="1"> You can use either `CmkSecretConfig` (with `SasConfiguration`) or
690
+ # `CustomSecretConfig` (without `SasConfiguration`) to provide
691
+ # credentials for a `CreateLocationAzureBlob` request. Do not provide
692
+ # both parameters for the same request.
693
+ #
694
+ # </note>
695
+ #
696
+ # @option params [Types::CustomSecretConfig] :custom_secret_config
697
+ # Specifies configuration information for a customer-managed Secrets
698
+ # Manager secret where the authentication token for an AzureBlob storage
699
+ # location is stored in plain text. This configuration includes the
700
+ # secret ARN, and the ARN for an IAM role that provides access to the
701
+ # secret.
702
+ #
703
+ # <note markdown="1"> You can use either `CmkSecretConfig` (with `SasConfiguration`) or
704
+ # `CustomSecretConfig` (without `SasConfiguration`) to provide
705
+ # credentials for a `CreateLocationAzureBlob` request. Do not provide
706
+ # both parameters for the same request.
707
+ #
708
+ # </note>
709
+ #
746
710
  # @return [Types::CreateLocationAzureBlobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
747
711
  #
748
712
  # * {Types::CreateLocationAzureBlobResponse#location_arn #location_arn} => String
@@ -751,20 +715,28 @@ module Aws::DataSync
751
715
  #
752
716
  # resp = client.create_location_azure_blob({
753
717
  # container_url: "AzureBlobContainerUrl", # required
754
- # authentication_type: "SAS", # required, accepts SAS
718
+ # authentication_type: "SAS", # required, accepts SAS, NONE
755
719
  # sas_configuration: {
756
720
  # token: "AzureBlobSasToken", # required
757
721
  # },
758
722
  # blob_type: "BLOCK", # accepts BLOCK
759
723
  # access_tier: "HOT", # accepts HOT, COOL, ARCHIVE
760
724
  # subdirectory: "AzureBlobSubdirectory",
761
- # agent_arns: ["AgentArn"], # required
725
+ # agent_arns: ["AgentArn"],
762
726
  # tags: [
763
727
  # {
764
728
  # key: "TagKey", # required
765
729
  # value: "TagValue",
766
730
  # },
767
731
  # ],
732
+ # cmk_secret_config: {
733
+ # secret_arn: "SecretArn",
734
+ # kms_key_arn: "KmsKeyArn",
735
+ # },
736
+ # custom_secret_config: {
737
+ # secret_arn: "SecretArn",
738
+ # secret_access_role_arn: "IamRoleArnOrEmptyString",
739
+ # },
768
740
  # })
769
741
  #
770
742
  # @example Response structure
@@ -1323,9 +1295,7 @@ module Aws::DataSync
1323
1295
  # @option params [String, StringIO, File] :kerberos_keytab
1324
1296
  # The Kerberos key table (keytab) that contains mappings between the
1325
1297
  # defined Kerberos principal and the encrypted keys. You can load the
1326
- # keytab from a file by providing the file's address. If you're using
1327
- # the CLI, it performs base64 encoding for you. Otherwise, provide the
1328
- # base64-encoded text.
1298
+ # keytab from a file by providing the file's address.
1329
1299
  #
1330
1300
  # <note markdown="1"> If `KERBEROS` is specified for `AuthenticationType`, this parameter is
1331
1301
  # required.
@@ -1485,14 +1455,15 @@ module Aws::DataSync
1485
1455
 
1486
1456
  # Creates a transfer *location* for an object storage system. DataSync
1487
1457
  # can use this location as a source or destination for transferring
1488
- # data.
1458
+ # data. You can make transfers with or without a [DataSync agent][1].
1489
1459
  #
1490
- # Before you begin, make sure that you understand the [prerequisites][1]
1460
+ # Before you begin, make sure that you understand the [prerequisites][2]
1491
1461
  # for DataSync to work with object storage systems.
1492
1462
  #
1493
1463
  #
1494
1464
  #
1495
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites
1465
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required
1466
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites
1496
1467
  #
1497
1468
  # @option params [required, String] :server_hostname
1498
1469
  # Specifies the domain name or IP version 4 (IPv4) address of the object
@@ -1524,9 +1495,17 @@ module Aws::DataSync
1524
1495
  # Specifies the secret key (for example, a password) if credentials are
1525
1496
  # required to authenticate with the object storage server.
1526
1497
  #
1527
- # @option params [required, Array<String>] :agent_arns
1528
- # Specifies the Amazon Resource Names (ARNs) of the DataSync agents that
1529
- # can connect with your object storage system.
1498
+ # @option params [Array<String>] :agent_arns
1499
+ # (Optional) Specifies the Amazon Resource Names (ARNs) of the DataSync
1500
+ # agents that can connect with your object storage system. If you are
1501
+ # setting up an agentless cross-cloud transfer, you do not need to
1502
+ # specify a value for this parameter.
1503
+ #
1504
+ # <note markdown="1"> Make sure you configure this parameter correctly when you first create
1505
+ # your storage location. You cannot add or remove agents from a storage
1506
+ # location after you create it.
1507
+ #
1508
+ # </note>
1530
1509
  #
1531
1510
  # @option params [Array<Types::TagListEntry>] :tags
1532
1511
  # Specifies the key-value pair that represents a tag that you want to
@@ -1558,6 +1537,41 @@ module Aws::DataSync
1558
1537
  #
1559
1538
  # To use this parameter, configure `ServerProtocol` to `HTTPS`.
1560
1539
  #
1540
+ # @option params [Types::CmkSecretConfig] :cmk_secret_config
1541
+ # Specifies configuration information for a DataSync-managed secret,
1542
+ # which includes the `SecretKey` that DataSync uses to access a specific
1543
+ # object storage location, with a customer-managed KMS key.
1544
+ #
1545
+ # When you include this paramater as part of a
1546
+ # `CreateLocationObjectStorage` request, you provide only the KMS key
1547
+ # ARN. DataSync uses this KMS key together with the value you specify
1548
+ # for the `SecretKey` parameter to create a DataSync-managed secret to
1549
+ # store the location access credentials.
1550
+ #
1551
+ # Make sure the DataSync has permission to access the KMS key that you
1552
+ # specify.
1553
+ #
1554
+ # <note markdown="1"> You can use either `CmkSecretConfig` (with `SecretKey`) or
1555
+ # `CustomSecretConfig` (without `SecretKey`) to provide credentials for
1556
+ # a `CreateLocationObjectStorage` request. Do not provide both
1557
+ # parameters for the same request.
1558
+ #
1559
+ # </note>
1560
+ #
1561
+ # @option params [Types::CustomSecretConfig] :custom_secret_config
1562
+ # Specifies configuration information for a customer-managed Secrets
1563
+ # Manager secret where the secret key for a specific object storage
1564
+ # location is stored in plain text. This configuration includes the
1565
+ # secret ARN, and the ARN for an IAM role that provides access to the
1566
+ # secret.
1567
+ #
1568
+ # <note markdown="1"> You can use either `CmkSecretConfig` (with `SecretKey`) or
1569
+ # `CustomSecretConfig` (without `SecretKey`) to provide credentials for
1570
+ # a `CreateLocationObjectStorage` request. Do not provide both
1571
+ # parameters for the same request.
1572
+ #
1573
+ # </note>
1574
+ #
1561
1575
  # @return [Types::CreateLocationObjectStorageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1562
1576
  #
1563
1577
  # * {Types::CreateLocationObjectStorageResponse#location_arn #location_arn} => String
@@ -1572,7 +1586,7 @@ module Aws::DataSync
1572
1586
  # bucket_name: "ObjectStorageBucketName", # required
1573
1587
  # access_key: "ObjectStorageAccessKey",
1574
1588
  # secret_key: "ObjectStorageSecretKey",
1575
- # agent_arns: ["AgentArn"], # required
1589
+ # agent_arns: ["AgentArn"],
1576
1590
  # tags: [
1577
1591
  # {
1578
1592
  # key: "TagKey", # required
@@ -1580,6 +1594,14 @@ module Aws::DataSync
1580
1594
  # },
1581
1595
  # ],
1582
1596
  # server_certificate: "data",
1597
+ # cmk_secret_config: {
1598
+ # secret_arn: "SecretArn",
1599
+ # kms_key_arn: "KmsKeyArn",
1600
+ # },
1601
+ # custom_secret_config: {
1602
+ # secret_arn: "SecretArn",
1603
+ # secret_access_role_arn: "IamRoleArnOrEmptyString",
1604
+ # },
1583
1605
  # })
1584
1606
  #
1585
1607
  # @example Response structure
@@ -1833,9 +1855,6 @@ module Aws::DataSync
1833
1855
  # Specifies your Kerberos key table (keytab) file, which includes
1834
1856
  # mappings between your Kerberos principal and encryption keys.
1835
1857
  #
1836
- # The file must be base64 encoded. If you're using the CLI, the
1837
- # encoding is done for you.
1838
- #
1839
1858
  # To avoid task execution errors, make sure that the Kerberos principal
1840
1859
  # that you use to create the keytab file matches exactly what you
1841
1860
  # specify for `KerberosPrincipal`.
@@ -1996,7 +2015,9 @@ module Aws::DataSync
1996
2015
  # higher performance than Basic mode. Enhanced mode tasks optimize the
1997
2016
  # data transfer process by listing, preparing, transferring, and
1998
2017
  # verifying data in parallel. Enhanced mode is currently available for
1999
- # transfers between Amazon S3 locations.
2018
+ # transfers between Amazon S3 locations, transfers between Azure Blob
2019
+ # and Amazon S3 without an agent, and transfers between other clouds
2020
+ # and Amazon S3 without an agent.
2000
2021
  #
2001
2022
  # <note markdown="1"> To create an Enhanced mode task, the IAM role that you use to call
2002
2023
  # the `CreateTask` operation must have the
@@ -2251,45 +2272,6 @@ module Aws::DataSync
2251
2272
  req.send_request(options)
2252
2273
  end
2253
2274
 
2254
- # Returns information about a DataSync discovery job.
2255
- #
2256
- # @option params [required, String] :discovery_job_arn
2257
- # Specifies the Amazon Resource Name (ARN) of the discovery job that you
2258
- # want information about.
2259
- #
2260
- # @return [Types::DescribeDiscoveryJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2261
- #
2262
- # * {Types::DescribeDiscoveryJobResponse#storage_system_arn #storage_system_arn} => String
2263
- # * {Types::DescribeDiscoveryJobResponse#discovery_job_arn #discovery_job_arn} => String
2264
- # * {Types::DescribeDiscoveryJobResponse#collection_duration_minutes #collection_duration_minutes} => Integer
2265
- # * {Types::DescribeDiscoveryJobResponse#status #status} => String
2266
- # * {Types::DescribeDiscoveryJobResponse#job_start_time #job_start_time} => Time
2267
- # * {Types::DescribeDiscoveryJobResponse#job_end_time #job_end_time} => Time
2268
- #
2269
- # @example Request syntax with placeholder values
2270
- #
2271
- # resp = client.describe_discovery_job({
2272
- # discovery_job_arn: "DiscoveryJobArn", # required
2273
- # })
2274
- #
2275
- # @example Response structure
2276
- #
2277
- # resp.storage_system_arn #=> String
2278
- # resp.discovery_job_arn #=> String
2279
- # resp.collection_duration_minutes #=> Integer
2280
- # resp.status #=> String, one of "RUNNING", "WARNING", "TERMINATED", "FAILED", "STOPPED", "COMPLETED", "COMPLETED_WITH_ISSUES"
2281
- # resp.job_start_time #=> Time
2282
- # resp.job_end_time #=> Time
2283
- #
2284
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeDiscoveryJob AWS API Documentation
2285
- #
2286
- # @overload describe_discovery_job(params = {})
2287
- # @param [Hash] params ({})
2288
- def describe_discovery_job(params = {}, options = {})
2289
- req = build_request(:describe_discovery_job, params)
2290
- req.send_request(options)
2291
- end
2292
-
2293
2275
  # Provides details about how an DataSync transfer location for Microsoft
2294
2276
  # Azure Blob Storage is configured.
2295
2277
  #
@@ -2306,6 +2288,9 @@ module Aws::DataSync
2306
2288
  # * {Types::DescribeLocationAzureBlobResponse#access_tier #access_tier} => String
2307
2289
  # * {Types::DescribeLocationAzureBlobResponse#agent_arns #agent_arns} => Array&lt;String&gt;
2308
2290
  # * {Types::DescribeLocationAzureBlobResponse#creation_time #creation_time} => Time
2291
+ # * {Types::DescribeLocationAzureBlobResponse#managed_secret_config #managed_secret_config} => Types::ManagedSecretConfig
2292
+ # * {Types::DescribeLocationAzureBlobResponse#cmk_secret_config #cmk_secret_config} => Types::CmkSecretConfig
2293
+ # * {Types::DescribeLocationAzureBlobResponse#custom_secret_config #custom_secret_config} => Types::CustomSecretConfig
2309
2294
  #
2310
2295
  # @example Request syntax with placeholder values
2311
2296
  #
@@ -2317,12 +2302,17 @@ module Aws::DataSync
2317
2302
  #
2318
2303
  # resp.location_arn #=> String
2319
2304
  # resp.location_uri #=> String
2320
- # resp.authentication_type #=> String, one of "SAS"
2305
+ # resp.authentication_type #=> String, one of "SAS", "NONE"
2321
2306
  # resp.blob_type #=> String, one of "BLOCK"
2322
2307
  # resp.access_tier #=> String, one of "HOT", "COOL", "ARCHIVE"
2323
2308
  # resp.agent_arns #=> Array
2324
2309
  # resp.agent_arns[0] #=> String
2325
2310
  # resp.creation_time #=> Time
2311
+ # resp.managed_secret_config.secret_arn #=> String
2312
+ # resp.cmk_secret_config.secret_arn #=> String
2313
+ # resp.cmk_secret_config.kms_key_arn #=> String
2314
+ # resp.custom_secret_config.secret_arn #=> String
2315
+ # resp.custom_secret_config.secret_access_role_arn #=> String
2326
2316
  #
2327
2317
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationAzureBlob AWS API Documentation
2328
2318
  #
@@ -2666,6 +2656,9 @@ module Aws::DataSync
2666
2656
  # * {Types::DescribeLocationObjectStorageResponse#agent_arns #agent_arns} => Array&lt;String&gt;
2667
2657
  # * {Types::DescribeLocationObjectStorageResponse#creation_time #creation_time} => Time
2668
2658
  # * {Types::DescribeLocationObjectStorageResponse#server_certificate #server_certificate} => String
2659
+ # * {Types::DescribeLocationObjectStorageResponse#managed_secret_config #managed_secret_config} => Types::ManagedSecretConfig
2660
+ # * {Types::DescribeLocationObjectStorageResponse#cmk_secret_config #cmk_secret_config} => Types::CmkSecretConfig
2661
+ # * {Types::DescribeLocationObjectStorageResponse#custom_secret_config #custom_secret_config} => Types::CustomSecretConfig
2669
2662
  #
2670
2663
  # @example Request syntax with placeholder values
2671
2664
  #
@@ -2684,6 +2677,11 @@ module Aws::DataSync
2684
2677
  # resp.agent_arns[0] #=> String
2685
2678
  # resp.creation_time #=> Time
2686
2679
  # resp.server_certificate #=> String
2680
+ # resp.managed_secret_config.secret_arn #=> String
2681
+ # resp.cmk_secret_config.secret_arn #=> String
2682
+ # resp.cmk_secret_config.kms_key_arn #=> String
2683
+ # resp.custom_secret_config.secret_arn #=> String
2684
+ # resp.custom_secret_config.secret_access_role_arn #=> String
2687
2685
  #
2688
2686
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeLocationObjectStorage AWS API Documentation
2689
2687
  #
@@ -2784,289 +2782,6 @@ module Aws::DataSync
2784
2782
  req.send_request(options)
2785
2783
  end
2786
2784
 
2787
- # Returns information about an on-premises storage system that you're
2788
- # using with DataSync Discovery.
2789
- #
2790
- # @option params [required, String] :storage_system_arn
2791
- # Specifies the Amazon Resource Name (ARN) of an on-premises storage
2792
- # system that you're using with DataSync Discovery.
2793
- #
2794
- # @return [Types::DescribeStorageSystemResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2795
- #
2796
- # * {Types::DescribeStorageSystemResponse#storage_system_arn #storage_system_arn} => String
2797
- # * {Types::DescribeStorageSystemResponse#server_configuration #server_configuration} => Types::DiscoveryServerConfiguration
2798
- # * {Types::DescribeStorageSystemResponse#system_type #system_type} => String
2799
- # * {Types::DescribeStorageSystemResponse#agent_arns #agent_arns} => Array&lt;String&gt;
2800
- # * {Types::DescribeStorageSystemResponse#name #name} => String
2801
- # * {Types::DescribeStorageSystemResponse#error_message #error_message} => String
2802
- # * {Types::DescribeStorageSystemResponse#connectivity_status #connectivity_status} => String
2803
- # * {Types::DescribeStorageSystemResponse#cloud_watch_log_group_arn #cloud_watch_log_group_arn} => String
2804
- # * {Types::DescribeStorageSystemResponse#creation_time #creation_time} => Time
2805
- # * {Types::DescribeStorageSystemResponse#secrets_manager_arn #secrets_manager_arn} => String
2806
- #
2807
- # @example Request syntax with placeholder values
2808
- #
2809
- # resp = client.describe_storage_system({
2810
- # storage_system_arn: "StorageSystemArn", # required
2811
- # })
2812
- #
2813
- # @example Response structure
2814
- #
2815
- # resp.storage_system_arn #=> String
2816
- # resp.server_configuration.server_hostname #=> String
2817
- # resp.server_configuration.server_port #=> Integer
2818
- # resp.system_type #=> String, one of "NetAppONTAP"
2819
- # resp.agent_arns #=> Array
2820
- # resp.agent_arns[0] #=> String
2821
- # resp.name #=> String
2822
- # resp.error_message #=> String
2823
- # resp.connectivity_status #=> String, one of "PASS", "FAIL", "UNKNOWN"
2824
- # resp.cloud_watch_log_group_arn #=> String
2825
- # resp.creation_time #=> Time
2826
- # resp.secrets_manager_arn #=> String
2827
- #
2828
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystem AWS API Documentation
2829
- #
2830
- # @overload describe_storage_system(params = {})
2831
- # @param [Hash] params ({})
2832
- def describe_storage_system(params = {}, options = {})
2833
- req = build_request(:describe_storage_system, params)
2834
- req.send_request(options)
2835
- end
2836
-
2837
- # Returns information, including performance data and capacity usage,
2838
- # which DataSync Discovery collects about a specific resource in
2839
- # your-premises storage system.
2840
- #
2841
- # @option params [required, String] :discovery_job_arn
2842
- # Specifies the Amazon Resource Name (ARN) of the discovery job that
2843
- # collects information about your on-premises storage system.
2844
- #
2845
- # @option params [required, String] :resource_type
2846
- # Specifies the kind of storage system resource that you want
2847
- # information about.
2848
- #
2849
- # @option params [required, String] :resource_id
2850
- # Specifies the universally unique identifier (UUID) of the storage
2851
- # system resource that you want information about.
2852
- #
2853
- # @option params [Time,DateTime,Date,Integer,String] :start_time
2854
- # Specifies a time within the total duration that the discovery job ran.
2855
- # To see information gathered during a certain time frame, use this
2856
- # parameter with `EndTime`.
2857
- #
2858
- # @option params [Time,DateTime,Date,Integer,String] :end_time
2859
- # Specifies a time within the total duration that the discovery job ran.
2860
- # To see information gathered during a certain time frame, use this
2861
- # parameter with `StartTime`.
2862
- #
2863
- # @option params [Integer] :max_results
2864
- # Specifies how many results that you want in the response.
2865
- #
2866
- # @option params [String] :next_token
2867
- # Specifies an opaque string that indicates the position to begin the
2868
- # next list of results in the response.
2869
- #
2870
- # @return [Types::DescribeStorageSystemResourceMetricsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2871
- #
2872
- # * {Types::DescribeStorageSystemResourceMetricsResponse#metrics #metrics} => Array&lt;Types::ResourceMetrics&gt;
2873
- # * {Types::DescribeStorageSystemResourceMetricsResponse#next_token #next_token} => String
2874
- #
2875
- # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2876
- #
2877
- # @example Request syntax with placeholder values
2878
- #
2879
- # resp = client.describe_storage_system_resource_metrics({
2880
- # discovery_job_arn: "DiscoveryJobArn", # required
2881
- # resource_type: "SVM", # required, accepts SVM, VOLUME, CLUSTER
2882
- # resource_id: "ResourceId", # required
2883
- # start_time: Time.now,
2884
- # end_time: Time.now,
2885
- # max_results: 1,
2886
- # next_token: "DiscoveryNextToken",
2887
- # })
2888
- #
2889
- # @example Response structure
2890
- #
2891
- # resp.metrics #=> Array
2892
- # resp.metrics[0].timestamp #=> Time
2893
- # resp.metrics[0].p95_metrics.iops.read #=> Float
2894
- # resp.metrics[0].p95_metrics.iops.write #=> Float
2895
- # resp.metrics[0].p95_metrics.iops.other #=> Float
2896
- # resp.metrics[0].p95_metrics.iops.total #=> Float
2897
- # resp.metrics[0].p95_metrics.throughput.read #=> Float
2898
- # resp.metrics[0].p95_metrics.throughput.write #=> Float
2899
- # resp.metrics[0].p95_metrics.throughput.other #=> Float
2900
- # resp.metrics[0].p95_metrics.throughput.total #=> Float
2901
- # resp.metrics[0].p95_metrics.latency.read #=> Float
2902
- # resp.metrics[0].p95_metrics.latency.write #=> Float
2903
- # resp.metrics[0].p95_metrics.latency.other #=> Float
2904
- # resp.metrics[0].capacity.used #=> Integer
2905
- # resp.metrics[0].capacity.provisioned #=> Integer
2906
- # resp.metrics[0].capacity.logical_used #=> Integer
2907
- # resp.metrics[0].capacity.cluster_cloud_storage_used #=> Integer
2908
- # resp.metrics[0].resource_id #=> String
2909
- # resp.metrics[0].resource_type #=> String, one of "SVM", "VOLUME", "CLUSTER"
2910
- # resp.next_token #=> String
2911
- #
2912
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemResourceMetrics AWS API Documentation
2913
- #
2914
- # @overload describe_storage_system_resource_metrics(params = {})
2915
- # @param [Hash] params ({})
2916
- def describe_storage_system_resource_metrics(params = {}, options = {})
2917
- req = build_request(:describe_storage_system_resource_metrics, params)
2918
- req.send_request(options)
2919
- end
2920
-
2921
- # Returns information that DataSync Discovery collects about resources
2922
- # in your on-premises storage system.
2923
- #
2924
- # @option params [required, String] :discovery_job_arn
2925
- # Specifies the Amazon Resource Name (ARN) of the discovery job that's
2926
- # collecting data from your on-premises storage system.
2927
- #
2928
- # @option params [required, String] :resource_type
2929
- # Specifies what kind of storage system resources that you want
2930
- # information about.
2931
- #
2932
- # @option params [Array<String>] :resource_ids
2933
- # Specifies the universally unique identifiers (UUIDs) of the storage
2934
- # system resources that you want information about. You can't use this
2935
- # parameter in combination with the `Filter` parameter.
2936
- #
2937
- # @option params [Hash<String,Array>] :filter
2938
- # Filters the storage system resources that you want returned. For
2939
- # example, this might be volumes associated with a specific storage
2940
- # virtual machine (SVM).
2941
- #
2942
- # @option params [Integer] :max_results
2943
- # Specifies the maximum number of storage system resources that you want
2944
- # to list in a response.
2945
- #
2946
- # @option params [String] :next_token
2947
- # Specifies an opaque string that indicates the position to begin the
2948
- # next list of results in the response.
2949
- #
2950
- # @return [Types::DescribeStorageSystemResourcesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2951
- #
2952
- # * {Types::DescribeStorageSystemResourcesResponse#resource_details #resource_details} => Types::ResourceDetails
2953
- # * {Types::DescribeStorageSystemResourcesResponse#next_token #next_token} => String
2954
- #
2955
- # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2956
- #
2957
- # @example Request syntax with placeholder values
2958
- #
2959
- # resp = client.describe_storage_system_resources({
2960
- # discovery_job_arn: "DiscoveryJobArn", # required
2961
- # resource_type: "SVM", # required, accepts SVM, VOLUME, CLUSTER
2962
- # resource_ids: ["ResourceId"],
2963
- # filter: {
2964
- # "SVM" => ["PtolemyString"],
2965
- # },
2966
- # max_results: 1,
2967
- # next_token: "DiscoveryNextToken",
2968
- # })
2969
- #
2970
- # @example Response structure
2971
- #
2972
- # resp.resource_details.net_app_ontapsv_ms #=> Array
2973
- # resp.resource_details.net_app_ontapsv_ms[0].cluster_uuid #=> String
2974
- # resp.resource_details.net_app_ontapsv_ms[0].resource_id #=> String
2975
- # resp.resource_details.net_app_ontapsv_ms[0].svm_name #=> String
2976
- # resp.resource_details.net_app_ontapsv_ms[0].cifs_share_count #=> Integer
2977
- # resp.resource_details.net_app_ontapsv_ms[0].enabled_protocols #=> Array
2978
- # resp.resource_details.net_app_ontapsv_ms[0].enabled_protocols[0] #=> String
2979
- # resp.resource_details.net_app_ontapsv_ms[0].total_capacity_used #=> Integer
2980
- # resp.resource_details.net_app_ontapsv_ms[0].total_capacity_provisioned #=> Integer
2981
- # resp.resource_details.net_app_ontapsv_ms[0].total_logical_capacity_used #=> Integer
2982
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.iops_read #=> Float
2983
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.iops_write #=> Float
2984
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.iops_other #=> Float
2985
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.iops_total #=> Float
2986
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.throughput_read #=> Float
2987
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.throughput_write #=> Float
2988
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.throughput_other #=> Float
2989
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.throughput_total #=> Float
2990
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.latency_read #=> Float
2991
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.latency_write #=> Float
2992
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.latency_other #=> Float
2993
- # resp.resource_details.net_app_ontapsv_ms[0].recommendations #=> Array
2994
- # resp.resource_details.net_app_ontapsv_ms[0].recommendations[0].storage_type #=> String
2995
- # resp.resource_details.net_app_ontapsv_ms[0].recommendations[0].storage_configuration #=> Hash
2996
- # resp.resource_details.net_app_ontapsv_ms[0].recommendations[0].storage_configuration["PtolemyString"] #=> String
2997
- # resp.resource_details.net_app_ontapsv_ms[0].recommendations[0].estimated_monthly_storage_cost #=> String
2998
- # resp.resource_details.net_app_ontapsv_ms[0].nfs_exported_volumes #=> Integer
2999
- # resp.resource_details.net_app_ontapsv_ms[0].recommendation_status #=> String, one of "NONE", "IN_PROGRESS", "COMPLETED", "FAILED"
3000
- # resp.resource_details.net_app_ontapsv_ms[0].total_snapshot_capacity_used #=> Integer
3001
- # resp.resource_details.net_app_ontapsv_ms[0].lun_count #=> Integer
3002
- # resp.resource_details.net_app_ontap_volumes #=> Array
3003
- # resp.resource_details.net_app_ontap_volumes[0].volume_name #=> String
3004
- # resp.resource_details.net_app_ontap_volumes[0].resource_id #=> String
3005
- # resp.resource_details.net_app_ontap_volumes[0].cifs_share_count #=> Integer
3006
- # resp.resource_details.net_app_ontap_volumes[0].security_style #=> String
3007
- # resp.resource_details.net_app_ontap_volumes[0].svm_uuid #=> String
3008
- # resp.resource_details.net_app_ontap_volumes[0].svm_name #=> String
3009
- # resp.resource_details.net_app_ontap_volumes[0].capacity_used #=> Integer
3010
- # resp.resource_details.net_app_ontap_volumes[0].capacity_provisioned #=> Integer
3011
- # resp.resource_details.net_app_ontap_volumes[0].logical_capacity_used #=> Integer
3012
- # resp.resource_details.net_app_ontap_volumes[0].nfs_exported #=> Boolean
3013
- # resp.resource_details.net_app_ontap_volumes[0].snapshot_capacity_used #=> Integer
3014
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.iops_read #=> Float
3015
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.iops_write #=> Float
3016
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.iops_other #=> Float
3017
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.iops_total #=> Float
3018
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.throughput_read #=> Float
3019
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.throughput_write #=> Float
3020
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.throughput_other #=> Float
3021
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.throughput_total #=> Float
3022
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.latency_read #=> Float
3023
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.latency_write #=> Float
3024
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.latency_other #=> Float
3025
- # resp.resource_details.net_app_ontap_volumes[0].recommendations #=> Array
3026
- # resp.resource_details.net_app_ontap_volumes[0].recommendations[0].storage_type #=> String
3027
- # resp.resource_details.net_app_ontap_volumes[0].recommendations[0].storage_configuration #=> Hash
3028
- # resp.resource_details.net_app_ontap_volumes[0].recommendations[0].storage_configuration["PtolemyString"] #=> String
3029
- # resp.resource_details.net_app_ontap_volumes[0].recommendations[0].estimated_monthly_storage_cost #=> String
3030
- # resp.resource_details.net_app_ontap_volumes[0].recommendation_status #=> String, one of "NONE", "IN_PROGRESS", "COMPLETED", "FAILED"
3031
- # resp.resource_details.net_app_ontap_volumes[0].lun_count #=> Integer
3032
- # resp.resource_details.net_app_ontap_clusters #=> Array
3033
- # resp.resource_details.net_app_ontap_clusters[0].cifs_share_count #=> Integer
3034
- # resp.resource_details.net_app_ontap_clusters[0].nfs_exported_volumes #=> Integer
3035
- # resp.resource_details.net_app_ontap_clusters[0].resource_id #=> String
3036
- # resp.resource_details.net_app_ontap_clusters[0].cluster_name #=> String
3037
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.iops_read #=> Float
3038
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.iops_write #=> Float
3039
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.iops_other #=> Float
3040
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.iops_total #=> Float
3041
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.throughput_read #=> Float
3042
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.throughput_write #=> Float
3043
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.throughput_other #=> Float
3044
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.throughput_total #=> Float
3045
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.latency_read #=> Float
3046
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.latency_write #=> Float
3047
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.latency_other #=> Float
3048
- # resp.resource_details.net_app_ontap_clusters[0].cluster_block_storage_size #=> Integer
3049
- # resp.resource_details.net_app_ontap_clusters[0].cluster_block_storage_used #=> Integer
3050
- # resp.resource_details.net_app_ontap_clusters[0].cluster_block_storage_logical_used #=> Integer
3051
- # resp.resource_details.net_app_ontap_clusters[0].recommendations #=> Array
3052
- # resp.resource_details.net_app_ontap_clusters[0].recommendations[0].storage_type #=> String
3053
- # resp.resource_details.net_app_ontap_clusters[0].recommendations[0].storage_configuration #=> Hash
3054
- # resp.resource_details.net_app_ontap_clusters[0].recommendations[0].storage_configuration["PtolemyString"] #=> String
3055
- # resp.resource_details.net_app_ontap_clusters[0].recommendations[0].estimated_monthly_storage_cost #=> String
3056
- # resp.resource_details.net_app_ontap_clusters[0].recommendation_status #=> String, one of "NONE", "IN_PROGRESS", "COMPLETED", "FAILED"
3057
- # resp.resource_details.net_app_ontap_clusters[0].lun_count #=> Integer
3058
- # resp.resource_details.net_app_ontap_clusters[0].cluster_cloud_storage_used #=> Integer
3059
- # resp.next_token #=> String
3060
- #
3061
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemResources AWS API Documentation
3062
- #
3063
- # @overload describe_storage_system_resources(params = {})
3064
- # @param [Hash] params ({})
3065
- def describe_storage_system_resources(params = {}, options = {})
3066
- req = build_request(:describe_storage_system_resources, params)
3067
- req.send_request(options)
3068
- end
3069
-
3070
2785
  # Provides information about a *task*, which defines where and how
3071
2786
  # DataSync transfers your data.
3072
2787
  #
@@ -3218,6 +2933,8 @@ module Aws::DataSync
3218
2933
  # * {Types::DescribeTaskExecutionResponse#files_prepared #files_prepared} => Integer
3219
2934
  # * {Types::DescribeTaskExecutionResponse#files_listed #files_listed} => Types::TaskExecutionFilesListedDetail
3220
2935
  # * {Types::DescribeTaskExecutionResponse#files_failed #files_failed} => Types::TaskExecutionFilesFailedDetail
2936
+ # * {Types::DescribeTaskExecutionResponse#launch_time #launch_time} => Time
2937
+ # * {Types::DescribeTaskExecutionResponse#end_time #end_time} => Time
3221
2938
  #
3222
2939
  # @example Request syntax with placeholder values
3223
2940
  #
@@ -3297,6 +3014,8 @@ module Aws::DataSync
3297
3014
  # resp.files_failed.transfer #=> Integer
3298
3015
  # resp.files_failed.verify #=> Integer
3299
3016
  # resp.files_failed.delete #=> Integer
3017
+ # resp.launch_time #=> Time
3018
+ # resp.end_time #=> Time
3300
3019
  #
3301
3020
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeTaskExecution AWS API Documentation
3302
3021
  #
@@ -3307,51 +3026,6 @@ module Aws::DataSync
3307
3026
  req.send_request(options)
3308
3027
  end
3309
3028
 
3310
- # Creates recommendations about where to migrate your data to in Amazon
3311
- # Web Services. Recommendations are generated based on information that
3312
- # DataSync Discovery collects about your on-premises storage system's
3313
- # resources. For more information, see [Recommendations provided by
3314
- # DataSync Discovery][1].
3315
- #
3316
- # Once generated, you can view your recommendations by using the
3317
- # [DescribeStorageSystemResources][2] operation.
3318
- #
3319
- #
3320
- #
3321
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-understand-recommendations.html
3322
- # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeStorageSystemResources.html
3323
- #
3324
- # @option params [required, String] :discovery_job_arn
3325
- # Specifies the Amazon Resource Name (ARN) of the discovery job that
3326
- # collects information about your on-premises storage system.
3327
- #
3328
- # @option params [required, Array<String>] :resource_ids
3329
- # Specifies the universally unique identifiers (UUIDs) of the resources
3330
- # in your storage system that you want recommendations on.
3331
- #
3332
- # @option params [required, String] :resource_type
3333
- # Specifies the type of resource in your storage system that you want
3334
- # recommendations on.
3335
- #
3336
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3337
- #
3338
- # @example Request syntax with placeholder values
3339
- #
3340
- # resp = client.generate_recommendations({
3341
- # discovery_job_arn: "DiscoveryJobArn", # required
3342
- # resource_ids: ["ResourceId"], # required
3343
- # resource_type: "SVM", # required, accepts SVM, VOLUME, CLUSTER
3344
- # })
3345
- #
3346
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/GenerateRecommendations AWS API Documentation
3347
- #
3348
- # @overload generate_recommendations(params = {})
3349
- # @param [Hash] params ({})
3350
- def generate_recommendations(params = {}, options = {})
3351
- req = build_request(:generate_recommendations, params)
3352
- req.send_request(options)
3353
- end
3354
-
3355
3029
  # Returns a list of DataSync agents that belong to an Amazon Web
3356
3030
  # Services account in the Amazon Web Services Region specified in the
3357
3031
  # request.
@@ -3414,53 +3088,6 @@ module Aws::DataSync
3414
3088
  req.send_request(options)
3415
3089
  end
3416
3090
 
3417
- # Provides a list of the existing discovery jobs in the Amazon Web
3418
- # Services Region and Amazon Web Services account where you're using
3419
- # DataSync Discovery.
3420
- #
3421
- # @option params [String] :storage_system_arn
3422
- # Specifies the Amazon Resource Name (ARN) of an on-premises storage
3423
- # system. Use this parameter if you only want to list the discovery jobs
3424
- # that are associated with a specific storage system.
3425
- #
3426
- # @option params [Integer] :max_results
3427
- # Specifies how many results you want in the response.
3428
- #
3429
- # @option params [String] :next_token
3430
- # Specifies an opaque string that indicates the position to begin the
3431
- # next list of results in the response.
3432
- #
3433
- # @return [Types::ListDiscoveryJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3434
- #
3435
- # * {Types::ListDiscoveryJobsResponse#discovery_jobs #discovery_jobs} => Array&lt;Types::DiscoveryJobListEntry&gt;
3436
- # * {Types::ListDiscoveryJobsResponse#next_token #next_token} => String
3437
- #
3438
- # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3439
- #
3440
- # @example Request syntax with placeholder values
3441
- #
3442
- # resp = client.list_discovery_jobs({
3443
- # storage_system_arn: "StorageSystemArn",
3444
- # max_results: 1,
3445
- # next_token: "DiscoveryNextToken",
3446
- # })
3447
- #
3448
- # @example Response structure
3449
- #
3450
- # resp.discovery_jobs #=> Array
3451
- # resp.discovery_jobs[0].discovery_job_arn #=> String
3452
- # resp.discovery_jobs[0].status #=> String, one of "RUNNING", "WARNING", "TERMINATED", "FAILED", "STOPPED", "COMPLETED", "COMPLETED_WITH_ISSUES"
3453
- # resp.next_token #=> String
3454
- #
3455
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListDiscoveryJobs AWS API Documentation
3456
- #
3457
- # @overload list_discovery_jobs(params = {})
3458
- # @param [Hash] params ({})
3459
- def list_discovery_jobs(params = {}, options = {})
3460
- req = build_request(:list_discovery_jobs, params)
3461
- req.send_request(options)
3462
- end
3463
-
3464
3091
  # Returns a list of source and destination locations.
3465
3092
  #
3466
3093
  # If you have more locations than are returned in a response (that is,
@@ -3518,46 +3145,6 @@ module Aws::DataSync
3518
3145
  req.send_request(options)
3519
3146
  end
3520
3147
 
3521
- # Lists the on-premises storage systems that you're using with DataSync
3522
- # Discovery.
3523
- #
3524
- # @option params [Integer] :max_results
3525
- # Specifies how many results you want in the response.
3526
- #
3527
- # @option params [String] :next_token
3528
- # Specifies an opaque string that indicates the position to begin the
3529
- # next list of results in the response.
3530
- #
3531
- # @return [Types::ListStorageSystemsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3532
- #
3533
- # * {Types::ListStorageSystemsResponse#storage_systems #storage_systems} => Array&lt;Types::StorageSystemListEntry&gt;
3534
- # * {Types::ListStorageSystemsResponse#next_token #next_token} => String
3535
- #
3536
- # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3537
- #
3538
- # @example Request syntax with placeholder values
3539
- #
3540
- # resp = client.list_storage_systems({
3541
- # max_results: 1,
3542
- # next_token: "DiscoveryNextToken",
3543
- # })
3544
- #
3545
- # @example Response structure
3546
- #
3547
- # resp.storage_systems #=> Array
3548
- # resp.storage_systems[0].storage_system_arn #=> String
3549
- # resp.storage_systems[0].name #=> String
3550
- # resp.next_token #=> String
3551
- #
3552
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListStorageSystems AWS API Documentation
3553
- #
3554
- # @overload list_storage_systems(params = {})
3555
- # @param [Hash] params ({})
3556
- def list_storage_systems(params = {}, options = {})
3557
- req = build_request(:list_storage_systems, params)
3558
- req.send_request(options)
3559
- end
3560
-
3561
3148
  # Returns all the tags associated with an Amazon Web Services resource.
3562
3149
  #
3563
3150
  # @option params [required, String] :resource_arn
@@ -3701,96 +3288,6 @@ module Aws::DataSync
3701
3288
  req.send_request(options)
3702
3289
  end
3703
3290
 
3704
- # Permanently removes a storage system resource from DataSync Discovery,
3705
- # including the associated discovery jobs, collected data, and
3706
- # recommendations.
3707
- #
3708
- # @option params [required, String] :storage_system_arn
3709
- # Specifies the Amazon Resource Name (ARN) of the storage system that
3710
- # you want to permanently remove from DataSync Discovery.
3711
- #
3712
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3713
- #
3714
- # @example Request syntax with placeholder values
3715
- #
3716
- # resp = client.remove_storage_system({
3717
- # storage_system_arn: "StorageSystemArn", # required
3718
- # })
3719
- #
3720
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/RemoveStorageSystem AWS API Documentation
3721
- #
3722
- # @overload remove_storage_system(params = {})
3723
- # @param [Hash] params ({})
3724
- def remove_storage_system(params = {}, options = {})
3725
- req = build_request(:remove_storage_system, params)
3726
- req.send_request(options)
3727
- end
3728
-
3729
- # Runs a DataSync discovery job on your on-premises storage system. If
3730
- # you haven't added the storage system to DataSync Discovery yet, do
3731
- # this first by using the [AddStorageSystem][1] operation.
3732
- #
3733
- #
3734
- #
3735
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_AddStorageSystem.html
3736
- #
3737
- # @option params [required, String] :storage_system_arn
3738
- # Specifies the Amazon Resource Name (ARN) of the on-premises storage
3739
- # system that you want to run the discovery job on.
3740
- #
3741
- # @option params [required, Integer] :collection_duration_minutes
3742
- # Specifies in minutes how long you want the discovery job to run.
3743
- #
3744
- # <note markdown="1"> For more accurate recommendations, we recommend a duration of at least
3745
- # 14 days. Longer durations allow time to collect a sufficient number of
3746
- # data points and provide a realistic representation of storage
3747
- # performance and utilization.
3748
- #
3749
- # </note>
3750
- #
3751
- # @option params [required, String] :client_token
3752
- # Specifies a client token to make sure requests with this API operation
3753
- # are idempotent. If you don't specify a client token, DataSync
3754
- # generates one for you automatically.
3755
- #
3756
- # **A suitable default value is auto-generated.** You should normally
3757
- # not need to pass this option.**
3758
- #
3759
- # @option params [Array<Types::TagListEntry>] :tags
3760
- # Specifies labels that help you categorize, filter, and search for your
3761
- # Amazon Web Services resources.
3762
- #
3763
- # @return [Types::StartDiscoveryJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3764
- #
3765
- # * {Types::StartDiscoveryJobResponse#discovery_job_arn #discovery_job_arn} => String
3766
- #
3767
- # @example Request syntax with placeholder values
3768
- #
3769
- # resp = client.start_discovery_job({
3770
- # storage_system_arn: "StorageSystemArn", # required
3771
- # collection_duration_minutes: 1, # required
3772
- # client_token: "PtolemyUUID", # required
3773
- # tags: [
3774
- # {
3775
- # key: "TagKey", # required
3776
- # value: "TagValue",
3777
- # },
3778
- # ],
3779
- # })
3780
- #
3781
- # @example Response structure
3782
- #
3783
- # resp.discovery_job_arn #=> String
3784
- #
3785
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StartDiscoveryJob AWS API Documentation
3786
- #
3787
- # @overload start_discovery_job(params = {})
3788
- # @param [Hash] params ({})
3789
- def start_discovery_job(params = {}, options = {})
3790
- req = build_request(:start_discovery_job, params)
3791
- req.send_request(options)
3792
- end
3793
-
3794
3291
  # Starts an DataSync transfer task. For each task, you can only run one
3795
3292
  # task execution at a time.
3796
3293
  #
@@ -3980,39 +3477,6 @@ module Aws::DataSync
3980
3477
  req.send_request(options)
3981
3478
  end
3982
3479
 
3983
- # Stops a running DataSync discovery job.
3984
- #
3985
- # You can stop a discovery job anytime. A job that's stopped before
3986
- # it's scheduled to end likely will provide you some information about
3987
- # your on-premises storage system resources. To get recommendations for
3988
- # a stopped job, you must use the [GenerateRecommendations][1]
3989
- # operation.
3990
- #
3991
- #
3992
- #
3993
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_GenerateRecommendations.html
3994
- #
3995
- # @option params [required, String] :discovery_job_arn
3996
- # Specifies the Amazon Resource Name (ARN) of the discovery job that you
3997
- # want to stop.
3998
- #
3999
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4000
- #
4001
- # @example Request syntax with placeholder values
4002
- #
4003
- # resp = client.stop_discovery_job({
4004
- # discovery_job_arn: "DiscoveryJobArn", # required
4005
- # })
4006
- #
4007
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StopDiscoveryJob AWS API Documentation
4008
- #
4009
- # @overload stop_discovery_job(params = {})
4010
- # @param [Hash] params ({})
4011
- def stop_discovery_job(params = {}, options = {})
4012
- req = build_request(:stop_discovery_job, params)
4013
- req.send_request(options)
4014
- end
4015
-
4016
3480
  # Applies a *tag* to an Amazon Web Services resource. Tags are key-value
4017
3481
  # pairs that can help you manage, filter, and search for your resources.
4018
3482
  #
@@ -4102,35 +3566,6 @@ module Aws::DataSync
4102
3566
  req.send_request(options)
4103
3567
  end
4104
3568
 
4105
- # Edits a DataSync discovery job configuration.
4106
- #
4107
- # @option params [required, String] :discovery_job_arn
4108
- # Specifies the Amazon Resource Name (ARN) of the discovery job that you
4109
- # want to update.
4110
- #
4111
- # @option params [required, Integer] :collection_duration_minutes
4112
- # Specifies in minutes how long that you want the discovery job to run.
4113
- # (You can't set this parameter to less than the number of minutes that
4114
- # the job has already run for.)
4115
- #
4116
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4117
- #
4118
- # @example Request syntax with placeholder values
4119
- #
4120
- # resp = client.update_discovery_job({
4121
- # discovery_job_arn: "DiscoveryJobArn", # required
4122
- # collection_duration_minutes: 1, # required
4123
- # })
4124
- #
4125
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateDiscoveryJob AWS API Documentation
4126
- #
4127
- # @overload update_discovery_job(params = {})
4128
- # @param [Hash] params ({})
4129
- def update_discovery_job(params = {}, options = {})
4130
- req = build_request(:update_discovery_job, params)
4131
- req.send_request(options)
4132
- end
4133
-
4134
3569
  # Modifies the following configurations of the Microsoft Azure Blob
4135
3570
  # Storage transfer location that you're using with DataSync.
4136
3571
  #
@@ -4179,16 +3614,35 @@ module Aws::DataSync
4179
3614
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers
4180
3615
  #
4181
3616
  # @option params [Array<String>] :agent_arns
4182
- # Specifies the Amazon Resource Name (ARN) of the DataSync agent that
4183
- # can connect with your Azure Blob Storage container.
3617
+ # (Optional) Specifies the Amazon Resource Name (ARN) of the DataSync
3618
+ # agent that can connect with your Azure Blob Storage container. If you
3619
+ # are setting up an agentless cross-cloud transfer, you do not need to
3620
+ # specify a value for this parameter.
4184
3621
  #
4185
3622
  # You can specify more than one agent. For more information, see [Using
4186
3623
  # multiple agents for your transfer][1].
4187
3624
  #
3625
+ # <note markdown="1"> You cannot add or remove agents from a storage location after you
3626
+ # initially create it.
3627
+ #
3628
+ # </note>
3629
+ #
4188
3630
  #
4189
3631
  #
4190
3632
  # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html
4191
3633
  #
3634
+ # @option params [Types::CmkSecretConfig] :cmk_secret_config
3635
+ # Specifies configuration information for a DataSync-managed secret,
3636
+ # such as an authentication token or set of credentials that DataSync
3637
+ # uses to access a specific transfer location, and a customer-managed
3638
+ # KMS key.
3639
+ #
3640
+ # @option params [Types::CustomSecretConfig] :custom_secret_config
3641
+ # Specifies configuration information for a customer-managed secret,
3642
+ # such as an authentication token or set of credentials that DataSync
3643
+ # uses to access a specific transfer location, and a customer-managed
3644
+ # KMS key.
3645
+ #
4192
3646
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4193
3647
  #
4194
3648
  # @example Request syntax with placeholder values
@@ -4196,13 +3650,21 @@ module Aws::DataSync
4196
3650
  # resp = client.update_location_azure_blob({
4197
3651
  # location_arn: "LocationArn", # required
4198
3652
  # subdirectory: "AzureBlobSubdirectory",
4199
- # authentication_type: "SAS", # accepts SAS
3653
+ # authentication_type: "SAS", # accepts SAS, NONE
4200
3654
  # sas_configuration: {
4201
3655
  # token: "AzureBlobSasToken", # required
4202
3656
  # },
4203
3657
  # blob_type: "BLOCK", # accepts BLOCK
4204
3658
  # access_tier: "HOT", # accepts HOT, COOL, ARCHIVE
4205
3659
  # agent_arns: ["AgentArn"],
3660
+ # cmk_secret_config: {
3661
+ # secret_arn: "SecretArn",
3662
+ # kms_key_arn: "KmsKeyArn",
3663
+ # },
3664
+ # custom_secret_config: {
3665
+ # secret_arn: "SecretArn",
3666
+ # secret_access_role_arn: "IamRoleArnOrEmptyString",
3667
+ # },
4206
3668
  # })
4207
3669
  #
4208
3670
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationAzureBlob AWS API Documentation
@@ -4586,9 +4048,7 @@ module Aws::DataSync
4586
4048
  # @option params [String, StringIO, File] :kerberos_keytab
4587
4049
  # The Kerberos key table (keytab) that contains mappings between the
4588
4050
  # defined Kerberos principal and the encrypted keys. You can load the
4589
- # keytab from a file by providing the file's address. If you use the
4590
- # CLI, it performs base64 encoding for you. Otherwise, provide the
4591
- # base64-encoded text.
4051
+ # keytab from a file by providing the file's address.
4592
4052
  #
4593
4053
  # @option params [String, StringIO, File] :kerberos_krb_5_conf
4594
4054
  # The `krb5.conf` file that contains the Kerberos configuration
@@ -4740,8 +4200,15 @@ module Aws::DataSync
4740
4200
  # required to authenticate with the object storage server.
4741
4201
  #
4742
4202
  # @option params [Array<String>] :agent_arns
4743
- # Specifies the Amazon Resource Names (ARNs) of the DataSync agents that
4744
- # can connect with your object storage system.
4203
+ # (Optional) Specifies the Amazon Resource Names (ARNs) of the DataSync
4204
+ # agents that can connect with your object storage system. If you are
4205
+ # setting up an agentless cross-cloud transfer, you do not need to
4206
+ # specify a value for this parameter.
4207
+ #
4208
+ # <note markdown="1"> You cannot add or remove agents from a storage location after you
4209
+ # initially create it.
4210
+ #
4211
+ # </note>
4745
4212
  #
4746
4213
  # @option params [String, StringIO, File] :server_certificate
4747
4214
  # Specifies a certificate chain for DataSync to authenticate with your
@@ -4771,6 +4238,18 @@ module Aws::DataSync
4771
4238
  # Updating this parameter doesn't interfere with tasks that you have in
4772
4239
  # progress.
4773
4240
  #
4241
+ # @option params [Types::CmkSecretConfig] :cmk_secret_config
4242
+ # Specifies configuration information for a DataSync-managed secret,
4243
+ # such as an authentication token or set of credentials that DataSync
4244
+ # uses to access a specific transfer location, and a customer-managed
4245
+ # KMS key.
4246
+ #
4247
+ # @option params [Types::CustomSecretConfig] :custom_secret_config
4248
+ # Specifies configuration information for a customer-managed secret,
4249
+ # such as an authentication token or set of credentials that DataSync
4250
+ # uses to access a specific transfer location, and a customer-managed
4251
+ # KMS key.
4252
+ #
4774
4253
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4775
4254
  #
4776
4255
  # @example Request syntax with placeholder values
@@ -4785,6 +4264,14 @@ module Aws::DataSync
4785
4264
  # secret_key: "ObjectStorageSecretKey",
4786
4265
  # agent_arns: ["AgentArn"],
4787
4266
  # server_certificate: "data",
4267
+ # cmk_secret_config: {
4268
+ # secret_arn: "SecretArn",
4269
+ # kms_key_arn: "KmsKeyArn",
4270
+ # },
4271
+ # custom_secret_config: {
4272
+ # secret_arn: "SecretArn",
4273
+ # secret_access_role_arn: "IamRoleArnOrEmptyString",
4274
+ # },
4788
4275
  # })
4789
4276
  #
4790
4277
  # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateLocationObjectStorage AWS API Documentation
@@ -4990,9 +4477,6 @@ module Aws::DataSync
4990
4477
  # Specifies your Kerberos key table (keytab) file, which includes
4991
4478
  # mappings between your Kerberos principal and encryption keys.
4992
4479
  #
4993
- # The file must be base64 encoded. If you're using the CLI, the
4994
- # encoding is done for you.
4995
- #
4996
4480
  # To avoid task execution errors, make sure that the Kerberos principal
4997
4481
  # that you use to create the keytab file matches exactly what you
4998
4482
  # specify for `KerberosPrincipal`.
@@ -5035,61 +4519,6 @@ module Aws::DataSync
5035
4519
  req.send_request(options)
5036
4520
  end
5037
4521
 
5038
- # Modifies some configurations of an on-premises storage system resource
5039
- # that you're using with DataSync Discovery.
5040
- #
5041
- # @option params [required, String] :storage_system_arn
5042
- # Specifies the ARN of the on-premises storage system that you want
5043
- # reconfigure.
5044
- #
5045
- # @option params [Types::DiscoveryServerConfiguration] :server_configuration
5046
- # Specifies the server name and network port required to connect with
5047
- # your on-premises storage system's management interface.
5048
- #
5049
- # @option params [Array<String>] :agent_arns
5050
- # Specifies the Amazon Resource Name (ARN) of the DataSync agent that
5051
- # connects to and reads your on-premises storage system. You can only
5052
- # specify one ARN.
5053
- #
5054
- # @option params [String] :name
5055
- # Specifies a familiar name for your on-premises storage system.
5056
- #
5057
- # @option params [String] :cloud_watch_log_group_arn
5058
- # Specifies the ARN of the Amazon CloudWatch log group for monitoring
5059
- # and logging discovery job events.
5060
- #
5061
- # @option params [Types::Credentials] :credentials
5062
- # Specifies the user name and password for accessing your on-premises
5063
- # storage system's management interface.
5064
- #
5065
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
5066
- #
5067
- # @example Request syntax with placeholder values
5068
- #
5069
- # resp = client.update_storage_system({
5070
- # storage_system_arn: "StorageSystemArn", # required
5071
- # server_configuration: {
5072
- # server_hostname: "DiscoveryServerHostname", # required
5073
- # server_port: 1,
5074
- # },
5075
- # agent_arns: ["AgentArn"],
5076
- # name: "Name",
5077
- # cloud_watch_log_group_arn: "LogGroupArn",
5078
- # credentials: {
5079
- # username: "PtolemyUsername", # required
5080
- # password: "PtolemyPassword", # required
5081
- # },
5082
- # })
5083
- #
5084
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateStorageSystem AWS API Documentation
5085
- #
5086
- # @overload update_storage_system(params = {})
5087
- # @param [Hash] params ({})
5088
- def update_storage_system(params = {}, options = {})
5089
- req = build_request(:update_storage_system, params)
5090
- req.send_request(options)
5091
- end
5092
-
5093
4522
  # Updates the configuration of a *task*, which defines where and how
5094
4523
  # DataSync transfers your data.
5095
4524
  #
@@ -5366,7 +4795,7 @@ module Aws::DataSync
5366
4795
  tracer: tracer
5367
4796
  )
5368
4797
  context[:gem_name] = 'aws-sdk-datasync'
5369
- context[:gem_version] = '1.102.0'
4798
+ context[:gem_version] = '1.104.0'
5370
4799
  Seahorse::Client::Request.new(handlers, context)
5371
4800
  end
5372
4801