feat(client-transfer): Added AS2 agreement configurations to control filename preservation and message signing enforcement. Added AS2 connector configuration to preserve content type from S3 objects.

awstools · awstools · commit c7611a42215c · 2024-12-18T19:12:49.000Z
diff --git a/clients/client-transfer/src/commands/CreateAgreementCommand.ts b/clients/client-transfer/src/commands/CreateAgreementCommand.ts
@@ -54,6 +54,8 @@ export interface CreateAgreementCommandOutput extends CreateAgreementResponse, _
  *       Value: "STRING_VALUE", // required
  *     },
  *   ],
+ *   PreserveFilename: "ENABLED" || "DISABLED",
+ *   EnforceMessageSigning: "ENABLED" || "DISABLED",
  * };
  * const command = new CreateAgreementCommand(input);
  * const response = await client.send(command);
diff --git a/clients/client-transfer/src/commands/CreateConnectorCommand.ts b/clients/client-transfer/src/commands/CreateConnectorCommand.ts
@@ -52,6 +52,7 @@ export interface CreateConnectorCommandOutput extends CreateConnectorResponse, _
  *     MdnSigningAlgorithm: "SHA256" || "SHA384" || "SHA512" || "SHA1" || "NONE" || "DEFAULT",
  *     MdnResponse: "SYNC" || "NONE",
  *     BasicAuthSecretId: "STRING_VALUE",
+ *     PreserveContentType: "ENABLED" || "DISABLED",
  *   },
  *   AccessRole: "STRING_VALUE", // required
  *   LoggingRole: "STRING_VALUE",
diff --git a/clients/client-transfer/src/commands/DescribeAgreementCommand.ts b/clients/client-transfer/src/commands/DescribeAgreementCommand.ts
@@ -58,6 +58,8 @@ export interface DescribeAgreementCommandOutput extends DescribeAgreementRespons
  * //         Value: "STRING_VALUE", // required
  * //       },
  * //     ],
+ * //     PreserveFilename: "ENABLED" || "DISABLED",
+ * //     EnforceMessageSigning: "ENABLED" || "DISABLED",
  * //   },
  * // };
  *
diff --git a/clients/client-transfer/src/commands/DescribeConnectorCommand.ts b/clients/client-transfer/src/commands/DescribeConnectorCommand.ts
@@ -56,6 +56,7 @@ export interface DescribeConnectorCommandOutput extends DescribeConnectorRespons
  * //       MdnSigningAlgorithm: "SHA256" || "SHA384" || "SHA512" || "SHA1" || "NONE" || "DEFAULT",
  * //       MdnResponse: "SYNC" || "NONE",
  * //       BasicAuthSecretId: "STRING_VALUE",
+ * //       PreserveContentType: "ENABLED" || "DISABLED",
  * //     },
  * //     AccessRole: "STRING_VALUE",
  * //     LoggingRole: "STRING_VALUE",
diff --git a/clients/client-transfer/src/commands/UpdateAgreementCommand.ts b/clients/client-transfer/src/commands/UpdateAgreementCommand.ts
@@ -46,6 +46,8 @@ export interface UpdateAgreementCommandOutput extends UpdateAgreementResponse, _
  *   PartnerProfileId: "STRING_VALUE",
  *   BaseDirectory: "STRING_VALUE",
  *   AccessRole: "STRING_VALUE",
+ *   PreserveFilename: "ENABLED" || "DISABLED",
+ *   EnforceMessageSigning: "ENABLED" || "DISABLED",
  * };
  * const command = new UpdateAgreementCommand(input);
  * const response = await client.send(command);
diff --git a/clients/client-transfer/src/commands/UpdateConnectorCommand.ts b/clients/client-transfer/src/commands/UpdateConnectorCommand.ts
@@ -50,6 +50,7 @@ export interface UpdateConnectorCommandOutput extends UpdateConnectorResponse, _
  *     MdnSigningAlgorithm: "SHA256" || "SHA384" || "SHA512" || "SHA1" || "NONE" || "DEFAULT",
  *     MdnResponse: "SYNC" || "NONE",
  *     BasicAuthSecretId: "STRING_VALUE",
