aws-sdk-datasync 1.101.0 → 1.103.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.
@@ -200,8 +200,7 @@ module Aws::DataSync
200
200
  # accepted modes and the configuration defaults that are included.
201
201
  #
202
202
  # @option options [Boolean] :disable_host_prefix_injection (false)
203
- # Set to true to disable SDK automatically adding host prefix
204
- # to default service endpoint when available.
203
+ # When `true`, the SDK will not prepend the modeled host prefix to the endpoint.
205
204
  #
206
205
  # @option options [Boolean] :disable_request_compression (false)
207
206
  # When set to 'true' the request body will not be compressed
@@ -477,92 +476,6 @@ module Aws::DataSync
477
476
 
478
477
  # @!group API Operations
479
478
 
480
- # Creates an Amazon Web Services resource for an on-premises storage
481
- # system that you want DataSync Discovery to collect information about.
482
- #
483
- # @option params [required, Types::DiscoveryServerConfiguration] :server_configuration
484
- # Specifies the server name and network port required to connect with
485
- # the management interface of your on-premises storage system.
486
- #
487
- # @option params [required, String] :system_type
488
- # Specifies the type of on-premises storage system that you want
489
- # DataSync Discovery to collect information about.
490
- #
491
- # <note markdown="1"> DataSync Discovery currently supports NetApp Fabric-Attached Storage
492
- # (FAS) and All Flash FAS (AFF) systems running ONTAP 9.7 or later.
493
- #
494
- # </note>
495
- #
496
- # @option params [required, Array<String>] :agent_arns
497
- # Specifies the Amazon Resource Name (ARN) of the DataSync agent that
498
- # connects to and reads from your on-premises storage system's
499
- # management interface. You can only specify one ARN.
500
- #
501
- # @option params [String] :cloud_watch_log_group_arn
502
- # Specifies the ARN of the Amazon CloudWatch log group for monitoring
503
- # and logging discovery job events.
504
- #
505
- # @option params [Array<Types::TagListEntry>] :tags
506
- # Specifies labels that help you categorize, filter, and search for your
507
- # Amazon Web Services resources. We recommend creating at least a name
508
- # tag for your on-premises storage system.
509
- #
510
- # @option params [String] :name
511
- # Specifies a familiar name for your on-premises storage system.
512
- #
513
- # @option params [required, String] :client_token
514
- # Specifies a client token to make sure requests with this API operation
515
- # are idempotent. If you don't specify a client token, DataSync
516
- # generates one for you automatically.
517
- #
518
- # **A suitable default value is auto-generated.** You should normally
519
- # not need to pass this option.**
520
- #
521
- # @option params [required, Types::Credentials] :credentials
522
- # Specifies the user name and password for accessing your on-premises
523
- # storage system's management interface.
524
- #
525
- # @return [Types::AddStorageSystemResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
526
- #
527
- # * {Types::AddStorageSystemResponse#storage_system_arn #storage_system_arn} => String
528
- #
529
- # @example Request syntax with placeholder values
530
- #
531
- # resp = client.add_storage_system({
532
- # server_configuration: { # required
533
- # server_hostname: "DiscoveryServerHostname", # required
534
- # server_port: 1,
535
- # },
536
- # system_type: "NetAppONTAP", # required, accepts NetAppONTAP
537
- # agent_arns: ["AgentArn"], # required
538
- # cloud_watch_log_group_arn: "LogGroupArn",
539
- # tags: [
540
- # {
541
- # key: "TagKey", # required
542
- # value: "TagValue",
543
- # },
544
- # ],
545
- # name: "Name",
546
- # client_token: "PtolemyUUID", # required
547
- # credentials: { # required
548
- # username: "PtolemyUsername", # required
549
- # password: "PtolemyPassword", # required
550
- # },
551
- # })
552
- #
553
- # @example Response structure
554
- #
555
- # resp.storage_system_arn #=> String
556
- #
557
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/AddStorageSystem AWS API Documentation
558
- #
559
- # @overload add_storage_system(params = {})
560
- # @param [Hash] params ({})
561
- def add_storage_system(params = {}, options = {})
562
- req = build_request(:add_storage_system, params)
563
- req.send_request(options)
564
- end
565
-
566
479
  # Stops an DataSync task execution that's in progress. The transfer of
567
480
  # some files are abruptly interrupted. File contents that're
568
481
  # transferred to the destination might be incomplete or inconsistent
@@ -1324,9 +1237,7 @@ module Aws::DataSync
1324
1237
  # @option params [String, StringIO, File] :kerberos_keytab
1325
1238
  # The Kerberos key table (keytab) that contains mappings between the
1326
1239
  # defined Kerberos principal and the encrypted keys. You can load the
1327
- # keytab from a file by providing the file's address. If you're using
1328
- # the CLI, it performs base64 encoding for you. Otherwise, provide the
1329
- # base64-encoded text.
1240
+ # keytab from a file by providing the file's address.
1330
1241
  #
1331
1242
  # <note markdown="1"> If `KERBEROS` is specified for `AuthenticationType`, this parameter is
1332
1243
  # required.
@@ -1834,9 +1745,6 @@ module Aws::DataSync
1834
1745
  # Specifies your Kerberos key table (keytab) file, which includes
1835
1746
  # mappings between your Kerberos principal and encryption keys.
1836
1747
  #
