aws-sdk-datasync 1.55.0 → 1.56.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.
@@ -10,6 +10,84 @@
10
10
  module Aws::DataSync
11
11
  module Types
12
12
 
13
+ # @!attribute [rw] server_configuration
14
+ # Specifies the server name and network port required to connect with
15
+ # the management interface of your on-premises storage system.
16
+ # @return [Types::DiscoveryServerConfiguration]
17
+ #
18
+ # @!attribute [rw] system_type
19
+ # Specifies the type of on-premises storage system that you want
20
+ # DataSync Discovery to collect information about.
21
+ #
22
+ # <note markdown="1"> DataSync Discovery currently supports NetApp Fabric-Attached Storage
23
+ # (FAS) and All Flash FAS (AFF) systems running ONTAP 9.7 or later.
24
+ #
25
+ # </note>
26
+ # @return [String]
27
+ #
28
+ # @!attribute [rw] agent_arns
29
+ # Specifies the Amazon Resource Name (ARN) of the DataSync agent that
30
+ # connects to and reads from your on-premises storage system's
31
+ # management interface.
32
+ # @return [Array<String>]
33
+ #
34
+ # @!attribute [rw] cloud_watch_log_group_arn
35
+ # Specifies the ARN of the Amazon CloudWatch log group for monitoring
36
+ # and logging discovery job events.
37
+ # @return [String]
38
+ #
39
+ # @!attribute [rw] tags
40
+ # Specifies labels that help you categorize, filter, and search for
41
+ # your Amazon Web Services resources. We recommend creating at least a
42
+ # name tag for your on-premises storage system.
43
+ # @return [Array<Types::TagListEntry>]
44
+ #
45
+ # @!attribute [rw] name
46
+ # Specifies a familiar name for your on-premises storage system.
47
+ # @return [String]
48
+ #
49
+ # @!attribute [rw] client_token
50
+ # Specifies a client token to make sure requests with this API
51
+ # operation are idempotent. If you don't specify a client token,
52
+ # DataSync generates one for you automatically.
53
+ #
54
+ # **A suitable default value is auto-generated.** You should normally
55
+ # not need to pass this option.
56
+ # @return [String]
57
+ #
58
+ # @!attribute [rw] credentials
59
+ # Specifies the user name and password for accessing your on-premises
60
+ # storage system's management interface.
61
+ # @return [Types::Credentials]
62
+ #
63
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/AddStorageSystemRequest AWS API Documentation
64
+ #
65
+ class AddStorageSystemRequest < Struct.new(
66
+ :server_configuration,
67
+ :system_type,
68
+ :agent_arns,
69
+ :cloud_watch_log_group_arn,
70
+ :tags,
71
+ :name,
72
+ :client_token,
73
+ :credentials)
74
+ SENSITIVE = []
75
+ include Aws::Structure
76
+ end
77
+
78
+ # @!attribute [rw] storage_system_arn
79
+ # The ARN of the on-premises storage system that you can use with
80
+ # DataSync Discovery.
81
+ # @return [String]
82
+ #
83
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/AddStorageSystemResponse AWS API Documentation
84
+ #
85
+ class AddStorageSystemResponse < Struct.new(
86
+ :storage_system_arn)
87
+ SENSITIVE = []
88
+ include Aws::Structure
89
+ end
90
+
13
91
  # Represents a single entry in a list (or array) of DataSync agents when
14
92
  # you call the [ListAgents][1] operation.
15
93
  #
@@ -62,6 +140,32 @@ module Aws::DataSync
62
140
  #
63
141
  class CancelTaskExecutionResponse < Aws::EmptyStructure; end
64
142
 
143
+ # The storage capacity of an on-premises storage system resource (for
144
+ # example, a volume).
145
+ #
146
+ # @!attribute [rw] used
147
+ # The amount of space that's being used in a storage system resource.
148
+ # @return [Integer]
149
+ #
150
+ # @!attribute [rw] provisioned
151
+ # The total amount of space available in a storage system resource.
152
+ # @return [Integer]
153
+ #
154
+ # @!attribute [rw] logical_used
155
+ # The amount of space that's being used in a storage system resource
156
+ # without accounting for compression or deduplication.
157
+ # @return [Integer]
158
+ #
159
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/Capacity AWS API Documentation
160
+ #
161
+ class Capacity < Struct.new(
162
+ :used,
163
+ :provisioned,
164
+ :logical_used)
165
+ SENSITIVE = []
166
+ include Aws::Structure
167
+ end
168
+
65
169
  # CreateAgentRequest
66
170
  #
67
171
  # @!attribute [rw] activation_key
@@ -298,9 +402,9 @@ module Aws::DataSync
298
402
  # The security groups must allow outbound traffic on the following
299
403
  # ports (depending on the protocol you use):
300
404
  #
301
- # * **Network File System (NFS)**\: TCP ports 111, 635, and 2049
405
+ # * **Network File System (NFS)**: TCP ports 111, 635, and 2049
302
406
  #
303
- # * **Server Message Block (SMB)**\: TCP port 445
407
+ # * **Server Message Block (SMB)**: TCP port 445
304
408
  #
305
409
  # Your file system's security groups must also allow inbound traffic
306
410
  # on the same ports.
@@ -1119,6 +1223,37 @@ module Aws::DataSync
1119
1223
  include Aws::Structure
1120
1224
  end
1121
1225
 
1226
+ # The credentials that provide DataSync Discovery read access to your
1227
+ # on-premises storage system's management interface.
1228
+ #
1229
+ # DataSync Discovery stores these credentials in [Secrets Manager][1].
1230
+ # For more information, see [Accessing your on-premises storage
1231
+ # system][2].
1232
+ #
1233
+ #
1234
+ #
1235
+ # [1]: https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html
1236
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-configure-storage.html
1237
+ #
1238
+ # @!attribute [rw] username
1239
+ # Specifies the user name for your storage system's management
1240
+ # interface.
1241
+ # @return [String]
1242
+ #
1243
+ # @!attribute [rw] password
1244
+ # Specifies the password for your storage system's management
1245
+ # interface.
1246
+ # @return [String]
1247
+ #
1248
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/Credentials AWS API Documentation
1249
+ #
1250
+ class Credentials < Struct.new(
1251
+ :username,
1252
+ :password)
1253
+ SENSITIVE = [:username, :password]
1254
+ include Aws::Structure
1255
+ end
1256
+
1122
1257
  # DeleteAgentRequest
1123
1258
  #
1124
1259
  # @!attribute [rw] agent_arn
@@ -1244,6 +1379,62 @@ module Aws::DataSync
1244
1379
  include Aws::Structure
1245
1380
  end
1246
1381
 
1382
+ # @!attribute [rw] discovery_job_arn
1383
+ # Specifies the Amazon Resource Name (ARN) of the discovery job that
1384
+ # you want information about.
1385
+ # @return [String]
1386
+ #
1387
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeDiscoveryJobRequest AWS API Documentation
1388
+ #
1389
+ class DescribeDiscoveryJobRequest < Struct.new(
1390
+ :discovery_job_arn)
1391
+ SENSITIVE = []
1392
+ include Aws::Structure
1393
+ end
1394
+
1395
+ # @!attribute [rw] storage_system_arn
1396
+ # The ARN of the on-premises storage system you're running the
1397
+ # discovery job on.
1398
+ # @return [String]
1399
+ #
1400
+ # @!attribute [rw] discovery_job_arn
1401
+ # The ARN of the discovery job.
1402
+ # @return [String]
1403
+ #
1404
+ # @!attribute [rw] collection_duration_minutes
1405
+ # The number of minutes that the discovery job runs.
1406
+ # @return [Integer]
1407
+ #
1408
+ # @!attribute [rw] status
1409
+ # Indicates the status of a discovery job. For more information, see
1410
+ # [Discovery job statuses][1].
1411
+ #
1412
+ #
1413
+ #
1414
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-job-statuses.html#discovery-job-statuses-table
1415
+ # @return [String]
1416
+ #
1417
+ # @!attribute [rw] job_start_time
1418
+ # The time when the discovery job started.
1419
+ # @return [Time]
1420
+ #
1421
+ # @!attribute [rw] job_end_time
1422
+ # The time when the discovery job ended.
1423
+ # @return [Time]
1424
+ #
1425
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeDiscoveryJobResponse AWS API Documentation
1426
+ #
1427
+ class DescribeDiscoveryJobResponse < Struct.new(
1428
+ :storage_system_arn,
1429
+ :discovery_job_arn,
1430
+ :collection_duration_minutes,
1431
+ :status,
1432
+ :job_start_time,
1433
+ :job_end_time)
1434
+ SENSITIVE = []
1435
+ include Aws::Structure
1436
+ end
1437
+
1247
1438
  # DescribeLocationEfsRequest
