aws-sdk-transfer 1.53.0 → 1.56.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +15 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-transfer/client.rb +88 -24
- data/lib/aws-sdk-transfer/client_api.rb +2 -0
- data/lib/aws-sdk-transfer/types.rb +139 -44
- data/lib/aws-sdk-transfer.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 39c99769c059939e06165d2c2ed8b711c36c9f5e08f7ada74706ee5ba41b0e1f
|
4
|
+
data.tar.gz: efce29b73f50cba763087e845db52b789c60ef897cd2bb6b3a43d2f84feada21
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 59ccd768fb291d1faf960b6a63230fa63f7170e4210e00dc68cb515763456e6c3d08ca10275829994c6a220ba87dd691a83f46b81480096ee9c98d69c7dd6e38
|
7
|
+
data.tar.gz: b4712eea79a68f04c9fa1b0553dd28652a31d29b4103f5f1bce7e3eceef2d15da68b8c1fc96a43519545e4ca1f49667d52ed2291a4609d12de8c6931ae312e46
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,21 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.56.0 (2022-06-22)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Until today, the service supported only RSA host keys and user keys. Now with this launch, Transfer Family has expanded the support for ECDSA and ED25519 host keys and user keys, enabling customers to support a broader set of clients by choosing RSA, ECDSA, and ED25519 host and user keys.
|
8
|
+
|
9
|
+
1.55.0 (2022-05-18)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - AWS Transfer Family now supports SetStat server configuration option, which provides the ability to ignore SetStat command issued by file transfer clients, enabling customers to upload files without any errors.
|
13
|
+
|
14
|
+
1.54.0 (2022-05-12)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - AWS Transfer Family now accepts ECDSA keys for server host keys
|
18
|
+
|
4
19
|
1.53.0 (2022-04-19)
|
5
20
|
------------------
|
6
21
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.56.0
|
@@ -608,8 +608,30 @@ module Aws::Transfer
|
|
608
608
|
# </note>
|
609
609
|
#
|
610
610
|
# @option params [String] :host_key
|
611
|
-
# The RSA
|
612
|
-
#
|
611
|
+
# The RSA, ECDSA, or ED25519 private key to use for your server.
|
612
|
+
#
|
613
|
+
# Use the following command to generate an RSA 2048 bit key with no
|
614
|
+
# passphrase:
|
615
|
+
#
|
616
|
+
# `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`.
|
617
|
+
#
|
618
|
+
# Use a minimum value of 2048 for the `-b` option: you can create a
|
619
|
+
# stronger key using 3072 or 4096.
|
620
|
+
#
|
621
|
+
# Use the following command to generate an ECDSA 256 bit key with no
|
622
|
+
# passphrase:
|
623
|
+
#
|
624
|
+
# `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`.
|
625
|
+
#
|
626
|
+
# Valid values for the `-b` option for ECDSA are 256, 384, and 521.
|
627
|
+
#
|
628
|
+
# Use the following command to generate an ED25519 key with no
|
629
|
+
# passphrase:
|
630
|
+
#
|
631
|
+
# `ssh-keygen -t ed25519 -N "" -f my-new-server-key`.
|
632
|
+
#
|
633
|
+
# For all of these commands, you can replace *my-new-server-key* with a
|
634
|
+
# string of your choice.
|
613
635
|
#
|
614
636
|
# If you aren't planning to migrate existing users from an existing
|
615
637
|
# SFTP-enabled server to a new server, don't update the host key.
|
@@ -708,13 +730,22 @@ module Aws::Transfer
|
|
708
730
|
# @option params [Types::ProtocolDetails] :protocol_details
|
709
731
|
# The protocol settings that are configured for your server.
|
710
732
|
#
|
711
|
-
# Use the `PassiveIp` parameter to indicate passive mode (for FTP and
|
712
|
-
#
|
713
|
-
#
|
733
|
+
# * Use the `PassiveIp` parameter to indicate passive mode (for FTP and
|
734
|
+
# FTPS protocols). Enter a single dotted-quad IPv4 address, such as
|
735
|
+
# the external IP address of a firewall, router, or load balancer.
|
736
|
+
#
|
737
|
+
# * Use the `SetStatOption` to ignore the error that is generated when
|
738
|
+
# the client attempts to use SETSTAT on a file you are uploading to an
|
739
|
+
# S3 bucket. Set the value to `ENABLE_NO_OP` to have the Transfer
|
740
|
+
# Family server ignore the SETSTAT command, and upload files without
|
741
|
+
# needing to make any changes to your SFTP client. Note that with
|
742
|
+
# `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log
|
743
|
+
# entry to CloudWatch Logs, so you can determine when the client is
|
744
|
+
# making a SETSTAT call.
|
714
745
|
#
|
715
|
-
# Use the `TlsSessionResumptionMode` parameter to determine whether or
|
716
|
-
#
|
717
|
-
#
|
746
|
+
# * Use the `TlsSessionResumptionMode` parameter to determine whether or
|
747
|
+
# not your Transfer server resumes recent, negotiated sessions through
|
748
|
+
# a unique session ID.
|
718
749
|
#
|
719
750
|
# @option params [String] :security_policy_name
|
720
751
|
# Specifies the name of the security policy that is attached to the
|
@@ -759,6 +790,7 @@ module Aws::Transfer
|
|
759
790
|
# protocol_details: {
|
760
791
|
# passive_ip: "PassiveIp",
|
761
792
|
# tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
|
793
|
+
# set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
|
762
794
|
# },
|
763
795
|
# security_policy_name: "SecurityPolicyName",
|
764
796
|
# tags: [
|
@@ -890,10 +922,7 @@ module Aws::Transfer
|
|
890
922
|
# The public portion of the Secure Shell (SSH) key used to authenticate
|
891
923
|
# the user to the server.
|
892
924
|
#
|
893
|
-
#
|
894
|
-
# beginning with `ecdsa`).
|
895
|
-
#
|
896
|
-
# </note>
|
925
|
+
# Transfer Family accepts RSA, ECDSA, and ED25519 keys.
|
897
926
|
#
|
898
927
|
# @option params [Array<Types::Tag>] :tags
|
899
928
|
# Key-value pairs that can be used to group and search for users. Tags
|
@@ -1466,6 +1495,7 @@ module Aws::Transfer
|
|
1466
1495
|
# resp.server.certificate #=> String
|
1467
1496
|
# resp.server.protocol_details.passive_ip #=> String
|
1468
1497
|
# resp.server.protocol_details.tls_session_resumption_mode #=> String, one of "DISABLED", "ENABLED", "ENFORCED"
|
1498
|
+
# resp.server.protocol_details.set_stat_option #=> String, one of "DEFAULT", "ENABLE_NO_OP"
|
1469
1499
|
# resp.server.domain #=> String, one of "S3", "EFS"
|
1470
1500
|
# resp.server.endpoint_details.address_allocation_ids #=> Array
|
1471
1501
|
# resp.server.endpoint_details.address_allocation_ids[0] #=> String
|
@@ -1659,6 +1689,8 @@ module Aws::Transfer
|
|
1659
1689
|
# @option params [required, String] :ssh_public_key_body
|
1660
1690
|
# The public key portion of an SSH key pair.
|
1661
1691
|
#
|
1692
|
+
# Transfer Family accepts RSA, ECDSA, and ED25519 keys.
|
1693
|
+
#
|
1662
1694
|
# @option params [required, String] :user_name
|
1663
1695
|
# The name of the user account that is assigned to one or more servers.
|
1664
1696
|
#
|
@@ -2518,13 +2550,22 @@ module Aws::Transfer
|
|
2518
2550
|
# @option params [Types::ProtocolDetails] :protocol_details
|
2519
2551
|
# The protocol settings that are configured for your server.
|
2520
2552
|
#
|
2521
|
-
# Use the `PassiveIp` parameter to indicate passive mode (for FTP and
|
2522
|
-
#
|
2523
|
-
#
|
2553
|
+
# * Use the `PassiveIp` parameter to indicate passive mode (for FTP and
|
2554
|
+
# FTPS protocols). Enter a single dotted-quad IPv4 address, such as
|
2555
|
+
# the external IP address of a firewall, router, or load balancer.
|
2524
2556
|
#
|
2525
|
-
# Use the `
|
2526
|
-
#
|
2527
|
-
#
|
2557
|
+
# * Use the `SetStatOption` to ignore the error that is generated when
|
2558
|
+
# the client attempts to use SETSTAT on a file you are uploading to an
|
2559
|
+
# S3 bucket. Set the value to `ENABLE_NO_OP` to have the Transfer
|
2560
|
+
# Family server ignore the SETSTAT command, and upload files without
|
2561
|
+
# needing to make any changes to your SFTP client. Note that with
|
2562
|
+
# `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log
|
2563
|
+
# entry to CloudWatch Logs, so you can determine when the client is
|
2564
|
+
# making a SETSTAT call.
|
2565
|
+
#
|
2566
|
+
# * Use the `TlsSessionResumptionMode` parameter to determine whether or
|
2567
|
+
# not your Transfer server resumes recent, negotiated sessions through
|
2568
|
+
# a unique session ID.
|
2528
2569
|
#
|
2529
2570
|
# @option params [Types::EndpointDetails] :endpoint_details
|
2530
2571
|
# The virtual private cloud (VPC) endpoint settings that are configured
|
@@ -2562,15 +2603,37 @@ module Aws::Transfer
|
|
2562
2603
|
# </note>
|
2563
2604
|
#
|
2564
2605
|
# @option params [String] :host_key
|
2565
|
-
# The RSA
|
2566
|
-
#
|
2606
|
+
# The RSA, ECDSA, or ED25519 private key to use for your server.
|
2607
|
+
#
|
2608
|
+
# Use the following command to generate an RSA 2048 bit key with no
|
2609
|
+
# passphrase:
|
2610
|
+
#
|
2611
|
+
# `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`.
|
2612
|
+
#
|
2613
|
+
# Use a minimum value of 2048 for the `-b` option: you can create a
|
2614
|
+
# stronger key using 3072 or 4096.
|
2615
|
+
#
|
2616
|
+
# Use the following command to generate an ECDSA 256 bit key with no
|
2617
|
+
# passphrase:
|
2618
|
+
#
|
2619
|
+
# `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`.
|
2620
|
+
#
|
2621
|
+
# Valid values for the `-b` option for ECDSA are 256, 384, and 521.
|
2622
|
+
#
|
2623
|
+
# Use the following command to generate an ED25519 key with no
|
2624
|
+
# passphrase:
|
2625
|
+
#
|
2626
|
+
# `ssh-keygen -t ed25519 -N "" -f my-new-server-key`.
|
2627
|
+
#
|
2628
|
+
# For all of these commands, you can replace *my-new-server-key* with a
|
2629
|
+
# string of your choice.
|
2567
2630
|
#
|
2568
2631
|
# If you aren't planning to migrate existing users from an existing
|
2569
|
-
# server to a new server, don't update the host key.
|
2570
|
-
# changing a server's host key can be disruptive.
|
2632
|
+
# SFTP-enabled server to a new server, don't update the host key.
|
2633
|
+
# Accidentally changing a server's host key can be disruptive.
|
2571
2634
|
#
|
2572
2635
|
# For more information, see [Change the host key for your SFTP-enabled
|
2573
|
-
# server][1] in the *Amazon Web
|
2636
|
+
# server][1] in the *Amazon Web Services Transfer Family User Guide*.
|
2574
2637
|
#
|
2575
2638
|
#
|
2576
2639
|
#
|
@@ -2664,6 +2727,7 @@ module Aws::Transfer
|
|
2664
2727
|
# protocol_details: {
|
2665
2728
|
# passive_ip: "PassiveIp",
|
2666
2729
|
# tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
|
2730
|
+
# set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
|
2667
2731
|
# },
|
2668
2732
|
# endpoint_details: {
|
2669
2733
|
# address_allocation_ids: ["AddressAllocationId"],
|
@@ -2866,7 +2930,7 @@ module Aws::Transfer
|
|
2866
2930
|
params: params,
|
2867
2931
|
config: config)
|
2868
2932
|
context[:gem_name] = 'aws-sdk-transfer'
|
2869
|
-
context[:gem_version] = '1.
|
2933
|
+
context[:gem_version] = '1.56.0'
|
2870
2934
|
Seahorse::Client::Request.new(handlers, context)
|
2871
2935
|
end
|
2872
2936
|
|
@@ -165,6 +165,7 @@ module Aws::Transfer
|
|
165
165
|
ServiceMetadata = Shapes::StructureShape.new(name: 'ServiceMetadata')
|
166
166
|
ServiceUnavailableException = Shapes::StructureShape.new(name: 'ServiceUnavailableException')
|
167
167
|
SessionId = Shapes::StringShape.new(name: 'SessionId')
|
168
|
+
SetStatOption = Shapes::StringShape.new(name: 'SetStatOption')
|
168
169
|
SourceFileLocation = Shapes::StringShape.new(name: 'SourceFileLocation')
|
169
170
|
SourceIp = Shapes::StringShape.new(name: 'SourceIp')
|
170
171
|
SshPublicKey = Shapes::StructureShape.new(name: 'SshPublicKey')
|
@@ -612,6 +613,7 @@ module Aws::Transfer
|
|
612
613
|
|
613
614
|
ProtocolDetails.add_member(:passive_ip, Shapes::ShapeRef.new(shape: PassiveIp, location_name: "PassiveIp"))
|
614
615
|
ProtocolDetails.add_member(:tls_session_resumption_mode, Shapes::ShapeRef.new(shape: TlsSessionResumptionMode, location_name: "TlsSessionResumptionMode"))
|
616
|
+
ProtocolDetails.add_member(:set_stat_option, Shapes::ShapeRef.new(shape: SetStatOption, location_name: "SetStatOption"))
|
615
617
|
ProtocolDetails.struct_class = Types::ProtocolDetails
|
616
618
|
|
617
619
|
Protocols.member = Shapes::ShapeRef.new(shape: Protocol)
|
@@ -300,6 +300,7 @@ module Aws::Transfer
|
|
300
300
|
# protocol_details: {
|
301
301
|
# passive_ip: "PassiveIp",
|
302
302
|
# tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
|
303
|
+
# set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
|
303
304
|
# },
|
304
305
|
# security_policy_name: "SecurityPolicyName",
|
305
306
|
# tags: [
|
@@ -409,8 +410,30 @@ module Aws::Transfer
|
|
409
410
|
# @return [String]
|
410
411
|
#
|
411
412
|
# @!attribute [rw] host_key
|
412
|
-
# The RSA
|
413
|
-
#
|
413
|
+
# The RSA, ECDSA, or ED25519 private key to use for your server.
|
414
|
+
#
|
415
|
+
# Use the following command to generate an RSA 2048 bit key with no
|
416
|
+
# passphrase:
|
417
|
+
#
|
418
|
+
# `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`.
|
419
|
+
#
|
420
|
+
# Use a minimum value of 2048 for the `-b` option: you can create a
|
421
|
+
# stronger key using 3072 or 4096.
|
422
|
+
#
|
423
|
+
# Use the following command to generate an ECDSA 256 bit key with no
|
424
|
+
# passphrase:
|
425
|
+
#
|
426
|
+
# `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`.
|
427
|
+
#
|
428
|
+
# Valid values for the `-b` option for ECDSA are 256, 384, and 521.
|
429
|
+
#
|
430
|
+
# Use the following command to generate an ED25519 key with no
|
431
|
+
# passphrase:
|
432
|
+
#
|
433
|
+
# `ssh-keygen -t ed25519 -N "" -f my-new-server-key`.
|
434
|
+
#
|
435
|
+
# For all of these commands, you can replace *my-new-server-key* with
|
436
|
+
# a string of your choice.
|
414
437
|
#
|
415
438
|
# If you aren't planning to migrate existing users from an existing
|
416
439
|
# SFTP-enabled server to a new server, don't update the host key.
|
@@ -519,13 +542,23 @@ module Aws::Transfer
|
|
519
542
|
# @!attribute [rw] protocol_details
|
520
543
|
# The protocol settings that are configured for your server.
|
521
544
|
#
|
522
|
-
# Use the `PassiveIp` parameter to indicate passive mode (for FTP
|
523
|
-
#
|
524
|
-
#
|
525
|
-
#
|
526
|
-
#
|
527
|
-
#
|
528
|
-
#
|
545
|
+
# * Use the `PassiveIp` parameter to indicate passive mode (for FTP
|
546
|
+
# and FTPS protocols). Enter a single dotted-quad IPv4 address, such
|
547
|
+
# as the external IP address of a firewall, router, or load
|
548
|
+
# balancer.
|
549
|
+
#
|
550
|
+
# * Use the `SetStatOption` to ignore the error that is generated when
|
551
|
+
# the client attempts to use SETSTAT on a file you are uploading to
|
552
|
+
# an S3 bucket. Set the value to `ENABLE_NO_OP` to have the Transfer
|
553
|
+
# Family server ignore the SETSTAT command, and upload files without
|
554
|
+
# needing to make any changes to your SFTP client. Note that with
|
555
|
+
# `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log
|
556
|
+
# entry to CloudWatch Logs, so you can determine when the client is
|
557
|
+
# making a SETSTAT call.
|
558
|
+
#
|
559
|
+
# * Use the `TlsSessionResumptionMode` parameter to determine whether
|
560
|
+
# or not your Transfer server resumes recent, negotiated sessions
|
561
|
+
# through a unique session ID.
|
529
562
|
# @return [Types::ProtocolDetails]
|
530
563
|
#
|
531
564
|
# @!attribute [rw] security_policy_name
|
@@ -706,10 +739,7 @@ module Aws::Transfer
|
|
706
739
|
# The public portion of the Secure Shell (SSH) key used to
|
707
740
|
# authenticate the user to the server.
|
708
741
|
#
|
709
|
-
#
|
710
|
-
# (keys beginning with `ecdsa`).
|
711
|
-
#
|
712
|
-
# </note>
|
742
|
+
# Transfer Family accepts RSA, ECDSA, and ED25519 keys.
|
713
743
|
# @return [String]
|
714
744
|
#
|
715
745
|
# @!attribute [rw] tags
|
@@ -1616,8 +1646,8 @@ module Aws::Transfer
|
|
1616
1646
|
# The protocol settings that are configured for your server.
|
1617
1647
|
#
|
1618
1648
|
# Use the `PassiveIp` parameter to indicate passive mode. Enter a
|
1619
|
-
# single
|
1620
|
-
#
|
1649
|
+
# single IPv4 address, such as the public IP address of a firewall,
|
1650
|
+
# router, or load balancer.
|
1621
1651
|
# @return [Types::ProtocolDetails]
|
1622
1652
|
#
|
1623
1653
|
# @!attribute [rw] domain
|
@@ -2273,6 +2303,8 @@ module Aws::Transfer
|
|
2273
2303
|
#
|
2274
2304
|
# @!attribute [rw] ssh_public_key_body
|
2275
2305
|
# The public key portion of an SSH key pair.
|
2306
|
+
#
|
2307
|
+
# Transfer Family accepts RSA, ECDSA, and ED25519 keys.
|
2276
2308
|
# @return [String]
|
2277
2309
|
#
|
2278
2310
|
# @!attribute [rw] user_name
|
@@ -3156,12 +3188,13 @@ module Aws::Transfer
|
|
3156
3188
|
# {
|
3157
3189
|
# passive_ip: "PassiveIp",
|
3158
3190
|
# tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
|
3191
|
+
# set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
|
3159
3192
|
# }
|
3160
3193
|
#
|
3161
3194
|
# @!attribute [rw] passive_ip
|
3162
3195
|
# Indicates passive mode, for FTP and FTPS protocols. Enter a single
|
3163
|
-
#
|
3164
|
-
#
|
3196
|
+
# IPv4 address, such as the public IP address of a firewall, router,
|
3197
|
+
# or load balancer. For example:
|
3165
3198
|
#
|
3166
3199
|
# ` aws transfer update-server --protocol-details PassiveIp=0.0.0.0 `
|
3167
3200
|
#
|
@@ -3169,10 +3202,10 @@ module Aws::Transfer
|
|
3169
3202
|
# you want to use.
|
3170
3203
|
#
|
3171
3204
|
# <note markdown="1"> If you change the `PassiveIp` value, you must stop and then restart
|
3172
|
-
# your Transfer server for the change to take effect. For
|
3173
|
-
# using
|
3174
|
-
# FTPS server behind a firewall or NAT with
|
3175
|
-
#
|
3205
|
+
# your Transfer Family server for the change to take effect. For
|
3206
|
+
# details on using passive mode (PASV) in a NAT environment, see
|
3207
|
+
# [Configuring your FTPS server behind a firewall or NAT with Transfer
|
3208
|
+
# Family][1].
|
3176
3209
|
#
|
3177
3210
|
# </note>
|
3178
3211
|
#
|
@@ -3182,14 +3215,15 @@ module Aws::Transfer
|
|
3182
3215
|
# @return [String]
|
3183
3216
|
#
|
3184
3217
|
# @!attribute [rw] tls_session_resumption_mode
|
3185
|
-
# A property used with Transfer servers that use the FTPS
|
3186
|
-
# TLS Session Resumption provides a mechanism to resume or
|
3187
|
-
# negotiated secret key between the control and data
|
3188
|
-
# FTPS session. `TlsSessionResumptionMode`
|
3189
|
-
# the server resumes recent, negotiated
|
3190
|
-
# session ID. This property is available
|
3191
|
-
# `UpdateServer` calls. If a
|
3192
|
-
#
|
3218
|
+
# A property used with Transfer Family servers that use the FTPS
|
3219
|
+
# protocol. TLS Session Resumption provides a mechanism to resume or
|
3220
|
+
# share a negotiated secret key between the control and data
|
3221
|
+
# connection for an FTPS session. `TlsSessionResumptionMode`
|
3222
|
+
# determines whether or not the server resumes recent, negotiated
|
3223
|
+
# sessions through a unique session ID. This property is available
|
3224
|
+
# during `CreateServer` and `UpdateServer` calls. If a
|
3225
|
+
# `TlsSessionResumptionMode` value is not specified during
|
3226
|
+
# `CreateServer`, it is set to `ENFORCED` by default.
|
3193
3227
|
#
|
3194
3228
|
# * `DISABLED`\: the server does not process TLS session resumption
|
3195
3229
|
# client requests and creates a new TLS session for each request.
|
@@ -3214,11 +3248,39 @@ module Aws::Transfer
|
|
3214
3248
|
# </note>
|
3215
3249
|
# @return [String]
|
3216
3250
|
#
|
3251
|
+
# @!attribute [rw] set_stat_option
|
3252
|
+
# Use the `SetStatOption` to ignore the error that is generated when
|
3253
|
+
# the client attempts to use `SETSTAT` on a file you are uploading to
|
3254
|
+
# an S3 bucket.
|
3255
|
+
#
|
3256
|
+
# Some SFTP file transfer clients can attempt to change the attributes
|
3257
|
+
# of remote files, including timestamp and permissions, using
|
3258
|
+
# commands, such as `SETSTAT` when uploading the file. However, these
|
3259
|
+
# commands are not compatible with object storage systems, such as
|
3260
|
+
# Amazon S3. Due to this incompatibility, file uploads from these
|
3261
|
+
# clients can result in errors even when the file is otherwise
|
3262
|
+
# successfully uploaded.
|
3263
|
+
#
|
3264
|
+
# Set the value to `ENABLE_NO_OP` to have the Transfer Family server
|
3265
|
+
# ignore the `SETSTAT` command, and upload files without needing to
|
3266
|
+
# make any changes to your SFTP client. While the `SetStatOption`
|
3267
|
+
# `ENABLE_NO_OP` setting ignores the error, it does generate a log
|
3268
|
+
# entry in Amazon CloudWatch Logs, so you can determine when the
|
3269
|
+
# client is making a `SETSTAT` call.
|
3270
|
+
#
|
3271
|
+
# <note markdown="1"> If you want to preserve the original timestamp for your file, and
|
3272
|
+
# modify other file attributes using `SETSTAT`, you can use Amazon EFS
|
3273
|
+
# as backend storage with Transfer Family.
|
3274
|
+
#
|
3275
|
+
# </note>
|
3276
|
+
# @return [String]
|
3277
|
+
#
|
3217
3278
|
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ProtocolDetails AWS API Documentation
|
3218
3279
|
#
|
3219
3280
|
class ProtocolDetails < Struct.new(
|
3220
3281
|
:passive_ip,
|
3221
|
-
:tls_session_resumption_mode
|
3282
|
+
:tls_session_resumption_mode,
|
3283
|
+
:set_stat_option)
|
3222
3284
|
SENSITIVE = []
|
3223
3285
|
include Aws::Structure
|
3224
3286
|
end
|
@@ -3456,6 +3518,8 @@ module Aws::Transfer
|
|
3456
3518
|
# @!attribute [rw] ssh_public_key_body
|
3457
3519
|
# Specifies the content of the SSH public key as specified by the
|
3458
3520
|
# `PublicKeyId`.
|
3521
|
+
#
|
3522
|
+
# Transfer Family accepts RSA, ECDSA, and ED25519 keys.
|
3459
3523
|
# @return [String]
|
3460
3524
|
#
|
3461
3525
|
# @!attribute [rw] ssh_public_key_id
|
@@ -3713,8 +3777,6 @@ module Aws::Transfer
|
|
3713
3777
|
|
3714
3778
|
# The request was denied due to request throttling.
|
3715
3779
|
#
|
3716
|
-
# HTTP Status Code: 400
|
3717
|
-
#
|
3718
3780
|
# @!attribute [rw] retry_after_seconds
|
3719
3781
|
# @return [String]
|
3720
3782
|
#
|
@@ -3936,6 +3998,7 @@ module Aws::Transfer
|
|
3936
3998
|
# protocol_details: {
|
3937
3999
|
# passive_ip: "PassiveIp",
|
3938
4000
|
# tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
|
4001
|
+
# set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
|
3939
4002
|
# },
|
3940
4003
|
# endpoint_details: {
|
3941
4004
|
# address_allocation_ids: ["AddressAllocationId"],
|
@@ -4013,13 +4076,23 @@ module Aws::Transfer
|
|
4013
4076
|
# @!attribute [rw] protocol_details
|
4014
4077
|
# The protocol settings that are configured for your server.
|
4015
4078
|
#
|
4016
|
-
# Use the `PassiveIp` parameter to indicate passive mode (for FTP
|
4017
|
-
#
|
4018
|
-
#
|
4019
|
-
#
|
4020
|
-
#
|
4021
|
-
#
|
4022
|
-
#
|
4079
|
+
# * Use the `PassiveIp` parameter to indicate passive mode (for FTP
|
4080
|
+
# and FTPS protocols). Enter a single dotted-quad IPv4 address, such
|
4081
|
+
# as the external IP address of a firewall, router, or load
|
4082
|
+
# balancer.
|
4083
|
+
#
|
4084
|
+
# * Use the `SetStatOption` to ignore the error that is generated when
|
4085
|
+
# the client attempts to use SETSTAT on a file you are uploading to
|
4086
|
+
# an S3 bucket. Set the value to `ENABLE_NO_OP` to have the Transfer
|
4087
|
+
# Family server ignore the SETSTAT command, and upload files without
|
4088
|
+
# needing to make any changes to your SFTP client. Note that with
|
4089
|
+
# `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log
|
4090
|
+
# entry to CloudWatch Logs, so you can determine when the client is
|
4091
|
+
# making a SETSTAT call.
|
4092
|
+
#
|
4093
|
+
# * Use the `TlsSessionResumptionMode` parameter to determine whether
|
4094
|
+
# or not your Transfer server resumes recent, negotiated sessions
|
4095
|
+
# through a unique session ID.
|
4023
4096
|
# @return [Types::ProtocolDetails]
|
4024
4097
|
#
|
4025
4098
|
# @!attribute [rw] endpoint_details
|
@@ -4060,15 +4133,37 @@ module Aws::Transfer
|
|
4060
4133
|
# @return [String]
|
4061
4134
|
#
|
4062
4135
|
# @!attribute [rw] host_key
|
4063
|
-
# The RSA
|
4064
|
-
#
|
4136
|
+
# The RSA, ECDSA, or ED25519 private key to use for your server.
|
4137
|
+
#
|
4138
|
+
# Use the following command to generate an RSA 2048 bit key with no
|
4139
|
+
# passphrase:
|
4140
|
+
#
|
4141
|
+
# `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`.
|
4142
|
+
#
|
4143
|
+
# Use a minimum value of 2048 for the `-b` option: you can create a
|
4144
|
+
# stronger key using 3072 or 4096.
|
4145
|
+
#
|
4146
|
+
# Use the following command to generate an ECDSA 256 bit key with no
|
4147
|
+
# passphrase:
|
4148
|
+
#
|
4149
|
+
# `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`.
|
4150
|
+
#
|
4151
|
+
# Valid values for the `-b` option for ECDSA are 256, 384, and 521.
|
4152
|
+
#
|
4153
|
+
# Use the following command to generate an ED25519 key with no
|
4154
|
+
# passphrase:
|
4155
|
+
#
|
4156
|
+
# `ssh-keygen -t ed25519 -N "" -f my-new-server-key`.
|
4157
|
+
#
|
4158
|
+
# For all of these commands, you can replace *my-new-server-key* with
|
4159
|
+
# a string of your choice.
|
4065
4160
|
#
|
4066
4161
|
# If you aren't planning to migrate existing users from an existing
|
4067
|
-
# server to a new server, don't update the host key.
|
4068
|
-
# changing a server's host key can be disruptive.
|
4162
|
+
# SFTP-enabled server to a new server, don't update the host key.
|
4163
|
+
# Accidentally changing a server's host key can be disruptive.
|
4069
4164
|
#
|
4070
4165
|
# For more information, see [Change the host key for your SFTP-enabled
|
4071
|
-
# server][1] in the *Amazon Web
|
4166
|
+
# server][1] in the *Amazon Web Services Transfer Family User Guide*.
|
4072
4167
|
#
|
4073
4168
|
#
|
4074
4169
|
#
|
data/lib/aws-sdk-transfer.rb
CHANGED
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: aws-sdk-transfer
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.
|
4
|
+
version: 1.56.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Amazon Web Services
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2022-
|
11
|
+
date: 2022-06-22 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: aws-sdk-core
|