1837
- # The file must be base64 encoded. If you're using the CLI, the
1838
- # encoding is done for you.
1839
- #
1840
1748
  # To avoid task execution errors, make sure that the Kerberos principal
1841
1749
  # that you use to create the keytab file matches exactly what you
1842
1750
  # specify for `KerberosPrincipal`.
@@ -2252,45 +2160,6 @@ module Aws::DataSync
2252
2160
  req.send_request(options)
2253
2161
  end
2254
2162
 
2255
- # Returns information about a DataSync discovery job.
2256
- #
2257
- # @option params [required, String] :discovery_job_arn
2258
- # Specifies the Amazon Resource Name (ARN) of the discovery job that you
2259
- # want information about.
2260
- #
2261
- # @return [Types::DescribeDiscoveryJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2262
- #
2263
- # * {Types::DescribeDiscoveryJobResponse#storage_system_arn #storage_system_arn} => String
2264
- # * {Types::DescribeDiscoveryJobResponse#discovery_job_arn #discovery_job_arn} => String
2265
- # * {Types::DescribeDiscoveryJobResponse#collection_duration_minutes #collection_duration_minutes} => Integer
2266
- # * {Types::DescribeDiscoveryJobResponse#status #status} => String
2267
- # * {Types::DescribeDiscoveryJobResponse#job_start_time #job_start_time} => Time
2268
- # * {Types::DescribeDiscoveryJobResponse#job_end_time #job_end_time} => Time
2269
- #
2270
- # @example Request syntax with placeholder values
2271
- #
2272
- # resp = client.describe_discovery_job({
2273
- # discovery_job_arn: "DiscoveryJobArn", # required
2274
- # })
2275
- #
2276
- # @example Response structure
2277
- #
2278
- # resp.storage_system_arn #=> String
2279
- # resp.discovery_job_arn #=> String
2280
- # resp.collection_duration_minutes #=> Integer
2281
- # resp.status #=> String, one of "RUNNING", "WARNING", "TERMINATED", "FAILED", "STOPPED", "COMPLETED", "COMPLETED_WITH_ISSUES"
2282
- # resp.job_start_time #=> Time
2283
- # resp.job_end_time #=> Time
2284
- #
2285
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeDiscoveryJob AWS API Documentation
2286
- #
2287
- # @overload describe_discovery_job(params = {})
2288
- # @param [Hash] params ({})
2289
- def describe_discovery_job(params = {}, options = {})
2290
- req = build_request(:describe_discovery_job, params)
2291
- req.send_request(options)
2292
- end
2293
-
2294
2163
  # Provides details about how an DataSync transfer location for Microsoft
2295
2164
  # Azure Blob Storage is configured.
2296
2165
  #
@@ -2785,289 +2654,6 @@ module Aws::DataSync
2785
2654
  req.send_request(options)
2786
2655
  end
2787
2656
 