1248
1439
  #
1249
1440
  # @!attribute [rw] location_arn
@@ -1857,6 +2048,239 @@ module Aws::DataSync
1857
2048
  include Aws::Structure
1858
2049
  end
1859
2050
 
2051
+ # @!attribute [rw] storage_system_arn
2052
+ # Specifies the Amazon Resource Name (ARN) of an on-premises storage
2053
+ # system that you're using with DataSync Discovery.
2054
+ # @return [String]
2055
+ #
2056
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemRequest AWS API Documentation
2057
+ #
2058
+ class DescribeStorageSystemRequest < Struct.new(
2059
+ :storage_system_arn)
2060
+ SENSITIVE = []
2061
+ include Aws::Structure
2062
+ end
2063
+
2064
+ # @!attribute [rw] discovery_job_arn
2065
+ # Specifies the Amazon Resource Name (ARN) of the discovery job that
2066
+ # collects information about your on-premises storage system.
2067
+ # @return [String]
2068
+ #
2069
+ # @!attribute [rw] resource_type
2070
+ # Specifies the kind of storage system resource that you want
2071
+ # information about.
2072
+ # @return [String]
2073
+ #
2074
+ # @!attribute [rw] resource_id
2075
+ # Specifies the universally unique identifier (UUID) of the storage
2076
+ # system resource that you want information about.
2077
+ # @return [String]
2078
+ #
2079
+ # @!attribute [rw] start_time
2080
+ # Specifies a time within the total duration that the discovery job
2081
+ # ran. To see information gathered during a certain time frame, use
2082
+ # this parameter with `EndTime`.
2083
+ # @return [Time]
2084
+ #
2085
+ # @!attribute [rw] end_time
2086
+ # Specifies a time within the total duration that the discovery job
2087
+ # ran. To see information gathered during a certain time frame, use
2088
+ # this parameter with `StartTime`.
2089
+ # @return [Time]
2090
+ #
2091
+ # @!attribute [rw] max_results
2092
+ # Specifies how many results that you want in the response.
2093
+ # @return [Integer]
2094
+ #
2095
+ # @!attribute [rw] next_token
2096
+ # Specifies an opaque string that indicates the position to begin the
2097
+ # next list of results in the response.
2098
+ # @return [String]
2099
+ #
2100
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemResourceMetricsRequest AWS API Documentation
2101
+ #
2102
+ class DescribeStorageSystemResourceMetricsRequest < Struct.new(
2103
+ :discovery_job_arn,
2104
+ :resource_type,
2105
+ :resource_id,
2106
+ :start_time,
2107
+ :end_time,
2108
+ :max_results,
2109
+ :next_token)
2110
+ SENSITIVE = []
2111
+ include Aws::Structure
2112
+ end
2113
+
2114
+ # @!attribute [rw] metrics
2115
+ # The details that your discovery job collected about your storage
2116
+ # system resource.
2117
+ # @return [Array<Types::ResourceMetrics>]
2118
+ #
2119
+ # @!attribute [rw] next_token
2120
+ # The opaque string that indicates the position to begin the next list
2121
+ # of results in the response.
2122
+ # @return [String]
2123
+ #
2124
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemResourceMetricsResponse AWS API Documentation
2125
+ #
2126
+ class DescribeStorageSystemResourceMetricsResponse < Struct.new(
2127
+ :metrics,
2128
+ :next_token)
2129
+ SENSITIVE = []
2130
+ include Aws::Structure
2131
+ end
2132
+
2133
+ # @!attribute [rw] discovery_job_arn
2134
+ # Specifies the Amazon Resource Name (ARN) of the discovery job
2135
+ # that's collecting data from your on-premises storage system.
2136
+ # @return [String]
2137
+ #
2138
+ # @!attribute [rw] resource_type
2139
+ # Specifies what kind of storage system resources that you want
2140
+ # information about.
2141
+ # @return [String]
2142
+ #
2143
+ # @!attribute [rw] resource_ids
2144
+ # Specifies the universally unique identifiers (UUIDs) of the storage
2145
+ # system resources that you want information about. You can't use
2146
+ # this parameter in combination with the `Filter` parameter.
2147
+ # @return [Array<String>]
2148
+ #
2149
+ # @!attribute [rw] filter
2150
+ # Filters the storage system resources that you want returned. For
2151
+ # example, this might be volumes associated with a specific storage
2152
+ # virtual machine (SVM).
2153
+ # @return [Hash<String,Array<String>>]
2154
+ #
2155
+ # @!attribute [rw] max_results
2156
+ # Specifies the maximum number of storage system resources that you
2157
+ # want to list in a response.
2158
+ # @return [Integer]
2159
+ #
2160
+ # @!attribute [rw] next_token
2161
+ # Specifies an opaque string that indicates the position to begin the
2162
+ # next list of results in the response.
2163
+ # @return [String]
2164
+ #
2165
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemResourcesRequest AWS API Documentation
2166
+ #
2167
+ class DescribeStorageSystemResourcesRequest < Struct.new(
2168
+ :discovery_job_arn,
2169
+ :resource_type,
2170
+ :resource_ids,
2171
+ :filter,
2172
+ :max_results,
2173
+ :next_token)
2174
+ SENSITIVE = []
2175
+ include Aws::Structure
2176
+ end
2177
+
2178
+ # @!attribute [rw] resource_details
2179
+ # The information collected about your storage system's resources. A
2180
+ # response can also include Amazon Web Services storage service
2181
+ # recommendations.
2182
+ #
2183
+ # For more information, see [storage resource information][1]
2184
+ # collected by and [recommendations][2] provided by DataSync
2185
+ # Discovery.
2186
+ #
2187
+ #
2188
+ #
2189
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-understand-findings.html
2190
+ # [2]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-understand-recommendations.html
2191
+ # @return [Types::ResourceDetails]
2192
+ #
2193
+ # @!attribute [rw] next_token
2194
+ # The opaque string that indicates the position to begin the next list
2195
+ # of results in the response.
2196
+ # @return [String]
2197
+ #
2198
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemResourcesResponse AWS API Documentation
2199
+ #
2200
+ class DescribeStorageSystemResourcesResponse < Struct.new(
2201
+ :resource_details,
2202
+ :next_token)
2203
+ SENSITIVE = []
2204
+ include Aws::Structure
2205
+ end
2206
+
2207
+ # @!attribute [rw] storage_system_arn
2208
+ # The ARN of the on-premises storage system that the discovery job
2209
+ # looked at.
2210
+ # @return [String]
2211
+ #
2212
+ # @!attribute [rw] server_configuration
2213
+ # The server name and network port required to connect with your
2214
+ # on-premises storage system's management interface.
2215
+ # @return [Types::DiscoveryServerConfiguration]
2216
+ #
2217
+ # @!attribute [rw] system_type
2218
+ # The type of on-premises storage system.
2219
+ #
2220
+ # <note markdown="1"> DataSync Discovery currently only supports NetApp Fabric-Attached
2221
+ # Storage (FAS) and All Flash FAS (AFF) systems running ONTAP 9.7 or
2222
+ # later.
2223
+ #
2224
+ # </note>
2225
+ # @return [String]
2226
+ #
2227
+ # @!attribute [rw] agent_arns
2228
+ # The ARN of the DataSync agent that connects to and reads from your
2229
+ # on-premises storage system.
2230
+ # @return [Array<String>]
2231
+ #
2232
+ # @!attribute [rw] name
2233
+ # The name that you gave your on-premises storage system when adding
2234
+ # it to DataSync Discovery.
2235
+ # @return [String]
2236
+ #
2237
+ # @!attribute [rw] error_message
2238
+ # Describes the connectivity error that the DataSync agent is
2239
+ # encountering with your on-premises storage system.
2240
+ # @return [String]
2241
+ #
2242
+ # @!attribute [rw] connectivity_status
2243
+ # Indicates whether your DataSync agent can connect to your
2244
+ # on-premises storage system.
2245
+ # @return [String]
2246
+ #
2247
+ # @!attribute [rw] cloud_watch_log_group_arn
2248
+ # The ARN of the Amazon CloudWatch log group that's used to monitor
2249
+ # and log discovery job events.
2250
+ # @return [String]
2251
+ #
2252
+ # @!attribute [rw] creation_time
2253
+ # The time when you added the on-premises storage system to DataSync
2254
+ # Discovery.
2255
+ # @return [Time]
2256
+ #
2257
+ # @!attribute [rw] secrets_manager_arn
2258
+ # The ARN of the secret that stores your on-premises storage system's
2259
+ # credentials. DataSync Discovery stores these credentials in [Secrets
2260
+ # Manager][1].
2261
+ #
2262
+ #
2263
+ #
2264
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-configure-storage.html#discovery-add-storage
2265
+ # @return [String]
2266
+ #
2267
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DescribeStorageSystemResponse AWS API Documentation
2268
+ #
2269
+ class DescribeStorageSystemResponse < Struct.new(
2270
+ :storage_system_arn,
2271
+ :server_configuration,
2272
+ :system_type,
2273
+ :agent_arns,
2274
+ :name,
2275
+ :error_message,
2276
+ :connectivity_status,
2277
+ :cloud_watch_log_group_arn,
2278
+ :creation_time,
2279
+ :secrets_manager_arn)
2280
+ SENSITIVE = []
2281
+ include Aws::Structure
2282
+ end
2283
+
1860
2284
  # DescribeTaskExecutionRequest
