Class: Aws::Transfer::Types::CreateAgreementRequest
- Inherits:
-
Struct
- Object
- Struct
- Aws::Transfer::Types::CreateAgreementRequest
- Defined in:
- gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb
Overview
Constant Summary collapse
- SENSITIVE =
[]
Instance Attribute Summary collapse
-
#access_role ⇒ String
Connectors are used to send files using either the AS2 or SFTP protocol.
-
#base_directory ⇒ String
The landing directory (folder) for files transferred by using the AS2 protocol.
-
#description ⇒ String
A name or short description to identify the agreement.
-
#local_profile_id ⇒ String
A unique identifier for the AS2 local profile.
-
#partner_profile_id ⇒ String
A unique identifier for the partner profile used in the agreement.
-
#server_id ⇒ String
A system-assigned unique identifier for a server instance.
-
#status ⇒ String
The status of the agreement.
-
#tags ⇒ Array<Types::Tag>
Key-value pairs that can be used to group and search for agreements.
Instance Attribute Details
#access_role ⇒ String
Connectors are used to send files using either the AS2 or SFTP protocol. For the access role, provide the Amazon Resource Name (ARN) of the Identity and Access Management role to use.
For AS2 connectors
With AS2, you can send files by calling StartFileTransfer
and
specifying the file paths in the request parameter, SendFilePaths
.
We use the file’s parent directory (for example, for
--send-file-paths /bucket/dir/file.txt
, parent directory is
/bucket/dir/
) to temporarily store a processed AS2 message file,
store the MDN when we receive them from the partner, and write a
final JSON file containing relevant metadata of the transmission.
So, the AccessRole
needs to provide read and write access to the
parent directory of the file location used in the
StartFileTransfer
request. Additionally, you need to provide read
and write access to the parent directory of the files that you
intend to send with StartFileTransfer
.
If you are using Basic authentication for your AS2 connector, the
access role requires the secretsmanager:GetSecretValue
permission
for the secret. If the secret is encrypted using a customer-managed
key instead of the Amazon Web Services managed key in Secrets
Manager, then the role also needs the kms:Decrypt
permission for
that key.
For SFTP connectors
Make sure that the access role provides read and write access to the
parent directory of the file location that's used in the
StartFileTransfer
request. Additionally, make sure that the role
provides secretsmanager:GetSecretValue
permission to Secrets
Manager.
451 452 453 454 455 456 457 458 459 460 461 462 |
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 451 class CreateAgreementRequest < Struct.new( :description, :server_id, :local_profile_id, :partner_profile_id, :base_directory, :access_role, :status, :tags) SENSITIVE = [] include Aws::Structure end |
#base_directory ⇒ String
The landing directory (folder) for files transferred by using the AS2 protocol.
A BaseDirectory
example is /DOC-EXAMPLE-BUCKET/home/mydirectory
.
451 452 453 454 455 456 457 458 459 460 461 462 |
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 451 class CreateAgreementRequest < Struct.new( :description, :server_id, :local_profile_id, :partner_profile_id, :base_directory, :access_role, :status, :tags) SENSITIVE = [] include Aws::Structure end |
#description ⇒ String
A name or short description to identify the agreement.
451 452 453 454 455 456 457 458 459 460 461 462 |
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 451 class CreateAgreementRequest < Struct.new( :description, :server_id, :local_profile_id, :partner_profile_id, :base_directory, :access_role, :status, :tags) SENSITIVE = [] include Aws::Structure end |
#local_profile_id ⇒ String
A unique identifier for the AS2 local profile.
451 452 453 454 455 456 457 458 459 460 461 462 |
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 451 class CreateAgreementRequest < Struct.new( :description, :server_id, :local_profile_id, :partner_profile_id, :base_directory, :access_role, :status, :tags) SENSITIVE = [] include Aws::Structure end |
#partner_profile_id ⇒ String
A unique identifier for the partner profile used in the agreement.
451 452 453 454 455 456 457 458 459 460 461 462 |
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 451 class CreateAgreementRequest < Struct.new( :description, :server_id, :local_profile_id, :partner_profile_id, :base_directory, :access_role, :status, :tags) SENSITIVE = [] include Aws::Structure end |
#server_id ⇒ String
A system-assigned unique identifier for a server instance. This is the specific server that the agreement uses.
451 452 453 454 455 456 457 458 459 460 461 462 |
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 451 class CreateAgreementRequest < Struct.new( :description, :server_id, :local_profile_id, :partner_profile_id, :base_directory, :access_role, :status, :tags) SENSITIVE = [] include Aws::Structure end |
#status ⇒ String
The status of the agreement. The agreement can be either ACTIVE
or
INACTIVE
.
451 452 453 454 455 456 457 458 459 460 461 462 |
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 451 class CreateAgreementRequest < Struct.new( :description, :server_id, :local_profile_id, :partner_profile_id, :base_directory, :access_role, :status, :tags) SENSITIVE = [] include Aws::Structure end |
#tags ⇒ Array<Types::Tag>
Key-value pairs that can be used to group and search for agreements.
451 452 453 454 455 456 457 458 459 460 461 462 |
# File 'gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb', line 451 class CreateAgreementRequest < Struct.new( :description, :server_id, :local_profile_id, :partner_profile_id, :base_directory, :access_role, :status, :tags) SENSITIVE = [] include Aws::Structure end |