aws-sdk-datasync 1.55.0 → 1.56.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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