aws-sdk-transfer 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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