2788
- # Returns information about an on-premises storage system that you're
2789
- # using with DataSync Discovery.
2790
- #
2791
- # @option params [required, String] :storage_system_arn
2792
- # Specifies the Amazon Resource Name (ARN) of an on-premises storage
2793
- # system that you're using with DataSync Discovery.
2794
- #
2795
- # @return [Types::DescribeStorageSystemResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2796
- #
2797
- # * {Types::DescribeStorageSystemResponse#storage_system_arn #storage_system_arn} => String
2798
- # * {Types::DescribeStorageSystemResponse#server_configuration #server_configuration} => Types::DiscoveryServerConfiguration
2799
- # * {Types::DescribeStorageSystemResponse#system_type #system_type} => String
2800
- # * {Types::DescribeStorageSystemResponse#agent_arns #agent_arns} => Array&lt;String&gt;
2801
- # * {Types::DescribeStorageSystemResponse#name #name} => String
2802
- # * {Types::DescribeStorageSystemResponse#error_message #error_message} => String
2803
- # * {Types::DescribeStorageSystemResponse#connectivity_status #connectivity_status} => String
2804
- # * {Types::DescribeStorageSystemResponse#cloud_watch_log_group_arn #cloud_watch_log_group_arn} => String
2805
- # * {Types::DescribeStorageSystemResponse#creation_time #creation_time} => Time
2806
- # * {Types::DescribeStorageSystemResponse#secrets_manager_arn #secrets_manager_arn} => String
2807
- #
2808
- # @example Request syntax with placeholder values
2809
- #
2810
- # resp = client.describe_storage_system({
2811
- # storage_system_arn: "StorageSystemArn", # required
2812
- # })
2813
- #
2814
- # @example Response structure
2815
- #
2816
- # resp.storage_system_arn #=> String
2817
- # resp.server_configuration.server_hostname #=> String
2818
- # resp.server_configuration.server_port #=> Integer
2819
- # resp.system_type #=> String, one of "NetAppONTAP"
2820
- # resp.agent_arns #=> Array
2821
- # resp.agent_arns[0] #=> String
2822
- # resp.name #=> String
2823
- # resp.error_message #=> String
2824
- # resp.connectivity_status #=> String, one of "PASS", "FAIL", "UNKNOWN"
2825
- # resp.cloud_watch_log_group_arn #=> String
2826
- # resp.creation_time #=> Time
2827
- # resp.secrets_manager_arn #=> String
2828
- #
2829
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystem AWS API Documentation
2830
- #
2831
- # @overload describe_storage_system(params = {})
2832
- # @param [Hash] params ({})
2833
- def describe_storage_system(params = {}, options = {})
2834
- req = build_request(:describe_storage_system, params)
2835
- req.send_request(options)
2836
- end
2837
-
2838
- # Returns information, including performance data and capacity usage,
2839
- # which DataSync Discovery collects about a specific resource in
2840
- # your-premises storage system.
2841
- #
2842
- # @option params [required, String] :discovery_job_arn
2843
- # Specifies the Amazon Resource Name (ARN) of the discovery job that
2844
- # collects information about your on-premises storage system.
2845
- #
2846
- # @option params [required, String] :resource_type
2847
- # Specifies the kind of storage system resource that you want
2848
- # information about.
2849
- #
2850
- # @option params [required, String] :resource_id
2851
- # Specifies the universally unique identifier (UUID) of the storage
2852
- # system resource that you want information about.
2853
- #
2854
- # @option params [Time,DateTime,Date,Integer,String] :start_time
2855
- # Specifies a time within the total duration that the discovery job ran.
2856
- # To see information gathered during a certain time frame, use this
2857
- # parameter with `EndTime`.
2858
- #
2859
- # @option params [Time,DateTime,Date,Integer,String] :end_time
2860
- # Specifies a time within the total duration that the discovery job ran.
2861
- # To see information gathered during a certain time frame, use this
2862
- # parameter with `StartTime`.
2863
- #
2864
- # @option params [Integer] :max_results
2865
- # Specifies how many results that you want in the response.
2866
- #
2867
- # @option params [String] :next_token
2868
- # Specifies an opaque string that indicates the position to begin the
2869
- # next list of results in the response.
2870
- #
2871
- # @return [Types::DescribeStorageSystemResourceMetricsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2872
- #
2873
- # * {Types::DescribeStorageSystemResourceMetricsResponse#metrics #metrics} => Array&lt;Types::ResourceMetrics&gt;
2874
- # * {Types::DescribeStorageSystemResourceMetricsResponse#next_token #next_token} => String
2875
- #
2876
- # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2877
- #
2878
- # @example Request syntax with placeholder values
2879
- #
2880
- # resp = client.describe_storage_system_resource_metrics({
2881
- # discovery_job_arn: "DiscoveryJobArn", # required
2882
- # resource_type: "SVM", # required, accepts SVM, VOLUME, CLUSTER
2883
- # resource_id: "ResourceId", # required
2884
- # start_time: Time.now,
2885
- # end_time: Time.now,
2886
- # max_results: 1,
2887
- # next_token: "DiscoveryNextToken",
2888
- # })
2889
- #
2890
- # @example Response structure
2891
- #
2892
- # resp.metrics #=> Array
2893
- # resp.metrics[0].timestamp #=> Time
2894
- # resp.metrics[0].p95_metrics.iops.read #=> Float
2895
- # resp.metrics[0].p95_metrics.iops.write #=> Float
2896
- # resp.metrics[0].p95_metrics.iops.other #=> Float
2897
- # resp.metrics[0].p95_metrics.iops.total #=> Float
2898
- # resp.metrics[0].p95_metrics.throughput.read #=> Float
2899
- # resp.metrics[0].p95_metrics.throughput.write #=> Float
2900
- # resp.metrics[0].p95_metrics.throughput.other #=> Float
2901
- # resp.metrics[0].p95_metrics.throughput.total #=> Float
2902
- # resp.metrics[0].p95_metrics.latency.read #=> Float
2903
- # resp.metrics[0].p95_metrics.latency.write #=> Float
2904
- # resp.metrics[0].p95_metrics.latency.other #=> Float
2905
- # resp.metrics[0].capacity.used #=> Integer
2906
- # resp.metrics[0].capacity.provisioned #=> Integer
2907
- # resp.metrics[0].capacity.logical_used #=> Integer
2908
- # resp.metrics[0].capacity.cluster_cloud_storage_used #=> Integer
2909
- # resp.metrics[0].resource_id #=> String
2910
- # resp.metrics[0].resource_type #=> String, one of "SVM", "VOLUME", "CLUSTER"
2911
- # resp.next_token #=> String
2912
- #
2913
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemResourceMetrics AWS API Documentation
2914
- #
2915
- # @overload describe_storage_system_resource_metrics(params = {})
2916
- # @param [Hash] params ({})
2917
- def describe_storage_system_resource_metrics(params = {}, options = {})
2918
- req = build_request(:describe_storage_system_resource_metrics, params)
2919
- req.send_request(options)
2920
- end
2921
-
2922
- # Returns information that DataSync Discovery collects about resources
2923
- # in your on-premises storage system.
2924
- #
2925
- # @option params [required, String] :discovery_job_arn
2926
- # Specifies the Amazon Resource Name (ARN) of the discovery job that's
2927
- # collecting data from your on-premises storage system.
2928
- #
2929
- # @option params [required, String] :resource_type
2930
- # Specifies what kind of storage system resources that you want
2931
- # information about.
2932
- #
2933
- # @option params [Array<String>] :resource_ids
2934
- # Specifies the universally unique identifiers (UUIDs) of the storage
2935
- # system resources that you want information about. You can't use this
2936
- # parameter in combination with the `Filter` parameter.
2937
- #
2938
- # @option params [Hash<String,Array>] :filter
2939
- # Filters the storage system resources that you want returned. For
2940
- # example, this might be volumes associated with a specific storage
2941
- # virtual machine (SVM).
2942
- #
2943
- # @option params [Integer] :max_results
2944
- # Specifies the maximum number of storage system resources that you want
2945
- # to list in a response.
2946
- #
2947
- # @option params [String] :next_token
2948
- # Specifies an opaque string that indicates the position to begin the
2949
- # next list of results in the response.
2950
- #
2951
- # @return [Types::DescribeStorageSystemResourcesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2952
- #
2953
- # * {Types::DescribeStorageSystemResourcesResponse#resource_details #resource_details} => Types::ResourceDetails
2954
- # * {Types::DescribeStorageSystemResourcesResponse#next_token #next_token} => String
2955
- #
2956
- # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2957
- #
2958
- # @example Request syntax with placeholder values
2959
- #
2960
- # resp = client.describe_storage_system_resources({
2961
- # discovery_job_arn: "DiscoveryJobArn", # required
2962
- # resource_type: "SVM", # required, accepts SVM, VOLUME, CLUSTER
2963
- # resource_ids: ["ResourceId"],
2964
- # filter: {
2965
- # "SVM" => ["PtolemyString"],
2966
- # },
2967
- # max_results: 1,
2968
- # next_token: "DiscoveryNextToken",
2969
- # })
2970
- #
2971
- # @example Response structure
2972
- #
2973
- # resp.resource_details.net_app_ontapsv_ms #=> Array
2974
- # resp.resource_details.net_app_ontapsv_ms[0].cluster_uuid #=> String
2975
- # resp.resource_details.net_app_ontapsv_ms[0].resource_id #=> String
2976
- # resp.resource_details.net_app_ontapsv_ms[0].svm_name #=> String
2977
- # resp.resource_details.net_app_ontapsv_ms[0].cifs_share_count #=> Integer
2978
- # resp.resource_details.net_app_ontapsv_ms[0].enabled_protocols #=> Array
2979
- # resp.resource_details.net_app_ontapsv_ms[0].enabled_protocols[0] #=> String
2980
- # resp.resource_details.net_app_ontapsv_ms[0].total_capacity_used #=> Integer
2981
- # resp.resource_details.net_app_ontapsv_ms[0].total_capacity_provisioned #=> Integer
2982
- # resp.resource_details.net_app_ontapsv_ms[0].total_logical_capacity_used #=> Integer
2983
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.iops_read #=> Float
2984
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.iops_write #=> Float
2985
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.iops_other #=> Float
2986
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.iops_total #=> Float
2987
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.throughput_read #=> Float
2988
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.throughput_write #=> Float
2989
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.throughput_other #=> Float
2990
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.throughput_total #=> Float
2991
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.latency_read #=> Float
2992
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.latency_write #=> Float
2993
- # resp.resource_details.net_app_ontapsv_ms[0].max_p95_performance.latency_other #=> Float
2994
- # resp.resource_details.net_app_ontapsv_ms[0].recommendations #=> Array
2995
- # resp.resource_details.net_app_ontapsv_ms[0].recommendations[0].storage_type #=> String
2996
- # resp.resource_details.net_app_ontapsv_ms[0].recommendations[0].storage_configuration #=> Hash
2997
- # resp.resource_details.net_app_ontapsv_ms[0].recommendations[0].storage_configuration["PtolemyString"] #=> String
2998
- # resp.resource_details.net_app_ontapsv_ms[0].recommendations[0].estimated_monthly_storage_cost #=> String
2999
- # resp.resource_details.net_app_ontapsv_ms[0].nfs_exported_volumes #=> Integer
3000
- # resp.resource_details.net_app_ontapsv_ms[0].recommendation_status #=> String, one of "NONE", "IN_PROGRESS", "COMPLETED", "FAILED"
3001
- # resp.resource_details.net_app_ontapsv_ms[0].total_snapshot_capacity_used #=> Integer
3002
- # resp.resource_details.net_app_ontapsv_ms[0].lun_count #=> Integer
3003
- # resp.resource_details.net_app_ontap_volumes #=> Array
3004
- # resp.resource_details.net_app_ontap_volumes[0].volume_name #=> String
3005
- # resp.resource_details.net_app_ontap_volumes[0].resource_id #=> String
3006
- # resp.resource_details.net_app_ontap_volumes[0].cifs_share_count #=> Integer
3007
- # resp.resource_details.net_app_ontap_volumes[0].security_style #=> String
3008
- # resp.resource_details.net_app_ontap_volumes[0].svm_uuid #=> String
3009
- # resp.resource_details.net_app_ontap_volumes[0].svm_name #=> String
3010
- # resp.resource_details.net_app_ontap_volumes[0].capacity_used #=> Integer
3011
- # resp.resource_details.net_app_ontap_volumes[0].capacity_provisioned #=> Integer
3012
- # resp.resource_details.net_app_ontap_volumes[0].logical_capacity_used #=> Integer
3013
- # resp.resource_details.net_app_ontap_volumes[0].nfs_exported #=> Boolean
3014
- # resp.resource_details.net_app_ontap_volumes[0].snapshot_capacity_used #=> Integer
3015
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.iops_read #=> Float
3016
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.iops_write #=> Float
3017
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.iops_other #=> Float
3018
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.iops_total #=> Float
3019
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.throughput_read #=> Float
3020
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.throughput_write #=> Float
3021
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.throughput_other #=> Float
3022
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.throughput_total #=> Float
3023
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.latency_read #=> Float
3024
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.latency_write #=> Float
3025
- # resp.resource_details.net_app_ontap_volumes[0].max_p95_performance.latency_other #=> Float
3026
- # resp.resource_details.net_app_ontap_volumes[0].recommendations #=> Array
3027
- # resp.resource_details.net_app_ontap_volumes[0].recommendations[0].storage_type #=> String
3028
- # resp.resource_details.net_app_ontap_volumes[0].recommendations[0].storage_configuration #=> Hash
3029
- # resp.resource_details.net_app_ontap_volumes[0].recommendations[0].storage_configuration["PtolemyString"] #=> String
3030
- # resp.resource_details.net_app_ontap_volumes[0].recommendations[0].estimated_monthly_storage_cost #=> String
3031
- # resp.resource_details.net_app_ontap_volumes[0].recommendation_status #=> String, one of "NONE", "IN_PROGRESS", "COMPLETED", "FAILED"
3032
- # resp.resource_details.net_app_ontap_volumes[0].lun_count #=> Integer
3033
- # resp.resource_details.net_app_ontap_clusters #=> Array
3034
- # resp.resource_details.net_app_ontap_clusters[0].cifs_share_count #=> Integer
3035
- # resp.resource_details.net_app_ontap_clusters[0].nfs_exported_volumes #=> Integer
3036
- # resp.resource_details.net_app_ontap_clusters[0].resource_id #=> String
3037
- # resp.resource_details.net_app_ontap_clusters[0].cluster_name #=> String
3038
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.iops_read #=> Float
3039
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.iops_write #=> Float
3040
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.iops_other #=> Float
3041
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.iops_total #=> Float
3042
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.throughput_read #=> Float
3043
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.throughput_write #=> Float
3044
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.throughput_other #=> Float
3045
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.throughput_total #=> Float
3046
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.latency_read #=> Float
3047
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.latency_write #=> Float
3048
- # resp.resource_details.net_app_ontap_clusters[0].max_p95_performance.latency_other #=> Float
3049
- # resp.resource_details.net_app_ontap_clusters[0].cluster_block_storage_size #=> Integer
3050
- # resp.resource_details.net_app_ontap_clusters[0].cluster_block_storage_used #=> Integer
3051
- # resp.resource_details.net_app_ontap_clusters[0].cluster_block_storage_logical_used #=> Integer
3052
- # resp.resource_details.net_app_ontap_clusters[0].recommendations #=> Array
3053
- # resp.resource_details.net_app_ontap_clusters[0].recommendations[0].storage_type #=> String
3054
- # resp.resource_details.net_app_ontap_clusters[0].recommendations[0].storage_configuration #=> Hash
3055
- # resp.resource_details.net_app_ontap_clusters[0].recommendations[0].storage_configuration["PtolemyString"] #=> String
3056
- # resp.resource_details.net_app_ontap_clusters[0].recommendations[0].estimated_monthly_storage_cost #=> String
3057
- # resp.resource_details.net_app_ontap_clusters[0].recommendation_status #=> String, one of "NONE", "IN_PROGRESS", "COMPLETED", "FAILED"
3058
- # resp.resource_details.net_app_ontap_clusters[0].lun_count #=> Integer
3059
- # resp.resource_details.net_app_ontap_clusters[0].cluster_cloud_storage_used #=> Integer
3060
- # resp.next_token #=> String
3061
- #
3062
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemResources AWS API Documentation
3063
- #
3064
- # @overload describe_storage_system_resources(params = {})
3065
- # @param [Hash] params ({})
3066
- def describe_storage_system_resources(params = {}, options = {})
3067
- req = build_request(:describe_storage_system_resources, params)
3068
- req.send_request(options)
3069
- end
3070
-
3071
2657
  # Provides information about a *task*, which defines where and how
