Interface DescribedAgreement.Builder
- All Superinterfaces:
Buildable,CopyableBuilder<DescribedAgreement.Builder,,DescribedAgreement> SdkBuilder<DescribedAgreement.Builder,,DescribedAgreement> SdkPojo
- Enclosing class:
DescribedAgreement
-
Method Summary
Modifier and TypeMethodDescriptionaccessRole(String accessRole) Connectors are used to send files using either the AS2 or SFTP protocol.agreementId(String agreementId) A unique identifier for the agreement.The unique Amazon Resource Name (ARN) for the agreement.baseDirectory(String baseDirectory) The landing directory (folder) for files that are transferred by using the AS2 protocol.description(String description) The name or short description that's used to identify the agreement.localProfileId(String localProfileId) A unique identifier for the AS2 local profile.partnerProfileId(String partnerProfileId) A unique identifier for the partner profile used in the agreement.A system-assigned unique identifier for a server instance.The current status of the agreement, eitherACTIVEorINACTIVE.status(AgreementStatusType status) The current status of the agreement, eitherACTIVEorINACTIVE.tags(Collection<Tag> tags) Key-value pairs that can be used to group and search for agreements.tags(Consumer<Tag.Builder>... tags) Key-value pairs that can be used to group and search for agreements.Key-value pairs that can be used to group and search for agreements.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copyMethods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, buildMethods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
arn
The unique Amazon Resource Name (ARN) for the agreement.
- Parameters:
arn- The unique Amazon Resource Name (ARN) for the agreement.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
agreementId
A unique identifier for the agreement. This identifier is returned when you create an agreement.
- Parameters:
agreementId- A unique identifier for the agreement. This identifier is returned when you create an agreement.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
description
The name or short description that's used to identify the agreement.
- Parameters:
description- The name or short description that's used to identify the agreement.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
status
The current status of the agreement, either
ACTIVEorINACTIVE.- Parameters:
status- The current status of the agreement, eitherACTIVEorINACTIVE.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
status
The current status of the agreement, either
ACTIVEorINACTIVE.- Parameters:
status- The current status of the agreement, eitherACTIVEorINACTIVE.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
serverId
A system-assigned unique identifier for a server instance. This identifier indicates the specific server that the agreement uses.
- Parameters:
serverId- A system-assigned unique identifier for a server instance. This identifier indicates the specific server that the agreement uses.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
localProfileId
A unique identifier for the AS2 local profile.
- Parameters:
localProfileId- A unique identifier for the AS2 local profile.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
partnerProfileId
A unique identifier for the partner profile used in the agreement.
- Parameters:
partnerProfileId- A unique identifier for the partner profile used in the agreement.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
baseDirectory
The landing directory (folder) for files that are transferred by using the AS2 protocol.
- Parameters:
baseDirectory- The landing directory (folder) for files that are transferred by using the AS2 protocol.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
accessRole
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
StartFileTransferand 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, theAccessRoleneeds to provide read and write access to the parent directory of the file location used in theStartFileTransferrequest. Additionally, you need to provide read and write access to the parent directory of the files that you intend to send withStartFileTransfer.If you are using Basic authentication for your AS2 connector, the access role requires the
secretsmanager:GetSecretValuepermission 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 thekms:Decryptpermission 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
StartFileTransferrequest. Additionally, make sure that the role providessecretsmanager:GetSecretValuepermission to Secrets Manager.- Parameters:
accessRole- 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
StartFileTransferand 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, theAccessRoleneeds to provide read and write access to the parent directory of the file location used in theStartFileTransferrequest. Additionally, you need to provide read and write access to the parent directory of the files that you intend to send withStartFileTransfer.If you are using Basic authentication for your AS2 connector, the access role requires the
secretsmanager:GetSecretValuepermission 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 thekms:Decryptpermission 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
StartFileTransferrequest. Additionally, make sure that the role providessecretsmanager:GetSecretValuepermission to Secrets Manager.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
Key-value pairs that can be used to group and search for agreements.
- Parameters:
tags- Key-value pairs that can be used to group and search for agreements.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
Key-value pairs that can be used to group and search for agreements.
- Parameters:
tags- Key-value pairs that can be used to group and search for agreements.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
Key-value pairs that can be used to group and search for agreements.
This is a convenience method that creates an instance of theTag.Builderavoiding the need to create one manually viaTag.builder().When the
Consumercompletes,SdkBuilder.build()is called immediately and its result is passed totags(List<Tag>).- Parameters:
tags- a consumer that will call methods onTag.Builder- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-