/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.transfer.model; import java.io.Serializable; import javax.annotation.Generated; import com.amazonaws.AmazonWebServiceRequest; /** * * @see AWS API * Documentation */ @Generated("com.amazonaws:aws-java-sdk-code-generator") public class CreateAgreementRequest extends com.amazonaws.AmazonWebServiceRequest implements Serializable, Cloneable { /** *
* A name or short description to identify the agreement. *
*/ private String description; /** ** A system-assigned unique identifier for a server instance. This is the specific server that the agreement uses. *
*/ private String serverId; /** ** A unique identifier for the AS2 local profile. *
*/ private String localProfileId; /** ** A unique identifier for the partner profile used in the agreement. *
*/ private String partnerProfileId; /** ** The landing directory (folder) for files transferred by using the AS2 protocol. *
*
* A BaseDirectory
example is /DOC-EXAMPLE-BUCKET/home/mydirectory
.
*
* 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.
*
* The status of the agreement. The agreement can be either ACTIVE
or INACTIVE
.
*
* Key-value pairs that can be used to group and search for agreements. *
*/ private java.util.List* A name or short description to identify the agreement. *
* * @param description * A name or short description to identify the agreement. */ public void setDescription(String description) { this.description = description; } /** ** A name or short description to identify the agreement. *
* * @return A name or short description to identify the agreement. */ public String getDescription() { return this.description; } /** ** A name or short description to identify the agreement. *
* * @param description * A name or short description to identify the agreement. * @return Returns a reference to this object so that method calls can be chained together. */ public CreateAgreementRequest withDescription(String description) { setDescription(description); return this; } /** ** A system-assigned unique identifier for a server instance. This is the specific server that the agreement uses. *
* * @param serverId * A system-assigned unique identifier for a server instance. This is the specific server that the agreement * uses. */ public void setServerId(String serverId) { this.serverId = serverId; } /** ** A system-assigned unique identifier for a server instance. This is the specific server that the agreement uses. *
* * @return A system-assigned unique identifier for a server instance. This is the specific server that the agreement * uses. */ public String getServerId() { return this.serverId; } /** ** A system-assigned unique identifier for a server instance. This is the specific server that the agreement uses. *
* * @param serverId * A system-assigned unique identifier for a server instance. This is the specific server that the agreement * uses. * @return Returns a reference to this object so that method calls can be chained together. */ public CreateAgreementRequest withServerId(String serverId) { setServerId(serverId); return this; } /** ** A unique identifier for the AS2 local profile. *
* * @param localProfileId * A unique identifier for the AS2 local profile. */ public void setLocalProfileId(String localProfileId) { this.localProfileId = localProfileId; } /** ** A unique identifier for the AS2 local profile. *
* * @return A unique identifier for the AS2 local profile. */ public String getLocalProfileId() { return this.localProfileId; } /** ** A unique identifier for the AS2 local profile. *
* * @param localProfileId * A unique identifier for the AS2 local profile. * @return Returns a reference to this object so that method calls can be chained together. */ public CreateAgreementRequest withLocalProfileId(String localProfileId) { setLocalProfileId(localProfileId); return this; } /** ** A unique identifier for the partner profile used in the agreement. *
* * @param partnerProfileId * A unique identifier for the partner profile used in the agreement. */ public void setPartnerProfileId(String partnerProfileId) { this.partnerProfileId = partnerProfileId; } /** ** A unique identifier for the partner profile used in the agreement. *
* * @return A unique identifier for the partner profile used in the agreement. */ public String getPartnerProfileId() { return this.partnerProfileId; } /** ** A unique identifier for the partner profile used in the agreement. *
* * @param partnerProfileId * A unique identifier for the partner profile used in the agreement. * @return Returns a reference to this object so that method calls can be chained together. */ public CreateAgreementRequest withPartnerProfileId(String partnerProfileId) { setPartnerProfileId(partnerProfileId); return this; } /** ** The landing directory (folder) for files transferred by using the AS2 protocol. *
*
* A BaseDirectory
example is /DOC-EXAMPLE-BUCKET/home/mydirectory
.
*
* A BaseDirectory
example is /DOC-EXAMPLE-BUCKET/home/mydirectory
.
*/
public void setBaseDirectory(String baseDirectory) {
this.baseDirectory = baseDirectory;
}
/**
*
* The landing directory (folder) for files transferred by using the AS2 protocol. *
*
* A BaseDirectory
example is /DOC-EXAMPLE-BUCKET/home/mydirectory
.
*
* A BaseDirectory
example is /DOC-EXAMPLE-BUCKET/home/mydirectory
.
*/
public String getBaseDirectory() {
return this.baseDirectory;
}
/**
*
* The landing directory (folder) for files transferred by using the AS2 protocol. *
*
* A BaseDirectory
example is /DOC-EXAMPLE-BUCKET/home/mydirectory
.
*
* A BaseDirectory
example is /DOC-EXAMPLE-BUCKET/home/mydirectory
.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public CreateAgreementRequest withBaseDirectory(String baseDirectory) {
setBaseDirectory(baseDirectory);
return this;
}
/**
*
* 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.
*
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.
*/
public void setAccessRole(String accessRole) {
this.accessRole = accessRole;
}
/**
*
* 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.
*
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.
*/
public String getAccessRole() {
return this.accessRole;
}
/**
*
* 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.
*
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.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public CreateAgreementRequest withAccessRole(String accessRole) {
setAccessRole(accessRole);
return this;
}
/**
*
* The status of the agreement. The agreement can be either ACTIVE
or INACTIVE
.
*
ACTIVE
or INACTIVE
.
* @see AgreementStatusType
*/
public void setStatus(String status) {
this.status = status;
}
/**
*
* The status of the agreement. The agreement can be either ACTIVE
or INACTIVE
.
*
ACTIVE
or INACTIVE
.
* @see AgreementStatusType
*/
public String getStatus() {
return this.status;
}
/**
*
* The status of the agreement. The agreement can be either ACTIVE
or INACTIVE
.
*
ACTIVE
or INACTIVE
.
* @return Returns a reference to this object so that method calls can be chained together.
* @see AgreementStatusType
*/
public CreateAgreementRequest withStatus(String status) {
setStatus(status);
return this;
}
/**
*
* The status of the agreement. The agreement can be either ACTIVE
or INACTIVE
.
*
ACTIVE
or INACTIVE
.
* @return Returns a reference to this object so that method calls can be chained together.
* @see AgreementStatusType
*/
public CreateAgreementRequest withStatus(AgreementStatusType status) {
this.status = status.toString();
return this;
}
/**
* * Key-value pairs that can be used to group and search for agreements. *
* * @return Key-value pairs that can be used to group and search for agreements. */ public java.util.List* Key-value pairs that can be used to group and search for agreements. *
* * @param tags * Key-value pairs that can be used to group and search for agreements. */ public void setTags(java.util.Collection* Key-value pairs that can be used to group and search for agreements. *
** NOTE: This method appends the values to the existing list (if any). Use * {@link #setTags(java.util.Collection)} or {@link #withTags(java.util.Collection)} if you want to override the * existing values. *
* * @param tags * Key-value pairs that can be used to group and search for agreements. * @return Returns a reference to this object so that method calls can be chained together. */ public CreateAgreementRequest withTags(Tag... tags) { if (this.tags == null) { setTags(new java.util.ArrayList* Key-value pairs that can be used to group and search for agreements. *
* * @param tags * Key-value pairs that can be used to group and search for agreements. * @return Returns a reference to this object so that method calls can be chained together. */ public CreateAgreementRequest withTags(java.util.Collection