+ *     PreserveContentType: "ENABLED" || "DISABLED",
  *   },
  *   AccessRole: "STRING_VALUE",
  *   LoggingRole: "STRING_VALUE",
diff --git a/clients/client-transfer/src/models/models_0.ts b/clients/client-transfer/src/models/models_0.ts
@@ -25,6 +25,34 @@ export class AccessDeniedException extends __BaseException {
   }
 }
 
+/**
+ * @public
+ * @enum
+ */
+export const EnforceMessageSigningType = {
+  DISABLED: "DISABLED",
+  ENABLED: "ENABLED",
+} as const;
+
+/**
+ * @public
+ */
+export type EnforceMessageSigningType = (typeof EnforceMessageSigningType)[keyof typeof EnforceMessageSigningType];
+
+/**
+ * @public
+ * @enum
+ */
+export const PreserveFilenameType = {
+  DISABLED: "DISABLED",
+  ENABLED: "ENABLED",
+} as const;
+
+/**
+ * @public
+ */
+export type PreserveFilenameType = (typeof PreserveFilenameType)[keyof typeof PreserveFilenameType];
+
 /**
  * @public
  * @enum
@@ -142,6 +170,44 @@ export interface CreateAgreementRequest {
    * @public
    */
   Tags?: Tag[] | undefined;
+
+  /**
+   * <p>
+   *     Determines whether or not Transfer Family appends a unique string of characters to the end of the AS2 message payload
+   *     filename when saving it.
+   *  </p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>ENABLED</code>: the filename provided by your trading parter is preserved when the file is saved.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>DISABLED</code> (default value): when Transfer Family  saves the file, the filename is adjusted, as
+   *       described in <a href="https://docs.aws.amazon.com/transfer/latest/userguide/send-as2-messages.html#file-names-as2">File names and locations</a>.</p>
+   *             </li>
+   *          </ul>
+   * @public
+   */
+  PreserveFilename?: PreserveFilenameType | undefined;
+
+  /**
+   * <p>
+   *      Determines whether or not unsigned messages from your trading partners will be accepted.
+   *   </p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>ENABLED</code>: Transfer Family rejects unsigned messages from your trading partner.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>DISABLED</code> (default value): Transfer Family accepts unsigned messages from your trading partner.</p>
+   *             </li>
+   *          </ul>
+   * @public
+   */
+  EnforceMessageSigning?: EnforceMessageSigningType | undefined;
 }
 
 /**
@@ -425,6 +491,44 @@ export interface DescribedAgreement {
    * @public
    */
   Tags?: Tag[] | undefined;
+
+  /**
+   * <p>
+   *     Determines whether or not Transfer Family appends a unique string of characters to the end of the AS2 message payload
+   *     filename when saving it.
+   *  </p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>ENABLED</code>: the filename provided by your trading parter is preserved when the file is saved.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>DISABLED</code> (default value): when Transfer Family  saves the file, the filename is adjusted, as
+   *       described in <a href="https://docs.aws.amazon.com/transfer/latest/userguide/send-as2-messages.html#file-names-as2">File names and locations</a>.</p>
+   *             </li>
+   *          </ul>
+   * @public
+   */
+  PreserveFilename?: PreserveFilenameType | undefined;
+
+  /**
+   * <p>
+   *      Determines whether or not unsigned messages from your trading partners will be accepted.
+   *   </p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>ENABLED</code>: Transfer Family rejects unsigned messages from your trading partner.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>DISABLED</code> (default value): Transfer Family accepts unsigned messages from your trading partner.</p>
+   *             </li>
+   *          </ul>
+   * @public
+   */
+  EnforceMessageSigning?: EnforceMessageSigningType | undefined;
 }
 
 /**
@@ -638,6 +742,44 @@ export interface UpdateAgreementRequest {
    * @public
    */
   AccessRole?: string | undefined;