3072
2658
  # DataSync transfers your data.
3073
2659
  #
@@ -3308,51 +2894,6 @@ module Aws::DataSync
3308
2894
  req.send_request(options)
3309
2895
  end
3310
2896
 
3311
- # Creates recommendations about where to migrate your data to in Amazon
3312
- # Web Services. Recommendations are generated based on information that
3313
- # DataSync Discovery collects about your on-premises storage system's
3314
- # resources. For more information, see [Recommendations provided by
3315
- # DataSync Discovery][1].
3316
- #
3317
- # Once generated, you can view your recommendations by using the
3318
- # [DescribeStorageSystemResources][2] operation.
3319
- #
3320
- #
3321
- #
3322
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-understand-recommendations.html
3323
- # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/API_DescribeStorageSystemResources.html
3324
- #
3325
- # @option params [required, String] :discovery_job_arn
3326
- # Specifies the Amazon Resource Name (ARN) of the discovery job that
3327
- # collects information about your on-premises storage system.
3328
- #
3329
- # @option params [required, Array<String>] :resource_ids
3330
- # Specifies the universally unique identifiers (UUIDs) of the resources
3331
- # in your storage system that you want recommendations on.
3332
- #
3333
- # @option params [required, String] :resource_type
3334
- # Specifies the type of resource in your storage system that you want
3335
- # recommendations on.
3336
- #
3337
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3338
- #
3339
- # @example Request syntax with placeholder values
3340
- #
3341
- # resp = client.generate_recommendations({
3342
- # discovery_job_arn: "DiscoveryJobArn", # required
3343
- # resource_ids: ["ResourceId"], # required
3344
- # resource_type: "SVM", # required, accepts SVM, VOLUME, CLUSTER
3345
- # })
3346
- #
3347
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/GenerateRecommendations AWS API Documentation
3348
- #
3349
- # @overload generate_recommendations(params = {})
3350
- # @param [Hash] params ({})
3351
- def generate_recommendations(params = {}, options = {})
3352
- req = build_request(:generate_recommendations, params)
3353
- req.send_request(options)
3354
- end
3355
-
3356
2897
  # Returns a list of DataSync agents that belong to an Amazon Web