1861
2285
  #
1862
2286
  # @!attribute [rw] task_execution_arn
@@ -2145,6 +2569,52 @@ module Aws::DataSync
2145
2569
  include Aws::Structure
2146
2570
  end
2147
2571
 
2572
+ # The details about a specific DataSync discovery job.
2573
+ #
2574
+ # @!attribute [rw] discovery_job_arn
2575
+ # The Amazon Resource Name (ARN) of a discovery job.
2576
+ # @return [String]
2577
+ #
2578
+ # @!attribute [rw] status
2579
+ # The status of a discovery job. For more information, see [Discovery
2580
+ # job statuses][1].
2581
+ #
2582
+ #
2583
+ #
2584
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-job-statuses.html#discovery-job-statuses-table
2585
+ # @return [String]
2586
+ #
2587
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DiscoveryJobListEntry AWS API Documentation
2588
+ #
2589
+ class DiscoveryJobListEntry < Struct.new(
2590
+ :discovery_job_arn,
2591
+ :status)
2592
+ SENSITIVE = []
2593
+ include Aws::Structure
2594
+ end
2595
+
2596
+ # The network settings that DataSync Discovery uses to connect with your
2597
+ # on-premises storage system's management interface.
2598
+ #
2599
+ # @!attribute [rw] server_hostname
2600
+ # The domain name or IP address of your storage system's management
2601
+ # interface.
2602
+ # @return [String]
2603
+ #
2604
+ # @!attribute [rw] server_port
2605
+ # The network port for accessing the storage system's management
2606
+ # interface.
2607
+ # @return [Integer]
2608
+ #
2609
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/DiscoveryServerConfiguration AWS API Documentation
2610
+ #
2611
+ class DiscoveryServerConfiguration < Struct.new(
2612
+ :server_hostname,
2613
+ :server_port)
2614
+ SENSITIVE = []
2615
+ include Aws::Structure
2616
+ end
2617
+
2148
2618
  # The subnet and security groups that DataSync uses to access your
2149
2619
  # Amazon EFS file system.
2150
2620
  #
@@ -2287,11 +2757,11 @@ module Aws::DataSync
2287
2757
  # Make sure that the user has the permissions it needs to copy the
2288
2758
  # data you want:
2289
2759
  #
2290
- # * `SE_TCB_NAME`\: Required to set object ownership and file
2291
- # metadata. With this privilege, you also can copy NTFS
2292
- # discretionary access lists (DACLs).
2760
+ # * `SE_TCB_NAME`: Required to set object ownership and file metadata.
2761
+ # With this privilege, you also can copy NTFS discretionary access
2762
+ # lists (DACLs).
2293
2763
  #
2294
- # * `SE_SECURITY_NAME`\: May be needed to copy NTFS system access
2764
+ # * `SE_SECURITY_NAME`: May be needed to copy NTFS system access
2295
2765
  # control lists (SACLs). This operation specifically requires the
2296
2766
  # Windows privilege, which is granted to members of the Domain
2297
2767
  # Admins group. If you configure your task to copy SACLs, make sure
@@ -2314,15 +2784,44 @@ module Aws::DataSync
2314
2784
  include Aws::Structure
2315
2785
  end
2316
2786
 
2317
- # The NameNode of the Hadoop Distributed File System (HDFS). The
2318
- # NameNode manages the file system's namespace. The NameNode performs
2319
- # operations such as opening, closing, and renaming files and
2320
- # directories. The NameNode contains the information to map blocks of
2321
- # data to the DataNodes.
2787
+ # @!attribute [rw] discovery_job_arn
2788
+ # Specifies the Amazon Resource Name (ARN) of the discovery job that
2789
+ # collects information about your on-premises storage system.
2790
+ # @return [String]
2322
2791
  #
2323
- # @!attribute [rw] hostname
2324
- # The hostname of the NameNode in the HDFS cluster. This value is the
2325
- # IP address or Domain Name Service (DNS) name of the NameNode. An
2792
+ # @!attribute [rw] resource_ids
2793
+ # Specifies the universally unique identifiers (UUIDs) of the
2794
+ # resources in your storage system that you want recommendations on.
2795
+ # @return [Array<String>]
2796
+ #
2797
+ # @!attribute [rw] resource_type
2798
+ # Specifies the type of resource in your storage system that you want
2799
+ # recommendations on.
2800
+ # @return [String]
2801
+ #
2802
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/GenerateRecommendationsRequest AWS API Documentation
2803
+ #
2804
+ class GenerateRecommendationsRequest < Struct.new(
2805
+ :discovery_job_arn,
2806
+ :resource_ids,
2807
+ :resource_type)
2808
+ SENSITIVE = []
2809
+ include Aws::Structure
2810
+ end
2811
+
2812
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/GenerateRecommendationsResponse AWS API Documentation
2813
+ #
2814
+ class GenerateRecommendationsResponse < Aws::EmptyStructure; end
2815
+
2816
+ # The NameNode of the Hadoop Distributed File System (HDFS). The
2817
+ # NameNode manages the file system's namespace. The NameNode performs
2818
+ # operations such as opening, closing, and renaming files and
2819
+ # directories. The NameNode contains the information to map blocks of
2820
+ # data to the DataNodes.
2821
+ #
2822
+ # @!attribute [rw] hostname
2823
+ # The hostname of the NameNode in the HDFS cluster. This value is the
2824
+ # IP address or Domain Name Service (DNS) name of the NameNode. An
2326
2825
  # agent that's installed on-premises uses this hostname to
2327
2826
  # communicate with the NameNode in the network.
2328
2827
  # @return [String]
@@ -2340,6 +2839,37 @@ module Aws::DataSync
2340
2839
  include Aws::Structure
2341
2840
  end
2342
2841
 
2842
+ # The IOPS peaks for an on-premises storage system resource. Each data
2843
+ # point represents the 95th percentile peak value during a 1-hour
2844
+ # interval.
2845
+ #
2846
+ # @!attribute [rw] read
2847
+ # Peak IOPS related to read operations.
2848
+ # @return [Float]
2849
+ #
2850
+ # @!attribute [rw] write
2851
+ # Peak IOPS related to write operations.
2852
+ # @return [Float]
2853
+ #
2854
+ # @!attribute [rw] other
2855
+ # Peak IOPS unrelated to read and write operations.
2856
+ # @return [Float]
2857
+ #
2858
+ # @!attribute [rw] total
2859
+ # Peak total IOPS on your on-premises storage system resource.
2860
+ # @return [Float]
2861
+ #
2862
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/IOPS AWS API Documentation
2863
+ #
2864
+ class IOPS < Struct.new(
2865
+ :read,
2866
+ :write,
2867
+ :other,
2868
+ :total)
2869
+ SENSITIVE = []
2870
+ include Aws::Structure
2871
+ end
2872
+
2343
2873
  # This exception is thrown when an error occurs in the DataSync service.
2344
2874
  #
2345
2875
  # @!attribute [rw] message
@@ -2378,6 +2908,32 @@ module Aws::DataSync
2378
2908
  include Aws::Structure
2379
2909
  end
2380
2910
 
2911
+ # The latency peaks for an on-premises storage system resource. Each
2912
+ # data point represents the 95th percentile peak value during a 1-hour
2913
+ # interval.
2914
+ #
2915
+ # @!attribute [rw] read
2916
+ # Peak latency for read operations.
2917
+ # @return [Float]
2918
+ #
2919
+ # @!attribute [rw] write
2920
+ # Peak latency for write operations.
2921
+ # @return [Float]
2922
+ #
2923
+ # @!attribute [rw] other
2924
+ # Peak latency for operations unrelated to read and write operations.
2925
+ # @return [Float]
2926
+ #
2927
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/Latency AWS API Documentation
2928
+ #
2929
+ class Latency < Struct.new(
2930
+ :read,
2931
+ :write,
2932
+ :other)
2933
+ SENSITIVE = []
2934
+ include Aws::Structure
2935
+ end
2936
+
2381
2937
  # ListAgentsRequest
