aws-sdk-transfer 1.0.0

Sign up to get free protection for your applications and to get access to all the features.
File without changes
@@ -0,0 +1,14 @@
1
+ # WARNING ABOUT GENERATED CODE
2
+ #
3
+ # This file is generated. See the contributing guide for more information:
4
+ # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
5
+ #
6
+ # WARNING ABOUT GENERATED CODE
7
+
8
+ module Aws::Transfer
9
+ module Errors
10
+
11
+ extend Aws::Errors::DynamicErrors
12
+
13
+ end
14
+ end
@@ -0,0 +1,23 @@
1
+ # WARNING ABOUT GENERATED CODE
2
+ #
3
+ # This file is generated. See the contributing guide for more information:
4
+ # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
5
+ #
6
+ # WARNING ABOUT GENERATED CODE
7
+
8
+ module Aws::Transfer
9
+ class Resource
10
+
11
+ # @param options ({})
12
+ # @option options [Client] :client
13
+ def initialize(options = {})
14
+ @client = options[:client] || Client.new(options)
15
+ end
16
+
17
+ # @return [Client]
18
+ def client
19
+ @client
20
+ end
21
+
22
+ end
23
+ end
@@ -0,0 +1,1134 @@
1
+ # WARNING ABOUT GENERATED CODE
2
+ #
3
+ # This file is generated. See the contributing guide for more information:
4
+ # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
5
+ #
6
+ # WARNING ABOUT GENERATED CODE
7
+
8
+ module Aws::Transfer
9
+ module Types
10
+
11
+ # @note When making an API call, you may pass CreateServerRequest
12
+ # data as a hash:
13
+ #
14
+ # {
15
+ # identity_provider_details: {
16
+ # url: "Url",
17
+ # invocation_role: "Role",
18
+ # },
19
+ # identity_provider_type: "SERVICE_MANAGED", # accepts SERVICE_MANAGED, API_GATEWAY
20
+ # logging_role: "Role",
21
+ # tags: [
22
+ # {
23
+ # key: "TagKey", # required
24
+ # value: "TagValue", # required
25
+ # },
26
+ # ],
27
+ # }
28
+ #
29
+ # @!attribute [rw] identity_provider_details
30
+ # An array containing all of the information required to call a
31
+ # customer-supplied authentication API. This parameter is not required
32
+ # when the `IdentityProviderType` value of server that is created uses
33
+ # the `SERVICE_MANAGED` authentication method.
34
+ # @return [Types::IdentityProviderDetails]
35
+ #
36
+ # @!attribute [rw] identity_provider_type
37
+ # The mode of authentication enabled for this service. The default
38
+ # value is `SERVICE_MANAGED`, which allows you to store and access
39
+ # SFTP user credentials within the service. An `IdentityProviderType`
40
+ # value of `API_GATEWAY` indicates that user authentication requires a
41
+ # call to an API Gateway endpoint URL provided by you to integrate an
42
+ # identity provider of your choice.
43
+ # @return [String]
44
+ #
45
+ # @!attribute [rw] logging_role
46
+ # A value that allows the service to write your SFTP users’ activity
47
+ # to your Amazon CloudWatch logs for monitoring and auditing purposes.
48
+ # @return [String]
49
+ #
50
+ # @!attribute [rw] tags
51
+ # Key-value pairs that can be used to group and search for servers.
52
+ # @return [Array<Types::Tag>]
53
+ #
54
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/CreateServerRequest AWS API Documentation
55
+ #
56
+ class CreateServerRequest < Struct.new(
57
+ :identity_provider_details,
58
+ :identity_provider_type,
59
+ :logging_role,
60
+ :tags)
61
+ include Aws::Structure
62
+ end
63
+
64
+ # @!attribute [rw] server_id
65
+ # The service-assigned ID of the SFTP server that is created.
66
+ # @return [String]
67
+ #
68
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/CreateServerResponse AWS API Documentation
69
+ #
70
+ class CreateServerResponse < Struct.new(
71
+ :server_id)
72
+ include Aws::Structure
73
+ end
74
+
75
+ # @note When making an API call, you may pass CreateUserRequest
76
+ # data as a hash:
77
+ #
78
+ # {
79
+ # home_directory: "HomeDirectory",
80
+ # policy: "Policy",
81
+ # role: "Role", # required
82
+ # server_id: "ServerId", # required
83
+ # ssh_public_key_body: "SshPublicKeyBody",
84
+ # tags: [
85
+ # {
86
+ # key: "TagKey", # required
87
+ # value: "TagValue", # required
88
+ # },
89
+ # ],
90
+ # user_name: "UserName", # required
91
+ # }
92
+ #
93
+ # @!attribute [rw] home_directory
94
+ # The landing directory (folder) for a user when they log in to the
95
+ # server using their SFTP client. An example is `/home/username `.
96
+ # @return [String]
97
+ #
98
+ # @!attribute [rw] policy
99
+ # A scope-down policy for your user so you can use the same IAM role
100
+ # across multiple users. This policy scopes down user access to
101
+ # portions of their Amazon S3 bucket. Variables you can use inside
102
+ # this policy include `$\{Transfer:UserName\}`,
103
+ # `$\{Transfer:HomeDirectory\}`, and `$\{Transfer:HomeBucket\}`.
104
+ # @return [String]
105
+ #
106
+ # @!attribute [rw] role
107
+ # The IAM role that controls your user’s access to your Amazon S3
108
+ # bucket. The policies attached to this role will determine the level
109
+ # of access you want to provide your users when transferring files
110
+ # into and out of your Amazon S3 bucket or buckets. The IAM role
111
+ # should also contain a trust relationship that allows the SFTP server
112
+ # to access your resources when servicing your SFTP user’s transfer
113
+ # requests.
114
+ # @return [String]
115
+ #
116
+ # @!attribute [rw] server_id
117
+ # A system-assigned unique identifier for an SFTP server instance.
118
+ # This is the specific SFTP server that you added your user to.
119
+ # @return [String]
120
+ #
121
+ # @!attribute [rw] ssh_public_key_body
122
+ # The public portion of the Secure Shall (SSH) key used to
123
+ # authenticate the user to the SFTP server.
124
+ # @return [String]
125
+ #
126
+ # @!attribute [rw] tags
127
+ # Key-value pairs that can be used to group and search for users. Tags
128
+ # are metadata attached to users for any purpose.
129
+ # @return [Array<Types::Tag>]
130
+ #
131
+ # @!attribute [rw] user_name
132
+ # A unique string that identifies a user and is associated with a
133
+ # server as specified by the `ServerId`.
134
+ # @return [String]
135
+ #
136
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/CreateUserRequest AWS API Documentation
137
+ #
138
+ class CreateUserRequest < Struct.new(
139
+ :home_directory,
140
+ :policy,
141
+ :role,
142
+ :server_id,
143
+ :ssh_public_key_body,
144
+ :tags,
145
+ :user_name)
146
+ include Aws::Structure
147
+ end
148
+
149
+ # @!attribute [rw] server_id
150
+ # The ID of the SFTP server that the user is attached to.
151
+ # @return [String]
152
+ #
153
+ # @!attribute [rw] user_name
154
+ # A unique string that identifies a user account associated with an
155
+ # SFTP server.
156
+ # @return [String]
157
+ #
158
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/CreateUserResponse AWS API Documentation
159
+ #
160
+ class CreateUserResponse < Struct.new(
161
+ :server_id,
162
+ :user_name)
163
+ include Aws::Structure
164
+ end
165
+
166
+ # @note When making an API call, you may pass DeleteServerRequest
167
+ # data as a hash:
168
+ #
169
+ # {
170
+ # server_id: "ServerId", # required
171
+ # }
172
+ #
173
+ # @!attribute [rw] server_id
174
+ # A unique system-assigned identifier for an SFTP server instance.
175
+ # @return [String]
176
+ #
177
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DeleteServerRequest AWS API Documentation
178
+ #
179
+ class DeleteServerRequest < Struct.new(
180
+ :server_id)
181
+ include Aws::Structure
182
+ end
183
+
184
+ # @note When making an API call, you may pass DeleteSshPublicKeyRequest
185
+ # data as a hash:
186
+ #
187
+ # {
188
+ # server_id: "ServerId", # required
189
+ # ssh_public_key_id: "SshPublicKeyId", # required
190
+ # user_name: "UserName", # required
191
+ # }
192
+ #
193
+ # @!attribute [rw] server_id
194
+ # A system-assigned unique identifier for a Secure File Transfer
195
+ # Protocol (SFTP) server instance that has the user assigned to it.
196
+ # @return [String]
197
+ #
198
+ # @!attribute [rw] ssh_public_key_id
199
+ # A unique identifier used to reference your user’s specific SSH key.
200
+ # @return [String]
201
+ #
202
+ # @!attribute [rw] user_name
203
+ # A unique string that identifies a user whose public key is being
204
+ # deleted.
205
+ # @return [String]
206
+ #
207
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DeleteSshPublicKeyRequest AWS API Documentation
208
+ #
209
+ class DeleteSshPublicKeyRequest < Struct.new(
210
+ :server_id,
211
+ :ssh_public_key_id,
212
+ :user_name)
213
+ include Aws::Structure
214
+ end
215
+
216
+ # @note When making an API call, you may pass DeleteUserRequest
217
+ # data as a hash:
218
+ #
219
+ # {
220
+ # server_id: "ServerId", # required
221
+ # user_name: "UserName", # required
222
+ # }
223
+ #
224
+ # @!attribute [rw] server_id
225
+ # A system-assigned unique identifier for an SFTP server instance that
226
+ # has the user assigned to it.
227
+ # @return [String]
228
+ #
229
+ # @!attribute [rw] user_name
230
+ # A unique string that identifies a user that is being deleted from
231
+ # the server.
232
+ # @return [String]
233
+ #
234
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DeleteUserRequest AWS API Documentation
235
+ #
236
+ class DeleteUserRequest < Struct.new(
237
+ :server_id,
238
+ :user_name)
239
+ include Aws::Structure
240
+ end
241
+
242
+ # @note When making an API call, you may pass DescribeServerRequest
243
+ # data as a hash:
244
+ #
245
+ # {
246
+ # server_id: "ServerId", # required
247
+ # }
248
+ #
249
+ # @!attribute [rw] server_id
250
+ # A system-assigned unique identifier for an SFTP server.
251
+ # @return [String]
252
+ #
253
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeServerRequest AWS API Documentation
254
+ #
255
+ class DescribeServerRequest < Struct.new(
256
+ :server_id)
257
+ include Aws::Structure
258
+ end
259
+
260
+ # @!attribute [rw] server
261
+ # An array containing the properties of the server with the `ServerID`
262
+ # you specified.
263
+ # @return [Types::DescribedServer]
264
+ #
265
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeServerResponse AWS API Documentation
266
+ #
267
+ class DescribeServerResponse < Struct.new(
268
+ :server)
269
+ include Aws::Structure
270
+ end
271
+
272
+ # @note When making an API call, you may pass DescribeUserRequest
273
+ # data as a hash:
274
+ #
275
+ # {
276
+ # server_id: "ServerId", # required
277
+ # user_name: "UserName", # required
278
+ # }
279
+ #
280
+ # @!attribute [rw] server_id
281
+ # A system-assigned unique identifier for an SFTP server that has this
282
+ # user assigned.
283
+ # @return [String]
284
+ #
285
+ # @!attribute [rw] user_name
286
+ # The name of the user assigned to one or more servers. User names are
287
+ # part of the sign-in credentials to use the AWS Transfer service and
288
+ # perform file transfer tasks.
289
+ # @return [String]
290
+ #
291
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeUserRequest AWS API Documentation
292
+ #
293
+ class DescribeUserRequest < Struct.new(
294
+ :server_id,
295
+ :user_name)
296
+ include Aws::Structure
297
+ end
298
+
299
+ # @!attribute [rw] server_id
300
+ # A system-assigned unique identifier for an SFTP server that has this
301
+ # user assigned.
302
+ # @return [String]
303
+ #
304
+ # @!attribute [rw] user
305
+ # An array containing the properties of the user account for the
306
+ # `ServerID` value that you specified.
307
+ # @return [Types::DescribedUser]
308
+ #
309
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeUserResponse AWS API Documentation
310
+ #
311
+ class DescribeUserResponse < Struct.new(
312
+ :server_id,
313
+ :user)
314
+ include Aws::Structure
315
+ end
316
+
317
+ # Describe the properties of the server that was specified. Information
318
+ # returned includes: the server Amazon Resource Name (ARN), the
319
+ # authentication configuration and type, the logging role, server Id and
320
+ # state, and assigned tags or metadata.
321
+ #
322
+ # @!attribute [rw] arn
323
+ # Specifies the unique Amazon Resource Name (ARN) for the server to be
324
+ # described.
325
+ # @return [String]
326
+ #
327
+ # @!attribute [rw] identity_provider_details
328
+ # Specifies information to call a customer-supplied authentication
329
+ # API. This field is not populated when the `IdentityProviderType` of
330
+ # the server is `SERVICE_MANAGED`&gt;.
331
+ # @return [Types::IdentityProviderDetails]
332
+ #
333
+ # @!attribute [rw] identity_provider_type
334
+ # This property defines the mode of authentication method enabled for
335
+ # this service. A value of `SERVICE_MANAGED`, means that you are using
336
+ # this Server to store and access SFTP user credentials within the
337
+ # service. A value of `API_GATEWAY` indicates that you have integrated
338
+ # an API Gateway endpoint that will be invoked for authenticating your
339
+ # user into the service.
340
+ # @return [String]
341
+ #
342
+ # @!attribute [rw] logging_role
343
+ # This property is an AWS Identity and Access Management (IAM) entity
344
+ # that allows the server to turn on Amazon CloudWatch logging for
345
+ # Amazon S3 events. When set, user activity can be view in your
346
+ # CloudWatch logs.
347
+ # @return [String]
348
+ #
349
+ # @!attribute [rw] server_id
350
+ # This property is a unique system assigned identifier for the SFTP
351
+ # server that you instantiate.
352
+ # @return [String]
353
+ #
354
+ # @!attribute [rw] state
355
+ # The condition of the SFTP server for the server that was described.
356
+ # A value of `ONLINE` indicates that the server can accept jobs and
357
+ # transfer files. A `State` value of `OFFLINE` means that the server
358
+ # cannot perform file transfer operations.
359
+ #
360
+ # The states of `STARTING` and `STOPPING` indicated that the server is
361
+ # in an intermediate state, either not fully able to respond, or not
362
+ # fully offline. The values of `START_FAILED` or `STOP_FAILED` can
363
+ # indicate an error condition.
364
+ # @return [String]
365
+ #
366
+ # @!attribute [rw] tags
367
+ # This property contains the key-value pairs that you can use to
368
+ # search for and group servers that were assigned to the server that
369
+ # was described.
370
+ # @return [Array<Types::Tag>]
371
+ #
372
+ # @!attribute [rw] user_count
373
+ # The number of users that are assigned to the SFTP server you
374
+ # specified with the `ServerId`.
375
+ # @return [Integer]
376
+ #
377
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribedServer AWS API Documentation
378
+ #
379
+ class DescribedServer < Struct.new(
380
+ :arn,
381
+ :identity_provider_details,
382
+ :identity_provider_type,
383
+ :logging_role,
384
+ :server_id,
385
+ :state,
386
+ :tags,
387
+ :user_count)
388
+ include Aws::Structure
389
+ end
390
+
391
+ # Returns properties of the user that you wish to describe.
392
+ #
393
+ # @!attribute [rw] arn
394
+ # This property contains the unique Amazon Resource Name (ARN) for the
395
+ # user that was requested to be described.
396
+ # @return [String]
397
+ #
398
+ # @!attribute [rw] home_directory
399
+ # This property specifies the landing directory (or folder) which is
400
+ # the location that files are written to or read from in an Amazon S3
401
+ # bucket for the described user. An example would be:
402
+ # `/bucket_name/home/username `.
403
+ # @return [String]
404
+ #
405
+ # @!attribute [rw] policy
406
+ # Specifies the name of the policy in use for the described user.
407
+ # @return [String]
408
+ #
409
+ # @!attribute [rw] role
410
+ # This property specifies the IAM role that controls your user’s
411
+ # access to your Amazon S3 bucket. The policies attached to this role
412
+ # will determine the level of access you want to provide your users
413
+ # when transferring files into and out of your Amazon S3 bucket or
414
+ # buckets. The IAM role should also contain a trust relationship that
415
+ # allows the SFTP server to access your resources when servicing your
416
+ # SFTP user’s transfer requests.
417
+ # @return [String]
418
+ #
419
+ # @!attribute [rw] ssh_public_keys
420
+ # This property contains the public key portion of the Secure Shell
421
+ # (SSH) keys stored for the described user.
422
+ # @return [Array<Types::SshPublicKey>]
423
+ #
424
+ # @!attribute [rw] tags
425
+ # This property contains the key-value pairs for the user requested.
426
+ # Tag can be used to search for and group users for a variety of
427
+ # purposes.
428
+ # @return [Array<Types::Tag>]
429
+ #
430
+ # @!attribute [rw] user_name
431
+ # This property is the name of the user that was requested to be
432
+ # described. User names are used for authentication purposes. This is
433
+ # the string that will be used by your user when they log in to your
434
+ # SFTP server.
435
+ # @return [String]
436
+ #
437
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribedUser AWS API Documentation
438
+ #
439
+ class DescribedUser < Struct.new(
440
+ :arn,
441
+ :home_directory,
442
+ :policy,
443
+ :role,
444
+ :ssh_public_keys,
445
+ :tags,
446
+ :user_name)
447
+ include Aws::Structure
448
+ end
449
+
450
+ # Returns information related to the type of user authentication that is
451
+ # in use for a server's users. A server can only have one method of
452
+ # authentication.
453
+ #
454
+ # @note When making an API call, you may pass IdentityProviderDetails
455
+ # data as a hash:
456
+ #
457
+ # {
458
+ # url: "Url",
459
+ # invocation_role: "Role",
460
+ # }
461
+ #
462
+ # @!attribute [rw] url
463
+ # The `IdentityProviderDetail` parameter contains the location of the
464
+ # service endpoint used to authenticate users.
465
+ # @return [String]
466
+ #
467
+ # @!attribute [rw] invocation_role
468
+ # The `Role` parameter provides the type of `InvocationRole` used to
469
+ # authenticate the user account.
470
+ # @return [String]
471
+ #
472
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/IdentityProviderDetails AWS API Documentation
473
+ #
474
+ class IdentityProviderDetails < Struct.new(
475
+ :url,
476
+ :invocation_role)
477
+ include Aws::Structure
478
+ end
479
+
480
+ # @note When making an API call, you may pass ImportSshPublicKeyRequest
481
+ # data as a hash:
482
+ #
483
+ # {
484
+ # server_id: "ServerId", # required
485
+ # ssh_public_key_body: "SshPublicKeyBody", # required
486
+ # user_name: "UserName", # required
487
+ # }
488
+ #
489
+ # @!attribute [rw] server_id
490
+ # A system-assigned unique identifier for an SFTP server.
491
+ # @return [String]
492
+ #
493
+ # @!attribute [rw] ssh_public_key_body
494
+ # The public key portion of an SSH key pair.
495
+ # @return [String]
496
+ #
497
+ # @!attribute [rw] user_name
498
+ # The name of the user account that is assigned to one or more
499
+ # servers.
500
+ # @return [String]
501
+ #
502
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ImportSshPublicKeyRequest AWS API Documentation
503
+ #
504
+ class ImportSshPublicKeyRequest < Struct.new(
505
+ :server_id,
506
+ :ssh_public_key_body,
507
+ :user_name)
508
+ include Aws::Structure
509
+ end
510
+
511
+ # This response identifies the user, server they belong to, and the
512
+ # identifier of the SSH public key associated with that user. A user can
513
+ # have more than one key on each server that they are associate with.
514
+ #
515
+ # @!attribute [rw] server_id
516
+ # A system-assigned unique identifier for an SFTP server.
517
+ # @return [String]
518
+ #
519
+ # @!attribute [rw] ssh_public_key_id
520
+ # This identifier is the name given to a public key by the system that
521
+ # was imported.
522
+ # @return [String]
523
+ #
524
+ # @!attribute [rw] user_name
525
+ # A user name assigned to the `ServerID` value that you specified.
526
+ # @return [String]
527
+ #
528
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ImportSshPublicKeyResponse AWS API Documentation
529
+ #
530
+ class ImportSshPublicKeyResponse < Struct.new(
531
+ :server_id,
532
+ :ssh_public_key_id,
533
+ :user_name)
534
+ include Aws::Structure
535
+ end
536
+
537
+ # @note When making an API call, you may pass ListServersRequest
538
+ # data as a hash:
539
+ #
540
+ # {
541
+ # max_results: 1,
542
+ # next_token: "NextToken",
543
+ # }
544
+ #
545
+ # @!attribute [rw] max_results
546
+ # Specifies the number of servers to return as a response to the
547
+ # `ListServers` query.
548
+ # @return [Integer]
549
+ #
550
+ # @!attribute [rw] next_token
551
+ # When additional results are obtained from the ListServers command, a
552
+ # `NextToken` parameter is returned in the output. You can then pass
553
+ # the `NextToken` parameter in a subsequent command to continue
554
+ # listing additional servers.
555
+ # @return [String]
556
+ #
557
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListServersRequest AWS API Documentation
558
+ #
559
+ class ListServersRequest < Struct.new(
560
+ :max_results,
561
+ :next_token)
562
+ include Aws::Structure
563
+ end
564
+
565
+ # @!attribute [rw] next_token
566
+ # When you can get additional results from the `ListServers`
567
+ # operation, a `NextToken` parameter is returned in the output. In a
568
+ # following command, you can pass in the `NextToken` parameter to
569
+ # continue listing additional servers.
570
+ # @return [String]
571
+ #
572
+ # @!attribute [rw] servers
573
+ # An array of servers that were listed.
574
+ # @return [Array<Types::ListedServer>]
575
+ #
576
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListServersResponse AWS API Documentation
577
+ #
578
+ class ListServersResponse < Struct.new(
579
+ :next_token,
580
+ :servers)
581
+ include Aws::Structure
582
+ end
583
+
584
+ # @note When making an API call, you may pass ListTagsForResourceRequest
585
+ # data as a hash:
586
+ #
587
+ # {
588
+ # arn: "Arn", # required
589
+ # max_results: 1,
590
+ # next_token: "NextToken",
591
+ # }
592
+ #
593
+ # @!attribute [rw] arn
594
+ # Requests the tags associated with a particular Amazon Resource Name
595
+ # (ARN). An ARN is an identifier for a specific AWS resource, such as
596
+ # a server, user, or role.
597
+ # @return [String]
598
+ #
599
+ # @!attribute [rw] max_results
600
+ # @return [Integer]
601
+ #
602
+ # @!attribute [rw] next_token
603
+ # @return [String]
604
+ #
605
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListTagsForResourceRequest AWS API Documentation
606
+ #
607
+ class ListTagsForResourceRequest < Struct.new(
608
+ :arn,
609
+ :max_results,
610
+ :next_token)
611
+ include Aws::Structure
612
+ end
613
+
614
+ # @!attribute [rw] arn
615
+ # This value is the ARN you specified to list the tags of.
616
+ # @return [String]
617
+ #
618
+ # @!attribute [rw] next_token
619
+ # @return [String]
620
+ #
621
+ # @!attribute [rw] tags
622
+ # Key-value pairs that are assigned to a resource, usually for the
623
+ # purpose of grouping and searching for items. Tags are metadata that
624
+ # you define that you can use for any purpose.
625
+ # @return [Array<Types::Tag>]
626
+ #
627
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListTagsForResourceResponse AWS API Documentation
628
+ #
629
+ class ListTagsForResourceResponse < Struct.new(
630
+ :arn,
631
+ :next_token,
632
+ :tags)
633
+ include Aws::Structure
634
+ end
635
+
636
+ # @note When making an API call, you may pass ListUsersRequest
637
+ # data as a hash:
638
+ #
639
+ # {
640
+ # max_results: 1,
641
+ # next_token: "NextToken",
642
+ # server_id: "ServerId", # required
643
+ # }
644
+ #
645
+ # @!attribute [rw] max_results
646
+ # Specifies the number of users to return as a response to the
647
+ # `ListUsers` request.
648
+ # @return [Integer]
649
+ #
650
+ # @!attribute [rw] next_token
651
+ # When you can get additional results from the `ListUsers`ListUsers
652
+ # call, a `NextToken` parameter is returned in the output. You can
653
+ # then pass in a subsequent command the `NextToken` parameter to
654
+ # continue listing additional users.
655
+ # @return [String]
656
+ #
657
+ # @!attribute [rw] server_id
658
+ # A system-assigned unique identifier for a Secure File Transfer
659
+ # Protocol (SFTP) server that has users are assigned to it.
660
+ # @return [String]
661
+ #
662
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListUsersRequest AWS API Documentation
663
+ #
664
+ class ListUsersRequest < Struct.new(
665
+ :max_results,
666
+ :next_token,
667
+ :server_id)
668
+ include Aws::Structure
669
+ end
670
+
671
+ # @!attribute [rw] next_token
672
+ # When you can get additional results from the `ListUsers` call, a
673
+ # `NextToken` parameter is returned in the output. You can then pass
674
+ # in a subsequent command the `NextToken` parameter to continue
675
+ # listing additional users.
676
+ # @return [String]
677
+ #
678
+ # @!attribute [rw] server_id
679
+ # A system-assigned unique identifier for an SFTP server that the
680
+ # users are assigned to.
681
+ # @return [String]
682
+ #
683
+ # @!attribute [rw] users
684
+ # Returns the user accounts and their properties for the `ServerId`
685
+ # value that you specify.
686
+ # @return [Array<Types::ListedUser>]
687
+ #
688
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListUsersResponse AWS API Documentation
689
+ #
690
+ class ListUsersResponse < Struct.new(
691
+ :next_token,
692
+ :server_id,
693
+ :users)
694
+ include Aws::Structure
695
+ end
696
+
697
+ # Returns properties of the server that was specified.
698
+ #
699
+ # @!attribute [rw] arn
700
+ # The unique Amazon Resource Name (ARN) for the server to be listed.
701
+ # @return [String]
702
+ #
703
+ # @!attribute [rw] identity_provider_type
704
+ # The authentication method used to validate a user for the server
705
+ # that was specified. listed. This can include Secure Shell (SSH),
706
+ # user name and password combinations, or your own custom
707
+ # authentication method. Valid values include `SERVICE_MANAGED` or
708
+ # `API_GATEWAY`.
709
+ # @return [String]
710
+ #
711
+ # @!attribute [rw] logging_role
712
+ # The AWS Identity and Access Management entity that allows the server
713
+ # to turn on Amazon CloudWatch logging.
714
+ # @return [String]
715
+ #
716
+ # @!attribute [rw] server_id
717
+ # This value is the unique system assigned identifier for the SFTP
718
+ # servers that were listed.
719
+ # @return [String]
720
+ #
721
+ # @!attribute [rw] state
722
+ # This property describes the condition of the SFTP server for the
723
+ # server that was described. A value of `ONLINE`&gt; indicates that
724
+ # the server can accept jobs and transfer files. A `State` value of
725
+ # `OFFLINE` means that the server cannot perform file transfer
726
+ # operations.
727
+ #
728
+ # The states of `STARTING` and `STOPPING` indicated that the server is
729
+ # in an intermediate state, either not fully able to respond, or not
730
+ # fully offline. The values of `START_FAILED` or `STOP_FAILED` can
731
+ # indicate an error condition.
732
+ # @return [String]
733
+ #
734
+ # @!attribute [rw] user_count
735
+ # This property is a numeric value that indicates the number of users
736
+ # that are assigned to the SFTP server you specified with the
737
+ # `ServerId`.
738
+ # @return [Integer]
739
+ #
740
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListedServer AWS API Documentation
741
+ #
742
+ class ListedServer < Struct.new(
743
+ :arn,
744
+ :identity_provider_type,
745
+ :logging_role,
746
+ :server_id,
747
+ :state,
748
+ :user_count)
749
+ include Aws::Structure
750
+ end
751
+
752
+ # Returns properties of the user that you specify.
753
+ #
754
+ # @!attribute [rw] arn
755
+ # This property is the unique Amazon Resource Name (ARN) for the user
756
+ # that you wish to learn about.
757
+ # @return [String]
758
+ #
759
+ # @!attribute [rw] home_directory
760
+ # This value specifies the location that files are written to or read
761
+ # from an Amazon S3 bucket for the user you specify by their ARN.
762
+ # @return [String]
763
+ #
764
+ # @!attribute [rw] role
765
+ # The role in use by this user. A *role* is an AWS Identity and Access
766
+ # Management (IAM) entity that in this case allows the SFTP server to
767
+ # act on a user's behalf. It allows the server to inherit the trust
768
+ # relationship that enables that user to perform file operations to
769
+ # their Amazon S3 bucket.
770
+ # @return [String]
771
+ #
772
+ # @!attribute [rw] ssh_public_key_count
773
+ # This value is the number of SSH public keys stored for the user you
774
+ # specified.
775
+ # @return [Integer]
776
+ #
777
+ # @!attribute [rw] user_name
778
+ # The name of the user whose ARN was specified. User names are used
779
+ # for authentication purposes.
780
+ # @return [String]
781
+ #
782
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListedUser AWS API Documentation
783
+ #
784
+ class ListedUser < Struct.new(
785
+ :arn,
786
+ :home_directory,
787
+ :role,
788
+ :ssh_public_key_count,
789
+ :user_name)
790
+ include Aws::Structure
791
+ end
792
+
793
+ # Provides information about the public Secure Shell (SSH) key that is
794
+ # associated with a user account for a specific server (as identified by
795
+ # `ServerId`). The information returned includes the date the key was
796
+ # imported, the public key contents, and the public key ID. A user can
797
+ # store more than one SSH public key associated with their user name on
798
+ # a specific SFTP server.
799
+ #
800
+ # @!attribute [rw] date_imported
801
+ # The date that the public key was added to the user account.
802
+ # @return [Time]
803
+ #
804
+ # @!attribute [rw] ssh_public_key_body
805
+ # The content of the SSH public key as specified by the `PublicKeyId`.
806
+ # @return [String]
807
+ #
808
+ # @!attribute [rw] ssh_public_key_id
809
+ # The `SshPublicKeyId` parameter contains the identifier of the public
810
+ # key.
811
+ # @return [String]
812
+ #
813
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/SshPublicKey AWS API Documentation
814
+ #
815
+ class SshPublicKey < Struct.new(
816
+ :date_imported,
817
+ :ssh_public_key_body,
818
+ :ssh_public_key_id)
819
+ include Aws::Structure
820
+ end
821
+
822
+ # @note When making an API call, you may pass StartServerRequest
823
+ # data as a hash:
824
+ #
825
+ # {
826
+ # server_id: "ServerId", # required
827
+ # }
828
+ #
829
+ # @!attribute [rw] server_id
830
+ # A system-assigned unique identifier for an SFTP server that you
831
+ # start.
832
+ # @return [String]
833
+ #
834
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/StartServerRequest AWS API Documentation
835
+ #
836
+ class StartServerRequest < Struct.new(
837
+ :server_id)
838
+ include Aws::Structure
839
+ end
840
+
841
+ # @note When making an API call, you may pass StopServerRequest
842
+ # data as a hash:
843
+ #
844
+ # {
845
+ # server_id: "ServerId", # required
846
+ # }
847
+ #
848
+ # @!attribute [rw] server_id
849
+ # A system-assigned unique identifier for an SFTP server that you
850
+ # stopped.
851
+ # @return [String]
852
+ #
853
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/StopServerRequest AWS API Documentation
854
+ #
855
+ class StopServerRequest < Struct.new(
856
+ :server_id)
857
+ include Aws::Structure
858
+ end
859
+
860
+ # Creates a key-value pair for a specific resource. Tags are metadata
861
+ # that you can use to search for and group a resource for various
862
+ # purposes. You can apply tags to servers, users, and roles. A tag key
863
+ # can take more than one value. For example, to group servers for
864
+ # accounting purposes, you might create a tag called `Group` and assign
865
+ # the values `Research` and `Accounting` to that group.
866
+ #
867
+ # @note When making an API call, you may pass Tag
868
+ # data as a hash:
869
+ #
870
+ # {
871
+ # key: "TagKey", # required
872
+ # value: "TagValue", # required
873
+ # }
874
+ #
875
+ # @!attribute [rw] key
876
+ # The name assigned to the tag that you create.
877
+ # @return [String]
878
+ #
879
+ # @!attribute [rw] value
880
+ # This property contains one or more values that you assigned to the
881
+ # key name you create.
882
+ # @return [String]
883
+ #
884
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/Tag AWS API Documentation
885
+ #
886
+ class Tag < Struct.new(
887
+ :key,
888
+ :value)
889
+ include Aws::Structure
890
+ end
891
+
892
+ # @note When making an API call, you may pass TagResourceRequest
893
+ # data as a hash:
894
+ #
895
+ # {
896
+ # arn: "Arn", # required
897
+ # tags: [ # required
898
+ # {
899
+ # key: "TagKey", # required
900
+ # value: "TagValue", # required
901
+ # },
902
+ # ],
903
+ # }
904
+ #
905
+ # @!attribute [rw] arn
906
+ # An Amazon Resource Name (ARN) for a specific AWS resource, such as a
907
+ # server, user, or role.
908
+ # @return [String]
909
+ #
910
+ # @!attribute [rw] tags
911
+ # Key-value pairs assigned to ARNs that you can use to group and
912
+ # search for resources by type. You can attach this metadata to user
913
+ # accounts for any purpose.
914
+ # @return [Array<Types::Tag>]
915
+ #
916
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/TagResourceRequest AWS API Documentation
917
+ #
918
+ class TagResourceRequest < Struct.new(
919
+ :arn,
920
+ :tags)
921
+ include Aws::Structure
922
+ end
923
+
924
+ # @note When making an API call, you may pass TestIdentityProviderRequest
925
+ # data as a hash:
926
+ #
927
+ # {
928
+ # server_id: "ServerId", # required
929
+ # user_name: "UserName", # required
930
+ # user_password: "UserPassword",
931
+ # }
932
+ #
933
+ # @!attribute [rw] server_id
934
+ # A system assigned identifier for a specific server. That server's
935
+ # user authentication method is tested with a user name and password.
936
+ # @return [String]
937
+ #
938
+ # @!attribute [rw] user_name
939
+ # This request parameter is name of the user account to be tested.
940
+ # @return [String]
941
+ #
942
+ # @!attribute [rw] user_password
943
+ # The password of the user account to be tested.
944
+ # @return [String]
945
+ #
946
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/TestIdentityProviderRequest AWS API Documentation
947
+ #
948
+ class TestIdentityProviderRequest < Struct.new(
949
+ :server_id,
950
+ :user_name,
951
+ :user_password)
952
+ include Aws::Structure
953
+ end
954
+
955
+ # @!attribute [rw] message
956
+ # The result of the authorization test as a message.
957
+ # @return [String]
958
+ #
959
+ # @!attribute [rw] status_code
960
+ # The HTTP status code that is the response from your API Gateway.
961
+ # @return [Integer]
962
+ #
963
+ # @!attribute [rw] url
964
+ # The endpoint of the service used to authenticate a user.
965
+ # @return [String]
966
+ #
967
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/TestIdentityProviderResponse AWS API Documentation
968
+ #
969
+ class TestIdentityProviderResponse < Struct.new(
970
+ :message,
971
+ :status_code,
972
+ :url)
973
+ include Aws::Structure
974
+ end
975
+
976
+ # @note When making an API call, you may pass UntagResourceRequest
977
+ # data as a hash:
978
+ #
979
+ # {
980
+ # arn: "Arn", # required
981
+ # tag_keys: ["TagKey"], # required
982
+ # }
983
+ #
984
+ # @!attribute [rw] arn
985
+ # This is the value of the resource that will have the tag removed. An
986
+ # Amazon Resource Name (ARN) is an identifier for a specific AWS
987
+ # resource, such as a server, user, or role.
988
+ # @return [String]
989
+ #
990
+ # @!attribute [rw] tag_keys
991
+ # TagKeys are key-value pairs assigned to ARNs that can be used to
992
+ # group and search for resources by type. This metadata can be
993
+ # attached to resources for any purpose.
994
+ # @return [Array<String>]
995
+ #
996
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UntagResourceRequest AWS API Documentation
997
+ #
998
+ class UntagResourceRequest < Struct.new(
999
+ :arn,
1000
+ :tag_keys)
1001
+ include Aws::Structure
1002
+ end
1003
+
1004
+ # @note When making an API call, you may pass UpdateServerRequest
1005
+ # data as a hash:
1006
+ #
1007
+ # {
1008
+ # identity_provider_details: {
1009
+ # url: "Url",
1010
+ # invocation_role: "Role",
1011
+ # },
1012
+ # logging_role: "NullableRole",
1013
+ # server_id: "ServerId", # required
1014
+ # }
1015
+ #
1016
+ # @!attribute [rw] identity_provider_details
1017
+ # This response parameter is an array containing all of the
1018
+ # information required to call a customer's authentication API
1019
+ # method.
1020
+ # @return [Types::IdentityProviderDetails]
1021
+ #
1022
+ # @!attribute [rw] logging_role
1023
+ # Changes the AWS Identity and Access Management (IAM) role that
1024
+ # allows Amazon S3 events to be logged in Amazon CloudWatch, turning
1025
+ # logging on or off.
1026
+ # @return [String]
1027
+ #
1028
+ # @!attribute [rw] server_id
1029
+ # A system-assigned unique identifier for an SFTP server instance that
1030
+ # the user account is assigned to.
1031
+ # @return [String]
1032
+ #
1033
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UpdateServerRequest AWS API Documentation
1034
+ #
1035
+ class UpdateServerRequest < Struct.new(
1036
+ :identity_provider_details,
1037
+ :logging_role,
1038
+ :server_id)
1039
+ include Aws::Structure
1040
+ end
1041
+
1042
+ # @!attribute [rw] server_id
1043
+ # A system-assigned unique identifier for an SFTP server that the user
1044
+ # account is assigned to.
1045
+ # @return [String]
1046
+ #
1047
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UpdateServerResponse AWS API Documentation
1048
+ #
1049
+ class UpdateServerResponse < Struct.new(
1050
+ :server_id)
1051
+ include Aws::Structure
1052
+ end
1053
+
1054
+ # @note When making an API call, you may pass UpdateUserRequest
1055
+ # data as a hash:
1056
+ #
1057
+ # {
1058
+ # home_directory: "HomeDirectory",
1059
+ # policy: "Policy",
1060
+ # role: "Role",
1061
+ # server_id: "ServerId", # required
1062
+ # user_name: "UserName", # required
1063
+ # }
1064
+ #
1065
+ # @!attribute [rw] home_directory
1066
+ # The HomeDirectory parameter specifies the landing directory (folder)
1067
+ # for a user when they log in to the server using their client. An
1068
+ # example would be: `/home/username `.
1069
+ # @return [String]
1070
+ #
1071
+ # @!attribute [rw] policy
1072
+ # Allows you to supply a scope-down policy for your user so you can
1073
+ # use the same AWS Identity and Access Management (IAM) role across
1074
+ # multiple users. The policy scopes down users access to portions of
1075
+ # your Amazon S3 bucket. Variables you can use inside this policy
1076
+ # include `$\{Transfer:UserName\}`, `$\{Transfer:HomeDirectory\}`, and
1077
+ # `$\{Transfer:HomeBucket\}`.
1078
+ # @return [String]
1079
+ #
1080
+ # @!attribute [rw] role
1081
+ # The IAM role that controls your user’s access to your Amazon S3
1082
+ # bucket. The policies attached to this role will determine the level
1083
+ # of access you want to provide your users when transferring files
1084
+ # into and out of your Amazon S3 bucket or buckets. The IAM role
1085
+ # should also contain a trust relationship that allows the Secure File
1086
+ # Transfer Protocol (SFTP) server to access your resources when
1087
+ # servicing your SFTP user’s transfer requests.
1088
+ # @return [String]
1089
+ #
1090
+ # @!attribute [rw] server_id
1091
+ # A system-assigned unique identifier for an SFTP server instance that
1092
+ # the user account is assigned to.
1093
+ # @return [String]
1094
+ #
1095
+ # @!attribute [rw] user_name
1096
+ # A unique string that identifies a user and is associated with a
1097
+ # server as specified by the ServerId. This is the string that will be
1098
+ # used by your user when they log in to your SFTP server.
1099
+ # @return [String]
1100
+ #
1101
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UpdateUserRequest AWS API Documentation
1102
+ #
1103
+ class UpdateUserRequest < Struct.new(
1104
+ :home_directory,
1105
+ :policy,
1106
+ :role,
1107
+ :server_id,
1108
+ :user_name)
1109
+ include Aws::Structure
1110
+ end
1111
+
1112
+ # `UpdateUserResponse` returns the user name and server identifier for
1113
+ # the request to update a user's properties.
1114
+ #
1115
+ # @!attribute [rw] server_id
1116
+ # A system-assigned unique identifier for an SFTP server instance that
1117
+ # the user account is assigned to.
1118
+ # @return [String]
1119
+ #
1120
+ # @!attribute [rw] user_name
1121
+ # The unique identifier for a user that is assigned to the SFTP server
1122
+ # instance that was specified in the request.
1123
+ # @return [String]
1124
+ #
1125
+ # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UpdateUserResponse AWS API Documentation
1126
+ #
1127
+ class UpdateUserResponse < Struct.new(
1128
+ :server_id,
1129
+ :user_name)
1130
+ include Aws::Structure
1131
+ end
1132
+
1133
+ end
1134
+ end