3357
2898
  # Services account in the Amazon Web Services Region specified in the
3358
2899
  # request.
@@ -3415,53 +2956,6 @@ module Aws::DataSync
3415
2956
  req.send_request(options)
3416
2957
  end
3417
2958
 
3418
- # Provides a list of the existing discovery jobs in the Amazon Web
3419
- # Services Region and Amazon Web Services account where you're using
3420
- # DataSync Discovery.
3421
- #
3422
- # @option params [String] :storage_system_arn
3423
- # Specifies the Amazon Resource Name (ARN) of an on-premises storage
3424
- # system. Use this parameter if you only want to list the discovery jobs
3425
- # that are associated with a specific storage system.
3426
- #
3427
- # @option params [Integer] :max_results
3428
- # Specifies how many results you want in the response.
3429
- #
3430
- # @option params [String] :next_token
3431
- # Specifies an opaque string that indicates the position to begin the
3432
- # next list of results in the response.
3433
- #
3434
- # @return [Types::ListDiscoveryJobsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3435
- #
3436
- # * {Types::ListDiscoveryJobsResponse#discovery_jobs #discovery_jobs} => Array&lt;Types::DiscoveryJobListEntry&gt;
3437
- # * {Types::ListDiscoveryJobsResponse#next_token #next_token} => String
3438
- #
3439
- # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3440
- #
3441
- # @example Request syntax with placeholder values
3442
- #
3443
- # resp = client.list_discovery_jobs({
3444
- # storage_system_arn: "StorageSystemArn",
3445
- # max_results: 1,
3446
- # next_token: "DiscoveryNextToken",
3447
- # })
3448
- #
3449
- # @example Response structure
3450
- #
3451
- # resp.discovery_jobs #=> Array
3452
- # resp.discovery_jobs[0].discovery_job_arn #=> String
3453
- # resp.discovery_jobs[0].status #=> String, one of "RUNNING", "WARNING", "TERMINATED", "FAILED", "STOPPED", "COMPLETED", "COMPLETED_WITH_ISSUES"
3454
- # resp.next_token #=> String
3455
- #
3456
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListDiscoveryJobs AWS API Documentation
3457
- #
3458
- # @overload list_discovery_jobs(params = {})
3459
- # @param [Hash] params ({})
3460
- def list_discovery_jobs(params = {}, options = {})
3461
- req = build_request(:list_discovery_jobs, params)
3462
- req.send_request(options)
3463
- end
3464
-
3465
2959
  # Returns a list of source and destination locations.