2382
2938
  #
2383
2939
  # @!attribute [rw] max_results
@@ -2421,6 +2977,49 @@ module Aws::DataSync
2421
2977
  include Aws::Structure
2422
2978
  end
2423
2979
 
2980
+ # @!attribute [rw] storage_system_arn
2981
+ # Specifies the Amazon Resource Name (ARN) of an on-premises storage
2982
+ # system. Use this parameter if you only want to list the discovery
2983
+ # jobs that are associated with a specific storage system.
2984
+ # @return [String]
2985
+ #
2986
+ # @!attribute [rw] max_results
2987
+ # Specifies how many results you want in the response.
2988
+ # @return [Integer]
2989
+ #
2990
+ # @!attribute [rw] next_token
2991
+ # Specifies an opaque string that indicates the position to begin the
2992
+ # next list of results in the response.
2993
+ # @return [String]
2994
+ #
2995
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListDiscoveryJobsRequest AWS API Documentation
2996
+ #
2997
+ class ListDiscoveryJobsRequest < Struct.new(
2998
+ :storage_system_arn,
2999
+ :max_results,
3000
+ :next_token)
3001
+ SENSITIVE = []
3002
+ include Aws::Structure
3003
+ end
3004
+
3005
+ # @!attribute [rw] discovery_jobs
3006
+ # The discovery jobs that you've run.
3007
+ # @return [Array<Types::DiscoveryJobListEntry>]
3008
+ #
3009
+ # @!attribute [rw] next_token
3010
+ # The opaque string that indicates the position to begin the next list
3011
+ # of results in the response.
3012
+ # @return [String]
3013
+ #
3014
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListDiscoveryJobsResponse AWS API Documentation
3015
+ #
3016
+ class ListDiscoveryJobsResponse < Struct.new(
3017
+ :discovery_jobs,
3018
+ :next_token)
3019
+ SENSITIVE = []
3020
+ include Aws::Structure
3021
+ end
3022
+
2424
3023
  # ListLocationsRequest
2425
3024
  #
2426
3025
  # @!attribute [rw] max_results
@@ -2469,6 +3068,43 @@ module Aws::DataSync
2469
3068
  include Aws::Structure
2470
3069
  end
2471
3070
 
3071
+ # @!attribute [rw] max_results
3072
+ # Specifies how many results you want in the response.
3073
+ # @return [Integer]
3074
+ #
3075
+ # @!attribute [rw] next_token
3076
+ # Specifies an opaque string that indicates the position to begin the
3077
+ # next list of results in the response.
3078
+ # @return [String]
3079
+ #
3080
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListStorageSystemsRequest AWS API Documentation
3081
+ #
3082
+ class ListStorageSystemsRequest < Struct.new(
3083
+ :max_results,
3084
+ :next_token)
3085
+ SENSITIVE = []
3086
+ include Aws::Structure
3087
+ end
3088
+
3089
+ # @!attribute [rw] storage_systems
3090
+ # The Amazon Resource Names ARNs) of the on-premises storage systems
3091
+ # that you're using with DataSync Discovery.
3092
+ # @return [Array<Types::StorageSystemListEntry>]
3093
+ #
3094
+ # @!attribute [rw] next_token
3095
+ # The opaque string that indicates the position to begin the next list
3096
+ # of results in the response.
3097
+ # @return [String]
3098
+ #
3099
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ListStorageSystemsResponse AWS API Documentation
3100
+ #
3101
+ class ListStorageSystemsResponse < Struct.new(
3102
+ :storage_systems,
3103
+ :next_token)
3104
+ SENSITIVE = []
3105
+ include Aws::Structure
3106
+ end
3107
+
2472
3108
  # ListTagsForResourceRequest
2473
3109
  #
2474
3110
  # @!attribute [rw] resource_arn
@@ -2697,6 +3333,333 @@ module Aws::DataSync
2697
3333
  include Aws::Structure
2698
3334
  end
2699
3335
 
