aws-sdk-transfer 1.54.0 → 1.57.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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +15 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-transfer/client.rb +1266 -235
- data/lib/aws-sdk-transfer/client_api.rb +629 -0
- data/lib/aws-sdk-transfer/types.rb +2059 -463
- data/lib/aws-sdk-transfer.rb +1 -1
- metadata +2 -2
|
@@ -363,11 +363,11 @@ module Aws::Transfer
|
|
|
363
363
|
|
|
364
364
|
# Used by administrators to choose which groups in the directory should
|
|
365
365
|
# have access to upload and download files over the enabled protocols
|
|
366
|
-
# using
|
|
367
|
-
#
|
|
368
|
-
#
|
|
369
|
-
#
|
|
370
|
-
#
|
|
366
|
+
# using Transfer Family. For example, a Microsoft Active Directory might
|
|
367
|
+
# contain 50,000 users, but only a small fraction might need the ability
|
|
368
|
+
# to transfer files to the server. An administrator can use
|
|
369
|
+
# `CreateAccess` to limit the access to the correct set of users who
|
|
370
|
+
# need this ability.
|
|
371
371
|
#
|
|
372
372
|
# @option params [String] :home_directory
|
|
373
373
|
# The landing directory (folder) for a user when they log in to the
|
|
@@ -376,12 +376,13 @@ module Aws::Transfer
|
|
|
376
376
|
# A `HomeDirectory` example is `/bucket_name/home/mydirectory`.
|
|
377
377
|
#
|
|
378
378
|
# @option params [String] :home_directory_type
|
|
379
|
-
# The type of landing directory (folder) you want your users' home
|
|
380
|
-
# directory to be when they log
|
|
379
|
+
# The type of landing directory (folder) that you want your users' home
|
|
380
|
+
# directory to be when they log in to the server. If you set it to
|
|
381
381
|
# `PATH`, the user will see the absolute Amazon S3 bucket or EFS paths
|
|
382
382
|
# as is in their file transfer protocol clients. If you set it
|
|
383
383
|
# `LOGICAL`, you need to provide mappings in the `HomeDirectoryMappings`
|
|
384
|
-
# for how you want to make Amazon S3 or EFS paths visible to your
|
|
384
|
+
# for how you want to make Amazon S3 or Amazon EFS paths visible to your
|
|
385
|
+
# users.
|
|
385
386
|
#
|
|
386
387
|
# @option params [Array<Types::HomeDirectoryMapEntry>] :home_directory_mappings
|
|
387
388
|
# Logical directory mappings that specify what Amazon S3 or Amazon EFS
|
|
@@ -389,10 +390,9 @@ module Aws::Transfer
|
|
|
389
390
|
# them visible. You must specify the `Entry` and `Target` pair, where
|
|
390
391
|
# `Entry` shows how the path is made visible and `Target` is the actual
|
|
391
392
|
# Amazon S3 or Amazon EFS path. If you only specify a target, it is
|
|
392
|
-
# displayed as is. You also must ensure that your
|
|
393
|
-
#
|
|
394
|
-
#
|
|
395
|
-
# to *LOGICAL*.
|
|
393
|
+
# displayed as is. You also must ensure that your Identity and Access
|
|
394
|
+
# Management (IAM) role provides access to paths in `Target`. This value
|
|
395
|
+
# can be set only when `HomeDirectoryType` is set to *LOGICAL*.
|
|
396
396
|
#
|
|
397
397
|
# The following is an `Entry` and `Target` pair example.
|
|
398
398
|
#
|
|
@@ -409,24 +409,24 @@ module Aws::Transfer
|
|
|
409
409
|
# `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
|
|
410
410
|
#
|
|
411
411
|
# @option params [String] :policy
|
|
412
|
-
# A session policy for your user so that you can use the same
|
|
413
|
-
# across multiple users. This policy
|
|
414
|
-
#
|
|
415
|
-
# policy include
|
|
416
|
-
# `$\{Transfer:
|
|
412
|
+
# A session policy for your user so that you can use the same Identity
|
|
413
|
+
# and Access Management (IAM) role across multiple users. This policy
|
|
414
|
+
# scopes down a user's access to portions of their Amazon S3 bucket.
|
|
415
|
+
# Variables that you can use inside this policy include
|
|
416
|
+
# `$\{Transfer:UserName\}`, `$\{Transfer:HomeDirectory\}`, and
|
|
417
|
+
# `$\{Transfer:HomeBucket\}`.
|
|
417
418
|
#
|
|
418
|
-
# <note markdown="1"> This
|
|
419
|
-
# use session policies.
|
|
419
|
+
# <note markdown="1"> This policy applies only when the domain of `ServerId` is Amazon S3.
|
|
420
|
+
# Amazon EFS does not use session policies.
|
|
420
421
|
#
|
|
421
|
-
# For session policies,
|
|
422
|
-
#
|
|
423
|
-
#
|
|
424
|
-
# `Policy` argument.
|
|
422
|
+
# For session policies, Transfer Family stores the policy as a JSON
|
|
423
|
+
# blob, instead of the Amazon Resource Name (ARN) of the policy. You
|
|
424
|
+
# save the policy as a JSON blob and pass it in the `Policy` argument.
|
|
425
425
|
#
|
|
426
426
|
# For an example of a session policy, see [Example session policy][1].
|
|
427
427
|
#
|
|
428
|
-
# For more information, see [AssumeRole][2] in the *
|
|
429
|
-
#
|
|
428
|
+
# For more information, see [AssumeRole][2] in the *Security Token
|
|
429
|
+
# Service API Reference*.
|
|
430
430
|
#
|
|
431
431
|
# </note>
|
|
432
432
|
#
|
|
@@ -444,13 +444,14 @@ module Aws::Transfer
|
|
|
444
444
|
# out of your Amazon EFS file systems.
|
|
445
445
|
#
|
|
446
446
|
# @option params [required, String] :role
|
|
447
|
-
#
|
|
448
|
-
# your users' access to your Amazon S3 bucket
|
|
449
|
-
#
|
|
450
|
-
# want to provide your users when
|
|
451
|
-
#
|
|
452
|
-
#
|
|
453
|
-
# resources when servicing your
|
|
447
|
+
# The Amazon Resource Name (ARN) of the Identity and Access Management
|
|
448
|
+
# (IAM) role that controls your users' access to your Amazon S3 bucket
|
|
449
|
+
# or Amazon EFS file system. The policies attached to this role
|
|
450
|
+
# determine the level of access that you want to provide your users when
|
|
451
|
+
# transferring files into and out of your Amazon S3 bucket or Amazon EFS
|
|
452
|
+
# file system. The IAM role should also contain a trust relationship
|
|
453
|
+
# that allows the server to access your resources when servicing your
|
|
454
|
+
# users' transfer requests.
|
|
454
455
|
#
|
|
455
456
|
# @option params [required, String] :server_id
|
|
456
457
|
# A system-assigned unique identifier for a server instance. This is the
|
|
@@ -460,9 +461,9 @@ module Aws::Transfer
|
|
|
460
461
|
# A unique identifier that is required to identify specific groups
|
|
461
462
|
# within your directory. The users of the group that you associate have
|
|
462
463
|
# access to your Amazon S3 or Amazon EFS resources over the enabled
|
|
463
|
-
# protocols using
|
|
464
|
-
#
|
|
465
|
-
#
|
|
464
|
+
# protocols using Transfer Family. If you know the group name, you can
|
|
465
|
+
# view the SID values by running the following command using Windows
|
|
466
|
+
# PowerShell.
|
|
466
467
|
#
|
|
467
468
|
# `Get-ADGroup -Filter \{samAccountName -like "YourGroupName*"\}
|
|
468
469
|
# -Properties * | Select SamAccountName,ObjectSid`
|
|
@@ -470,10 +471,10 @@ module Aws::Transfer
|
|
|
470
471
|
# In that command, replace *YourGroupName* with the name of your Active
|
|
471
472
|
# Directory group.
|
|
472
473
|
#
|
|
473
|
-
# The
|
|
474
|
-
# consisting of uppercase and lowercase alphanumeric
|
|
475
|
-
# spaces. You can also include underscores or any of
|
|
476
|
-
# characters: =,.@:/-
|
|
474
|
+
# The regular expression used to validate this parameter is a string of
|
|
475
|
+
# characters consisting of uppercase and lowercase alphanumeric
|
|
476
|
+
# characters with no spaces. You can also include underscores or any of
|
|
477
|
+
# the following characters: =,.@:/-
|
|
477
478
|
#
|
|
478
479
|
# @return [Types::CreateAccessResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
479
480
|
#
|
|
@@ -516,6 +517,214 @@ module Aws::Transfer
|
|
|
516
517
|
req.send_request(options)
|
|
517
518
|
end
|
|
518
519
|
|
|
520
|
+
# Creates an agreement. An agreement is a bilateral trading partner
|
|
521
|
+
# agreement, or partnership, between an Transfer Family server and an
|
|
522
|
+
# AS2 process. The agreement defines the file and message transfer
|
|
523
|
+
# relationship between the server and the AS2 process. To define an
|
|
524
|
+
# agreement, Transfer Family combines a server, local profile, partner
|
|
525
|
+
# profile, certificate, and other attributes.
|
|
526
|
+
#
|
|
527
|
+
# The partner is identified with the `PartnerProfileId`, and the AS2
|
|
528
|
+
# process is identified with the `LocalProfileId`.
|
|
529
|
+
#
|
|
530
|
+
# @option params [String] :description
|
|
531
|
+
# A name or short description to identify the agreement.
|
|
532
|
+
#
|
|
533
|
+
# @option params [required, String] :server_id
|
|
534
|
+
# A system-assigned unique identifier for a server instance. This is the
|
|
535
|
+
# specific server that the agreement uses.
|
|
536
|
+
#
|
|
537
|
+
# @option params [required, String] :local_profile_id
|
|
538
|
+
# A unique identifier for the AS2 local profile.
|
|
539
|
+
#
|
|
540
|
+
# @option params [required, String] :partner_profile_id
|
|
541
|
+
# A unique identifier for the partner profile used in the agreement.
|
|
542
|
+
#
|
|
543
|
+
# @option params [required, String] :base_directory
|
|
544
|
+
# The landing directory (folder) for files transferred by using the AS2
|
|
545
|
+
# protocol.
|
|
546
|
+
#
|
|
547
|
+
# A `BaseDirectory` example is `/DOC-EXAMPLE-BUCKET/home/mydirectory `.
|
|
548
|
+
#
|
|
549
|
+
# @option params [required, String] :access_role
|
|
550
|
+
# The Amazon Resource Name (ARN) of the Identity and Access Management
|
|
551
|
+
# (IAM) role that grants access to at least the `HomeDirectory` of your
|
|
552
|
+
# users' Amazon S3 buckets.
|
|
553
|
+
#
|
|
554
|
+
# @option params [String] :status
|
|
555
|
+
# The status of the agreement. The agreement can be either `ACTIVE` or
|
|
556
|
+
# `INACTIVE`.
|
|
557
|
+
#
|
|
558
|
+
# @option params [Array<Types::Tag>] :tags
|
|
559
|
+
# Key-value pairs that can be used to group and search for agreements.
|
|
560
|
+
#
|
|
561
|
+
# @return [Types::CreateAgreementResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
562
|
+
#
|
|
563
|
+
# * {Types::CreateAgreementResponse#agreement_id #agreement_id} => String
|
|
564
|
+
#
|
|
565
|
+
# @example Request syntax with placeholder values
|
|
566
|
+
#
|
|
567
|
+
# resp = client.create_agreement({
|
|
568
|
+
# description: "Description",
|
|
569
|
+
# server_id: "ServerId", # required
|
|
570
|
+
# local_profile_id: "ProfileId", # required
|
|
571
|
+
# partner_profile_id: "ProfileId", # required
|
|
572
|
+
# base_directory: "HomeDirectory", # required
|
|
573
|
+
# access_role: "Role", # required
|
|
574
|
+
# status: "ACTIVE", # accepts ACTIVE, INACTIVE
|
|
575
|
+
# tags: [
|
|
576
|
+
# {
|
|
577
|
+
# key: "TagKey", # required
|
|
578
|
+
# value: "TagValue", # required
|
|
579
|
+
# },
|
|
580
|
+
# ],
|
|
581
|
+
# })
|
|
582
|
+
#
|
|
583
|
+
# @example Response structure
|
|
584
|
+
#
|
|
585
|
+
# resp.agreement_id #=> String
|
|
586
|
+
#
|
|
587
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/CreateAgreement AWS API Documentation
|
|
588
|
+
#
|
|
589
|
+
# @overload create_agreement(params = {})
|
|
590
|
+
# @param [Hash] params ({})
|
|
591
|
+
def create_agreement(params = {}, options = {})
|
|
592
|
+
req = build_request(:create_agreement, params)
|
|
593
|
+
req.send_request(options)
|
|
594
|
+
end
|
|
595
|
+
|
|
596
|
+
# Creates the connector, which captures the parameters for an outbound
|
|
597
|
+
# connection for the AS2 protocol. The connector is required for sending
|
|
598
|
+
# files from a customer's non Amazon Web Services server.
|
|
599
|
+
#
|
|
600
|
+
# @option params [required, String] :url
|
|
601
|
+
# The URL of the partner's AS2 endpoint.
|
|
602
|
+
#
|
|
603
|
+
# @option params [required, Types::As2ConnectorConfig] :as_2_config
|
|
604
|
+
# A structure that contains the parameters for a connector object.
|
|
605
|
+
#
|
|
606
|
+
# @option params [required, String] :access_role
|
|
607
|
+
# With AS2, you can send files by calling `StartFileTransfer` and
|
|
608
|
+
# specifying the file paths in the request parameter, `SendFilePaths`.
|
|
609
|
+
# We use the file’s parent directory (for example, for
|
|
610
|
+
# `--send-file-paths /bucket/dir/file.txt`, parent directory is
|
|
611
|
+
# `/bucket/dir/`) to temporarily store a processed AS2 message file,
|
|
612
|
+
# store the MDN when we receive them from the partner, and write a final
|
|
613
|
+
# JSON file containing relevant metadata of the transmission. So, the
|
|
614
|
+
# `AccessRole` needs to provide read and write access to the parent
|
|
615
|
+
# directory of the file location used in the `StartFileTransfer`
|
|
616
|
+
# request. Additionally, you need to provide read and write access to
|
|
617
|
+
# the parent directory of the files that you intend to send with
|
|
618
|
+
# `StartFileTransfer`.
|
|
619
|
+
#
|
|
620
|
+
# @option params [String] :logging_role
|
|
621
|
+
# The Amazon Resource Name (ARN) of the Identity and Access Management
|
|
622
|
+
# (IAM) role that allows a connector to turn on CloudWatch logging for
|
|
623
|
+
# Amazon S3 events. When set, you can view connector activity in your
|
|
624
|
+
# CloudWatch logs.
|
|
625
|
+
#
|
|
626
|
+
# @option params [Array<Types::Tag>] :tags
|
|
627
|
+
# Key-value pairs that can be used to group and search for connectors.
|
|
628
|
+
# Tags are metadata attached to connectors for any purpose.
|
|
629
|
+
#
|
|
630
|
+
# @return [Types::CreateConnectorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
631
|
+
#
|
|
632
|
+
# * {Types::CreateConnectorResponse#connector_id #connector_id} => String
|
|
633
|
+
#
|
|
634
|
+
# @example Request syntax with placeholder values
|
|
635
|
+
#
|
|
636
|
+
# resp = client.create_connector({
|
|
637
|
+
# url: "Url", # required
|
|
638
|
+
# as_2_config: { # required
|
|
639
|
+
# local_profile_id: "ProfileId",
|
|
640
|
+
# partner_profile_id: "ProfileId",
|
|
641
|
+
# message_subject: "MessageSubject",
|
|
642
|
+
# compression: "ZLIB", # accepts ZLIB, DISABLED
|
|
643
|
+
# encryption_algorithm: "AES128_CBC", # accepts AES128_CBC, AES192_CBC, AES256_CBC
|
|
644
|
+
# signing_algorithm: "SHA256", # accepts SHA256, SHA384, SHA512, SHA1, NONE
|
|
645
|
+
# mdn_signing_algorithm: "SHA256", # accepts SHA256, SHA384, SHA512, SHA1, NONE, DEFAULT
|
|
646
|
+
# mdn_response: "SYNC", # accepts SYNC, NONE
|
|
647
|
+
# },
|
|
648
|
+
# access_role: "Role", # required
|
|
649
|
+
# logging_role: "Role",
|
|
650
|
+
# tags: [
|
|
651
|
+
# {
|
|
652
|
+
# key: "TagKey", # required
|
|
653
|
+
# value: "TagValue", # required
|
|
654
|
+
# },
|
|
655
|
+
# ],
|
|
656
|
+
# })
|
|
657
|
+
#
|
|
658
|
+
# @example Response structure
|
|
659
|
+
#
|
|
660
|
+
# resp.connector_id #=> String
|
|
661
|
+
#
|
|
662
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/CreateConnector AWS API Documentation
|
|
663
|
+
#
|
|
664
|
+
# @overload create_connector(params = {})
|
|
665
|
+
# @param [Hash] params ({})
|
|
666
|
+
def create_connector(params = {}, options = {})
|
|
667
|
+
req = build_request(:create_connector, params)
|
|
668
|
+
req.send_request(options)
|
|
669
|
+
end
|
|
670
|
+
|
|
671
|
+
# Creates the profile for the AS2 process. The agreement is between the
|
|
672
|
+
# partner and the AS2 process.
|
|
673
|
+
#
|
|
674
|
+
# @option params [required, String] :as_2_id
|
|
675
|
+
# The `As2Id` is the *AS2-name*, as defined in the defined in the [RFC
|
|
676
|
+
# 4130][1]. For inbound transfers, this is the `AS2-From` header for the
|
|
677
|
+
# AS2 messages sent from the partner. For outbound connectors, this is
|
|
678
|
+
# the `AS2-To` header for the AS2 messages sent to the partner using the
|
|
679
|
+
# `StartFileTransfer` API operation. This ID cannot include spaces.
|
|
680
|
+
#
|
|
681
|
+
#
|
|
682
|
+
#
|
|
683
|
+
# [1]: https://datatracker.ietf.org/doc/html/rfc4130
|
|
684
|
+
#
|
|
685
|
+
# @option params [required, String] :profile_type
|
|
686
|
+
# Indicates whether to list only `LOCAL` type profiles or only `PARTNER`
|
|
687
|
+
# type profiles. If not supplied in the request, the command lists all
|
|
688
|
+
# types of profiles.
|
|
689
|
+
#
|
|
690
|
+
# @option params [Array<String>] :certificate_ids
|
|
691
|
+
# An array of identifiers for the imported certificates. You use this
|
|
692
|
+
# identifier for working with profiles and partner profiles.
|
|
693
|
+
#
|
|
694
|
+
# @option params [Array<Types::Tag>] :tags
|
|
695
|
+
# Key-value pairs that can be used to group and search for AS2 profiles.
|
|
696
|
+
#
|
|
697
|
+
# @return [Types::CreateProfileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
698
|
+
#
|
|
699
|
+
# * {Types::CreateProfileResponse#profile_id #profile_id} => String
|
|
700
|
+
#
|
|
701
|
+
# @example Request syntax with placeholder values
|
|
702
|
+
#
|
|
703
|
+
# resp = client.create_profile({
|
|
704
|
+
# as_2_id: "As2Id", # required
|
|
705
|
+
# profile_type: "LOCAL", # required, accepts LOCAL, PARTNER
|
|
706
|
+
# certificate_ids: ["CertificateId"],
|
|
707
|
+
# tags: [
|
|
708
|
+
# {
|
|
709
|
+
# key: "TagKey", # required
|
|
710
|
+
# value: "TagValue", # required
|
|
711
|
+
# },
|
|
712
|
+
# ],
|
|
713
|
+
# })
|
|
714
|
+
#
|
|
715
|
+
# @example Response structure
|
|
716
|
+
#
|
|
717
|
+
# resp.profile_id #=> String
|
|
718
|
+
#
|
|
719
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/CreateProfile AWS API Documentation
|
|
720
|
+
#
|
|
721
|
+
# @overload create_profile(params = {})
|
|
722
|
+
# @param [Hash] params ({})
|
|
723
|
+
def create_profile(params = {}, options = {})
|
|
724
|
+
req = build_request(:create_profile, params)
|
|
725
|
+
req.send_request(options)
|
|
726
|
+
end
|
|
727
|
+
|
|
519
728
|
# Instantiates an auto-scaling virtual server based on the selected file
|
|
520
729
|
# transfer protocol in Amazon Web Services. When you make updates to
|
|
521
730
|
# your file transfer protocol-enabled server or when you work with
|
|
@@ -523,20 +732,18 @@ module Aws::Transfer
|
|
|
523
732
|
# to the newly created server.
|
|
524
733
|
#
|
|
525
734
|
# @option params [String] :certificate
|
|
526
|
-
# The Amazon Resource Name (ARN) of the
|
|
527
|
-
#
|
|
735
|
+
# The Amazon Resource Name (ARN) of the Certificate Manager (ACM)
|
|
736
|
+
# certificate. Required when `Protocols` is set to `FTPS`.
|
|
528
737
|
#
|
|
529
738
|
# To request a new public certificate, see [Request a public
|
|
530
|
-
# certificate][1] in the
|
|
531
|
-
# User Guide</i>.
|
|
739
|
+
# certificate][1] in the *Certificate Manager User Guide*.
|
|
532
740
|
#
|
|
533
741
|
# To import an existing certificate into ACM, see [Importing
|
|
534
|
-
# certificates into ACM][2] in the
|
|
535
|
-
# Manager User Guide</i>.
|
|
742
|
+
# certificates into ACM][2] in the *Certificate Manager User Guide*.
|
|
536
743
|
#
|
|
537
744
|
# To request a private certificate to use FTPS through private IP
|
|
538
|
-
# addresses, see [Request a private certificate][3] in the
|
|
539
|
-
#
|
|
745
|
+
# addresses, see [Request a private certificate][3] in the *Certificate
|
|
746
|
+
# Manager User Guide*.
|
|
540
747
|
#
|
|
541
748
|
# Certificates with the following cryptographic algorithms and key sizes
|
|
542
749
|
# are supported:
|
|
@@ -575,10 +782,10 @@ module Aws::Transfer
|
|
|
575
782
|
# @option params [Types::EndpointDetails] :endpoint_details
|
|
576
783
|
# The virtual private cloud (VPC) endpoint settings that are configured
|
|
577
784
|
# for your server. When you host your endpoint within your VPC, you can
|
|
578
|
-
# make
|
|
579
|
-
# attach Elastic IP addresses and make
|
|
580
|
-
# internet. Your VPC's default security groups are
|
|
581
|
-
# assigned to your endpoint.
|
|
785
|
+
# make your endpoint accessible only to resources within your VPC, or
|
|
786
|
+
# you can attach Elastic IP addresses and make your endpoint accessible
|
|
787
|
+
# to clients over the internet. Your VPC's default security groups are
|
|
788
|
+
# automatically assigned to your endpoint.
|
|
582
789
|
#
|
|
583
790
|
# @option params [String] :endpoint_type
|
|
584
791
|
# The type of endpoint that you want your server to use. You can choose
|
|
@@ -608,15 +815,15 @@ module Aws::Transfer
|
|
|
608
815
|
# </note>
|
|
609
816
|
#
|
|
610
817
|
# @option params [String] :host_key
|
|
611
|
-
# The RSA or
|
|
818
|
+
# The RSA, ECDSA, or ED25519 private key to use for your server.
|
|
612
819
|
#
|
|
613
820
|
# Use the following command to generate an RSA 2048 bit key with no
|
|
614
821
|
# passphrase:
|
|
615
822
|
#
|
|
616
823
|
# `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`.
|
|
617
824
|
#
|
|
618
|
-
# Use a minimum value of 2048 for the `-b` option
|
|
619
|
-
# stronger key using 3072 or 4096.
|
|
825
|
+
# Use a minimum value of 2048 for the `-b` option. You can create a
|
|
826
|
+
# stronger key by using 3072 or 4096.
|
|
620
827
|
#
|
|
621
828
|
# Use the following command to generate an ECDSA 256 bit key with no
|
|
622
829
|
# passphrase:
|
|
@@ -625,7 +832,12 @@ module Aws::Transfer
|
|
|
625
832
|
#
|
|
626
833
|
# Valid values for the `-b` option for ECDSA are 256, 384, and 521.
|
|
627
834
|
#
|
|
628
|
-
#
|
|
835
|
+
# Use the following command to generate an ED25519 key with no
|
|
836
|
+
# passphrase:
|
|
837
|
+
#
|
|
838
|
+
# `ssh-keygen -t ed25519 -N "" -f my-new-server-key`.
|
|
839
|
+
#
|
|
840
|
+
# For all of these commands, you can replace *my-new-server-key* with a
|
|
629
841
|
# string of your choice.
|
|
630
842
|
#
|
|
631
843
|
# If you aren't planning to migrate existing users from an existing
|
|
@@ -633,7 +845,7 @@ module Aws::Transfer
|
|
|
633
845
|
# Accidentally changing a server's host key can be disruptive.
|
|
634
846
|
#
|
|
635
847
|
# For more information, see [Change the host key for your SFTP-enabled
|
|
636
|
-
# server][1] in the *
|
|
848
|
+
# server][1] in the *Transfer Family User Guide*.
|
|
637
849
|
#
|
|
638
850
|
#
|
|
639
851
|
#
|
|
@@ -647,34 +859,35 @@ module Aws::Transfer
|
|
|
647
859
|
# Not required when `IdentityProviderType` is set to `SERVICE_MANAGED`.
|
|
648
860
|
#
|
|
649
861
|
# @option params [String] :identity_provider_type
|
|
650
|
-
#
|
|
651
|
-
#
|
|
652
|
-
# credentials within the
|
|
862
|
+
# The mode of authentication for a server. The default value is
|
|
863
|
+
# `SERVICE_MANAGED`, which allows you to store and access user
|
|
864
|
+
# credentials within the Transfer Family service.
|
|
653
865
|
#
|
|
654
866
|
# Use `AWS_DIRECTORY_SERVICE` to provide access to Active Directory
|
|
655
|
-
# groups in
|
|
656
|
-
# Active Directory in your on-premises environment or in
|
|
657
|
-
# Services using AD
|
|
658
|
-
# a Directory ID using the `IdentityProviderDetails`
|
|
867
|
+
# groups in Directory Service for Microsoft Active Directory or
|
|
868
|
+
# Microsoft Active Directory in your on-premises environment or in
|
|
869
|
+
# Amazon Web Services using AD Connector. This option also requires you
|
|
870
|
+
# to provide a Directory ID by using the `IdentityProviderDetails`
|
|
871
|
+
# parameter.
|
|
659
872
|
#
|
|
660
873
|
# Use the `API_GATEWAY` value to integrate with an identity provider of
|
|
661
874
|
# your choosing. The `API_GATEWAY` setting requires you to provide an
|
|
662
|
-
# API Gateway endpoint URL to call for authentication using
|
|
663
|
-
# `IdentityProviderDetails` parameter.
|
|
875
|
+
# Amazon API Gateway endpoint URL to call for authentication by using
|
|
876
|
+
# the `IdentityProviderDetails` parameter.
|
|
664
877
|
#
|
|
665
|
-
# Use the `AWS_LAMBDA` value to directly use
|
|
878
|
+
# Use the `AWS_LAMBDA` value to directly use an Lambda function as your
|
|
666
879
|
# identity provider. If you choose this value, you must specify the ARN
|
|
667
|
-
# for the
|
|
880
|
+
# for the Lambda function in the `Function` parameter or the
|
|
668
881
|
# `IdentityProviderDetails` data type.
|
|
669
882
|
#
|
|
670
883
|
# @option params [String] :logging_role
|
|
671
|
-
#
|
|
672
|
-
#
|
|
673
|
-
#
|
|
674
|
-
#
|
|
884
|
+
# The Amazon Resource Name (ARN) of the Identity and Access Management
|
|
885
|
+
# (IAM) role that allows a server to turn on Amazon CloudWatch logging
|
|
886
|
+
# for Amazon S3 or Amazon EFSevents. When set, you can view user
|
|
887
|
+
# activity in your CloudWatch logs.
|
|
675
888
|
#
|
|
676
889
|
# @option params [String] :post_authentication_login_banner
|
|
677
|
-
#
|
|
890
|
+
# Specifies a string to display when users connect to a server. This
|
|
678
891
|
# string is displayed after the user authenticates.
|
|
679
892
|
#
|
|
680
893
|
# <note markdown="1"> The SFTP protocol does not support post-authentication display
|
|
@@ -683,9 +896,9 @@ module Aws::Transfer
|
|
|
683
896
|
# </note>
|
|
684
897
|
#
|
|
685
898
|
# @option params [String] :pre_authentication_login_banner
|
|
686
|
-
#
|
|
899
|
+
# Specifies a string to display when users connect to a server. This
|
|
687
900
|
# string is displayed before the user authenticates. For example, the
|
|
688
|
-
# following banner displays details about using the system
|
|
901
|
+
# following banner displays details about using the system:
|
|
689
902
|
#
|
|
690
903
|
# `This system is for the use of authorized users only. Individuals
|
|
691
904
|
# using this computer system without authority, or in excess of their
|
|
@@ -705,33 +918,52 @@ module Aws::Transfer
|
|
|
705
918
|
#
|
|
706
919
|
# * `FTP` (File Transfer Protocol): Unencrypted file transfer
|
|
707
920
|
#
|
|
708
|
-
#
|
|
709
|
-
#
|
|
710
|
-
# server when clients connect to it over FTPS.
|
|
921
|
+
# * `AS2` (Applicability Statement 2): used for transporting structured
|
|
922
|
+
# business-to-business data
|
|
711
923
|
#
|
|
712
|
-
#
|
|
713
|
-
#
|
|
714
|
-
#
|
|
924
|
+
# <note markdown="1"> * If you select `FTPS`, you must choose a certificate stored in
|
|
925
|
+
# Certificate Manager (ACM) which is used to identify your server when
|
|
926
|
+
# clients connect to it over FTPS.
|
|
715
927
|
#
|
|
716
|
-
#
|
|
717
|
-
#
|
|
928
|
+
# * If `Protocol` includes either `FTP` or `FTPS`, then the
|
|
929
|
+
# `EndpointType` must be `VPC` and the `IdentityProviderType` must be
|
|
930
|
+
# `AWS_DIRECTORY_SERVICE` or `API_GATEWAY`.
|
|
718
931
|
#
|
|
719
|
-
#
|
|
720
|
-
#
|
|
721
|
-
#
|
|
932
|
+
# * If `Protocol` includes `FTP`, then `AddressAllocationIds` cannot be
|
|
933
|
+
# associated.
|
|
934
|
+
#
|
|
935
|
+
# * If `Protocol` is set only to `SFTP`, the `EndpointType` can be set
|
|
936
|
+
# to `PUBLIC` and the `IdentityProviderType` can be set to
|
|
937
|
+
# `SERVICE_MANAGED`.
|
|
938
|
+
#
|
|
939
|
+
# * If `Protocol` includes `AS2`, then the `EndpointType` must be `VPC`,
|
|
940
|
+
# and domain must be Amazon S3.
|
|
722
941
|
#
|
|
723
942
|
# </note>
|
|
724
943
|
#
|
|
725
944
|
# @option params [Types::ProtocolDetails] :protocol_details
|
|
726
945
|
# The protocol settings that are configured for your server.
|
|
727
946
|
#
|
|
728
|
-
#
|
|
729
|
-
#
|
|
730
|
-
#
|
|
947
|
+
# * To indicate passive mode (for FTP and FTPS protocols), use the
|
|
948
|
+
# `PassiveIp` parameter. Enter a single dotted-quad IPv4 address, such
|
|
949
|
+
# as the external IP address of a firewall, router, or load balancer.
|
|
950
|
+
#
|
|
951
|
+
# * To ignore the error that is generated when the client attempts to
|
|
952
|
+
# use the `SETSTAT` command on a file that you are uploading to an
|
|
953
|
+
# Amazon S3 bucket, use the `SetStatOption` parameter. To have the
|
|
954
|
+
# Transfer Family server ignore the `SETSTAT` command and upload files
|
|
955
|
+
# without needing to make any changes to your SFTP client, set the
|
|
956
|
+
# value to `ENABLE_NO_OP`. If you set the `SetStatOption` parameter to
|
|
957
|
+
# `ENABLE_NO_OP`, Transfer Family generates a log entry to Amazon
|
|
958
|
+
# CloudWatch Logs, so that you can determine when the client is making
|
|
959
|
+
# a `SETSTAT` call.
|
|
731
960
|
#
|
|
732
|
-
#
|
|
733
|
-
#
|
|
734
|
-
#
|
|
961
|
+
# * To determine whether your Transfer Family server resumes recent,
|
|
962
|
+
# negotiated sessions through a unique session ID, use the
|
|
963
|
+
# `TlsSessionResumptionMode` parameter.
|
|
964
|
+
#
|
|
965
|
+
# * `As2Transports` indicates the transport method for the AS2 messages.
|
|
966
|
+
# Currently, only HTTP is supported.
|
|
735
967
|
#
|
|
736
968
|
# @option params [String] :security_policy_name
|
|
737
969
|
# Specifies the name of the security policy that is attached to the
|
|
@@ -742,7 +974,7 @@ module Aws::Transfer
|
|
|
742
974
|
#
|
|
743
975
|
# @option params [Types::WorkflowDetails] :workflow_details
|
|
744
976
|
# Specifies the workflow ID for the workflow to assign and the execution
|
|
745
|
-
# role used for executing the workflow.
|
|
977
|
+
# role that's used for executing the workflow.
|
|
746
978
|
#
|
|
747
979
|
# @return [Types::CreateServerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
748
980
|
#
|
|
@@ -772,10 +1004,12 @@ module Aws::Transfer
|
|
|
772
1004
|
# logging_role: "Role",
|
|
773
1005
|
# post_authentication_login_banner: "PostAuthenticationLoginBanner",
|
|
774
1006
|
# pre_authentication_login_banner: "PreAuthenticationLoginBanner",
|
|
775
|
-
# protocols: ["SFTP"], # accepts SFTP, FTP, FTPS
|
|
1007
|
+
# protocols: ["SFTP"], # accepts SFTP, FTP, FTPS, AS2
|
|
776
1008
|
# protocol_details: {
|
|
777
1009
|
# passive_ip: "PassiveIp",
|
|
778
1010
|
# tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
|
|
1011
|
+
# set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
|
|
1012
|
+
# as_2_transports: ["HTTP"], # accepts HTTP
|
|
779
1013
|
# },
|
|
780
1014
|
# security_policy_name: "SecurityPolicyName",
|
|
781
1015
|
# tags: [
|
|
@@ -812,9 +1046,9 @@ module Aws::Transfer
|
|
|
812
1046
|
# servers that have the `IdentityProviderType` set to `SERVICE_MANAGED`.
|
|
813
1047
|
# Using parameters for `CreateUser`, you can specify the user name, set
|
|
814
1048
|
# the home directory, store the user's public key, and assign the
|
|
815
|
-
# user's
|
|
816
|
-
#
|
|
817
|
-
#
|
|
1049
|
+
# user's Identity and Access Management (IAM) role. You can also
|
|
1050
|
+
# optionally add a session policy, and assign metadata with tags that
|
|
1051
|
+
# can be used to group and search for users.
|
|
818
1052
|
#
|
|
819
1053
|
# @option params [String] :home_directory
|
|
820
1054
|
# The landing directory (folder) for a user when they log in to the
|
|
@@ -823,12 +1057,13 @@ module Aws::Transfer
|
|
|
823
1057
|
# A `HomeDirectory` example is `/bucket_name/home/mydirectory`.
|
|
824
1058
|
#
|
|
825
1059
|
# @option params [String] :home_directory_type
|
|
826
|
-
# The type of landing directory (folder) you want your users' home
|
|
827
|
-
# directory to be when they log
|
|
1060
|
+
# The type of landing directory (folder) that you want your users' home
|
|
1061
|
+
# directory to be when they log in to the server. If you set it to
|
|
828
1062
|
# `PATH`, the user will see the absolute Amazon S3 bucket or EFS paths
|
|
829
1063
|
# as is in their file transfer protocol clients. If you set it
|
|
830
1064
|
# `LOGICAL`, you need to provide mappings in the `HomeDirectoryMappings`
|
|
831
|
-
# for how you want to make Amazon S3 or EFS paths visible to your
|
|
1065
|
+
# for how you want to make Amazon S3 or Amazon EFS paths visible to your
|
|
1066
|
+
# users.
|
|
832
1067
|
#
|
|
833
1068
|
# @option params [Array<Types::HomeDirectoryMapEntry>] :home_directory_mappings
|
|
834
1069
|
# Logical directory mappings that specify what Amazon S3 or Amazon EFS
|
|
@@ -836,10 +1071,9 @@ module Aws::Transfer
|
|
|
836
1071
|
# them visible. You must specify the `Entry` and `Target` pair, where
|
|
837
1072
|
# `Entry` shows how the path is made visible and `Target` is the actual
|
|
838
1073
|
# Amazon S3 or Amazon EFS path. If you only specify a target, it is
|
|
839
|
-
# displayed as is. You also must ensure that your
|
|
840
|
-
#
|
|
841
|
-
#
|
|
842
|
-
# to *LOGICAL*.
|
|
1074
|
+
# displayed as is. You also must ensure that your Identity and Access
|
|
1075
|
+
# Management (IAM) role provides access to paths in `Target`. This value
|
|
1076
|
+
# can be set only when `HomeDirectoryType` is set to *LOGICAL*.
|
|
843
1077
|
#
|
|
844
1078
|
# The following is an `Entry` and `Target` pair example.
|
|
845
1079
|
#
|
|
@@ -856,19 +1090,19 @@ module Aws::Transfer
|
|
|
856
1090
|
# `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
|
|
857
1091
|
#
|
|
858
1092
|
# @option params [String] :policy
|
|
859
|
-
# A session policy for your user so that you can use the same
|
|
860
|
-
# across multiple users. This policy
|
|
861
|
-
#
|
|
862
|
-
# policy include
|
|
863
|
-
# `$\{Transfer:
|
|
1093
|
+
# A session policy for your user so that you can use the same Identity
|
|
1094
|
+
# and Access Management (IAM) role across multiple users. This policy
|
|
1095
|
+
# scopes down a user's access to portions of their Amazon S3 bucket.
|
|
1096
|
+
# Variables that you can use inside this policy include
|
|
1097
|
+
# `$\{Transfer:UserName\}`, `$\{Transfer:HomeDirectory\}`, and
|
|
1098
|
+
# `$\{Transfer:HomeBucket\}`.
|
|
864
1099
|
#
|
|
865
|
-
# <note markdown="1"> This
|
|
866
|
-
# use session policies.
|
|
1100
|
+
# <note markdown="1"> This policy applies only when the domain of `ServerId` is Amazon S3.
|
|
1101
|
+
# Amazon EFS does not use session policies.
|
|
867
1102
|
#
|
|
868
|
-
# For session policies,
|
|
869
|
-
#
|
|
870
|
-
#
|
|
871
|
-
# `Policy` argument.
|
|
1103
|
+
# For session policies, Transfer Family stores the policy as a JSON
|
|
1104
|
+
# blob, instead of the Amazon Resource Name (ARN) of the policy. You
|
|
1105
|
+
# save the policy as a JSON blob and pass it in the `Policy` argument.
|
|
872
1106
|
#
|
|
873
1107
|
# For an example of a session policy, see [Example session policy][1].
|
|
874
1108
|
#
|
|
@@ -891,13 +1125,14 @@ module Aws::Transfer
|
|
|
891
1125
|
# into and out of your Amazon EFS file systems.
|
|
892
1126
|
#
|
|
893
1127
|
# @option params [required, String] :role
|
|
894
|
-
#
|
|
895
|
-
# your users' access to your Amazon S3 bucket
|
|
896
|
-
#
|
|
897
|
-
# want to provide your users when
|
|
898
|
-
#
|
|
899
|
-
#
|
|
900
|
-
# resources when servicing your
|
|
1128
|
+
# The Amazon Resource Name (ARN) of the Identity and Access Management
|
|
1129
|
+
# (IAM) role that controls your users' access to your Amazon S3 bucket
|
|
1130
|
+
# or Amazon EFS file system. The policies attached to this role
|
|
1131
|
+
# determine the level of access that you want to provide your users when
|
|
1132
|
+
# transferring files into and out of your Amazon S3 bucket or Amazon EFS
|
|
1133
|
+
# file system. The IAM role should also contain a trust relationship
|
|
1134
|
+
# that allows the server to access your resources when servicing your
|
|
1135
|
+
# users' transfer requests.
|
|
901
1136
|
#
|
|
902
1137
|
# @option params [required, String] :server_id
|
|
903
1138
|
# A system-assigned unique identifier for a server instance. This is the
|
|
@@ -907,10 +1142,7 @@ module Aws::Transfer
|
|
|
907
1142
|
# The public portion of the Secure Shell (SSH) key used to authenticate
|
|
908
1143
|
# the user to the server.
|
|
909
1144
|
#
|
|
910
|
-
#
|
|
911
|
-
# beginning with `ecdsa`).
|
|
912
|
-
#
|
|
913
|
-
# </note>
|
|
1145
|
+
# Transfer Family accepts RSA, ECDSA, and ED25519 keys.
|
|
914
1146
|
#
|
|
915
1147
|
# @option params [Array<Types::Tag>] :tags
|
|
916
1148
|
# Key-value pairs that can be used to group and search for users. Tags
|
|
@@ -987,20 +1219,20 @@ module Aws::Transfer
|
|
|
987
1219
|
# The `TYPE` specifies which of the following actions is being taken for
|
|
988
1220
|
# this step.
|
|
989
1221
|
#
|
|
990
|
-
# * *COPY*\:
|
|
1222
|
+
# * *COPY*\: Copy the file to another location.
|
|
991
1223
|
#
|
|
992
|
-
# * *CUSTOM*\: custom step with
|
|
1224
|
+
# * *CUSTOM*\: Perform a custom step with an Lambda function target.
|
|
993
1225
|
#
|
|
994
|
-
# * *DELETE*\:
|
|
1226
|
+
# * *DELETE*\: Delete the file.
|
|
995
1227
|
#
|
|
996
|
-
# * *TAG*\:
|
|
1228
|
+
# * *TAG*\: Add a tag to the file.
|
|
997
1229
|
#
|
|
998
1230
|
# <note markdown="1"> Currently, copying and tagging are supported only on S3.
|
|
999
1231
|
#
|
|
1000
1232
|
# </note>
|
|
1001
1233
|
#
|
|
1002
1234
|
# For file location, you specify either the S3 bucket and key, or the
|
|
1003
|
-
# EFS
|
|
1235
|
+
# EFS file system ID and path.
|
|
1004
1236
|
#
|
|
1005
1237
|
# @option params [Array<Types::WorkflowStep>] :on_exception_steps
|
|
1006
1238
|
# Specifies the steps (actions) to take if errors are encountered during
|
|
@@ -1137,9 +1369,9 @@ module Aws::Transfer
|
|
|
1137
1369
|
# A unique identifier that is required to identify specific groups
|
|
1138
1370
|
# within your directory. The users of the group that you associate have
|
|
1139
1371
|
# access to your Amazon S3 or Amazon EFS resources over the enabled
|
|
1140
|
-
# protocols using
|
|
1141
|
-
#
|
|
1142
|
-
#
|
|
1372
|
+
# protocols using Transfer Family. If you know the group name, you can
|
|
1373
|
+
# view the SID values by running the following command using Windows
|
|
1374
|
+
# PowerShell.
|
|
1143
1375
|
#
|
|
1144
1376
|
# `Get-ADGroup -Filter \{samAccountName -like "YourGroupName*"\}
|
|
1145
1377
|
# -Properties * | Select SamAccountName,ObjectSid`
|
|
@@ -1147,10 +1379,10 @@ module Aws::Transfer
|
|
|
1147
1379
|
# In that command, replace *YourGroupName* with the name of your Active
|
|
1148
1380
|
# Directory group.
|
|
1149
1381
|
#
|
|
1150
|
-
# The
|
|
1151
|
-
# consisting of uppercase and lowercase alphanumeric
|
|
1152
|
-
# spaces. You can also include underscores or any of
|
|
1153
|
-
# characters: =,.@:/-
|
|
1382
|
+
# The regular expression used to validate this parameter is a string of
|
|
1383
|
+
# characters consisting of uppercase and lowercase alphanumeric
|
|
1384
|
+
# characters with no spaces. You can also include underscores or any of
|
|
1385
|
+
# the following characters: =,.@:/-
|
|
1154
1386
|
#
|
|
1155
1387
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
|
1156
1388
|
#
|
|
@@ -1170,6 +1402,100 @@ module Aws::Transfer
|
|
|
1170
1402
|
req.send_request(options)
|
|
1171
1403
|
end
|
|
1172
1404
|
|
|
1405
|
+
# Delete the agreement that's specified in the provided `AgreementId`.
|
|
1406
|
+
#
|
|
1407
|
+
# @option params [required, String] :agreement_id
|
|
1408
|
+
# A unique identifier for the agreement. This identifier is returned
|
|
1409
|
+
# when you create an agreement.
|
|
1410
|
+
#
|
|
1411
|
+
# @option params [required, String] :server_id
|
|
1412
|
+
# The server ID associated with the agreement that you are deleting.
|
|
1413
|
+
#
|
|
1414
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
|
1415
|
+
#
|
|
1416
|
+
# @example Request syntax with placeholder values
|
|
1417
|
+
#
|
|
1418
|
+
# resp = client.delete_agreement({
|
|
1419
|
+
# agreement_id: "AgreementId", # required
|
|
1420
|
+
# server_id: "ServerId", # required
|
|
1421
|
+
# })
|
|
1422
|
+
#
|
|
1423
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DeleteAgreement AWS API Documentation
|
|
1424
|
+
#
|
|
1425
|
+
# @overload delete_agreement(params = {})
|
|
1426
|
+
# @param [Hash] params ({})
|
|
1427
|
+
def delete_agreement(params = {}, options = {})
|
|
1428
|
+
req = build_request(:delete_agreement, params)
|
|
1429
|
+
req.send_request(options)
|
|
1430
|
+
end
|
|
1431
|
+
|
|
1432
|
+
# Deletes the certificate that's specified in the `CertificateId`
|
|
1433
|
+
# parameter.
|
|
1434
|
+
#
|
|
1435
|
+
# @option params [required, String] :certificate_id
|
|
1436
|
+
# The ID of the certificate object that you are deleting.
|
|
1437
|
+
#
|
|
1438
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
|
1439
|
+
#
|
|
1440
|
+
# @example Request syntax with placeholder values
|
|
1441
|
+
#
|
|
1442
|
+
# resp = client.delete_certificate({
|
|
1443
|
+
# certificate_id: "CertificateId", # required
|
|
1444
|
+
# })
|
|
1445
|
+
#
|
|
1446
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DeleteCertificate AWS API Documentation
|
|
1447
|
+
#
|
|
1448
|
+
# @overload delete_certificate(params = {})
|
|
1449
|
+
# @param [Hash] params ({})
|
|
1450
|
+
def delete_certificate(params = {}, options = {})
|
|
1451
|
+
req = build_request(:delete_certificate, params)
|
|
1452
|
+
req.send_request(options)
|
|
1453
|
+
end
|
|
1454
|
+
|
|
1455
|
+
# Deletes the agreement that's specified in the provided `ConnectorId`.
|
|
1456
|
+
#
|
|
1457
|
+
# @option params [required, String] :connector_id
|
|
1458
|
+
# The unique identifier for the connector.
|
|
1459
|
+
#
|
|
1460
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
|
1461
|
+
#
|
|
1462
|
+
# @example Request syntax with placeholder values
|
|
1463
|
+
#
|
|
1464
|
+
# resp = client.delete_connector({
|
|
1465
|
+
# connector_id: "ConnectorId", # required
|
|
1466
|
+
# })
|
|
1467
|
+
#
|
|
1468
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DeleteConnector AWS API Documentation
|
|
1469
|
+
#
|
|
1470
|
+
# @overload delete_connector(params = {})
|
|
1471
|
+
# @param [Hash] params ({})
|
|
1472
|
+
def delete_connector(params = {}, options = {})
|
|
1473
|
+
req = build_request(:delete_connector, params)
|
|
1474
|
+
req.send_request(options)
|
|
1475
|
+
end
|
|
1476
|
+
|
|
1477
|
+
# Deletes the profile that's specified in the `ProfileId` parameter.
|
|
1478
|
+
#
|
|
1479
|
+
# @option params [required, String] :profile_id
|
|
1480
|
+
# The ID of the profile that you are deleting.
|
|
1481
|
+
#
|
|
1482
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
|
1483
|
+
#
|
|
1484
|
+
# @example Request syntax with placeholder values
|
|
1485
|
+
#
|
|
1486
|
+
# resp = client.delete_profile({
|
|
1487
|
+
# profile_id: "ProfileId", # required
|
|
1488
|
+
# })
|
|
1489
|
+
#
|
|
1490
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DeleteProfile AWS API Documentation
|
|
1491
|
+
#
|
|
1492
|
+
# @overload delete_profile(params = {})
|
|
1493
|
+
# @param [Hash] params ({})
|
|
1494
|
+
def delete_profile(params = {}, options = {})
|
|
1495
|
+
req = build_request(:delete_profile, params)
|
|
1496
|
+
req.send_request(options)
|
|
1497
|
+
end
|
|
1498
|
+
|
|
1173
1499
|
# Deletes the file transfer protocol-enabled server that you specify.
|
|
1174
1500
|
#
|
|
1175
1501
|
# No response returns from this operation.
|
|
@@ -1285,7 +1611,7 @@ module Aws::Transfer
|
|
|
1285
1611
|
|
|
1286
1612
|
# Describes the access that is assigned to the specific file transfer
|
|
1287
1613
|
# protocol-enabled server, as identified by its `ServerId` property and
|
|
1288
|
-
# its `
|
|
1614
|
+
# its `ExternalId`.
|
|
1289
1615
|
#
|
|
1290
1616
|
# The response from this call returns the properties of the access that
|
|
1291
1617
|
# is associated with the `ServerId` value that was specified.
|
|
@@ -1298,9 +1624,9 @@ module Aws::Transfer
|
|
|
1298
1624
|
# A unique identifier that is required to identify specific groups
|
|
1299
1625
|
# within your directory. The users of the group that you associate have
|
|
1300
1626
|
# access to your Amazon S3 or Amazon EFS resources over the enabled
|
|
1301
|
-
# protocols using
|
|
1302
|
-
#
|
|
1303
|
-
#
|
|
1627
|
+
# protocols using Transfer Family. If you know the group name, you can
|
|
1628
|
+
# view the SID values by running the following command using Windows
|
|
1629
|
+
# PowerShell.
|
|
1304
1630
|
#
|
|
1305
1631
|
# `Get-ADGroup -Filter \{samAccountName -like "YourGroupName*"\}
|
|
1306
1632
|
# -Properties * | Select SamAccountName,ObjectSid`
|
|
@@ -1308,10 +1634,10 @@ module Aws::Transfer
|
|
|
1308
1634
|
# In that command, replace *YourGroupName* with the name of your Active
|
|
1309
1635
|
# Directory group.
|
|
1310
1636
|
#
|
|
1311
|
-
# The
|
|
1312
|
-
# consisting of uppercase and lowercase alphanumeric
|
|
1313
|
-
# spaces. You can also include underscores or any of
|
|
1314
|
-
# characters: =,.@:/-
|
|
1637
|
+
# The regular expression used to validate this parameter is a string of
|
|
1638
|
+
# characters consisting of uppercase and lowercase alphanumeric
|
|
1639
|
+
# characters with no spaces. You can also include underscores or any of
|
|
1640
|
+
# the following characters: =,.@:/-
|
|
1315
1641
|
#
|
|
1316
1642
|
# @return [Types::DescribeAccessResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
1317
1643
|
#
|
|
@@ -1350,6 +1676,137 @@ module Aws::Transfer
|
|
|
1350
1676
|
req.send_request(options)
|
|
1351
1677
|
end
|
|
1352
1678
|
|
|
1679
|
+
# Describes the agreement that's identified by the `AgreementId`.
|
|
1680
|
+
#
|
|
1681
|
+
# @option params [required, String] :agreement_id
|
|
1682
|
+
# A unique identifier for the agreement. This identifier is returned
|
|
1683
|
+
# when you create an agreement.
|
|
1684
|
+
#
|
|
1685
|
+
# @option params [required, String] :server_id
|
|
1686
|
+
# The server ID that's associated with the agreement.
|
|
1687
|
+
#
|
|
1688
|
+
# @return [Types::DescribeAgreementResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
1689
|
+
#
|
|
1690
|
+
# * {Types::DescribeAgreementResponse#agreement #agreement} => Types::DescribedAgreement
|
|
1691
|
+
#
|
|
1692
|
+
# @example Request syntax with placeholder values
|
|
1693
|
+
#
|
|
1694
|
+
# resp = client.describe_agreement({
|
|
1695
|
+
# agreement_id: "AgreementId", # required
|
|
1696
|
+
# server_id: "ServerId", # required
|
|
1697
|
+
# })
|
|
1698
|
+
#
|
|
1699
|
+
# @example Response structure
|
|
1700
|
+
#
|
|
1701
|
+
# resp.agreement.arn #=> String
|
|
1702
|
+
# resp.agreement.agreement_id #=> String
|
|
1703
|
+
# resp.agreement.description #=> String
|
|
1704
|
+
# resp.agreement.status #=> String, one of "ACTIVE", "INACTIVE"
|
|
1705
|
+
# resp.agreement.server_id #=> String
|
|
1706
|
+
# resp.agreement.local_profile_id #=> String
|
|
1707
|
+
# resp.agreement.partner_profile_id #=> String
|
|
1708
|
+
# resp.agreement.base_directory #=> String
|
|
1709
|
+
# resp.agreement.access_role #=> String
|
|
1710
|
+
# resp.agreement.tags #=> Array
|
|
1711
|
+
# resp.agreement.tags[0].key #=> String
|
|
1712
|
+
# resp.agreement.tags[0].value #=> String
|
|
1713
|
+
#
|
|
1714
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeAgreement AWS API Documentation
|
|
1715
|
+
#
|
|
1716
|
+
# @overload describe_agreement(params = {})
|
|
1717
|
+
# @param [Hash] params ({})
|
|
1718
|
+
def describe_agreement(params = {}, options = {})
|
|
1719
|
+
req = build_request(:describe_agreement, params)
|
|
1720
|
+
req.send_request(options)
|
|
1721
|
+
end
|
|
1722
|
+
|
|
1723
|
+
# Describes the certificate that's identified by the `CertificateId`.
|
|
1724
|
+
#
|
|
1725
|
+
# @option params [required, String] :certificate_id
|
|
1726
|
+
# An array of identifiers for the imported certificates. You use this
|
|
1727
|
+
# identifier for working with profiles and partner profiles.
|
|
1728
|
+
#
|
|
1729
|
+
# @return [Types::DescribeCertificateResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
1730
|
+
#
|
|
1731
|
+
# * {Types::DescribeCertificateResponse#certificate #certificate} => Types::DescribedCertificate
|
|
1732
|
+
#
|
|
1733
|
+
# @example Request syntax with placeholder values
|
|
1734
|
+
#
|
|
1735
|
+
# resp = client.describe_certificate({
|
|
1736
|
+
# certificate_id: "CertificateId", # required
|
|
1737
|
+
# })
|
|
1738
|
+
#
|
|
1739
|
+
# @example Response structure
|
|
1740
|
+
#
|
|
1741
|
+
# resp.certificate.arn #=> String
|
|
1742
|
+
# resp.certificate.certificate_id #=> String
|
|
1743
|
+
# resp.certificate.usage #=> String, one of "SIGNING", "ENCRYPTION"
|
|
1744
|
+
# resp.certificate.status #=> String, one of "ACTIVE", "PENDING_ROTATION", "INACTIVE"
|
|
1745
|
+
# resp.certificate.certificate #=> String
|
|
1746
|
+
# resp.certificate.certificate_chain #=> String
|
|
1747
|
+
# resp.certificate.active_date #=> Time
|
|
1748
|
+
# resp.certificate.inactive_date #=> Time
|
|
1749
|
+
# resp.certificate.serial #=> String
|
|
1750
|
+
# resp.certificate.not_before_date #=> Time
|
|
1751
|
+
# resp.certificate.not_after_date #=> Time
|
|
1752
|
+
# resp.certificate.type #=> String, one of "CERTIFICATE", "CERTIFICATE_WITH_PRIVATE_KEY"
|
|
1753
|
+
# resp.certificate.description #=> String
|
|
1754
|
+
# resp.certificate.tags #=> Array
|
|
1755
|
+
# resp.certificate.tags[0].key #=> String
|
|
1756
|
+
# resp.certificate.tags[0].value #=> String
|
|
1757
|
+
#
|
|
1758
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeCertificate AWS API Documentation
|
|
1759
|
+
#
|
|
1760
|
+
# @overload describe_certificate(params = {})
|
|
1761
|
+
# @param [Hash] params ({})
|
|
1762
|
+
def describe_certificate(params = {}, options = {})
|
|
1763
|
+
req = build_request(:describe_certificate, params)
|
|
1764
|
+
req.send_request(options)
|
|
1765
|
+
end
|
|
1766
|
+
|
|
1767
|
+
# Describes the connector that's identified by the `ConnectorId.`
|
|
1768
|
+
#
|
|
1769
|
+
# @option params [required, String] :connector_id
|
|
1770
|
+
# The unique identifier for the connector.
|
|
1771
|
+
#
|
|
1772
|
+
# @return [Types::DescribeConnectorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
1773
|
+
#
|
|
1774
|
+
# * {Types::DescribeConnectorResponse#connector #connector} => Types::DescribedConnector
|
|
1775
|
+
#
|
|
1776
|
+
# @example Request syntax with placeholder values
|
|
1777
|
+
#
|
|
1778
|
+
# resp = client.describe_connector({
|
|
1779
|
+
# connector_id: "ConnectorId", # required
|
|
1780
|
+
# })
|
|
1781
|
+
#
|
|
1782
|
+
# @example Response structure
|
|
1783
|
+
#
|
|
1784
|
+
# resp.connector.arn #=> String
|
|
1785
|
+
# resp.connector.connector_id #=> String
|
|
1786
|
+
# resp.connector.url #=> String
|
|
1787
|
+
# resp.connector.as_2_config.local_profile_id #=> String
|
|
1788
|
+
# resp.connector.as_2_config.partner_profile_id #=> String
|
|
1789
|
+
# resp.connector.as_2_config.message_subject #=> String
|
|
1790
|
+
# resp.connector.as_2_config.compression #=> String, one of "ZLIB", "DISABLED"
|
|
1791
|
+
# resp.connector.as_2_config.encryption_algorithm #=> String, one of "AES128_CBC", "AES192_CBC", "AES256_CBC"
|
|
1792
|
+
# resp.connector.as_2_config.signing_algorithm #=> String, one of "SHA256", "SHA384", "SHA512", "SHA1", "NONE"
|
|
1793
|
+
# resp.connector.as_2_config.mdn_signing_algorithm #=> String, one of "SHA256", "SHA384", "SHA512", "SHA1", "NONE", "DEFAULT"
|
|
1794
|
+
# resp.connector.as_2_config.mdn_response #=> String, one of "SYNC", "NONE"
|
|
1795
|
+
# resp.connector.access_role #=> String
|
|
1796
|
+
# resp.connector.logging_role #=> String
|
|
1797
|
+
# resp.connector.tags #=> Array
|
|
1798
|
+
# resp.connector.tags[0].key #=> String
|
|
1799
|
+
# resp.connector.tags[0].value #=> String
|
|
1800
|
+
#
|
|
1801
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeConnector AWS API Documentation
|
|
1802
|
+
#
|
|
1803
|
+
# @overload describe_connector(params = {})
|
|
1804
|
+
# @param [Hash] params ({})
|
|
1805
|
+
def describe_connector(params = {}, options = {})
|
|
1806
|
+
req = build_request(:describe_connector, params)
|
|
1807
|
+
req.send_request(options)
|
|
1808
|
+
end
|
|
1809
|
+
|
|
1353
1810
|
# You can use `DescribeExecution` to check the details of the execution
|
|
1354
1811
|
# of the specified workflow.
|
|
1355
1812
|
#
|
|
@@ -1412,6 +1869,43 @@ module Aws::Transfer
|
|
|
1412
1869
|
req.send_request(options)
|
|
1413
1870
|
end
|
|
1414
1871
|
|
|
1872
|
+
# Returns the details of the profile that's specified by the
|
|
1873
|
+
# `ProfileId`.
|
|
1874
|
+
#
|
|
1875
|
+
# @option params [required, String] :profile_id
|
|
1876
|
+
# The identifier of the profile that you want described.
|
|
1877
|
+
#
|
|
1878
|
+
# @return [Types::DescribeProfileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
1879
|
+
#
|
|
1880
|
+
# * {Types::DescribeProfileResponse#profile #profile} => Types::DescribedProfile
|
|
1881
|
+
#
|
|
1882
|
+
# @example Request syntax with placeholder values
|
|
1883
|
+
#
|
|
1884
|
+
# resp = client.describe_profile({
|
|
1885
|
+
# profile_id: "ProfileId", # required
|
|
1886
|
+
# })
|
|
1887
|
+
#
|
|
1888
|
+
# @example Response structure
|
|
1889
|
+
#
|
|
1890
|
+
# resp.profile.arn #=> String
|
|
1891
|
+
# resp.profile.profile_id #=> String
|
|
1892
|
+
# resp.profile.profile_type #=> String, one of "LOCAL", "PARTNER"
|
|
1893
|
+
# resp.profile.as_2_id #=> String
|
|
1894
|
+
# resp.profile.certificate_ids #=> Array
|
|
1895
|
+
# resp.profile.certificate_ids[0] #=> String
|
|
1896
|
+
# resp.profile.tags #=> Array
|
|
1897
|
+
# resp.profile.tags[0].key #=> String
|
|
1898
|
+
# resp.profile.tags[0].value #=> String
|
|
1899
|
+
#
|
|
1900
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeProfile AWS API Documentation
|
|
1901
|
+
#
|
|
1902
|
+
# @overload describe_profile(params = {})
|
|
1903
|
+
# @param [Hash] params ({})
|
|
1904
|
+
def describe_profile(params = {}, options = {})
|
|
1905
|
+
req = build_request(:describe_profile, params)
|
|
1906
|
+
req.send_request(options)
|
|
1907
|
+
end
|
|
1908
|
+
|
|
1415
1909
|
# Describes the security policy that is attached to your file transfer
|
|
1416
1910
|
# protocol-enabled server. The response contains a description of the
|
|
1417
1911
|
# security policy's properties. For more information about security
|
|
@@ -1483,6 +1977,9 @@ module Aws::Transfer
|
|
|
1483
1977
|
# resp.server.certificate #=> String
|
|
1484
1978
|
# resp.server.protocol_details.passive_ip #=> String
|
|
1485
1979
|
# resp.server.protocol_details.tls_session_resumption_mode #=> String, one of "DISABLED", "ENABLED", "ENFORCED"
|
|
1980
|
+
# resp.server.protocol_details.set_stat_option #=> String, one of "DEFAULT", "ENABLE_NO_OP"
|
|
1981
|
+
# resp.server.protocol_details.as_2_transports #=> Array
|
|
1982
|
+
# resp.server.protocol_details.as_2_transports[0] #=> String, one of "HTTP"
|
|
1486
1983
|
# resp.server.domain #=> String, one of "S3", "EFS"
|
|
1487
1984
|
# resp.server.endpoint_details.address_allocation_ids #=> Array
|
|
1488
1985
|
# resp.server.endpoint_details.address_allocation_ids[0] #=> String
|
|
@@ -1503,7 +2000,7 @@ module Aws::Transfer
|
|
|
1503
2000
|
# resp.server.post_authentication_login_banner #=> String
|
|
1504
2001
|
# resp.server.pre_authentication_login_banner #=> String
|
|
1505
2002
|
# resp.server.protocols #=> Array
|
|
1506
|
-
# resp.server.protocols[0] #=> String, one of "SFTP", "FTP", "FTPS"
|
|
2003
|
+
# resp.server.protocols[0] #=> String, one of "SFTP", "FTP", "FTPS", "AS2"
|
|
1507
2004
|
# resp.server.security_policy_name #=> String
|
|
1508
2005
|
# resp.server.server_id #=> String
|
|
1509
2006
|
# resp.server.state #=> String, one of "OFFLINE", "ONLINE", "STARTING", "STOPPING", "START_FAILED", "STOP_FAILED"
|
|
@@ -1542,8 +2039,8 @@ module Aws::Transfer
|
|
|
1542
2039
|
#
|
|
1543
2040
|
# @option params [required, String] :user_name
|
|
1544
2041
|
# The name of the user assigned to one or more servers. User names are
|
|
1545
|
-
# part of the sign-in credentials to use the
|
|
1546
|
-
#
|
|
2042
|
+
# part of the sign-in credentials to use the Transfer Family service and
|
|
2043
|
+
# perform file transfer tasks.
|
|
1547
2044
|
#
|
|
1548
2045
|
# @return [Types::DescribeUserResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
1549
2046
|
#
|
|
@@ -1663,6 +2160,70 @@ module Aws::Transfer
|
|
|
1663
2160
|
req.send_request(options)
|
|
1664
2161
|
end
|
|
1665
2162
|
|
|
2163
|
+
# Imports the signing and encryption certificates that you need to
|
|
2164
|
+
# create local (AS2) profiles and partner profiles.
|
|
2165
|
+
#
|
|
2166
|
+
# @option params [required, String] :usage
|
|
2167
|
+
# Specifies whether this certificate is used for signing or encryption.
|
|
2168
|
+
#
|
|
2169
|
+
# @option params [required, String] :certificate
|
|
2170
|
+
# The file that contains the certificate to import.
|
|
2171
|
+
#
|
|
2172
|
+
# @option params [String] :certificate_chain
|
|
2173
|
+
# An optional list of certificates that make up the chain for the
|
|
2174
|
+
# certificate that's being imported.
|
|
2175
|
+
#
|
|
2176
|
+
# @option params [String] :private_key
|
|
2177
|
+
# The file that contains the private key for the certificate that's
|
|
2178
|
+
# being imported.
|
|
2179
|
+
#
|
|
2180
|
+
# @option params [Time,DateTime,Date,Integer,String] :active_date
|
|
2181
|
+
# An optional date that specifies when the certificate becomes active.
|
|
2182
|
+
#
|
|
2183
|
+
# @option params [Time,DateTime,Date,Integer,String] :inactive_date
|
|
2184
|
+
# An optional date that specifies when the certificate becomes inactive.
|
|
2185
|
+
#
|
|
2186
|
+
# @option params [String] :description
|
|
2187
|
+
# A short description that helps identify the certificate.
|
|
2188
|
+
#
|
|
2189
|
+
# @option params [Array<Types::Tag>] :tags
|
|
2190
|
+
# Key-value pairs that can be used to group and search for certificates.
|
|
2191
|
+
#
|
|
2192
|
+
# @return [Types::ImportCertificateResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
2193
|
+
#
|
|
2194
|
+
# * {Types::ImportCertificateResponse#certificate_id #certificate_id} => String
|
|
2195
|
+
#
|
|
2196
|
+
# @example Request syntax with placeholder values
|
|
2197
|
+
#
|
|
2198
|
+
# resp = client.import_certificate({
|
|
2199
|
+
# usage: "SIGNING", # required, accepts SIGNING, ENCRYPTION
|
|
2200
|
+
# certificate: "CertificateBodyType", # required
|
|
2201
|
+
# certificate_chain: "CertificateChainType",
|
|
2202
|
+
# private_key: "PrivateKeyType",
|
|
2203
|
+
# active_date: Time.now,
|
|
2204
|
+
# inactive_date: Time.now,
|
|
2205
|
+
# description: "Description",
|
|
2206
|
+
# tags: [
|
|
2207
|
+
# {
|
|
2208
|
+
# key: "TagKey", # required
|
|
2209
|
+
# value: "TagValue", # required
|
|
2210
|
+
# },
|
|
2211
|
+
# ],
|
|
2212
|
+
# })
|
|
2213
|
+
#
|
|
2214
|
+
# @example Response structure
|
|
2215
|
+
#
|
|
2216
|
+
# resp.certificate_id #=> String
|
|
2217
|
+
#
|
|
2218
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ImportCertificate AWS API Documentation
|
|
2219
|
+
#
|
|
2220
|
+
# @overload import_certificate(params = {})
|
|
2221
|
+
# @param [Hash] params ({})
|
|
2222
|
+
def import_certificate(params = {}, options = {})
|
|
2223
|
+
req = build_request(:import_certificate, params)
|
|
2224
|
+
req.send_request(options)
|
|
2225
|
+
end
|
|
2226
|
+
|
|
1666
2227
|
# Adds a Secure Shell (SSH) public key to a user account identified by a
|
|
1667
2228
|
# `UserName` value assigned to the specific file transfer
|
|
1668
2229
|
# protocol-enabled server, identified by `ServerId`.
|
|
@@ -1676,6 +2237,8 @@ module Aws::Transfer
|
|
|
1676
2237
|
# @option params [required, String] :ssh_public_key_body
|
|
1677
2238
|
# The public key portion of an SSH key pair.
|
|
1678
2239
|
#
|
|
2240
|
+
# Transfer Family accepts RSA, ECDSA, and ED25519 keys.
|
|
2241
|
+
#
|
|
1679
2242
|
# @option params [required, String] :user_name
|
|
1680
2243
|
# The name of the user account that is assigned to one or more servers.
|
|
1681
2244
|
#
|
|
@@ -1758,10 +2321,159 @@ module Aws::Transfer
|
|
|
1758
2321
|
req.send_request(options)
|
|
1759
2322
|
end
|
|
1760
2323
|
|
|
2324
|
+
# Returns a list of the agreements for the server that's identified by
|
|
2325
|
+
# the `ServerId` that you supply. If you want to limit the results to a
|
|
2326
|
+
# certain number, supply a value for the `MaxResults` parameter. If you
|
|
2327
|
+
# ran the command previously and received a value for `NextToken`, you
|
|
2328
|
+
# can supply that value to continue listing agreements from where you
|
|
2329
|
+
# left off.
|
|
2330
|
+
#
|
|
2331
|
+
# @option params [Integer] :max_results
|
|
2332
|
+
# The maximum number of agreements to return.
|
|
2333
|
+
#
|
|
2334
|
+
# @option params [String] :next_token
|
|
2335
|
+
# When you can get additional results from the `ListAgreements` call, a
|
|
2336
|
+
# `NextToken` parameter is returned in the output. You can then pass in
|
|
2337
|
+
# a subsequent command to the `NextToken` parameter to continue listing
|
|
2338
|
+
# additional agreements.
|
|
2339
|
+
#
|
|
2340
|
+
# @option params [required, String] :server_id
|
|
2341
|
+
# The identifier of the server for which you want a list of agreements.
|
|
2342
|
+
#
|
|
2343
|
+
# @return [Types::ListAgreementsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
2344
|
+
#
|
|
2345
|
+
# * {Types::ListAgreementsResponse#next_token #next_token} => String
|
|
2346
|
+
# * {Types::ListAgreementsResponse#agreements #agreements} => Array<Types::ListedAgreement>
|
|
2347
|
+
#
|
|
2348
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
|
2349
|
+
#
|
|
2350
|
+
# @example Request syntax with placeholder values
|
|
2351
|
+
#
|
|
2352
|
+
# resp = client.list_agreements({
|
|
2353
|
+
# max_results: 1,
|
|
2354
|
+
# next_token: "NextToken",
|
|
2355
|
+
# server_id: "ServerId", # required
|
|
2356
|
+
# })
|
|
2357
|
+
#
|
|
2358
|
+
# @example Response structure
|
|
2359
|
+
#
|
|
2360
|
+
# resp.next_token #=> String
|
|
2361
|
+
# resp.agreements #=> Array
|
|
2362
|
+
# resp.agreements[0].arn #=> String
|
|
2363
|
+
# resp.agreements[0].agreement_id #=> String
|
|
2364
|
+
# resp.agreements[0].description #=> String
|
|
2365
|
+
# resp.agreements[0].status #=> String, one of "ACTIVE", "INACTIVE"
|
|
2366
|
+
# resp.agreements[0].server_id #=> String
|
|
2367
|
+
# resp.agreements[0].local_profile_id #=> String
|
|
2368
|
+
# resp.agreements[0].partner_profile_id #=> String
|
|
2369
|
+
#
|
|
2370
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListAgreements AWS API Documentation
|
|
2371
|
+
#
|
|
2372
|
+
# @overload list_agreements(params = {})
|
|
2373
|
+
# @param [Hash] params ({})
|
|
2374
|
+
def list_agreements(params = {}, options = {})
|
|
2375
|
+
req = build_request(:list_agreements, params)
|
|
2376
|
+
req.send_request(options)
|
|
2377
|
+
end
|
|
2378
|
+
|
|
2379
|
+
# Returns a list of the current certificates that have been imported
|
|
2380
|
+
# into Transfer Family. If you want to limit the results to a certain
|
|
2381
|
+
# number, supply a value for the `MaxResults` parameter. If you ran the
|
|
2382
|
+
# command previously and received a value for the `NextToken` parameter,
|
|
2383
|
+
# you can supply that value to continue listing certificates from where
|
|
2384
|
+
# you left off.
|
|
2385
|
+
#
|
|
2386
|
+
# @option params [Integer] :max_results
|
|
2387
|
+
# The maximum number of certificates to return.
|
|
2388
|
+
#
|
|
2389
|
+
# @option params [String] :next_token
|
|
2390
|
+
# When you can get additional results from the `ListCertificates` call,
|
|
2391
|
+
# a `NextToken` parameter is returned in the output. You can then pass
|
|
2392
|
+
# in a subsequent command to the `NextToken` parameter to continue
|
|
2393
|
+
# listing additional certificates.
|
|
2394
|
+
#
|
|
2395
|
+
# @return [Types::ListCertificatesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
2396
|
+
#
|
|
2397
|
+
# * {Types::ListCertificatesResponse#next_token #next_token} => String
|
|
2398
|
+
# * {Types::ListCertificatesResponse#certificates #certificates} => Array<Types::ListedCertificate>
|
|
2399
|
+
#
|
|
2400
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
|
2401
|
+
#
|
|
2402
|
+
# @example Request syntax with placeholder values
|
|
2403
|
+
#
|
|
2404
|
+
# resp = client.list_certificates({
|
|
2405
|
+
# max_results: 1,
|
|
2406
|
+
# next_token: "NextToken",
|
|
2407
|
+
# })
|
|
2408
|
+
#
|
|
2409
|
+
# @example Response structure
|
|
2410
|
+
#
|
|
2411
|
+
# resp.next_token #=> String
|
|
2412
|
+
# resp.certificates #=> Array
|
|
2413
|
+
# resp.certificates[0].arn #=> String
|
|
2414
|
+
# resp.certificates[0].certificate_id #=> String
|
|
2415
|
+
# resp.certificates[0].usage #=> String, one of "SIGNING", "ENCRYPTION"
|
|
2416
|
+
# resp.certificates[0].status #=> String, one of "ACTIVE", "PENDING_ROTATION", "INACTIVE"
|
|
2417
|
+
# resp.certificates[0].active_date #=> Time
|
|
2418
|
+
# resp.certificates[0].inactive_date #=> Time
|
|
2419
|
+
# resp.certificates[0].type #=> String, one of "CERTIFICATE", "CERTIFICATE_WITH_PRIVATE_KEY"
|
|
2420
|
+
# resp.certificates[0].description #=> String
|
|
2421
|
+
#
|
|
2422
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListCertificates AWS API Documentation
|
|
2423
|
+
#
|
|
2424
|
+
# @overload list_certificates(params = {})
|
|
2425
|
+
# @param [Hash] params ({})
|
|
2426
|
+
def list_certificates(params = {}, options = {})
|
|
2427
|
+
req = build_request(:list_certificates, params)
|
|
2428
|
+
req.send_request(options)
|
|
2429
|
+
end
|
|
2430
|
+
|
|
2431
|
+
# Lists the connectors for the specified Region.
|
|
2432
|
+
#
|
|
2433
|
+
# @option params [Integer] :max_results
|
|
2434
|
+
# The maximum number of connectors to return.
|
|
2435
|
+
#
|
|
2436
|
+
# @option params [String] :next_token
|
|
2437
|
+
# When you can get additional results from the `ListConnectors` call, a
|
|
2438
|
+
# `NextToken` parameter is returned in the output. You can then pass in
|
|
2439
|
+
# a subsequent command to the `NextToken` parameter to continue listing
|
|
2440
|
+
# additional connectors.
|
|
2441
|
+
#
|
|
2442
|
+
# @return [Types::ListConnectorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
2443
|
+
#
|
|
2444
|
+
# * {Types::ListConnectorsResponse#next_token #next_token} => String
|
|
2445
|
+
# * {Types::ListConnectorsResponse#connectors #connectors} => Array<Types::ListedConnector>
|
|
2446
|
+
#
|
|
2447
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
|
2448
|
+
#
|
|
2449
|
+
# @example Request syntax with placeholder values
|
|
2450
|
+
#
|
|
2451
|
+
# resp = client.list_connectors({
|
|
2452
|
+
# max_results: 1,
|
|
2453
|
+
# next_token: "NextToken",
|
|
2454
|
+
# })
|
|
2455
|
+
#
|
|
2456
|
+
# @example Response structure
|
|
2457
|
+
#
|
|
2458
|
+
# resp.next_token #=> String
|
|
2459
|
+
# resp.connectors #=> Array
|
|
2460
|
+
# resp.connectors[0].arn #=> String
|
|
2461
|
+
# resp.connectors[0].connector_id #=> String
|
|
2462
|
+
# resp.connectors[0].url #=> String
|
|
2463
|
+
#
|
|
2464
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListConnectors AWS API Documentation
|
|
2465
|
+
#
|
|
2466
|
+
# @overload list_connectors(params = {})
|
|
2467
|
+
# @param [Hash] params ({})
|
|
2468
|
+
def list_connectors(params = {}, options = {})
|
|
2469
|
+
req = build_request(:list_connectors, params)
|
|
2470
|
+
req.send_request(options)
|
|
2471
|
+
end
|
|
2472
|
+
|
|
1761
2473
|
# Lists all executions for the specified workflow.
|
|
1762
2474
|
#
|
|
1763
2475
|
# @option params [Integer] :max_results
|
|
1764
|
-
# Specifies the
|
|
2476
|
+
# Specifies the maximum number of executions to return.
|
|
1765
2477
|
#
|
|
1766
2478
|
# @option params [String] :next_token
|
|
1767
2479
|
# `ListExecutions` returns the `NextToken` parameter in the output. You
|
|
@@ -1770,13 +2482,13 @@ module Aws::Transfer
|
|
|
1770
2482
|
#
|
|
1771
2483
|
# This is useful for pagination, for instance. If you have 100
|
|
1772
2484
|
# executions for a workflow, you might only want to list first 10. If
|
|
1773
|
-
# so,
|
|
2485
|
+
# so, call the API by specifying the `max-results`\:
|
|
1774
2486
|
#
|
|
1775
2487
|
# `aws transfer list-executions --max-results 10`
|
|
1776
2488
|
#
|
|
1777
2489
|
# This returns details for the first 10 executions, as well as the
|
|
1778
2490
|
# pointer (`NextToken`) to the eleventh execution. You can now call the
|
|
1779
|
-
# API again,
|
|
2491
|
+
# API again, supplying the `NextToken` value you received:
|
|
1780
2492
|
#
|
|
1781
2493
|
# `aws transfer list-executions --max-results 10 --next-token
|
|
1782
2494
|
# $somePointerReturnedFromPreviousListResult`
|
|
@@ -1830,6 +2542,58 @@ module Aws::Transfer
|
|
|
1830
2542
|
req.send_request(options)
|
|
1831
2543
|
end
|
|
1832
2544
|
|
|
2545
|
+
# Returns a list of the profiles for your system. If you want to limit
|
|
2546
|
+
# the results to a certain number, supply a value for the `MaxResults`
|
|
2547
|
+
# parameter. If you ran the command previously and received a value for
|
|
2548
|
+
# `NextToken`, you can supply that value to continue listing profiles
|
|
2549
|
+
# from where you left off.
|
|
2550
|
+
#
|
|
2551
|
+
# @option params [Integer] :max_results
|
|
2552
|
+
# The maximum number of profiles to return.
|
|
2553
|
+
#
|
|
2554
|
+
# @option params [String] :next_token
|
|
2555
|
+
# When there are additional results that were not returned, a
|
|
2556
|
+
# `NextToken` parameter is returned. You can use that value for a
|
|
2557
|
+
# subsequent call to `ListProfiles` to continue listing results.
|
|
2558
|
+
#
|
|
2559
|
+
# @option params [String] :profile_type
|
|
2560
|
+
# Indicates whether to list only `LOCAL` type profiles or only `PARTNER`
|
|
2561
|
+
# type profiles. If not supplied in the request, the command lists all
|
|
2562
|
+
# types of profiles.
|
|
2563
|
+
#
|
|
2564
|
+
# @return [Types::ListProfilesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
2565
|
+
#
|
|
2566
|
+
# * {Types::ListProfilesResponse#next_token #next_token} => String
|
|
2567
|
+
# * {Types::ListProfilesResponse#profiles #profiles} => Array<Types::ListedProfile>
|
|
2568
|
+
#
|
|
2569
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
|
2570
|
+
#
|
|
2571
|
+
# @example Request syntax with placeholder values
|
|
2572
|
+
#
|
|
2573
|
+
# resp = client.list_profiles({
|
|
2574
|
+
# max_results: 1,
|
|
2575
|
+
# next_token: "NextToken",
|
|
2576
|
+
# profile_type: "LOCAL", # accepts LOCAL, PARTNER
|
|
2577
|
+
# })
|
|
2578
|
+
#
|
|
2579
|
+
# @example Response structure
|
|
2580
|
+
#
|
|
2581
|
+
# resp.next_token #=> String
|
|
2582
|
+
# resp.profiles #=> Array
|
|
2583
|
+
# resp.profiles[0].arn #=> String
|
|
2584
|
+
# resp.profiles[0].profile_id #=> String
|
|
2585
|
+
# resp.profiles[0].as_2_id #=> String
|
|
2586
|
+
# resp.profiles[0].profile_type #=> String, one of "LOCAL", "PARTNER"
|
|
2587
|
+
#
|
|
2588
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ListProfiles AWS API Documentation
|
|
2589
|
+
#
|
|
2590
|
+
# @overload list_profiles(params = {})
|
|
2591
|
+
# @param [Hash] params ({})
|
|
2592
|
+
def list_profiles(params = {}, options = {})
|
|
2593
|
+
req = build_request(:list_profiles, params)
|
|
2594
|
+
req.send_request(options)
|
|
2595
|
+
end
|
|
2596
|
+
|
|
1833
2597
|
# Lists the security policies that are attached to your file transfer
|
|
1834
2598
|
# protocol-enabled servers.
|
|
1835
2599
|
#
|
|
@@ -2106,6 +2870,41 @@ module Aws::Transfer
|
|
|
2106
2870
|
req.send_request(options)
|
|
2107
2871
|
end
|
|
2108
2872
|
|
|
2873
|
+
# Begins an outbound file transfer. You specify the `ConnectorId` and
|
|
2874
|
+
# the file paths for where to send the files.
|
|
2875
|
+
#
|
|
2876
|
+
# @option params [required, String] :connector_id
|
|
2877
|
+
# The unique identifier for the connector.
|
|
2878
|
+
#
|
|
2879
|
+
# @option params [required, Array<String>] :send_file_paths
|
|
2880
|
+
# An array of strings. Each string represents the absolute path for one
|
|
2881
|
+
# outbound file transfer. For example, ` DOC-EXAMPLE-BUCKET/myfile.txt
|
|
2882
|
+
# `.
|
|
2883
|
+
#
|
|
2884
|
+
# @return [Types::StartFileTransferResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
2885
|
+
#
|
|
2886
|
+
# * {Types::StartFileTransferResponse#transfer_id #transfer_id} => String
|
|
2887
|
+
#
|
|
2888
|
+
# @example Request syntax with placeholder values
|
|
2889
|
+
#
|
|
2890
|
+
# resp = client.start_file_transfer({
|
|
2891
|
+
# connector_id: "ConnectorId", # required
|
|
2892
|
+
# send_file_paths: ["FilePath"], # required
|
|
2893
|
+
# })
|
|
2894
|
+
#
|
|
2895
|
+
# @example Response structure
|
|
2896
|
+
#
|
|
2897
|
+
# resp.transfer_id #=> String
|
|
2898
|
+
#
|
|
2899
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/StartFileTransfer AWS API Documentation
|
|
2900
|
+
#
|
|
2901
|
+
# @overload start_file_transfer(params = {})
|
|
2902
|
+
# @param [Hash] params ({})
|
|
2903
|
+
def start_file_transfer(params = {}, options = {})
|
|
2904
|
+
req = build_request(:start_file_transfer, params)
|
|
2905
|
+
req.send_request(options)
|
|
2906
|
+
end
|
|
2907
|
+
|
|
2109
2908
|
# Changes the state of a file transfer protocol-enabled server from
|
|
2110
2909
|
# `OFFLINE` to `ONLINE`. It has no impact on a server that is already
|
|
2111
2910
|
# `ONLINE`. An `ONLINE` server can accept and process file transfer
|
|
@@ -2142,7 +2941,7 @@ module Aws::Transfer
|
|
|
2142
2941
|
# file transfer jobs. Information tied to your server, such as server
|
|
2143
2942
|
# and user properties, are not affected by stopping your server.
|
|
2144
2943
|
#
|
|
2145
|
-
# <note markdown="1"> Stopping the server
|
|
2944
|
+
# <note markdown="1"> Stopping the server does not reduce or impact your file transfer
|
|
2146
2945
|
# protocol endpoint billing; you must delete the server to stop being
|
|
2147
2946
|
# billed.
|
|
2148
2947
|
#
|
|
@@ -2280,7 +3079,7 @@ module Aws::Transfer
|
|
|
2280
3079
|
#
|
|
2281
3080
|
# resp = client.test_identity_provider({
|
|
2282
3081
|
# server_id: "ServerId", # required
|
|
2283
|
-
# server_protocol: "SFTP", # accepts SFTP, FTP, FTPS
|
|
3082
|
+
# server_protocol: "SFTP", # accepts SFTP, FTP, FTPS, AS2
|
|
2284
3083
|
# source_ip: "SourceIp",
|
|
2285
3084
|
# user_name: "UserName", # required
|
|
2286
3085
|
# user_password: "UserPassword",
|
|
@@ -2346,12 +3145,13 @@ module Aws::Transfer
|
|
|
2346
3145
|
# A `HomeDirectory` example is `/bucket_name/home/mydirectory`.
|
|
2347
3146
|
#
|
|
2348
3147
|
# @option params [String] :home_directory_type
|
|
2349
|
-
# The type of landing directory (folder) you want your users' home
|
|
2350
|
-
# directory to be when they log
|
|
3148
|
+
# The type of landing directory (folder) that you want your users' home
|
|
3149
|
+
# directory to be when they log in to the server. If you set it to
|
|
2351
3150
|
# `PATH`, the user will see the absolute Amazon S3 bucket or EFS paths
|
|
2352
3151
|
# as is in their file transfer protocol clients. If you set it
|
|
2353
3152
|
# `LOGICAL`, you need to provide mappings in the `HomeDirectoryMappings`
|
|
2354
|
-
# for how you want to make Amazon S3 or EFS paths visible to your
|
|
3153
|
+
# for how you want to make Amazon S3 or Amazon EFS paths visible to your
|
|
3154
|
+
# users.
|
|
2355
3155
|
#
|
|
2356
3156
|
# @option params [Array<Types::HomeDirectoryMapEntry>] :home_directory_mappings
|
|
2357
3157
|
# Logical directory mappings that specify what Amazon S3 or Amazon EFS
|
|
@@ -2359,10 +3159,9 @@ module Aws::Transfer
|
|
|
2359
3159
|
# them visible. You must specify the `Entry` and `Target` pair, where
|
|
2360
3160
|
# `Entry` shows how the path is made visible and `Target` is the actual
|
|
2361
3161
|
# Amazon S3 or Amazon EFS path. If you only specify a target, it is
|
|
2362
|
-
# displayed as is. You also must ensure that your
|
|
2363
|
-
#
|
|
2364
|
-
#
|
|
2365
|
-
# to *LOGICAL*.
|
|
3162
|
+
# displayed as is. You also must ensure that your Identity and Access
|
|
3163
|
+
# Management (IAM) role provides access to paths in `Target`. This value
|
|
3164
|
+
# can be set only when `HomeDirectoryType` is set to *LOGICAL*.
|
|
2366
3165
|
#
|
|
2367
3166
|
# The following is an `Entry` and `Target` pair example.
|
|
2368
3167
|
#
|
|
@@ -2379,19 +3178,19 @@ module Aws::Transfer
|
|
|
2379
3178
|
# `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
|
|
2380
3179
|
#
|
|
2381
3180
|
# @option params [String] :policy
|
|
2382
|
-
# A session policy for your user so that you can use the same
|
|
2383
|
-
# across multiple users. This policy
|
|
2384
|
-
#
|
|
2385
|
-
# policy include
|
|
2386
|
-
# `$\{Transfer:
|
|
3181
|
+
# A session policy for your user so that you can use the same Identity
|
|
3182
|
+
# and Access Management (IAM) role across multiple users. This policy
|
|
3183
|
+
# scopes down a user's access to portions of their Amazon S3 bucket.
|
|
3184
|
+
# Variables that you can use inside this policy include
|
|
3185
|
+
# `$\{Transfer:UserName\}`, `$\{Transfer:HomeDirectory\}`, and
|
|
3186
|
+
# `$\{Transfer:HomeBucket\}`.
|
|
2387
3187
|
#
|
|
2388
|
-
# <note markdown="1"> This
|
|
2389
|
-
# use session policies.
|
|
3188
|
+
# <note markdown="1"> This policy applies only when the domain of `ServerId` is Amazon S3.
|
|
3189
|
+
# Amazon EFS does not use session policies.
|
|
2390
3190
|
#
|
|
2391
|
-
# For session policies,
|
|
2392
|
-
#
|
|
2393
|
-
#
|
|
2394
|
-
# `Policy` argument.
|
|
3191
|
+
# For session policies, Transfer Family stores the policy as a JSON
|
|
3192
|
+
# blob, instead of the Amazon Resource Name (ARN) of the policy. You
|
|
3193
|
+
# save the policy as a JSON blob and pass it in the `Policy` argument.
|
|
2395
3194
|
#
|
|
2396
3195
|
# For an example of a session policy, see [Example session policy][1].
|
|
2397
3196
|
#
|
|
@@ -2414,13 +3213,14 @@ module Aws::Transfer
|
|
|
2414
3213
|
# out of your Amazon EFS file systems.
|
|
2415
3214
|
#
|
|
2416
3215
|
# @option params [String] :role
|
|
2417
|
-
#
|
|
2418
|
-
# your users' access to your Amazon S3 bucket
|
|
2419
|
-
#
|
|
2420
|
-
# want to provide your users when
|
|
2421
|
-
#
|
|
2422
|
-
#
|
|
2423
|
-
# resources when servicing your
|
|
3216
|
+
# The Amazon Resource Name (ARN) of the Identity and Access Management
|
|
3217
|
+
# (IAM) role that controls your users' access to your Amazon S3 bucket
|
|
3218
|
+
# or Amazon EFS file system. The policies attached to this role
|
|
3219
|
+
# determine the level of access that you want to provide your users when
|
|
3220
|
+
# transferring files into and out of your Amazon S3 bucket or Amazon EFS
|
|
3221
|
+
# file system. The IAM role should also contain a trust relationship
|
|
3222
|
+
# that allows the server to access your resources when servicing your
|
|
3223
|
+
# users' transfer requests.
|
|
2424
3224
|
#
|
|
2425
3225
|
# @option params [required, String] :server_id
|
|
2426
3226
|
# A system-assigned unique identifier for a server instance. This is the
|
|
@@ -2430,9 +3230,9 @@ module Aws::Transfer
|
|
|
2430
3230
|
# A unique identifier that is required to identify specific groups
|
|
2431
3231
|
# within your directory. The users of the group that you associate have
|
|
2432
3232
|
# access to your Amazon S3 or Amazon EFS resources over the enabled
|
|
2433
|
-
# protocols using
|
|
2434
|
-
#
|
|
2435
|
-
#
|
|
3233
|
+
# protocols using Transfer Family. If you know the group name, you can
|
|
3234
|
+
# view the SID values by running the following command using Windows
|
|
3235
|
+
# PowerShell.
|
|
2436
3236
|
#
|
|
2437
3237
|
# `Get-ADGroup -Filter \{samAccountName -like "YourGroupName*"\}
|
|
2438
3238
|
# -Properties * | Select SamAccountName,ObjectSid`
|
|
@@ -2440,10 +3240,10 @@ module Aws::Transfer
|
|
|
2440
3240
|
# In that command, replace *YourGroupName* with the name of your Active
|
|
2441
3241
|
# Directory group.
|
|
2442
3242
|
#
|
|
2443
|
-
# The
|
|
2444
|
-
# consisting of uppercase and lowercase alphanumeric
|
|
2445
|
-
# spaces. You can also include underscores or any of
|
|
2446
|
-
# characters: =,.@:/-
|
|
3243
|
+
# The regular expression used to validate this parameter is a string of
|
|
3244
|
+
# characters consisting of uppercase and lowercase alphanumeric
|
|
3245
|
+
# characters with no spaces. You can also include underscores or any of
|
|
3246
|
+
# the following characters: =,.@:/-
|
|
2447
3247
|
#
|
|
2448
3248
|
# @return [Types::UpdateAccessResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
2449
3249
|
#
|
|
@@ -2486,6 +3286,216 @@ module Aws::Transfer
|
|
|
2486
3286
|
req.send_request(options)
|
|
2487
3287
|
end
|
|
2488
3288
|
|
|
3289
|
+
# Updates some of the parameters for an existing agreement. Provide the
|
|
3290
|
+
# `AgreementId` and the `ServerId` for the agreement that you want to
|
|
3291
|
+
# update, along with the new values for the parameters to update.
|
|
3292
|
+
#
|
|
3293
|
+
# @option params [required, String] :agreement_id
|
|
3294
|
+
# A unique identifier for the agreement. This identifier is returned
|
|
3295
|
+
# when you create an agreement.
|
|
3296
|
+
#
|
|
3297
|
+
# @option params [required, String] :server_id
|
|
3298
|
+
# A system-assigned unique identifier for a server instance. This is the
|
|
3299
|
+
# specific server that the agreement uses.
|
|
3300
|
+
#
|
|
3301
|
+
# @option params [String] :description
|
|
3302
|
+
# To replace the existing description, provide a short description for
|
|
3303
|
+
# the agreement.
|
|
3304
|
+
#
|
|
3305
|
+
# @option params [String] :status
|
|
3306
|
+
# You can update the status for the agreement, either activating an
|
|
3307
|
+
# inactive agreement or the reverse.
|
|
3308
|
+
#
|
|
3309
|
+
# @option params [String] :local_profile_id
|
|
3310
|
+
# To change the local profile identifier, provide a new value here.
|
|
3311
|
+
#
|
|
3312
|
+
# @option params [String] :partner_profile_id
|
|
3313
|
+
# To change the partner profile identifier, provide a new value here.
|
|
3314
|
+
#
|
|
3315
|
+
# @option params [String] :base_directory
|
|
3316
|
+
# To change the landing directory (folder) for files that are
|
|
3317
|
+
# transferred, provide the bucket folder that you want to use; for
|
|
3318
|
+
# example, `/DOC-EXAMPLE-BUCKET/home/mydirectory `.
|
|
3319
|
+
#
|
|
3320
|
+
# @option params [String] :access_role
|
|
3321
|
+
# The Amazon Resource Name (ARN) of the Identity and Access Management
|
|
3322
|
+
# (IAM) role that grants access to at least the `HomeDirectory` of your
|
|
3323
|
+
# users' Amazon S3 buckets.
|
|
3324
|
+
#
|
|
3325
|
+
# @return [Types::UpdateAgreementResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
3326
|
+
#
|
|
3327
|
+
# * {Types::UpdateAgreementResponse#agreement_id #agreement_id} => String
|
|
3328
|
+
#
|
|
3329
|
+
# @example Request syntax with placeholder values
|
|
3330
|
+
#
|
|
3331
|
+
# resp = client.update_agreement({
|
|
3332
|
+
# agreement_id: "AgreementId", # required
|
|
3333
|
+
# server_id: "ServerId", # required
|
|
3334
|
+
# description: "Description",
|
|
3335
|
+
# status: "ACTIVE", # accepts ACTIVE, INACTIVE
|
|
3336
|
+
# local_profile_id: "ProfileId",
|
|
3337
|
+
# partner_profile_id: "ProfileId",
|
|
3338
|
+
# base_directory: "HomeDirectory",
|
|
3339
|
+
# access_role: "Role",
|
|
3340
|
+
# })
|
|
3341
|
+
#
|
|
3342
|
+
# @example Response structure
|
|
3343
|
+
#
|
|
3344
|
+
# resp.agreement_id #=> String
|
|
3345
|
+
#
|
|
3346
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UpdateAgreement AWS API Documentation
|
|
3347
|
+
#
|
|
3348
|
+
# @overload update_agreement(params = {})
|
|
3349
|
+
# @param [Hash] params ({})
|
|
3350
|
+
def update_agreement(params = {}, options = {})
|
|
3351
|
+
req = build_request(:update_agreement, params)
|
|
3352
|
+
req.send_request(options)
|
|
3353
|
+
end
|
|
3354
|
+
|
|
3355
|
+
# Updates the active and inactive dates for a certificate.
|
|
3356
|
+
#
|
|
3357
|
+
# @option params [required, String] :certificate_id
|
|
3358
|
+
# The identifier of the certificate object that you are updating.
|
|
3359
|
+
#
|
|
3360
|
+
# @option params [Time,DateTime,Date,Integer,String] :active_date
|
|
3361
|
+
# An optional date that specifies when the certificate becomes active.
|
|
3362
|
+
#
|
|
3363
|
+
# @option params [Time,DateTime,Date,Integer,String] :inactive_date
|
|
3364
|
+
# An optional date that specifies when the certificate becomes inactive.
|
|
3365
|
+
#
|
|
3366
|
+
# @option params [String] :description
|
|
3367
|
+
# A short description to help identify the certificate.
|
|
3368
|
+
#
|
|
3369
|
+
# @return [Types::UpdateCertificateResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
3370
|
+
#
|
|
3371
|
+
# * {Types::UpdateCertificateResponse#certificate_id #certificate_id} => String
|
|
3372
|
+
#
|
|
3373
|
+
# @example Request syntax with placeholder values
|
|
3374
|
+
#
|
|
3375
|
+
# resp = client.update_certificate({
|
|
3376
|
+
# certificate_id: "CertificateId", # required
|
|
3377
|
+
# active_date: Time.now,
|
|
3378
|
+
# inactive_date: Time.now,
|
|
3379
|
+
# description: "Description",
|
|
3380
|
+
# })
|
|
3381
|
+
#
|
|
3382
|
+
# @example Response structure
|
|
3383
|
+
#
|
|
3384
|
+
# resp.certificate_id #=> String
|
|
3385
|
+
#
|
|
3386
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UpdateCertificate AWS API Documentation
|
|
3387
|
+
#
|
|
3388
|
+
# @overload update_certificate(params = {})
|
|
3389
|
+
# @param [Hash] params ({})
|
|
3390
|
+
def update_certificate(params = {}, options = {})
|
|
3391
|
+
req = build_request(:update_certificate, params)
|
|
3392
|
+
req.send_request(options)
|
|
3393
|
+
end
|
|
3394
|
+
|
|
3395
|
+
# Updates some of the parameters for an existing connector. Provide the
|
|
3396
|
+
# `ConnectorId` for the connector that you want to update, along with
|
|
3397
|
+
# the new values for the parameters to update.
|
|
3398
|
+
#
|
|
3399
|
+
# @option params [required, String] :connector_id
|
|
3400
|
+
# The unique identifier for the connector.
|
|
3401
|
+
#
|
|
3402
|
+
# @option params [String] :url
|
|
3403
|
+
# The URL of the partner's AS2 endpoint.
|
|
3404
|
+
#
|
|
3405
|
+
# @option params [Types::As2ConnectorConfig] :as_2_config
|
|
3406
|
+
# A structure that contains the parameters for a connector object.
|
|
3407
|
+
#
|
|
3408
|
+
# @option params [String] :access_role
|
|
3409
|
+
# With AS2, you can send files by calling `StartFileTransfer` and
|
|
3410
|
+
# specifying the file paths in the request parameter, `SendFilePaths`.
|
|
3411
|
+
# We use the file’s parent directory (for example, for
|
|
3412
|
+
# `--send-file-paths /bucket/dir/file.txt`, parent directory is
|
|
3413
|
+
# `/bucket/dir/`) to temporarily store a processed AS2 message file,
|
|
3414
|
+
# store the MDN when we receive them from the partner, and write a final
|
|
3415
|
+
# JSON file containing relevant metadata of the transmission. So, the
|
|
3416
|
+
# `AccessRole` needs to provide read and write access to the parent
|
|
3417
|
+
# directory of the file location used in the `StartFileTransfer`
|
|
3418
|
+
# request. Additionally, you need to provide read and write access to
|
|
3419
|
+
# the parent directory of the files that you intend to send with
|
|
3420
|
+
# `StartFileTransfer`.
|
|
3421
|
+
#
|
|
3422
|
+
# @option params [String] :logging_role
|
|
3423
|
+
# The Amazon Resource Name (ARN) of the Identity and Access Management
|
|
3424
|
+
# (IAM) role that allows a connector to turn on CloudWatch logging for
|
|
3425
|
+
# Amazon S3 events. When set, you can view connector activity in your
|
|
3426
|
+
# CloudWatch logs.
|
|
3427
|
+
#
|
|
3428
|
+
# @return [Types::UpdateConnectorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
3429
|
+
#
|
|
3430
|
+
# * {Types::UpdateConnectorResponse#connector_id #connector_id} => String
|
|
3431
|
+
#
|
|
3432
|
+
# @example Request syntax with placeholder values
|
|
3433
|
+
#
|
|
3434
|
+
# resp = client.update_connector({
|
|
3435
|
+
# connector_id: "ConnectorId", # required
|
|
3436
|
+
# url: "Url",
|
|
3437
|
+
# as_2_config: {
|
|
3438
|
+
# local_profile_id: "ProfileId",
|
|
3439
|
+
# partner_profile_id: "ProfileId",
|
|
3440
|
+
# message_subject: "MessageSubject",
|
|
3441
|
+
# compression: "ZLIB", # accepts ZLIB, DISABLED
|
|
3442
|
+
# encryption_algorithm: "AES128_CBC", # accepts AES128_CBC, AES192_CBC, AES256_CBC
|
|
3443
|
+
# signing_algorithm: "SHA256", # accepts SHA256, SHA384, SHA512, SHA1, NONE
|
|
3444
|
+
# mdn_signing_algorithm: "SHA256", # accepts SHA256, SHA384, SHA512, SHA1, NONE, DEFAULT
|
|
3445
|
+
# mdn_response: "SYNC", # accepts SYNC, NONE
|
|
3446
|
+
# },
|
|
3447
|
+
# access_role: "Role",
|
|
3448
|
+
# logging_role: "Role",
|
|
3449
|
+
# })
|
|
3450
|
+
#
|
|
3451
|
+
# @example Response structure
|
|
3452
|
+
#
|
|
3453
|
+
# resp.connector_id #=> String
|
|
3454
|
+
#
|
|
3455
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UpdateConnector AWS API Documentation
|
|
3456
|
+
#
|
|
3457
|
+
# @overload update_connector(params = {})
|
|
3458
|
+
# @param [Hash] params ({})
|
|
3459
|
+
def update_connector(params = {}, options = {})
|
|
3460
|
+
req = build_request(:update_connector, params)
|
|
3461
|
+
req.send_request(options)
|
|
3462
|
+
end
|
|
3463
|
+
|
|
3464
|
+
# Updates some of the parameters for an existing profile. Provide the
|
|
3465
|
+
# `ProfileId` for the profile that you want to update, along with the
|
|
3466
|
+
# new values for the parameters to update.
|
|
3467
|
+
#
|
|
3468
|
+
# @option params [required, String] :profile_id
|
|
3469
|
+
# The identifier of the profile object that you are updating.
|
|
3470
|
+
#
|
|
3471
|
+
# @option params [Array<String>] :certificate_ids
|
|
3472
|
+
# An array of identifiers for the imported certificates. You use this
|
|
3473
|
+
# identifier for working with profiles and partner profiles.
|
|
3474
|
+
#
|
|
3475
|
+
# @return [Types::UpdateProfileResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
3476
|
+
#
|
|
3477
|
+
# * {Types::UpdateProfileResponse#profile_id #profile_id} => String
|
|
3478
|
+
#
|
|
3479
|
+
# @example Request syntax with placeholder values
|
|
3480
|
+
#
|
|
3481
|
+
# resp = client.update_profile({
|
|
3482
|
+
# profile_id: "ProfileId", # required
|
|
3483
|
+
# certificate_ids: ["CertificateId"],
|
|
3484
|
+
# })
|
|
3485
|
+
#
|
|
3486
|
+
# @example Response structure
|
|
3487
|
+
#
|
|
3488
|
+
# resp.profile_id #=> String
|
|
3489
|
+
#
|
|
3490
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UpdateProfile AWS API Documentation
|
|
3491
|
+
#
|
|
3492
|
+
# @overload update_profile(params = {})
|
|
3493
|
+
# @param [Hash] params ({})
|
|
3494
|
+
def update_profile(params = {}, options = {})
|
|
3495
|
+
req = build_request(:update_profile, params)
|
|
3496
|
+
req.send_request(options)
|
|
3497
|
+
end
|
|
3498
|
+
|
|
2489
3499
|
# Updates the file transfer protocol-enabled server's properties after
|
|
2490
3500
|
# that server has been created.
|
|
2491
3501
|
#
|
|
@@ -2535,21 +3545,34 @@ module Aws::Transfer
|
|
|
2535
3545
|
# @option params [Types::ProtocolDetails] :protocol_details
|
|
2536
3546
|
# The protocol settings that are configured for your server.
|
|
2537
3547
|
#
|
|
2538
|
-
#
|
|
2539
|
-
#
|
|
2540
|
-
#
|
|
3548
|
+
# * To indicate passive mode (for FTP and FTPS protocols), use the
|
|
3549
|
+
# `PassiveIp` parameter. Enter a single dotted-quad IPv4 address, such
|
|
3550
|
+
# as the external IP address of a firewall, router, or load balancer.
|
|
3551
|
+
#
|
|
3552
|
+
# * To ignore the error that is generated when the client attempts to
|
|
3553
|
+
# use the `SETSTAT` command on a file that you are uploading to an
|
|
3554
|
+
# Amazon S3 bucket, use the `SetStatOption` parameter. To have the
|
|
3555
|
+
# Transfer Family server ignore the `SETSTAT` command and upload files
|
|
3556
|
+
# without needing to make any changes to your SFTP client, set the
|
|
3557
|
+
# value to `ENABLE_NO_OP`. If you set the `SetStatOption` parameter to
|
|
3558
|
+
# `ENABLE_NO_OP`, Transfer Family generates a log entry to Amazon
|
|
3559
|
+
# CloudWatch Logs, so that you can determine when the client is making
|
|
3560
|
+
# a `SETSTAT` call.
|
|
3561
|
+
#
|
|
3562
|
+
# * To determine whether your Transfer Family server resumes recent,
|
|
3563
|
+
# negotiated sessions through a unique session ID, use the
|
|
3564
|
+
# `TlsSessionResumptionMode` parameter.
|
|
2541
3565
|
#
|
|
2542
|
-
#
|
|
2543
|
-
#
|
|
2544
|
-
# unique session ID.
|
|
3566
|
+
# * `As2Transports` indicates the transport method for the AS2 messages.
|
|
3567
|
+
# Currently, only HTTP is supported.
|
|
2545
3568
|
#
|
|
2546
3569
|
# @option params [Types::EndpointDetails] :endpoint_details
|
|
2547
3570
|
# The virtual private cloud (VPC) endpoint settings that are configured
|
|
2548
3571
|
# for your server. When you host your endpoint within your VPC, you can
|
|
2549
|
-
# make
|
|
2550
|
-
# attach Elastic IP addresses and make
|
|
2551
|
-
# internet. Your VPC's default security groups are
|
|
2552
|
-
# assigned to your endpoint.
|
|
3572
|
+
# make your endpoint accessible only to resources within your VPC, or
|
|
3573
|
+
# you can attach Elastic IP addresses and make your endpoint accessible
|
|
3574
|
+
# to clients over the internet. Your VPC's default security groups are
|
|
3575
|
+
# automatically assigned to your endpoint.
|
|
2553
3576
|
#
|
|
2554
3577
|
# @option params [String] :endpoint_type
|
|
2555
3578
|
# The type of endpoint that you want your server to use. You can choose
|
|
@@ -2579,15 +3602,15 @@ module Aws::Transfer
|
|
|
2579
3602
|
# </note>
|
|
2580
3603
|
#
|
|
2581
3604
|
# @option params [String] :host_key
|
|
2582
|
-
# The RSA or
|
|
3605
|
+
# The RSA, ECDSA, or ED25519 private key to use for your server.
|
|
2583
3606
|
#
|
|
2584
3607
|
# Use the following command to generate an RSA 2048 bit key with no
|
|
2585
3608
|
# passphrase:
|
|
2586
3609
|
#
|
|
2587
3610
|
# `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`.
|
|
2588
3611
|
#
|
|
2589
|
-
# Use a minimum value of 2048 for the `-b` option
|
|
2590
|
-
# stronger key using 3072 or 4096.
|
|
3612
|
+
# Use a minimum value of 2048 for the `-b` option. You can create a
|
|
3613
|
+
# stronger key by using 3072 or 4096.
|
|
2591
3614
|
#
|
|
2592
3615
|
# Use the following command to generate an ECDSA 256 bit key with no
|
|
2593
3616
|
# passphrase:
|
|
@@ -2596,7 +3619,12 @@ module Aws::Transfer
|
|
|
2596
3619
|
#
|
|
2597
3620
|
# Valid values for the `-b` option for ECDSA are 256, 384, and 521.
|
|
2598
3621
|
#
|
|
2599
|
-
#
|
|
3622
|
+
# Use the following command to generate an ED25519 key with no
|
|
3623
|
+
# passphrase:
|
|
3624
|
+
#
|
|
3625
|
+
# `ssh-keygen -t ed25519 -N "" -f my-new-server-key`.
|
|
3626
|
+
#
|
|
3627
|
+
# For all of these commands, you can replace *my-new-server-key* with a
|
|
2600
3628
|
# string of your choice.
|
|
2601
3629
|
#
|
|
2602
3630
|
# If you aren't planning to migrate existing users from an existing
|
|
@@ -2604,7 +3632,7 @@ module Aws::Transfer
|
|
|
2604
3632
|
# Accidentally changing a server's host key can be disruptive.
|
|
2605
3633
|
#
|
|
2606
3634
|
# For more information, see [Change the host key for your SFTP-enabled
|
|
2607
|
-
# server][1] in the *
|
|
3635
|
+
# server][1] in the *Transfer Family User Guide*.
|
|
2608
3636
|
#
|
|
2609
3637
|
#
|
|
2610
3638
|
#
|
|
@@ -2615,13 +3643,13 @@ module Aws::Transfer
|
|
|
2615
3643
|
# customer's authentication API method.
|
|
2616
3644
|
#
|
|
2617
3645
|
# @option params [String] :logging_role
|
|
2618
|
-
#
|
|
2619
|
-
#
|
|
2620
|
-
#
|
|
2621
|
-
#
|
|
3646
|
+
# The Amazon Resource Name (ARN) of the Identity and Access Management
|
|
3647
|
+
# (IAM) role that allows a server to turn on Amazon CloudWatch logging
|
|
3648
|
+
# for Amazon S3 or Amazon EFSevents. When set, you can view user
|
|
3649
|
+
# activity in your CloudWatch logs.
|
|
2622
3650
|
#
|
|
2623
3651
|
# @option params [String] :post_authentication_login_banner
|
|
2624
|
-
#
|
|
3652
|
+
# Specifies a string to display when users connect to a server. This
|
|
2625
3653
|
# string is displayed after the user authenticates.
|
|
2626
3654
|
#
|
|
2627
3655
|
# <note markdown="1"> The SFTP protocol does not support post-authentication display
|
|
@@ -2630,9 +3658,9 @@ module Aws::Transfer
|
|
|
2630
3658
|
# </note>
|
|
2631
3659
|
#
|
|
2632
3660
|
# @option params [String] :pre_authentication_login_banner
|
|
2633
|
-
#
|
|
3661
|
+
# Specifies a string to display when users connect to a server. This
|
|
2634
3662
|
# string is displayed before the user authenticates. For example, the
|
|
2635
|
-
# following banner displays details about using the system
|
|
3663
|
+
# following banner displays details about using the system:
|
|
2636
3664
|
#
|
|
2637
3665
|
# `This system is for the use of authorized users only. Individuals
|
|
2638
3666
|
# using this computer system without authority, or in excess of their
|
|
@@ -2679,7 +3707,7 @@ module Aws::Transfer
|
|
|
2679
3707
|
#
|
|
2680
3708
|
# @option params [Types::WorkflowDetails] :workflow_details
|
|
2681
3709
|
# Specifies the workflow ID for the workflow to assign and the execution
|
|
2682
|
-
# role used for executing the workflow.
|
|
3710
|
+
# role that's used for executing the workflow.
|
|
2683
3711
|
#
|
|
2684
3712
|
# To remove an associated workflow from a server, you can provide an
|
|
2685
3713
|
# empty `OnUpload` object, as in the following example.
|
|
@@ -2698,6 +3726,8 @@ module Aws::Transfer
|
|
|
2698
3726
|
# protocol_details: {
|
|
2699
3727
|
# passive_ip: "PassiveIp",
|
|
2700
3728
|
# tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
|
|
3729
|
+
# set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
|
|
3730
|
+
# as_2_transports: ["HTTP"], # accepts HTTP
|
|
2701
3731
|
# },
|
|
2702
3732
|
# endpoint_details: {
|
|
2703
3733
|
# address_allocation_ids: ["AddressAllocationId"],
|
|
@@ -2717,7 +3747,7 @@ module Aws::Transfer
|
|
|
2717
3747
|
# logging_role: "NullableRole",
|
|
2718
3748
|
# post_authentication_login_banner: "PostAuthenticationLoginBanner",
|
|
2719
3749
|
# pre_authentication_login_banner: "PreAuthenticationLoginBanner",
|
|
2720
|
-
# protocols: ["SFTP"], # accepts SFTP, FTP, FTPS
|
|
3750
|
+
# protocols: ["SFTP"], # accepts SFTP, FTP, FTPS, AS2
|
|
2721
3751
|
# security_policy_name: "SecurityPolicyName",
|
|
2722
3752
|
# server_id: "ServerId", # required
|
|
2723
3753
|
# workflow_details: {
|
|
@@ -2757,12 +3787,13 @@ module Aws::Transfer
|
|
|
2757
3787
|
# A `HomeDirectory` example is `/bucket_name/home/mydirectory`.
|
|
2758
3788
|
#
|
|
2759
3789
|
# @option params [String] :home_directory_type
|
|
2760
|
-
# The type of landing directory (folder) you want your users' home
|
|
2761
|
-
# directory to be when they log
|
|
3790
|
+
# The type of landing directory (folder) that you want your users' home
|
|
3791
|
+
# directory to be when they log in to the server. If you set it to
|
|
2762
3792
|
# `PATH`, the user will see the absolute Amazon S3 bucket or EFS paths
|
|
2763
3793
|
# as is in their file transfer protocol clients. If you set it
|
|
2764
3794
|
# `LOGICAL`, you need to provide mappings in the `HomeDirectoryMappings`
|
|
2765
|
-
# for how you want to make Amazon S3 or EFS paths visible to your
|
|
3795
|
+
# for how you want to make Amazon S3 or Amazon EFS paths visible to your
|
|
3796
|
+
# users.
|
|
2766
3797
|
#
|
|
2767
3798
|
# @option params [Array<Types::HomeDirectoryMapEntry>] :home_directory_mappings
|
|
2768
3799
|
# Logical directory mappings that specify what Amazon S3 or Amazon EFS
|
|
@@ -2770,10 +3801,9 @@ module Aws::Transfer
|
|
|
2770
3801
|
# them visible. You must specify the `Entry` and `Target` pair, where
|
|
2771
3802
|
# `Entry` shows how the path is made visible and `Target` is the actual
|
|
2772
3803
|
# Amazon S3 or Amazon EFS path. If you only specify a target, it is
|
|
2773
|
-
# displayed as is. You also must ensure that your
|
|
2774
|
-
#
|
|
2775
|
-
#
|
|
2776
|
-
# to *LOGICAL*.
|
|
3804
|
+
# displayed as is. You also must ensure that your Identity and Access
|
|
3805
|
+
# Management (IAM) role provides access to paths in `Target`. This value
|
|
3806
|
+
# can be set only when `HomeDirectoryType` is set to *LOGICAL*.
|
|
2777
3807
|
#
|
|
2778
3808
|
# The following is an `Entry` and `Target` pair example.
|
|
2779
3809
|
#
|
|
@@ -2790,19 +3820,19 @@ module Aws::Transfer
|
|
|
2790
3820
|
# `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
|
|
2791
3821
|
#
|
|
2792
3822
|
# @option params [String] :policy
|
|
2793
|
-
# A session policy for your user so that you can use the same
|
|
2794
|
-
# across multiple users. This policy
|
|
2795
|
-
#
|
|
2796
|
-
# policy include
|
|
2797
|
-
# `$\{Transfer:
|
|
3823
|
+
# A session policy for your user so that you can use the same Identity
|
|
3824
|
+
# and Access Management (IAM) role across multiple users. This policy
|
|
3825
|
+
# scopes down a user's access to portions of their Amazon S3 bucket.
|
|
3826
|
+
# Variables that you can use inside this policy include
|
|
3827
|
+
# `$\{Transfer:UserName\}`, `$\{Transfer:HomeDirectory\}`, and
|
|
3828
|
+
# `$\{Transfer:HomeBucket\}`.
|
|
2798
3829
|
#
|
|
2799
|
-
# <note markdown="1"> This
|
|
2800
|
-
# use session policies.
|
|
3830
|
+
# <note markdown="1"> This policy applies only when the domain of `ServerId` is Amazon S3.
|
|
3831
|
+
# Amazon EFS does not use session policies.
|
|
2801
3832
|
#
|
|
2802
|
-
# For session policies,
|
|
2803
|
-
#
|
|
2804
|
-
#
|
|
2805
|
-
# `Policy` argument.
|
|
3833
|
+
# For session policies, Transfer Family stores the policy as a JSON
|
|
3834
|
+
# blob, instead of the Amazon Resource Name (ARN) of the policy. You
|
|
3835
|
+
# save the policy as a JSON blob and pass it in the `Policy` argument.
|
|
2806
3836
|
#
|
|
2807
3837
|
# For an example of a session policy, see [Creating a session
|
|
2808
3838
|
# policy][1].
|
|
@@ -2826,13 +3856,14 @@ module Aws::Transfer
|
|
|
2826
3856
|
# transferring files into and out of your Amazon EFS file systems.
|
|
2827
3857
|
#
|
|
2828
3858
|
# @option params [String] :role
|
|
2829
|
-
#
|
|
2830
|
-
# your users' access to your Amazon S3 bucket
|
|
2831
|
-
#
|
|
2832
|
-
# want to provide your users when
|
|
2833
|
-
#
|
|
2834
|
-
#
|
|
2835
|
-
# resources when servicing your
|
|
3859
|
+
# The Amazon Resource Name (ARN) of the Identity and Access Management
|
|
3860
|
+
# (IAM) role that controls your users' access to your Amazon S3 bucket
|
|
3861
|
+
# or Amazon EFS file system. The policies attached to this role
|
|
3862
|
+
# determine the level of access that you want to provide your users when
|
|
3863
|
+
# transferring files into and out of your Amazon S3 bucket or Amazon EFS
|
|
3864
|
+
# file system. The IAM role should also contain a trust relationship
|
|
3865
|
+
# that allows the server to access your resources when servicing your
|
|
3866
|
+
# users' transfer requests.
|
|
2836
3867
|
#
|
|
2837
3868
|
# @option params [required, String] :server_id
|
|
2838
3869
|
# A system-assigned unique identifier for a server instance that the
|
|
@@ -2900,7 +3931,7 @@ module Aws::Transfer
|
|
|
2900
3931
|
params: params,
|
|
2901
3932
|
config: config)
|
|
2902
3933
|
context[:gem_name] = 'aws-sdk-transfer'
|
|
2903
|
-
context[:gem_version] = '1.
|
|
3934
|
+
context[:gem_version] = '1.57.0'
|
|
2904
3935
|
Seahorse::Client::Request.new(handlers, context)
|
|
2905
3936
|
end
|
|
2906
3937
|
|