3466
2960
  #
3467
2961
  # If you have more locations than are returned in a response (that is,
@@ -3519,46 +3013,6 @@ module Aws::DataSync
3519
3013
  req.send_request(options)
3520
3014
  end
3521
3015
 
3522
- # Lists the on-premises storage systems that you're using with DataSync
3523
- # Discovery.
3524
- #
3525
- # @option params [Integer] :max_results
3526
- # Specifies how many results you want in the response.
3527
- #
3528
- # @option params [String] :next_token
3529
- # Specifies an opaque string that indicates the position to begin the
3530
- # next list of results in the response.
3531
- #
3532
- # @return [Types::ListStorageSystemsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3533
- #
3534
- # * {Types::ListStorageSystemsResponse#storage_systems #storage_systems} => Array&lt;Types::StorageSystemListEntry&gt;
3535
- # * {Types::ListStorageSystemsResponse#next_token #next_token} => String
3536
- #
3537
- # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3538
- #
3539
- # @example Request syntax with placeholder values
3540
- #
3541
- # resp = client.list_storage_systems({
3542
- # max_results: 1,
3543
- # next_token: "DiscoveryNextToken",
3544
- # })
3545
- #
3546
- # @example Response structure
3547
- #
3548
- # resp.storage_systems #=> Array
3549
- # resp.storage_systems[0].storage_system_arn #=> String
3550
- # resp.storage_systems[0].name #=> String
3551
- # resp.next_token #=> String
3552
- #
3553
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListStorageSystems AWS API Documentation
3554
- #
3555
- # @overload list_storage_systems(params = {})
3556
- # @param [Hash] params ({})
3557
- def list_storage_systems(params = {}, options = {})
3558
- req = build_request(:list_storage_systems, params)
3559
- req.send_request(options)
3560
- end
3561
-
3562
3016
  # Returns all the tags associated with an Amazon Web Services resource.
3563
3017
  #
3564
3018
  # @option params [required, String] :resource_arn
@@ -3702,96 +3156,6 @@ module Aws::DataSync
3702
3156
  req.send_request(options)
3703
3157
  end
3704
3158
 