+
+  /**
+   * <p>
+   *     Determines whether or not Transfer Family appends a unique string of characters to the end of the AS2 message payload
+   *     filename when saving it.
+   *  </p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>ENABLED</code>: the filename provided by your trading parter is preserved when the file is saved.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>DISABLED</code> (default value): when Transfer Family  saves the file, the filename is adjusted, as
+   *       described in <a href="https://docs.aws.amazon.com/transfer/latest/userguide/send-as2-messages.html#file-names-as2">File names and locations</a>.</p>
+   *             </li>
+   *          </ul>
+   * @public
+   */
+  PreserveFilename?: PreserveFilenameType | undefined;
+
+  /**
+   * <p>
+   *      Determines whether or not unsigned messages from your trading partners will be accepted.
+   *   </p>
+   *          <ul>
+   *             <li>
+   *                <p>
+   *                   <code>ENABLED</code>: Transfer Family rejects unsigned messages from your trading partner.</p>
+   *             </li>
+   *             <li>
+   *                <p>
+   *                   <code>DISABLED</code> (default value): Transfer Family accepts unsigned messages from your trading partner.</p>
+   *             </li>
+   *          </ul>
+   * @public
+   */
+  EnforceMessageSigning?: EnforceMessageSigningType | undefined;
 }
 
 /**
@@ -714,6 +856,20 @@ export const MdnSigningAlg = {
  */
 export type MdnSigningAlg = (typeof MdnSigningAlg)[keyof typeof MdnSigningAlg];
 
+/**
+ * @public
+ * @enum
+ */
+export const PreserveContentType = {
+  DISABLED: "DISABLED",
+  ENABLED: "ENABLED",
+} as const;
+
+/**
+ * @public
+ */
+export type PreserveContentType = (typeof PreserveContentType)[keyof typeof PreserveContentType];
+
 /**
  * @public
  * @enum
@@ -838,6 +994,14 @@ export interface As2ConnectorConfig {
    * @public
    */
   BasicAuthSecretId?: string | undefined;
+
+  /**
+   * <p>Allows you to use the Amazon S3 <code>Content-Type</code> that is associated with objects in S3 instead of
+   *           having the content type mapped based on the file extension. This parameter is enabled by default when you create an AS2 connector
+   *           from the console, but disabled by default when you create an AS2 connector by calling the API directly.</p>
+   * @public
+   */
+  PreserveContentType?: PreserveContentType | undefined;
 }
 
 /**
@@ -957,9 +1121,7 @@ export interface DescribedCertificate {
   Usage?: CertificateUsageType | undefined;
 
   /**
-   * <p>The certificate can be either <code>ACTIVE</code>, <code>PENDING_ROTATION</code>, or
-   *         <code>INACTIVE</code>. <code>PENDING_ROTATION</code> means that this certificate will
-   *       replace the current certificate when it expires.</p>
+   * <p>Currently, the only available status is <code>ACTIVE</code>: all other values are reserved for future use.</p>
    * @public
    */
   Status?: CertificateStatusType | undefined;
diff --git a/codegen/sdk-codegen/aws-models/transfer.json b/codegen/sdk-codegen/aws-models/transfer.json

Original file line number	Diff line number	Diff line change
`@@ -58,6 +58,8 @@ export interface DescribeAgreementCommandOutput extends DescribeAgreementRespons`
`58`	`58`	`* // Value: "STRING_VALUE", // required`
`59`	`59`	`* // },`
`60`	`60`	`* // ],`
	`61`	`+ * // PreserveFilename: "ENABLED" \|\| "DISABLED",`
	`62`	`+ * // EnforceMessageSigning: "ENABLED" \|\| "DISABLED",`
`61`	`63`	`* // },`
`62`	`64`	`* // };`
`63`	`65`	`*`