3336
+ # The performance data that DataSync Discovery collects about an
3337
+ # on-premises storage system resource.
3338
+ #
3339
+ # @!attribute [rw] iops_read
3340
+ # Peak IOPS related to read operations.
3341
+ # @return [Float]
3342
+ #
3343
+ # @!attribute [rw] iops_write
3344
+ # Peak IOPS related to write operations.
3345
+ # @return [Float]
3346
+ #
3347
+ # @!attribute [rw] iops_other
3348
+ # Peak IOPS unrelated to read and write operations.
3349
+ # @return [Float]
3350
+ #
3351
+ # @!attribute [rw] iops_total
3352
+ # Peak total IOPS on your on-premises storage system resource.
3353
+ # @return [Float]
3354
+ #
3355
+ # @!attribute [rw] throughput_read
3356
+ # Peak throughput related to read operations.
3357
+ # @return [Float]
3358
+ #
3359
+ # @!attribute [rw] throughput_write
3360
+ # Peak throughput related to write operations.
3361
+ # @return [Float]
3362
+ #
3363
+ # @!attribute [rw] throughput_other
3364
+ # Peak throughput unrelated to read and write operations.
3365
+ # @return [Float]
3366
+ #
3367
+ # @!attribute [rw] throughput_total
3368
+ # Peak total throughput on your on-premises storage system resource.
3369
+ # @return [Float]
3370
+ #
3371
+ # @!attribute [rw] latency_read
3372
+ # Peak latency for read operations.
3373
+ # @return [Float]
3374
+ #
3375
+ # @!attribute [rw] latency_write
3376
+ # Peak latency for write operations.
3377
+ # @return [Float]
3378
+ #
3379
+ # @!attribute [rw] latency_other
3380
+ # Peak latency for operations unrelated to read and write operations.
3381
+ # @return [Float]
3382
+ #
3383
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/MaxP95Performance AWS API Documentation
3384
+ #
3385
+ class MaxP95Performance < Struct.new(
3386
+ :iops_read,
3387
+ :iops_write,
3388
+ :iops_other,
3389
+ :iops_total,
3390
+ :throughput_read,
3391
+ :throughput_write,
3392
+ :throughput_other,
3393
+ :throughput_total,
3394
+ :latency_read,
3395
+ :latency_write,
3396
+ :latency_other)
3397
+ SENSITIVE = []
3398
+ include Aws::Structure
3399
+ end
3400
+
3401
+ # The information that DataSync Discovery collects about an on-premises
3402
+ # storage system cluster.
3403
+ #
3404
+ # @!attribute [rw] cifs_share_count
3405
+ # The number of CIFS shares in the cluster.
3406
+ # @return [Integer]
3407
+ #
3408
+ # @!attribute [rw] nfs_exported_volumes
3409
+ # The number of NFS volumes in the cluster.
3410
+ # @return [Integer]
3411
+ #
3412
+ # @!attribute [rw] resource_id
3413
+ # The universally unique identifier (UUID) of the cluster.
3414
+ # @return [String]
3415
+ #
3416
+ # @!attribute [rw] cluster_name
3417
+ # The name of the cluster.
3418
+ # @return [String]
3419
+ #
3420
+ # @!attribute [rw] max_p95_performance
3421
+ # The performance data that DataSync Discovery collects about the
3422
+ # cluster.
3423
+ # @return [Types::MaxP95Performance]
3424
+ #
3425
+ # @!attribute [rw] cluster_block_storage_size
3426
+ # The total storage space that's available in the cluster.
3427
+ # @return [Integer]
3428
+ #
3429
+ # @!attribute [rw] cluster_block_storage_used
3430
+ # The storage space that's being used in a cluster.
3431
+ # @return [Integer]
3432
+ #
3433
+ # @!attribute [rw] cluster_block_storage_logical_used
3434
+ # The storage space that's being used in the cluster without
3435
+ # accounting for compression or deduplication.
3436
+ # @return [Integer]
3437
+ #
3438
+ # @!attribute [rw] recommendations
3439
+ # The Amazon Web Services storage services that DataSync Discovery
3440
+ # recommends for the cluster. For more information, see
3441
+ # [Recommendations provided by DataSync Discovery][1].
3442
+ #
3443
+ #
3444
+ #
3445
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-understand-recommendations.html
3446
+ # @return [Array<Types::Recommendation>]
3447
+ #
3448
+ # @!attribute [rw] recommendation_status
3449
+ # Indicates whether DataSync Discovery recommendations for the cluster
3450
+ # are ready to view, incomplete, or can't be determined.
3451
+ #
3452
+ # For more information, see [Recommendation statuses][1].
3453
+ #
3454
+ #
3455
+ #
3456
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-job-statuses.html#recommendation-statuses-table
3457
+ # @return [String]
3458
+ #
3459
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/NetAppONTAPCluster AWS API Documentation
3460
+ #
3461
+ class NetAppONTAPCluster < Struct.new(
3462
+ :cifs_share_count,
3463
+ :nfs_exported_volumes,
3464
+ :resource_id,
3465
+ :cluster_name,
3466
+ :max_p95_performance,
3467
+ :cluster_block_storage_size,
3468
+ :cluster_block_storage_used,
3469
+ :cluster_block_storage_logical_used,
3470
+ :recommendations,
3471
+ :recommendation_status)
3472
+ SENSITIVE = []
3473
+ include Aws::Structure
3474
+ end
3475
+
3476
+ # The information that DataSync Discovery collects about a storage
3477
+ # virtual machine (SVM) in your on-premises storage system.
3478
+ #
3479
+ # @!attribute [rw] cluster_uuid
3480
+ # The universally unique identifier (UUID) of the cluster associated
3481
+ # with the SVM.
3482
+ # @return [String]
3483
+ #
3484
+ # @!attribute [rw] resource_id
3485
+ # The UUID of the SVM.
3486
+ # @return [String]
3487
+ #
3488
+ # @!attribute [rw] svm_name
3489
+ # The name of the SVM
3490
+ # @return [String]
3491
+ #
3492
+ # @!attribute [rw] cifs_share_count
3493
+ # The number of CIFS shares in the SVM.
3494
+ # @return [Integer]
3495
+ #
3496
+ # @!attribute [rw] enabled_protocols
3497
+ # The data transfer protocols (such as NFS) configured for the SVM.
3498
+ # @return [Array<String>]
3499
+ #
3500
+ # @!attribute [rw] total_capacity_used
3501
+ # The storage space that's being used in the SVM.
3502
+ # @return [Integer]
3503
+ #
3504
+ # @!attribute [rw] total_capacity_provisioned
3505
+ # The total storage space that's available in the SVM.
3506
+ # @return [Integer]
3507
+ #
3508
+ # @!attribute [rw] total_logical_capacity_used
3509
+ # The storage space that's being used in the SVM without accounting
3510
+ # for compression or deduplication.
3511
+ # @return [Integer]
3512
+ #
3513
+ # @!attribute [rw] max_p95_performance
3514
+ # The performance data that DataSync Discovery collects about the SVM.
3515
+ # @return [Types::MaxP95Performance]
3516
+ #
3517
+ # @!attribute [rw] recommendations
3518
+ # The Amazon Web Services storage services that DataSync Discovery
3519
+ # recommends for the SVM. For more information, see [Recommendations
3520
+ # provided by DataSync Discovery][1].
3521
+ #
3522
+ #
3523
+ #
3524
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-understand-recommendations.html
3525
+ # @return [Array<Types::Recommendation>]
3526
+ #
3527
+ # @!attribute [rw] nfs_exported_volumes
3528
+ # The number of NFS volumes in the SVM.
3529
+ # @return [Integer]
3530
+ #
3531
+ # @!attribute [rw] recommendation_status
3532
+ # Indicates whether DataSync Discovery recommendations for the SVM are
3533
+ # ready to view, incomplete, or can't be determined.
3534
+ #
3535
+ # For more information, see [Recommendation statuses][1].
3536
+ #
3537
+ #
3538
+ #
3539
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-job-statuses.html#recommendation-statuses-table
3540
+ # @return [String]
3541
+ #
3542
+ # @!attribute [rw] total_snapshot_capacity_used
3543
+ # The amount of storage in the SVM that's being used for snapshots.
3544
+ # @return [Integer]
3545
+ #
3546
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/NetAppONTAPSVM AWS API Documentation
3547
+ #
3548
+ class NetAppONTAPSVM < Struct.new(
3549
+ :cluster_uuid,
3550
+ :resource_id,
3551
+ :svm_name,
3552
+ :cifs_share_count,
3553
+ :enabled_protocols,
3554
+ :total_capacity_used,
3555
+ :total_capacity_provisioned,
3556
+ :total_logical_capacity_used,
3557
+ :max_p95_performance,
3558
+ :recommendations,
3559
+ :nfs_exported_volumes,
3560
+ :recommendation_status,
3561
+ :total_snapshot_capacity_used)
3562
+ SENSITIVE = []
3563
+ include Aws::Structure
3564
+ end
3565
+
3566
+ # The information that DataSync Discovery collects about a volume in
3567
+ # your on-premises storage system.
3568
+ #
3569
+ # @!attribute [rw] volume_name
3570
+ # The name of the volume.
3571
+ # @return [String]
3572
+ #
3573
+ # @!attribute [rw] resource_id
3574
+ # The universally unique identifier (UUID) of the volume.
3575
+ # @return [String]
3576
+ #
3577
+ # @!attribute [rw] cifs_share_count
3578
+ # The number of CIFS shares in the volume.
3579
+ # @return [Integer]
3580
+ #
3581
+ # @!attribute [rw] security_style
3582
+ # The volume's security style (such as Unix or NTFS).
3583
+ # @return [String]
3584
+ #
3585
+ # @!attribute [rw] svm_uuid
3586
+ # The UUID of the storage virtual machine (SVM) associated with the
3587
+ # volume.
3588
+ # @return [String]
3589
+ #
3590
+ # @!attribute [rw] svm_name
3591
+ # The name of the SVM associated with the volume.
3592
+ # @return [String]
3593
+ #
3594
+ # @!attribute [rw] capacity_used
3595
+ # The storage space that's being used in the volume.
3596
+ # @return [Integer]
3597
+ #
3598
+ # @!attribute [rw] capacity_provisioned
3599
+ # The total storage space that's available in the volume.
3600
+ # @return [Integer]
3601
+ #
3602
+ # @!attribute [rw] logical_capacity_used
3603
+ # The storage space that's being used in the volume without
3604
+ # accounting for compression or deduplication.
3605
+ # @return [Integer]
3606
+ #
3607
+ # @!attribute [rw] nfs_exported
3608
+ # The number of NFS volumes in the volume.
3609
+ # @return [Boolean]
3610
+ #
3611
+ # @!attribute [rw] snapshot_capacity_used
3612
+ # The amount of storage in the volume that's being used for
3613
+ # snapshots.
3614
+ # @return [Integer]
3615
+ #
3616
+ # @!attribute [rw] max_p95_performance
3617
+ # The performance data that DataSync Discovery collects about the
3618
+ # volume.
3619
+ # @return [Types::MaxP95Performance]
3620
+ #
3621
+ # @!attribute [rw] recommendations
3622
+ # The Amazon Web Services storage services that DataSync Discovery
3623
+ # recommends for the volume. For more information, see
3624
+ # [Recommendations provided by DataSync Discovery][1].
3625
+ #
3626
+ #
3627
+ #
3628
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-understand-recommendations.html
3629
+ # @return [Array<Types::Recommendation>]
3630
+ #
3631
+ # @!attribute [rw] recommendation_status
3632
+ # Indicates whether DataSync Discovery recommendations for the volume
3633
+ # are ready to view, incomplete, or can't be determined.
3634
+ #
3635
+ # For more information, see [Recommendation statuses][1].
3636
+ #
3637
+ #
3638
+ #
3639
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-job-statuses.html#recommendation-statuses-table
3640
+ # @return [String]
3641
+ #
3642
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/NetAppONTAPVolume AWS API Documentation
3643
+ #
3644
+ class NetAppONTAPVolume < Struct.new(
3645
+ :volume_name,
3646
+ :resource_id,
3647
+ :cifs_share_count,
3648
+ :security_style,
3649
+ :svm_uuid,
3650
+ :svm_name,
3651
+ :capacity_used,
3652
+ :capacity_provisioned,
3653
+ :logical_capacity_used,
3654
+ :nfs_exported,
3655
+ :snapshot_capacity_used,
3656
+ :max_p95_performance,
3657
+ :recommendations,
3658
+ :recommendation_status)
3659
+ SENSITIVE = []
3660
+ include Aws::Structure
3661
+ end
3662
+
2700
3663
  # Specifies how DataSync can access a location using the NFS protocol.
2701
3664
  #
2702
3665
  # @!attribute [rw] version
@@ -2708,13 +3671,13 @@ module Aws::DataSync
2708
3671
  #
2709
3672
  # * `AUTOMATIC` (default): DataSync chooses NFS version 4.1.
2710
3673
  #
2711
- # * `NFS3`\: Stateless protocol version that allows for asynchronous
3674
+ # * `NFS3`: Stateless protocol version that allows for asynchronous
2712
3675
  # writes on the server.
2713
3676
  #
2714
- # * `NFSv4_0`\: Stateful, firewall-friendly protocol version that
3677
+ # * `NFSv4_0`: Stateful, firewall-friendly protocol version that
2715
3678
  # supports delegations and pseudo file systems.
