S3Request Class
(QtAws::S3::S3Request)The S3Request class provides an interface for S3 requests. More...
Public Types
| enum | Action { AbortMultipartUploadAction, CompleteMultipartUploadAction, CopyObjectAction, CreateBucketAction, ..., UploadPartCopyAction } |
| flags | Actions |
Public Functions
| S3Request(const Action action) | |
| S3Request(const S3Request &other) | |
| Action | action() const |
| QString | actionString() const |
| QString | apiVersion() const |
| void | setAction(const Action action) |
| void | setApiVersion(const QString &version) |
| S3Request & | operator=(const S3Request &other) |
| virtual bool | operator==(const S3Request &other) const |
- 7 public functions inherited from QtAws::Core::AwsAbstractRequest
Protected Functions
| S3Request(S3RequestPrivate * const d) | |
| int | clearParameter(const QString &name) |
| void | clearParameters() |
| QVariant | parameter(const QString &name, const QVariant &defaultValue = QVariant()) const |
| const QVariantMap & | parameters() const |
| void | setParameter(const QString &name, const QVariant &value) |
| void | setParameters(const QVariantMap ¶meters) |
Reimplemented Protected Functions
| virtual QNetworkRequest | unsignedRequest(const QUrl &endpoint) const override |
- 4 protected functions inherited from QtAws::Core::AwsAbstractRequest
Detailed Description
The S3Request class provides an interface for S3 requests.
Member Type Documentation
enum S3Request::Action
flags S3Request::Actions
This enum describes the actions that can be performed as S3 requests.
| Constant | Value | Description |
|---|---|---|
QtAws::S3::S3Request::AbortMultipartUploadAction | 0 | S3 AbortMultipartUpload action. |
QtAws::S3::S3Request::CompleteMultipartUploadAction | 1 | S3 CompleteMultipartUpload action. |
QtAws::S3::S3Request::CopyObjectAction | 2 | S3 CopyObject action. |
QtAws::S3::S3Request::CreateBucketAction | 3 | S3 CreateBucket action. |
QtAws::S3::S3Request::CreateMultipartUploadAction | 4 | S3 CreateMultipartUpload action. |
QtAws::S3::S3Request::DeleteBucketAction | 5 | S3 DeleteBucket action. |
QtAws::S3::S3Request::DeleteBucketAnalyticsConfigurationAction | 6 | S3 DeleteBucketAnalyticsConfiguration action. |
QtAws::S3::S3Request::DeleteBucketCorsAction | 7 | S3 DeleteBucketCors action. |
QtAws::S3::S3Request::DeleteBucketEncryptionAction | 8 | S3 DeleteBucketEncryption action. |
QtAws::S3::S3Request::DeleteBucketInventoryConfigurationAction | 9 | S3 DeleteBucketInventoryConfiguration action. |
QtAws::S3::S3Request::DeleteBucketLifecycleAction | 10 | S3 DeleteBucketLifecycle action. |
QtAws::S3::S3Request::DeleteBucketMetricsConfigurationAction | 11 | S3 DeleteBucketMetricsConfiguration action. |
QtAws::S3::S3Request::DeleteBucketPolicyAction | 12 | S3 DeleteBucketPolicy action. |
QtAws::S3::S3Request::DeleteBucketReplicationAction | 13 | S3 DeleteBucketReplication action. |
QtAws::S3::S3Request::DeleteBucketTaggingAction | 14 | S3 DeleteBucketTagging action. |
QtAws::S3::S3Request::DeleteBucketWebsiteAction | 15 | S3 DeleteBucketWebsite action. |
QtAws::S3::S3Request::DeleteObjectAction | 16 | S3 DeleteObject action. |
QtAws::S3::S3Request::DeleteObjectTaggingAction | 17 | S3 DeleteObjectTagging action. |
QtAws::S3::S3Request::DeleteObjectsAction | 18 | S3 DeleteObjects action. |
QtAws::S3::S3Request::GetBucketAccelerateConfigurationAction | 19 | S3 GetBucketAccelerateConfiguration action. |
QtAws::S3::S3Request::GetBucketAclAction | 20 | S3 GetBucketAcl action. |
QtAws::S3::S3Request::GetBucketAnalyticsConfigurationAction | 21 | S3 GetBucketAnalyticsConfiguration action. |
QtAws::S3::S3Request::GetBucketCorsAction | 22 | S3 GetBucketCors action. |
QtAws::S3::S3Request::GetBucketEncryptionAction | 23 | S3 GetBucketEncryption action. |
QtAws::S3::S3Request::GetBucketInventoryConfigurationAction | 24 | S3 GetBucketInventoryConfiguration action. |
QtAws::S3::S3Request::GetBucketLifecycleAction | 25 | S3 GetBucketLifecycle action. |
QtAws::S3::S3Request::GetBucketLifecycleConfigurationAction | 26 | S3 GetBucketLifecycleConfiguration action. |
QtAws::S3::S3Request::GetBucketLocationAction | 27 | S3 GetBucketLocation action. |
QtAws::S3::S3Request::GetBucketLoggingAction | 28 | S3 GetBucketLogging action. |
QtAws::S3::S3Request::GetBucketMetricsConfigurationAction | 29 | S3 GetBucketMetricsConfiguration action. |
QtAws::S3::S3Request::GetBucketNotificationAction | 30 | S3 GetBucketNotification action. |
QtAws::S3::S3Request::GetBucketNotificationConfigurationAction | 31 | S3 GetBucketNotificationConfiguration action. |
QtAws::S3::S3Request::GetBucketPolicyAction | 32 | S3 GetBucketPolicy action. |
QtAws::S3::S3Request::GetBucketReplicationAction | 33 | S3 GetBucketReplication action. |
QtAws::S3::S3Request::GetBucketRequestPaymentAction | 34 | S3 GetBucketRequestPayment action. |
QtAws::S3::S3Request::GetBucketTaggingAction | 35 | S3 GetBucketTagging action. |
QtAws::S3::S3Request::GetBucketVersioningAction | 36 | S3 GetBucketVersioning action. |
QtAws::S3::S3Request::GetBucketWebsiteAction | 37 | S3 GetBucketWebsite action. |
QtAws::S3::S3Request::GetObjectAction | 38 | S3 GetObject action. |
QtAws::S3::S3Request::GetObjectAclAction | 39 | S3 GetObjectAcl action. |
QtAws::S3::S3Request::GetObjectTaggingAction | 40 | S3 GetObjectTagging action. |
QtAws::S3::S3Request::GetObjectTorrentAction | 41 | S3 GetObjectTorrent action. |
QtAws::S3::S3Request::HeadBucketAction | 42 | S3 HeadBucket action. |
QtAws::S3::S3Request::HeadObjectAction | 43 | S3 HeadObject action. |
QtAws::S3::S3Request::ListBucketAnalyticsConfigurationsAction | 44 | S3 ListBucketAnalyticsConfigurations action. |
QtAws::S3::S3Request::ListBucketInventoryConfigurationsAction | 45 | S3 ListBucketInventoryConfigurations action. |
QtAws::S3::S3Request::ListBucketMetricsConfigurationsAction | 46 | S3 ListBucketMetricsConfigurations action. |
QtAws::S3::S3Request::ListBucketsAction | 47 | S3 ListBuckets action. |
QtAws::S3::S3Request::ListMultipartUploadsAction | 48 | S3 ListMultipartUploads action. |
QtAws::S3::S3Request::ListObjectVersionsAction | 49 | S3 ListObjectVersions action. |
QtAws::S3::S3Request::ListObjectsAction | 50 | S3 ListObjects action. |
QtAws::S3::S3Request::ListObjectsV2Action | 51 | S3 ListObjectsV2 action. |
QtAws::S3::S3Request::ListPartsAction | 52 | S3 ListParts action. |
QtAws::S3::S3Request::PutBucketAccelerateConfigurationAction | 53 | S3 PutBucketAccelerateConfiguration action. |
QtAws::S3::S3Request::PutBucketAclAction | 54 | S3 PutBucketAcl action. |
QtAws::S3::S3Request::PutBucketAnalyticsConfigurationAction | 55 | S3 PutBucketAnalyticsConfiguration action. |
QtAws::S3::S3Request::PutBucketCorsAction | 56 | S3 PutBucketCors action. |
QtAws::S3::S3Request::PutBucketEncryptionAction | 57 | S3 PutBucketEncryption action. |
QtAws::S3::S3Request::PutBucketInventoryConfigurationAction | 58 | S3 PutBucketInventoryConfiguration action. |
QtAws::S3::S3Request::PutBucketLifecycleAction | 59 | S3 PutBucketLifecycle action. |
QtAws::S3::S3Request::PutBucketLifecycleConfigurationAction | 60 | S3 PutBucketLifecycleConfiguration action. |
QtAws::S3::S3Request::PutBucketLoggingAction | 61 | S3 PutBucketLogging action. |
QtAws::S3::S3Request::PutBucketMetricsConfigurationAction | 62 | S3 PutBucketMetricsConfiguration action. |
QtAws::S3::S3Request::PutBucketNotificationAction | 63 | S3 PutBucketNotification action. |
QtAws::S3::S3Request::PutBucketNotificationConfigurationAction | 64 | S3 PutBucketNotificationConfiguration action. |
QtAws::S3::S3Request::PutBucketPolicyAction | 65 | S3 PutBucketPolicy action. |
QtAws::S3::S3Request::PutBucketReplicationAction | 66 | S3 PutBucketReplication action. |
QtAws::S3::S3Request::PutBucketRequestPaymentAction | 67 | S3 PutBucketRequestPayment action. |
QtAws::S3::S3Request::PutBucketTaggingAction | 68 | S3 PutBucketTagging action. |
QtAws::S3::S3Request::PutBucketVersioningAction | 69 | S3 PutBucketVersioning action. |
QtAws::S3::S3Request::PutBucketWebsiteAction | 70 | S3 PutBucketWebsite action. |
QtAws::S3::S3Request::PutObjectAction | 71 | S3 PutObject action. |
QtAws::S3::S3Request::PutObjectAclAction | 72 | S3 PutObjectAcl action. |
QtAws::S3::S3Request::PutObjectTaggingAction | 73 | S3 PutObjectTagging action. |
QtAws::S3::S3Request::RestoreObjectAction | 74 | S3 RestoreObject action. |
QtAws::S3::S3Request::SelectObjectContentAction | 75 | S3 SelectObjectContent action. |
QtAws::S3::S3Request::UploadPartAction | 76 | S3 UploadPart action. |
QtAws::S3::S3Request::UploadPartCopyAction | 77 | S3 UploadPartCopy action. |
The Actions type is a typedef for QFlags<Action>. It stores an OR combination of Action values.
Member Function Documentation
S3Request::S3Request(const Action action)
Constructs a S3Request object for S3 action.
S3Request::S3Request(const S3Request &other)
Constructs a copy of other.
[protected] S3Request::S3Request(S3RequestPrivate * const d)
Constructs aa S3Request object with private implementation d.
This overload allows derived classes to provide their own private class implementation that inherits from S3RequestPrivate.
Action S3Request::action() const
Returns the S3 action to be performed by this request.
See also setAction().
QString S3Request::actionString() const
Returns the name of the S3 action to be performed by this request.
QString S3Request::apiVersion() const
Returns the S3 API version implemented by this request.
See also setApiVersion().
[protected] int S3Request::clearParameter(const QString &name)
Removes the a name parameter from the request, then returns the number of paramters removed (typically 0 or 1).
[protected] void S3Request::clearParameters()
Removes all parameters from the request.
[protected] QVariant S3Request::parameter(const QString &name, const QVariant &defaultValue = QVariant()) const
Returns the value of the name pararemter if set; defaultValue otherwise.
See also setParameter().
[protected] const QVariantMap &S3Request::parameters() const
Returns the parameters included in this request.
See also setParameters().
void S3Request::setAction(const Action action)
Sets the S3 action to be performed by this request to action.
See also action().
void S3Request::setApiVersion(const QString &version)
Sets the S3 API version to include in this request to version.
See also apiVersion().
[protected] void S3Request::setParameter(const QString &name, const QVariant &value)
Sets the name parameter to value.
See also parameter().
[protected] void S3Request::setParameters(const QVariantMap ¶meters)
Sets the paramters for this request to parameters. Any request parameters set previously will be discarded.
See also parameters().
[override virtual protected] QNetworkRequest S3Request::unsignedRequest(const QUrl &endpoint) const
Reimplemented from AwsAbstractRequest::unsignedRequest().
Returns a network request for the S3 request using the given endpoint.
This S3 implementation builds request URLs by combining the common query parameters (such as Action and Version), with any that have been added (via setParameter) by child classes.
S3Request &S3Request::operator=(const S3Request &other)
Sets the S3Request object to be equal to other.
[virtual] bool S3Request::operator==(const S3Request &other) const
Returns true if this request is equal to other; false otherwise.
Note, most derived *Request classes do not need to provider their own implementations of this function, since most such request classes rely on this class' parameters functionality for all request parameters, and that parameters map is already checked via this implementation.
© 2018 Paul Colby Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.