feat(S3): adds suspend and resume features for multipart upload tasks

#4167

Author: Brennan Stehling

AWSS3/AWSS3TransferUtility.h

@@ -620,6 +620,30 @@ handleEventsForBackgroundURLSession:(NSString *)identifier
                                                     expression:(nullable AWSS3TransferUtilityDownloadExpression *)expression
                                              completionHandler:(nullable AWSS3TransferUtilityDownloadCompletionHandlerBlock)completionHandler;
 
+/**
+ Suspends multipart upload
+ @param multipartUploadTask task
+ */
+- (nullable NSError *)suspendMultipartUpload:(AWSS3TransferUtilityMultiPartUploadTask *)multipartUploadTask;
+
+/**
+ Suspends all multipart uploads.
+ @param completionHandler completion handler
+ */
+- (void)suspendAllMultipartUploadsWithCompletionHandler:(nullable AWSS3TransferUtilityMultiPartUploadSuspendBlock)completionHandler;
+
+/**
+  Resumes a multipart upload.
+ @param multiPartUploadTask   The task to resume
+ */
+- (nullable NSError *)resumeMultipartUpload:(nonnull AWSS3TransferUtilityMultiPartUploadTask *)multiPartUploadTask;
+
+/**
+  Resumes all multipart uploads.
+ @param completionHandler completion handler  
+ */
+- (void)resumeAllMultipartUploadsWithCompletionHandler:(nullable AWSS3TransferUtilityMultiPartUploadResumeBlock)completionHandler;
+
 /**
  Assigns progress feedback and completion handler blocks. This method should be called when the app was suspended while the transfer is still happening.