3705
- # Permanently removes a storage system resource from DataSync Discovery,
3706
- # including the associated discovery jobs, collected data, and
3707
- # recommendations.
3708
- #
3709
- # @option params [required, String] :storage_system_arn
3710
- # Specifies the Amazon Resource Name (ARN) of the storage system that
3711
- # you want to permanently remove from DataSync Discovery.
3712
- #
3713
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3714
- #
3715
- # @example Request syntax with placeholder values
3716
- #
3717
- # resp = client.remove_storage_system({
3718
- # storage_system_arn: "StorageSystemArn", # required
3719
- # })
3720
- #
3721
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/RemoveStorageSystem AWS API Documentation
3722
- #
3723
- # @overload remove_storage_system(params = {})
3724
- # @param [Hash] params ({})
3725
- def remove_storage_system(params = {}, options = {})
3726
- req = build_request(:remove_storage_system, params)
3727
- req.send_request(options)
3728
- end
3729
-
3730
- # Runs a DataSync discovery job on your on-premises storage system. If
3731
- # you haven't added the storage system to DataSync Discovery yet, do
3732
- # this first by using the [AddStorageSystem][1] operation.
3733
- #
3734
- #
3735
- #
3736
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_AddStorageSystem.html
3737
- #
3738
- # @option params [required, String] :storage_system_arn
3739
- # Specifies the Amazon Resource Name (ARN) of the on-premises storage
3740
- # system that you want to run the discovery job on.
3741
- #
3742
- # @option params [required, Integer] :collection_duration_minutes
3743
- # Specifies in minutes how long you want the discovery job to run.
3744
- #
3745
- # <note markdown="1"> For more accurate recommendations, we recommend a duration of at least
3746
- # 14 days. Longer durations allow time to collect a sufficient number of
3747
- # data points and provide a realistic representation of storage
3748
- # performance and utilization.
3749
- #
3750
- # </note>
3751
- #
3752
- # @option params [required, String] :client_token
3753
- # Specifies a client token to make sure requests with this API operation
3754
- # are idempotent. If you don't specify a client token, DataSync
3755
- # generates one for you automatically.
3756
- #
3757
- # **A suitable default value is auto-generated.** You should normally
3758
- # not need to pass this option.**
3759
- #
3760
- # @option params [Array<Types::TagListEntry>] :tags
3761
- # Specifies labels that help you categorize, filter, and search for your
3762
- # Amazon Web Services resources.
3763
- #
3764
- # @return [Types::StartDiscoveryJobResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3765
- #
3766
- # * {Types::StartDiscoveryJobResponse#discovery_job_arn #discovery_job_arn} => String
3767
- #
3768
- # @example Request syntax with placeholder values
3769
- #
3770
- # resp = client.start_discovery_job({
3771
- # storage_system_arn: "StorageSystemArn", # required
3772
- # collection_duration_minutes: 1, # required
3773
- # client_token: "PtolemyUUID", # required
3774
- # tags: [
3775
- # {
3776
- # key: "TagKey", # required
3777
- # value: "TagValue",
3778
- # },
3779
- # ],
3780
- # })
3781
- #
3782
- # @example Response structure
3783
- #
3784
- # resp.discovery_job_arn #=> String
3785
- #
3786
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StartDiscoveryJob AWS API Documentation
3787
- #
3788
- # @overload start_discovery_job(params = {})
3789
- # @param [Hash] params ({})
3790
- def start_discovery_job(params = {}, options = {})
3791
- req = build_request(:start_discovery_job, params)
3792
- req.send_request(options)
3793
- end
3794
-
3795
3159
  # Starts an DataSync transfer task. For each task, you can only run one
3796
3160
  # task execution at a time.
3797
3161
  #
@@ -3981,39 +3345,6 @@ module Aws::DataSync
3981
3345
  req.send_request(options)
3982
3346
  end
3983
3347
 
3984
- # Stops a running DataSync discovery job.
3985
- #
3986
- # You can stop a discovery job anytime. A job that's stopped before
3987
- # it's scheduled to end likely will provide you some information about
3988
- # your on-premises storage system resources. To get recommendations for
3989
- # a stopped job, you must use the [GenerateRecommendations][1]
3990
- # operation.
3991
- #
3992
- #
3993
- #
3994
- # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/API_GenerateRecommendations.html
3995
- #
3996
- # @option params [required, String] :discovery_job_arn
3997
- # Specifies the Amazon Resource Name (ARN) of the discovery job that you
3998
- # want to stop.
3999
- #
4000
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4001
- #
4002
- # @example Request syntax with placeholder values
4003
- #
4004
- # resp = client.stop_discovery_job({
4005
- # discovery_job_arn: "DiscoveryJobArn", # required
4006
- # })
4007
- #
4008
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StopDiscoveryJob AWS API Documentation
4009
- #
4010
- # @overload stop_discovery_job(params = {})
4011
- # @param [Hash] params ({})
4012
- def stop_discovery_job(params = {}, options = {})
4013
- req = build_request(:stop_discovery_job, params)
4014
- req.send_request(options)
4015
- end
4016
-
4017
3348
  # Applies a *tag* to an Amazon Web Services resource. Tags are key-value
4018
3349
  # pairs that can help you manage, filter, and search for your resources.
4019
3350
  #
@@ -4103,35 +3434,6 @@ module Aws::DataSync
4103
3434
  req.send_request(options)
4104
3435
  end
4105
3436
 