2716
3679
  #
2717
- # * `NFSv4_1`\: Stateful protocol version that supports sessions,
3680
+ # * `NFSv4_1`: Stateful protocol version that supports sessions,
2718
3681
  # directory delegations, and parallel data processing. NFS version
2719
3682
  # 4.1 also includes all features available in version 4.0.
2720
3683
  #
@@ -2771,7 +3734,7 @@ module Aws::DataSync
2771
3734
  # information, see [Storage class considerations with Amazon S3
2772
3735
  # locations][1].
2773
3736
  #
2774
- # `POINT_IN_TIME_CONSISTENT`\: At the end of the transfer, DataSync
3737
+ # `POINT_IN_TIME_CONSISTENT`: At the end of the transfer, DataSync
2775
3738
  # scans the entire source and destination to verify that both
2776
3739
  # locations are fully synchronized.
2777
3740
  #
@@ -2780,7 +3743,7 @@ module Aws::DataSync
2780
3743
  # information, see [Storage class considerations with Amazon S3
2781
3744
  # locations][1].
2782
3745
  #
2783
- # `NONE`\: DataSync doesn't run additional verification at the end of
3746
+ # `NONE`: DataSync doesn't run additional verification at the end of
2784
3747
  # the transfer. All data transmissions are still integrity-checked
2785
3748
  # with checksum verification during the transfer.
2786
3749
  #
@@ -2821,10 +3784,10 @@ module Aws::DataSync
2821
3784
  #
2822
3785
  # Default value: `BEST_EFFORT`
2823
3786
  #
2824
- # `BEST_EFFORT`\: Attempt to preserve the per-file `Atime` value
3787
+ # `BEST_EFFORT`: Attempt to preserve the per-file `Atime` value
2825
3788
  # (recommended).
2826
3789
  #
2827
- # `NONE`\: Ignore `Atime`.
3790
+ # `NONE`: Ignore `Atime`.
2828
3791
  #
2829
3792
  # <note markdown="1"> If `Atime` is set to `BEST_EFFORT`, `Mtime` must be set to
2830
3793
  # `PRESERVE`.
@@ -2842,9 +3805,9 @@ module Aws::DataSync
2842
3805
  #
2843
3806
  # Default Value: `PRESERVE`
2844
3807
  #
2845
- # `PRESERVE`\: Preserve original `Mtime` (recommended)
3808
+ # `PRESERVE`: Preserve original `Mtime` (recommended)
2846
3809
  #
2847
- # `NONE`\: Ignore `Mtime`.
3810
+ # `NONE`: Ignore `Mtime`.
2848
3811
  #
2849
3812
  # <note markdown="1"> If `Mtime` is set to `PRESERVE`, `Atime` must be set to
2850
3813
  # `BEST_EFFORT`.
@@ -2862,10 +3825,10 @@ module Aws::DataSync
2862
3825
  # Default value: `INT_VALUE`. This preserves the integer value of the
2863
3826
  # ID.
2864
3827
  #
2865
- # `INT_VALUE`\: Preserve the integer value of UID and group ID (GID)
3828
+ # `INT_VALUE`: Preserve the integer value of UID and group ID (GID)
2866
3829
  # (recommended).
2867
3830
  #
2868
- # `NONE`\: Ignore UID and GID.
3831
+ # `NONE`: Ignore UID and GID.
2869
3832
  #
2870
3833
  #
2871
3834
  #
@@ -2880,10 +3843,10 @@ module Aws::DataSync
2880
3843
  # Default value: `INT_VALUE`. This preserves the integer value of the
2881
3844
  # ID.
2882
3845
  #
2883
- # `INT_VALUE`\: Preserve the integer value of user ID (UID) and GID
3846
+ # `INT_VALUE`: Preserve the integer value of user ID (UID) and GID
2884
3847
  # (recommended).
2885
3848
  #
2886
- # `NONE`\: Ignore UID and GID.
3849
+ # `NONE`: Ignore UID and GID.
2887
3850
  #
2888
3851
  #
2889
3852
  #
@@ -2900,9 +3863,9 @@ module Aws::DataSync
2900
3863
  #
2901
3864
  # Default value: `PRESERVE`
2902
3865
  #
2903
- # `PRESERVE`\: Ignore such destination files (recommended).
3866
+ # `PRESERVE`: Ignore such destination files (recommended).
2904
3867
  #
2905
- # `REMOVE`\: Delete destination files that aren’t present in the
3868
+ # `REMOVE`: Delete destination files that aren’t present in the
2906
3869
  # source.
2907
3870
  #
2908
3871
  # <note markdown="1"> If you set this parameter to `REMOVE`, you can't set `TransferMode`
@@ -2929,9 +3892,9 @@ module Aws::DataSync
2929
3892
  #
2930
3893
  # Default value: `NONE`
2931
3894
  #
2932
- # `NONE`\: Ignore special devices (recommended).
3895
+ # `NONE`: Ignore special devices (recommended).
2933
3896
  #
2934
- # `PRESERVE`\: Preserve character and block device metadata. This
3897
+ # `PRESERVE`: Preserve character and block device metadata. This
2935
3898
  # option currently isn't supported for Amazon EFS.
2936
3899
  # @return [String]
2937
3900
  #
@@ -2943,9 +3906,9 @@ module Aws::DataSync
2943
3906
  #
2944
3907
  # Default value: `PRESERVE`
2945
3908
  #
2946
- # `PRESERVE`\: Preserve POSIX-style permissions (recommended).
3909
+ # `PRESERVE`: Preserve POSIX-style permissions (recommended).
2947
3910
  #
2948
- # `NONE`\: Ignore permissions.
3911
+ # `NONE`: Ignore permissions.
2949
3912
  #
2950
3913
  # <note markdown="1"> DataSync can preserve extant permissions of a source location.
2951
3914
  #
@@ -2996,11 +3959,11 @@ module Aws::DataSync
2996
3959
  # transfers all the content from the source (without comparing what's
2997
3960
  # in the destination).
2998
3961
  #
2999
- # `CHANGED`\: DataSync copies only data or metadata that is new or
3962
+ # `CHANGED`: DataSync copies only data or metadata that is new or
3000
3963
  # different content from the source location to the destination
3001
3964
  # location.
3002
3965
  #
3003
- # `ALL`\: DataSync copies all source location content to the
3966
+ # `ALL`: DataSync copies all source location content to the
3004
3967
  # destination (without comparing what's in the destination).
3005
3968
  # @return [String]
3006
3969
  #
@@ -3015,7 +3978,7 @@ module Aws::DataSync
3015
3978
  #
3016
3979
  # Default value: `OWNER_DACL`
3017
3980
  #
3018
- # `OWNER_DACL`\: For each copied object, DataSync copies the following
3981
+ # `OWNER_DACL`: For each copied object, DataSync copies the following
3019
3982
  # metadata:
3020
3983
  #
3021
3984
  # * The object owner.
@@ -3026,7 +3989,7 @@ module Aws::DataSync
3026
3989
  # DataSync won't copy NTFS system access control lists (SACLs) with
3027
3990
  # this option.
3028
3991
  #
3029
- # `OWNER_DACL_SACL`\: For each copied object, DataSync copies the
3992
+ # `OWNER_DACL_SACL`: For each copied object, DataSync copies the
3030
3993
  # following metadata:
3031
3994
  #
3032
3995
  # * The object owner.
@@ -3043,7 +4006,7 @@ module Aws::DataSync
3043
4006
  # permissions to files, folders, and metadata, see
3044
4007
  # [user](create-smb-location.html#SMBuser).
3045
4008
  #
3046
- # `NONE`\: None of the SMB security descriptor components are copied.
4009
+ # `NONE`: None of the SMB security descriptor components are copied.
3047
4010
  # Destination objects are owned by the user that was provided for
3048
4011
  # accessing the destination location. DACLs and SACLs are set based on
3049
4012
  # the destination server’s configuration.
@@ -3083,6 +4046,37 @@ module Aws::DataSync
3083
4046
  include Aws::Structure
3084
4047
  end
3085
4048
 
