Skip to content

Commit 2319d3a

Browse files
author
AWS
committed
AWS Transfer Family Update: This launch enables customers to manage contents of their remote directories, by deleting old files or moving files to archive folders in remote servers once they have been retrieved. Customers will be able to automate the process using event-driven architecture.
1 parent 772443c commit 2319d3a

File tree

2 files changed

+129
-18
lines changed

2 files changed

+129
-18
lines changed

‎.changes/next-release/feature-AWSTransferFamily-724cb17.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "AWS Transfer Family",
4+
"contributor": "",
5+
"description": "This launch enables customers to manage contents of their remote directories, by deleting old files or moving files to archive folders in remote servers once they have been retrieved. Customers will be able to automate the process using event-driven architecture."
6+
}

‎services/transfer/src/main/resources/codegen-resources/service-2.json

Lines changed: 123 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -578,7 +578,7 @@
578578
{"shape":"InternalServiceError"},
579579
{"shape":"ServiceUnavailableException"}
580580
],
581-
"documentation":"<p>Imports the signing and encryption certificates that you need to create local (AS2) profiles and partner profiles.</p>"
581+
"documentation":"<p>Imports the signing and encryption certificates that you need to create local (AS2) profiles and partner profiles.</p> <p>You can import both the certificate and its chain in the <code>Certificate</code> parameter.</p> <note> <p>If you use the <code>Certificate</code> parameter to upload both the certificate and its chain, don't use the <code>CertificateChain</code> parameter.</p> </note>"
582582
},
583583
"ImportHostKey":{
584584
"name":"ImportHostKey",
@@ -900,6 +900,40 @@
900900
],
901901
"documentation":"<p>Begins a file transfer between local Amazon Web Services storage and a remote AS2 or SFTP server.</p> <ul> <li> <p>For an AS2 connector, you specify the <code>ConnectorId</code> and one or more <code>SendFilePaths</code> to identify the files you want to transfer.</p> </li> <li> <p>For an SFTP connector, the file transfer can be either outbound or inbound. In both cases, you specify the <code>ConnectorId</code>. Depending on the direction of the transfer, you also specify the following items:</p> <ul> <li> <p>If you are transferring file from a partner's SFTP server to Amazon Web Services storage, you specify one or more <code>RetrieveFilePaths</code> to identify the files you want to transfer, and a <code>LocalDirectoryPath</code> to specify the destination folder.</p> </li> <li> <p>If you are transferring file to a partner's SFTP server from Amazon Web Services storage, you specify one or more <code>SendFilePaths</code> to identify the files you want to transfer, and a <code>RemoteDirectoryPath</code> to specify the destination folder.</p> </li> </ul> </li> </ul>"
902902
},
903+
"StartRemoteDelete":{
904+
"name":"StartRemoteDelete",
905+
"http":{
906+
"method":"POST",
907+
"requestUri":"/"
908+
},
909+
"input":{"shape":"StartRemoteDeleteRequest"},
910+
"output":{"shape":"StartRemoteDeleteResponse"},
911+
"errors":[
912+
{"shape":"ResourceNotFoundException"},
913+
{"shape":"InvalidRequestException"},
914+
{"shape":"ThrottlingException"},
915+
{"shape":"InternalServiceError"},
916+
{"shape":"ServiceUnavailableException"}
917+
],
918+
"documentation":"<p>Deletes a file or directory on the remote SFTP server.</p>"
919+
},
920+
"StartRemoteMove":{
921+
"name":"StartRemoteMove",
922+
"http":{
923+
"method":"POST",
924+
"requestUri":"/"
925+
},
926+
"input":{"shape":"StartRemoteMoveRequest"},
927+
"output":{"shape":"StartRemoteMoveResponse"},
928+
"errors":[
929+
{"shape":"ResourceNotFoundException"},
930+
{"shape":"InvalidRequestException"},
931+
{"shape":"ThrottlingException"},
932+
{"shape":"InternalServiceError"},
933+
{"shape":"ServiceUnavailableException"}
934+
],
935+
"documentation":"<p>Moves or renames a file or directory on the remote SFTP server.</p>"
936+
},
903937
"StartServer":{
904938
"name":"StartServer",
905939
"http":{
@@ -1239,7 +1273,7 @@
12391273
},
12401274
"MdnResponse":{
12411275
"shape":"MdnResponse",
1242-
"documentation":"<p>Used for outbound requests (from an Transfer Family server to a partner AS2 server) to determine whether the partner response for transfers is synchronous or asynchronous. Specify either of the following values:</p> <ul> <li> <p> <code>SYNC</code>: The system expects a synchronous MDN response, confirming that the file was transferred successfully (or not).</p> </li> <li> <p> <code>NONE</code>: Specifies that no MDN response is required.</p> </li> </ul>"
1276+
"documentation":"<p>Used for outbound requests (from an Transfer Family connector to a partner AS2 server) to determine whether the partner response for transfers is synchronous or asynchronous. Specify either of the following values:</p> <ul> <li> <p> <code>SYNC</code>: The system expects a synchronous MDN response, confirming that the file was transferred successfully (or not).</p> </li> <li> <p> <code>NONE</code>: Specifies that no MDN response is required.</p> </li> </ul>"
12431277
},
12441278
"BasicAuthSecretId":{
12451279
"shape":"As2ConnectorSecretId",
@@ -1656,7 +1690,7 @@
16561690
},
16571691
"LoggingRole":{
16581692
"shape":"NullableRole",
1659-
"documentation":"<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that allows a server to turn on Amazon CloudWatch logging for Amazon S3 or Amazon EFSevents. When set, you can view user activity in your CloudWatch logs.</p>"
1693+
"documentation":"<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that allows a server to turn on Amazon CloudWatch logging for Amazon S3 or Amazon EFS events. When set, you can view user activity in your CloudWatch logs.</p>"
16601694
},
16611695
"PostAuthenticationLoginBanner":{
16621696
"shape":"PostAuthenticationLoginBanner",
@@ -2017,6 +2051,12 @@
20172051
}
20182052
}
20192053
},
2054+
"DeleteId":{
2055+
"type":"string",
2056+
"max":512,
2057+
"min":1,
2058+
"pattern":"[0-9a-zA-Z./-]+"
2059+
},
20202060
"DeleteProfileRequest":{
20212061
"type":"structure",
20222062
"required":["ProfileId"],
@@ -2544,7 +2584,7 @@
25442584
},
25452585
"Status":{
25462586
"shape":"CertificateStatusType",
2547-
"documentation":"<p>Currently, the only available status is <code>ACTIVE</code>: all other values are reserved for future use.</p>"
2587+
"documentation":"<p>A certificate's status can be either <code>ACTIVE</code> or <code>INACTIVE</code>.</p> <p>You can set <code>ActiveDate</code> and <code>InactiveDate</code> in the <code>UpdateCertificate</code> call. If you set values for these parameters, those values are used to determine whether the certificate has a status of <code>ACTIVE</code> or <code>INACTIVE</code>.</p> <p>If you don't set values for <code>ActiveDate</code> and <code>InactiveDate</code>, we use the <code>NotBefore</code> and <code>NotAfter</code> date as specified on the X509 certificate to determine when a certificate is active and when it is inactive.</p>"
25482588
},
25492589
"Certificate":{
25502590
"shape":"CertificateBodyType",
@@ -2556,11 +2596,11 @@
25562596
},
25572597
"ActiveDate":{
25582598
"shape":"CertDate",
2559-
"documentation":"<p>An optional date that specifies when the certificate becomes active.</p>"
2599+
"documentation":"<p>An optional date that specifies when the certificate becomes active. If you do not specify a value, <code>ActiveDate</code> takes the same value as <code>NotBeforeDate</code>, which is specified by the CA. </p>"
25602600
},
25612601
"InactiveDate":{
25622602
"shape":"CertDate",
2563-
"documentation":"<p>An optional date that specifies when the certificate becomes inactive.</p>"
2603+
"documentation":"<p>An optional date that specifies when the certificate becomes inactive. If you do not specify a value, <code>InactiveDate</code> takes the same value as <code>NotAfterDate</code>, which is specified by the CA.</p>"
25642604
},
25652605
"Serial":{
25662606
"shape":"CertSerial",
@@ -2840,7 +2880,7 @@
28402880
},
28412881
"LoggingRole":{
28422882
"shape":"NullableRole",
2843-
"documentation":"<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that allows a server to turn on Amazon CloudWatch logging for Amazon S3 or Amazon EFSevents. When set, you can view user activity in your CloudWatch logs.</p>"
2883+
"documentation":"<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that allows a server to turn on Amazon CloudWatch logging for Amazon S3 or Amazon EFS events. When set, you can view user activity in your CloudWatch logs.</p>"
28442884
},
28452885
"PostAuthenticationLoginBanner":{
28462886
"shape":"PostAuthenticationLoginBanner",
@@ -3426,23 +3466,23 @@
34263466
},
34273467
"Certificate":{
34283468
"shape":"CertificateBodyType",
3429-
"documentation":"<ul> <li> <p>For the CLI, provide a file path for a certificate in URI format. For example, <code>--certificate file://encryption-cert.pem</code>. Alternatively, you can provide the raw content.</p> </li> <li> <p>For the SDK, specify the raw content of a certificate file. For example, <code>--certificate \"`cat encryption-cert.pem`\"</code>.</p> </li> </ul>"
3469+
"documentation":"<ul> <li> <p>For the CLI, provide a file path for a certificate in URI format. For example, <code>--certificate file://encryption-cert.pem</code>. Alternatively, you can provide the raw content.</p> </li> <li> <p>For the SDK, specify the raw content of a certificate file. For example, <code>--certificate \"`cat encryption-cert.pem`\"</code>.</p> </li> </ul> <note> <p>You can provide both the certificate and its chain in this parameter, without needing to use the <code>CertificateChain</code> parameter. If you use this parameter for both the certificate and its chain, do not use the <code>CertificateChain</code> parameter.</p> </note>"
34303470
},
34313471
"CertificateChain":{
34323472
"shape":"CertificateChainType",
34333473
"documentation":"<p>An optional list of certificates that make up the chain for the certificate that's being imported.</p>"
34343474
},
34353475
"PrivateKey":{
34363476
"shape":"PrivateKeyType",
3437-
"documentation":"<ul> <li> <p>For the CLI, provide a file path for a private key in URI format.For example, <code>--private-key file://encryption-key.pem</code>. Alternatively, you can provide the raw content of the private key file.</p> </li> <li> <p>For the SDK, specify the raw content of a private key file. For example, <code>--private-key \"`cat encryption-key.pem`\"</code> </p> </li> </ul>"
3477+
"documentation":"<ul> <li> <p>For the CLI, provide a file path for a private key in URI format. For example, <code>--private-key file://encryption-key.pem</code>. Alternatively, you can provide the raw content of the private key file.</p> </li> <li> <p>For the SDK, specify the raw content of a private key file. For example, <code>--private-key \"`cat encryption-key.pem`\"</code> </p> </li> </ul>"
34383478
},
34393479
"ActiveDate":{
34403480
"shape":"CertDate",
3441-
"documentation":"<p>An optional date that specifies when the certificate becomes active.</p>"
3481+
"documentation":"<p>An optional date that specifies when the certificate becomes active. If you do not specify a value, <code>ActiveDate</code> takes the same value as <code>NotBeforeDate</code>, which is specified by the CA. </p>"
34423482
},
34433483
"InactiveDate":{
34443484
"shape":"CertDate",
3445-
"documentation":"<p>An optional date that specifies when the certificate becomes inactive.</p>"
3485+
"documentation":"<p>An optional date that specifies when the certificate becomes inactive. If you do not specify a value, <code>InactiveDate</code> takes the same value as <code>NotAfterDate</code>, which is specified by the CA.</p>"
34463486
},
34473487
"Description":{
34483488
"shape":"Description",
@@ -4133,11 +4173,11 @@
41334173
},
41344174
"ActiveDate":{
41354175
"shape":"CertDate",
4136-
"documentation":"<p>An optional date that specifies when the certificate becomes active.</p>"
4176+
"documentation":"<p>An optional date that specifies when the certificate becomes active. If you do not specify a value, <code>ActiveDate</code> takes the same value as <code>NotBeforeDate</code>, which is specified by the CA. </p>"
41374177
},
41384178
"InactiveDate":{
41394179
"shape":"CertDate",
4140-
"documentation":"<p>An optional date that specifies when the certificate becomes inactive.</p>"
4180+
"documentation":"<p>An optional date that specifies when the certificate becomes inactive. If you do not specify a value, <code>InactiveDate</code> takes the same value as <code>NotAfterDate</code>, which is specified by the CA.</p>"
41414181
},
41424182
"Type":{
41434183
"shape":"CertificateType",
@@ -4285,7 +4325,7 @@
42854325
},
42864326
"LoggingRole":{
42874327
"shape":"Role",
4288-
"documentation":"<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that allows a server to turn on Amazon CloudWatch logging for Amazon S3 or Amazon EFSevents. When set, you can view user activity in your CloudWatch logs.</p>"
4328+
"documentation":"<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that allows a server to turn on Amazon CloudWatch logging for Amazon S3 or Amazon EFS events. When set, you can view user activity in your CloudWatch logs.</p>"
42894329
},
42904330
"ServerId":{
42914331
"shape":"ServerId",
@@ -4410,7 +4450,7 @@
44104450
"members":{
44114451
"LoggingRole":{
44124452
"shape":"Role",
4413-
"documentation":"<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that allows a server to turn on Amazon CloudWatch logging for Amazon S3 or Amazon EFSevents. When set, you can view user activity in your CloudWatch logs.</p>"
4453+
"documentation":"<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that allows a server to turn on Amazon CloudWatch logging for Amazon S3 or Amazon EFS events. When set, you can view user activity in your CloudWatch logs.</p>"
44144454
},
44154455
"LogGroupName":{
44164456
"shape":"LogGroupName",
@@ -4475,6 +4515,12 @@
44754515
"min":1,
44764516
"pattern":"[\\p{Print}\\p{Blank}]+"
44774517
},
4518+
"MoveId":{
4519+
"type":"string",
4520+
"max":512,
4521+
"min":1,
4522+
"pattern":"[0-9a-zA-Z./-]+"
4523+
},
44784524
"NextToken":{
44794525
"type":"string",
44804526
"max":6144,
@@ -5099,6 +5145,65 @@
50995145
}
51005146
}
51015147
},
5148+
"StartRemoteDeleteRequest":{
5149+
"type":"structure",
5150+
"required":[
5151+
"ConnectorId",
5152+
"DeletePath"
5153+
],
5154+
"members":{
5155+
"ConnectorId":{
5156+
"shape":"ConnectorId",
5157+
"documentation":"<p>The unique identifier for the connector.</p>"
5158+
},
5159+
"DeletePath":{
5160+
"shape":"FilePath",
5161+
"documentation":"<p>The absolute path of the file or directory to delete. You can only specify one path per call to this operation.</p>"
5162+
}
5163+
}
5164+
},
5165+
"StartRemoteDeleteResponse":{
5166+
"type":"structure",
5167+
"required":["DeleteId"],
5168+
"members":{
5169+
"DeleteId":{
5170+
"shape":"DeleteId",
5171+
"documentation":"<p>Returns a unique identifier for the delete operation.</p>"
5172+
}
5173+
}
5174+
},
5175+
"StartRemoteMoveRequest":{
5176+
"type":"structure",
5177+
"required":[
5178+
"ConnectorId",
5179+
"SourcePath",
5180+
"TargetPath"
5181+
],
5182+
"members":{
5183+
"ConnectorId":{
5184+
"shape":"ConnectorId",
5185+
"documentation":"<p>The unique identifier for the connector.</p>"
5186+
},
5187+
"SourcePath":{
5188+
"shape":"FilePath",
5189+
"documentation":"<p>The absolute path of the file or directory to move or rename. You can only specify one path per call to this operation.</p>"
5190+
},
5191+
"TargetPath":{
5192+
"shape":"FilePath",
5193+
"documentation":"<p>The absolute path for the target of the move/rename operation.</p>"
5194+
}
5195+
}
5196+
},
5197+
"StartRemoteMoveResponse":{
5198+
"type":"structure",
5199+
"required":["MoveId"],
5200+
"members":{
5201+
"MoveId":{
5202+
"shape":"MoveId",
5203+
"documentation":"<p>Returns a unique identifier for the move/rename operation.</p>"
5204+
}
5205+
}
5206+
},
51025207
"StartServerRequest":{
51035208
"type":"structure",
51045209
"required":["ServerId"],
@@ -5481,11 +5586,11 @@
54815586
},
54825587
"ActiveDate":{
54835588
"shape":"CertDate",
5484-
"documentation":"<p>An optional date that specifies when the certificate becomes active.</p>"
5589+
"documentation":"<p>An optional date that specifies when the certificate becomes active. If you do not specify a value, <code>ActiveDate</code> takes the same value as <code>NotBeforeDate</code>, which is specified by the CA. </p>"
54855590
},
54865591
"InactiveDate":{
54875592
"shape":"CertDate",
5488-
"documentation":"<p>An optional date that specifies when the certificate becomes inactive.</p>"
5593+
"documentation":"<p>An optional date that specifies when the certificate becomes inactive. If you do not specify a value, <code>InactiveDate</code> takes the same value as <code>NotAfterDate</code>, which is specified by the CA.</p>"
54895594
},
54905595
"Description":{
54915596
"shape":"Description",
@@ -5640,7 +5745,7 @@
56405745
},
56415746
"LoggingRole":{
56425747
"shape":"NullableRole",
5643-
"documentation":"<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that allows a server to turn on Amazon CloudWatch logging for Amazon S3 or Amazon EFSevents. When set, you can view user activity in your CloudWatch logs.</p>"
5748+
"documentation":"<p>The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) role that allows a server to turn on Amazon CloudWatch logging for Amazon S3 or Amazon EFS events. When set, you can view user activity in your CloudWatch logs.</p>"
56445749
},
56455750
"PostAuthenticationLoginBanner":{
56465751
"shape":"PostAuthenticationLoginBanner",

0 commit comments

Comments
 (0)