4106
- # Edits a DataSync discovery job configuration.
4107
- #
4108
- # @option params [required, String] :discovery_job_arn
4109
- # Specifies the Amazon Resource Name (ARN) of the discovery job that you
4110
- # want to update.
4111
- #
4112
- # @option params [required, Integer] :collection_duration_minutes
4113
- # Specifies in minutes how long that you want the discovery job to run.
4114
- # (You can't set this parameter to less than the number of minutes that
4115
- # the job has already run for.)
4116
- #
4117
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4118
- #
4119
- # @example Request syntax with placeholder values
4120
- #
4121
- # resp = client.update_discovery_job({
4122
- # discovery_job_arn: "DiscoveryJobArn", # required
4123
- # collection_duration_minutes: 1, # required
4124
- # })
4125
- #
4126
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateDiscoveryJob AWS API Documentation
4127
- #
4128
- # @overload update_discovery_job(params = {})
4129
- # @param [Hash] params ({})
4130
- def update_discovery_job(params = {}, options = {})
4131
- req = build_request(:update_discovery_job, params)
4132
- req.send_request(options)
4133
- end
4134
-
4135
3437
  # Modifies the following configurations of the Microsoft Azure Blob
4136
3438
  # Storage transfer location that you're using with DataSync.
4137
3439
  #
@@ -4587,9 +3889,7 @@ module Aws::DataSync
4587
3889
  # @option params [String, StringIO, File] :kerberos_keytab
4588
3890
  # The Kerberos key table (keytab) that contains mappings between the
4589
3891
  # defined Kerberos principal and the encrypted keys. You can load the
4590
- # keytab from a file by providing the file's address. If you use the
4591
- # CLI, it performs base64 encoding for you. Otherwise, provide the
4592
- # base64-encoded text.
3892
+ # keytab from a file by providing the file's address.
4593
3893
  #
4594
3894
  # @option params [String, StringIO, File] :kerberos_krb_5_conf
4595
3895
  # The `krb5.conf` file that contains the Kerberos configuration
@@ -4991,9 +4291,6 @@ module Aws::DataSync
4991
4291
  # Specifies your Kerberos key table (keytab) file, which includes
4992
4292
  # mappings between your Kerberos principal and encryption keys.
4993
4293
  #
4994
- # The file must be base64 encoded. If you're using the CLI, the
4995
- # encoding is done for you.
4996
- #
4997
4294
  # To avoid task execution errors, make sure that the Kerberos principal
4998
4295
  # that you use to create the keytab file matches exactly what you
4999
4296
  # specify for `KerberosPrincipal`.
@@ -5036,61 +4333,6 @@ module Aws::DataSync
5036
4333
  req.send_request(options)
5037
4334
  end
5038
4335
 
5039
- # Modifies some configurations of an on-premises storage system resource
5040
- # that you're using with DataSync Discovery.
5041
- #
5042
- # @option params [required, String] :storage_system_arn
5043
- # Specifies the ARN of the on-premises storage system that you want
5044
- # reconfigure.
5045
- #
5046
- # @option params [Types::DiscoveryServerConfiguration] :server_configuration
5047
- # Specifies the server name and network port required to connect with
5048
- # your on-premises storage system's management interface.
5049
- #
5050
- # @option params [Array<String>] :agent_arns
5051
- # Specifies the Amazon Resource Name (ARN) of the DataSync agent that
5052
- # connects to and reads your on-premises storage system. You can only
5053
- # specify one ARN.
5054
- #
5055
- # @option params [String] :name
5056
- # Specifies a familiar name for your on-premises storage system.
5057
- #
5058
- # @option params [String] :cloud_watch_log_group_arn
5059
- # Specifies the ARN of the Amazon CloudWatch log group for monitoring
5060
- # and logging discovery job events.
5061
- #
5062
- # @option params [Types::Credentials] :credentials
5063
- # Specifies the user name and password for accessing your on-premises
5064
- # storage system's management interface.
5065
- #
5066
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
5067
- #
5068
- # @example Request syntax with placeholder values
5069
- #
5070
- # resp = client.update_storage_system({
5071
- # storage_system_arn: "StorageSystemArn", # required
5072
- # server_configuration: {
5073
- # server_hostname: "DiscoveryServerHostname", # required
5074
- # server_port: 1,
5075
- # },
5076
- # agent_arns: ["AgentArn"],
5077
- # name: "Name",
5078
- # cloud_watch_log_group_arn: "LogGroupArn",
5079
- # credentials: {
5080
- # username: "PtolemyUsername", # required
5081
- # password: "PtolemyPassword", # required
5082
- # },
5083
- # })
5084
- #
5085
- # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateStorageSystem AWS API Documentation
5086
- #
5087
- # @overload update_storage_system(params = {})
5088
- # @param [Hash] params ({})
5089
- def update_storage_system(params = {}, options = {})
5090
- req = build_request(:update_storage_system, params)
5091
- req.send_request(options)
5092
- end
5093
-
5094
4336
  # Updates the configuration of a *task*, which defines where and how
5095
4337
  # DataSync transfers your data.
5096
4338
  #
@@ -5367,7 +4609,7 @@ module Aws::DataSync
5367
4609
  tracer: tracer
5368
4610
  )
5369
4611
  context[:gem_name] = 'aws-sdk-datasync'
5370
- context[:gem_version] = '1.101.0'
4612
+ context[:gem_version] = '1.103.0'
5371
4613
  Seahorse::Client::Request.new(handlers, context)
5372
4614
  end
5373
4615