4049
+ # The types of performance data that DataSync Discovery collects about
4050
+ # an on-premises storage system resource.
4051
+ #
4052
+ # @!attribute [rw] iops
4053
+ # The IOPS peaks for an on-premises storage system resource. Each data
4054
+ # point represents the 95th percentile peak value during a 1-hour
4055
+ # interval.
4056
+ # @return [Types::IOPS]
4057
+ #
4058
+ # @!attribute [rw] throughput
4059
+ # The throughput peaks for an on-premises storage system resource.
4060
+ # Each data point represents the 95th percentile peak value during a
4061
+ # 1-hour interval.
4062
+ # @return [Types::Throughput]
4063
+ #
4064
+ # @!attribute [rw] latency
4065
+ # The latency peaks for an on-premises storage system resource. Each
4066
+ # data point represents the 95th percentile peak value during a 1-hour
4067
+ # interval.
4068
+ # @return [Types::Latency]
4069
+ #
4070
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/P95Metrics AWS API Documentation
4071
+ #
4072
+ class P95Metrics < Struct.new(
4073
+ :iops,
4074
+ :throughput,
4075
+ :latency)
4076
+ SENSITIVE = []
4077
+ include Aws::Structure
4078
+ end
4079
+
3086
4080
  # The VPC endpoint, subnet, and security group that an agent uses to
3087
4081
  # access IP addresses in a VPC (Virtual Private Cloud).
3088
4082
  #
@@ -3150,6 +4144,127 @@ module Aws::DataSync
3150
4144
  include Aws::Structure
3151
4145
  end
3152
4146
 
4147
+ # The details about an Amazon Web Services storage service that DataSync
4148
+ # Discovery recommends for a resource in your on-premises storage
4149
+ # system.
4150
+ #
4151
+ # For more information, see [Recommendations provided by DataSync
4152
+ # Discovery][1].
4153
+ #
4154
+ #
4155
+ #
4156
+ # [1]: https://docs.aws.amazon.com/datasync/latest/userguide/discovery-understand-recommendations.html
4157
+ #
4158
+ # @!attribute [rw] storage_type
4159
+ # A recommended Amazon Web Services storage service that you can
4160
+ # migrate data to based on information that DataSync Discovery
4161
+ # collects about your on-premises storage system.
4162
+ # @return [String]
4163
+ #
4164
+ # @!attribute [rw] storage_configuration
4165
+ # Information about how you can set up a recommended Amazon Web
4166
+ # Services storage service.
4167
+ # @return [Hash<String,String>]
4168
+ #
4169
+ # @!attribute [rw] estimated_monthly_storage_cost
4170
+ # The estimated monthly cost of the recommended Amazon Web Services
4171
+ # storage service.
4172
+ # @return [String]
4173
+ #
4174
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/Recommendation AWS API Documentation
4175
+ #
4176
+ class Recommendation < Struct.new(
4177
+ :storage_type,
4178
+ :storage_configuration,
4179
+ :estimated_monthly_storage_cost)
4180
+ SENSITIVE = []
4181
+ include Aws::Structure
4182
+ end
4183
+
4184
+ # @!attribute [rw] storage_system_arn
4185
+ # Specifies the Amazon Resource Name (ARN) of the storage system that
4186
+ # you want to permanently remove from DataSync Discovery.
4187
+ # @return [String]
4188
+ #
4189
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/RemoveStorageSystemRequest AWS API Documentation
4190
+ #
4191
+ class RemoveStorageSystemRequest < Struct.new(
4192
+ :storage_system_arn)
4193
+ SENSITIVE = []
4194
+ include Aws::Structure
4195
+ end
4196
+
4197
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/RemoveStorageSystemResponse AWS API Documentation
4198
+ #
4199
+ class RemoveStorageSystemResponse < Aws::EmptyStructure; end
4200
+
4201
+ # Information provided by DataSync Discovery about the resources in your
4202
+ # on-premises storage system.
4203
+ #
4204
+ # @!attribute [rw] net_app_ontapsv_ms
4205
+ # The information that DataSync Discovery collects about storage
4206
+ # virtual machines (SVMs) in your on-premises storage system.
4207
+ # @return [Array<Types::NetAppONTAPSVM>]
4208
+ #
4209
+ # @!attribute [rw] net_app_ontap_volumes
4210
+ # The information that DataSync Discovery collects about volumes in
4211
+ # your on-premises storage system.
4212
+ # @return [Array<Types::NetAppONTAPVolume>]
4213
+ #
4214
+ # @!attribute [rw] net_app_ontap_clusters
4215
+ # The information that DataSync Discovery collects about the cluster
4216
+ # in your on-premises storage system.
4217
+ # @return [Array<Types::NetAppONTAPCluster>]
4218
+ #
4219
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ResourceDetails AWS API Documentation
4220
+ #
4221
+ class ResourceDetails < Struct.new(
4222
+ :net_app_ontapsv_ms,
4223
+ :net_app_ontap_volumes,
4224
+ :net_app_ontap_clusters)
4225
+ SENSITIVE = []
4226
+ include Aws::Structure
4227
+ end
4228
+
4229
+ # Information, including performance data and capacity usage, provided
4230
+ # by DataSync Discovery about a resource in your on-premises storage
4231
+ # system.
4232
+ #
4233
+ # @!attribute [rw] timestamp
4234
+ # The time when DataSync Discovery collected this information from the
4235
+ # resource.
4236
+ # @return [Time]
4237
+ #
4238
+ # @!attribute [rw] p95_metrics
4239
+ # The types of performance data that DataSync Discovery collects about
4240
+ # the on-premises storage system resource.
4241
+ # @return [Types::P95Metrics]
4242
+ #
4243
+ # @!attribute [rw] capacity
4244
+ # The storage capacity of the on-premises storage system resource.
4245
+ # @return [Types::Capacity]
4246
+ #
4247
+ # @!attribute [rw] resource_id
4248
+ # The universally unique identifier (UUID) of the on-premises storage
4249
+ # system resource.
4250
+ # @return [String]
4251
+ #
4252
+ # @!attribute [rw] resource_type
4253
+ # The type of on-premises storage system resource.
4254
+ # @return [String]
4255
+ #
4256
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/ResourceMetrics AWS API Documentation
4257
+ #
4258
+ class ResourceMetrics < Struct.new(
4259
+ :timestamp,
4260
+ :p95_metrics,
4261
+ :capacity,
4262
+ :resource_id,
4263
+ :resource_type)
4264
+ SENSITIVE = []
4265
+ include Aws::Structure
4266
+ end
4267
+
3153
4268
  # The Amazon Resource Name (ARN) of the Identity and Access Management
3154
4269
  # (IAM) role used to access an Amazon S3 bucket.
3155
4270
  #
@@ -3181,23 +4296,23 @@ module Aws::DataSync
3181
4296
  # These are the following options for configuring the SMB version:
3182
4297
  #
3183
4298
  # * `AUTOMATIC` (default): DataSync and the SMB file server negotiate
3184
- # a protocol version that they mutually support. (DataSync supports
3185
- # SMB versions 1.0 and later.)
4299
+ # the highest version of SMB that they mutually support between 2.1
4300
+ # and 3.1.1.
3186
4301
  #
3187
4302
  # This is the recommended option. If you instead choose a specific
3188
4303
  # version that your file server doesn't support, you may get an
3189
4304
  # `Operation Not Supported` error.
3190
4305
  #
3191
- # * `SMB3`\: Restricts the protocol negotiation to only SMB version
4306
+ # * `SMB3`: Restricts the protocol negotiation to only SMB version
3192
4307
  # 3.0.2.
3193
4308
  #
3194
- # * `SMB2`\: Restricts the protocol negotiation to only SMB version
4309
+ # * `SMB2`: Restricts the protocol negotiation to only SMB version
3195
4310
  # 2.1.
3196
4311
  #
3197
- # * `SMB2_0`\: Restricts the protocol negotiation to only SMB version
4312
+ # * `SMB2_0`: Restricts the protocol negotiation to only SMB version
3198
4313
  # 2.0.
3199
4314
  #
3200
- # * `SMB1`\: Restricts the protocol negotiation to only SMB version
4315
+ # * `SMB1`: Restricts the protocol negotiation to only SMB version
3201
4316
  # 1.0.
3202
4317
  #
3203
4318
  # <note markdown="1"> The `SMB1` option isn't available when [creating an Amazon FSx
@@ -3218,6 +4333,59 @@ module Aws::DataSync
3218
4333
  include Aws::Structure
3219
4334
  end
3220
4335
 
4336
+ # @!attribute [rw] storage_system_arn
4337
+ # Specifies the Amazon Resource Name (ARN) of the on-premises storage
4338
+ # system that you want to run the discovery job on.
4339
+ # @return [String]
4340
+ #
4341
+ # @!attribute [rw] collection_duration_minutes
4342
+ # Specifies in minutes how long you want the discovery job to run.
4343
+ #
4344
+ # <note markdown="1"> For more accurate recommendations, we recommend a duration of at
4345
+ # least 14 days. Longer durations allow time to collect a sufficient
4346
+ # number of data points and provide a realistic representation of
4347
+ # storage performance and utilization.
4348
+ #
4349
+ # </note>
4350
+ # @return [Integer]
4351
+ #
4352
+ # @!attribute [rw] client_token
4353
+ # Specifies a client token to make sure requests with this API
4354
+ # operation are idempotent. If you don't specify a client token,
4355
+ # DataSync generates one for you automatically.
4356
+ #
4357
+ # **A suitable default value is auto-generated.** You should normally
4358
+ # not need to pass this option.
4359
+ # @return [String]
4360
+ #
4361
+ # @!attribute [rw] tags
4362
+ # Specifies labels that help you categorize, filter, and search for
4363
+ # your Amazon Web Services resources.
4364
+ # @return [Array<Types::TagListEntry>]
4365
+ #
4366
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StartDiscoveryJobRequest AWS API Documentation
4367
+ #
4368
+ class StartDiscoveryJobRequest < Struct.new(
4369
+ :storage_system_arn,
4370
+ :collection_duration_minutes,
4371
+ :client_token,
4372
+ :tags)
4373
+ SENSITIVE = []
4374
+ include Aws::Structure
4375
+ end
4376
+
4377
+ # @!attribute [rw] discovery_job_arn
4378
+ # The ARN of the discovery job that you started.
4379
+ # @return [String]
4380
+ #
4381
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StartDiscoveryJobResponse AWS API Documentation
4382
+ #
4383
+ class StartDiscoveryJobResponse < Struct.new(
4384
+ :discovery_job_arn)
4385
+ SENSITIVE = []
4386
+ include Aws::Structure
4387
+ end
4388
+
3221
4389
  # StartTaskExecutionRequest
3222
4390
  #
3223
4391
  # @!attribute [rw] task_arn
@@ -3285,6 +4453,45 @@ module Aws::DataSync
3285
4453
  include Aws::Structure
3286
4454
  end
3287
4455
 
4456
+ # @!attribute [rw] discovery_job_arn
4457
+ # Specifies the Amazon Resource Name (ARN) of the discovery job that
4458
+ # you want to stop.
4459
+ # @return [String]
4460
+ #
4461
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StopDiscoveryJobRequest AWS API Documentation
4462
+ #
4463
+ class StopDiscoveryJobRequest < Struct.new(
4464
+ :discovery_job_arn)
4465
+ SENSITIVE = []
4466
+ include Aws::Structure
4467
+ end
4468
+
4469
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StopDiscoveryJobResponse AWS API Documentation
4470
+ #
4471
+ class StopDiscoveryJobResponse < Aws::EmptyStructure; end
4472
+
4473
+ # Information that identifies an on-premises storage system that you're
4474
+ # using with DataSync Discovery.
4475
+ #
4476
+ # @!attribute [rw] storage_system_arn
4477
+ # The Amazon Resource Names (ARN) of an on-premises storage system
4478
+ # that you added to DataSync Discovery.
4479
+ # @return [String]
4480
+ #
4481
+ # @!attribute [rw] name
4482
+ # The name of an on-premises storage system that you added to DataSync
4483
+ # Discovery.
4484
+ # @return [String]
4485
+ #
4486
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/StorageSystemListEntry AWS API Documentation
4487
+ #
4488
+ class StorageSystemListEntry < Struct.new(
4489
+ :storage_system_arn,
4490
+ :name)
4491
+ SENSITIVE = []
4492
+ include Aws::Structure
4493
+ end
4494
+
3288
4495
  # A key-value pair representing a single tag that's been applied to an
3289
4496
  # Amazon Web Services resource.
3290
4497
  #
@@ -3507,6 +4714,37 @@ module Aws::DataSync
3507
4714
  include Aws::Structure
3508
4715
  end
3509
4716
 
4717
+ # The throughput peaks for an on-premises storage system volume. Each
4718
+ # data point represents the 95th percentile peak value during a 1-hour
4719
+ # interval.
4720
+ #
4721
+ # @!attribute [rw] read
4722
+ # Peak throughput related to read operations.
4723
+ # @return [Float]
4724
+ #
4725
+ # @!attribute [rw] write
4726
+ # Peak throughput related to write operations.
4727
+ # @return [Float]
4728
+ #
4729
+ # @!attribute [rw] other
4730
+ # Peak throughput unrelated to read and write operations.
4731
+ # @return [Float]
4732
+ #
4733
+ # @!attribute [rw] total
4734
+ # Peak total throughput on your on-premises storage system resource.
4735
+ # @return [Float]
4736
+ #
4737
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/Throughput AWS API Documentation
4738
+ #
4739
+ class Throughput < Struct.new(
4740
+ :read,
4741
+ :write,
4742
+ :other,
4743
+ :total)
4744
+ SENSITIVE = []
4745
+ include Aws::Structure
4746
+ end
4747
+
3510
4748
  # UntagResourceRequest
3511
4749
  #
3512
4750
  # @!attribute [rw] resource_arn
@@ -3554,6 +4792,30 @@ module Aws::DataSync
3554
4792
  #
3555
4793
  class UpdateAgentResponse < Aws::EmptyStructure; end
3556
4794
 
4795
+ # @!attribute [rw] discovery_job_arn
4796
+ # Specifies the Amazon Resource Name (ARN) of the discovery job that
4797
+ # you want to update.
4798
+ # @return [String]
4799
+ #
4800
+ # @!attribute [rw] collection_duration_minutes
4801
+ # Specifies in minutes how long that you want the discovery job to
4802
+ # run. (You can't set this parameter to less than the number of
4803
+ # minutes that the job has already run for.)
4804
+ # @return [Integer]
4805
+ #
4806
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateDiscoveryJobRequest AWS API Documentation
4807
+ #
4808
+ class UpdateDiscoveryJobRequest < Struct.new(
4809
+ :discovery_job_arn,
4810
+ :collection_duration_minutes)
4811
+ SENSITIVE = []
4812
+ include Aws::Structure
4813
+ end
4814
+
4815
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateDiscoveryJobResponse AWS API Documentation
4816
+ #
4817
+ class UpdateDiscoveryJobResponse < Aws::EmptyStructure; end
4818
+
3557
4819
  # @!attribute [rw] location_arn
3558
4820
  # The Amazon Resource Name (ARN) of the source HDFS cluster location.
3559
4821
  # @return [String]
@@ -3851,9 +5113,55 @@ module Aws::DataSync
3851
5113
  #
3852
5114
  class UpdateLocationSmbResponse < Aws::EmptyStructure; end
3853
5115
 
5116
+ # @!attribute [rw] storage_system_arn
5117
+ # Specifies the ARN of the on-premises storage system that you want
5118
+ # reconfigure.
5119
+ # @return [String]
5120
+ #
5121
+ # @!attribute [rw] server_configuration
5122
+ # Specifies the server name and network port required to connect with
5123
+ # your on-premises storage system's management interface.
5124
+ # @return [Types::DiscoveryServerConfiguration]
5125
+ #
5126
+ # @!attribute [rw] agent_arns
5127
+ # Specifies the Amazon Resource Name (ARN) of the DataSync agent that
5128
+ # connects to and reads your on-premises storage system.
5129
+ # @return [Array<String>]
5130
+ #
5131
+ # @!attribute [rw] name
5132
+ # Specifies a familiar name for your on-premises storage system.
5133
+ # @return [String]
5134
+ #
5135
+ # @!attribute [rw] cloud_watch_log_group_arn
5136
+ # Specifies the ARN of the Amazon CloudWatch log group for monitoring
5137
+ # and logging discovery job events.
5138
+ # @return [String]
5139
+ #
5140
+ # @!attribute [rw] credentials
5141
+ # Specifies the user name and password for accessing your on-premises
5142
+ # storage system's management interface.
5143
+ # @return [Types::Credentials]
5144
+ #
5145
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateStorageSystemRequest AWS API Documentation
5146
+ #
5147
+ class UpdateStorageSystemRequest < Struct.new(
5148
+ :storage_system_arn,
5149
+ :server_configuration,
5150
+ :agent_arns,
5151
+ :name,
5152
+ :cloud_watch_log_group_arn,
5153
+ :credentials)
5154
+ SENSITIVE = []
5155
+ include Aws::Structure
5156
+ end
5157
+
5158
+ # @see http://docs.aws.amazon.com/goto/WebAPI/datasync-2018-11-09/UpdateStorageSystemResponse AWS API Documentation
5159
+ #
5160
+ class UpdateStorageSystemResponse < Aws::EmptyStructure; end
5161
+
3854
5162
  # @!attribute [rw] task_execution_arn
3855
- # The Amazon Resource Name (ARN) of the specific task execution that
3856
- # is being updated.
5163
+ # Specifies the Amazon Resource Name (ARN) of the task execution that
5164
+ # you're updating.
3857
5165
  # @return [String]
3858
5166
  #
3859
5167
  # @!attribute [rw] options