Assembly: AWSSDK (in AWSSDK.dll) Version: 1.4.10.0 (1.4.10.0)
Syntax
| C# | Visual Basic | Visual C++ |
public interface AmazonS3 : IDisposable
Public Interface AmazonS3 _ Inherits IDisposable
public interface class AmazonS3 : IDisposable
Members
| All Members | Methods |
| Member | Description | |
|---|---|---|
| AbortMultipartUpload(AbortMultipartUploadRequest) |
This method aborts a multipart upload. After a multipart upload is
aborted, no additional parts can be uploaded using that upload ID.
The storage consumed by any previously uploaded parts will be freed.
However, if any part uploads are currently in progress, those part
uploads may or may not succeed. As a result, it may be necessary to
abort a given multipart upload multiple times in order to completely free
all storage consumed by all parts.
| |
| BeginAbortMultipartUpload(AbortMultipartUploadRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the AbortMultipartUpload operation.
| |
| BeginCompleteMultipartUpload(CompleteMultipartUploadRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the CompleteMultipartUpload operation.
| |
| BeginCopyObject(CopyObjectRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the CopyObject operation.
| |
| BeginCopyPart(CopyPartRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the CopyPart operation.
| |
| BeginDeleteBucket(DeleteBucketRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the DeleteBucket operation.
| |
| BeginDeleteBucketPolicy(DeleteBucketPolicyRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the DeleteBucketPolicy operation.
| |
| BeginDeleteBucketWebsite(DeleteBucketWebsiteRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the DeleteBucketWebsite operation.
| |
| BeginDeleteLifecycleConfiguration(DeleteLifecycleConfigurationRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the DeleteLifecycleConfiguration operation.
| |
| BeginDeleteObject(DeleteObjectRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the DeleteObject operation.
| |
| BeginDeleteObjects(DeleteObjectsRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the DeleteObjects operation.
| |
| BeginDisableBucketLogging(DisableBucketLoggingRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the DisableBucketLogging operation.
| |
| BeginEnableBucketLogging(EnableBucketLoggingRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the EnableBucketLogging operation.
| |
| BeginGetACL(GetACLRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the GetACL operation.
| |
| BeginGetBucketLocation(GetBucketLocationRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the GetBucketLocation operation.
| |
| BeginGetBucketLogging(GetBucketLoggingRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the GetBucketLogging operation.
| |
| BeginGetBucketPolicy(GetBucketPolicyRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the GetBucketPolicy operation.
| |
| BeginGetBucketVersioning(GetBucketVersioningRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the GetBucketVersioning operation.
| |
| BeginGetBucketWebsite(GetBucketWebsiteRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the GetBucketWebsite operation.
| |
| BeginGetLifecycleConfiguration(GetLifecycleConfigurationRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the GetLifecycleConfiguration operation.
| |
| BeginGetNotificationConfiguration(GetNotificationConfigurationRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the GetNotificationConfiguration operation.
| |
| BeginGetObject(GetObjectRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the GetObject operation.
| |
| BeginGetObjectMetadata(GetObjectMetadataRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the GetObjectMetadata operation.
| |
| BeginInitiateMultipartUpload(InitiateMultipartUploadRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the InitiateMultipartUpload operation.
| |
| BeginListBuckets(AsyncCallback, Object) |
The ListBuckets operation returns a list of all of the buckets
owned by the authenticated sender of the request.
| |
| BeginListBuckets(ListBucketsRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the ListBuckets operation.
| |
| BeginListMultipartUploads(ListMultipartUploadsRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the ListMultipartUploads operation.
| |
| BeginListObjects(ListObjectsRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the ListObjects operation.
| |
| BeginListParts(ListPartsRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the ListParts operation.
| |
| BeginListVersions(ListVersionsRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the ListVersions operation.
| |
| BeginPutBucket(PutBucketRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the PutBucket operation.
| |
| BeginPutBucketPolicy(PutBucketPolicyRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the PutBucketPolicy operation.
| |
| BeginPutBucketWebsite(PutBucketWebsiteRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the PutBucketWebsite operation.
| |
| BeginPutLifecycleConfiguration(PutLifecycleConfigurationRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the PutLifecycleConfiguration operation.
| |
| BeginPutObject(PutObjectRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the PutObject operation.
| |
| BeginSetACL(SetACLRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the SetACL operation.
| |
| BeginSetBucketVersioning(SetBucketVersioningRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the SetBucketVersioning operation.
| |
| BeginSetNotificationConfiguration(SetNotificationConfigurationRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the SetNotificationConfiguration operation.
| |
| BeginUploadPart(UploadPartRequest, AsyncCallback, Object) |
Initiates the asynchronous execution of the UploadPart operation.
| |
| CompleteMultipartUpload(CompleteMultipartUploadRequest) |
This operation completes a multipart upload by assembling
previously uploaded parts.
You first upload all parts using the UploadPart method. After successfully uploading all relevant parts of an upload, you call this operation to complete the upload. Upon receiving this request, Amazon S3 concatenates all the parts in ascending order by part number to create a new object. In the CompleteMultipartUpload request, you must provide the parts list. For each part in the list, you provide the part number and the ETag header value, returned after that part was uploaded. Processing of a CompleteMultipartUpload request may take several minutes to complete. | |
| CopyObject(CopyObjectRequest) |
The copy operation creates a copy of an object that is already stored in Amazon S3.
When copying an object, you can preserve all metadata (default) or specify new metadata.
However, the ACL is not preserved and is set to private for the user making the request.
To override the default ACL setting, specify a new ACL when generating a copy request.
If versioning has been enabled on the source bucket, and you want to copy a specific
version of an object, please use
SourceVersionId to specify the
version. By default, the most recent version of an object is copied to the
destination bucket.
| |
| CopyPart(CopyPartRequest) |
This method creates a part in a multipart upload from an existing Amazon S3 Object.
You must initiate a multipart upload before you can copy a part.
Your CopyPart request must include an upload ID and a part number. The upload ID is the ID returned by Amazon S3 in response to your Initiate Multipart Upload request. Part number can be any number between 1 and 10,000, inclusive. A part number uniquely identifies a part and also defines its position within the object being uploaded. If you copy a part using the same part number as an existing part, that part is overwritten. When you copy a part, the CopyPartResponse response contains an ETag property. You should record this ETag property value and the part number. After uploading all parts, you must send a CompleteMultipartUpload request. At that time Amazon S3 constructs a complete object by concatenating all the parts you uploaded, in ascending order based on the part numbers. The CompleteMultipartUpload request requires you to send all the part numbers and the corresponding ETag values. | |
| DeleteBucket(DeleteBucketRequest) |
The DeleteBucket operation deletes the bucket named in the request.
All objects in the bucket must be deleted before the bucket itself can be deleted.
Only the owner of a bucket can delete it, regardless of the bucket's access control policy.
| |
| DeleteBucketPolicy(DeleteBucketPolicyRequest) | Deletes the policy associated with the specified bucket. Only the owner of the bucket can delete the bucket policy. If you delete a policy that does not exist, Amazon S3 will return a success (not an error message). Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy may be specified per-bucket. For more information on forming bucket polices, refer: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ | |
| DeleteBucketWebsite(DeleteBucketWebsiteRequest) |
This operation removes the website configuration for a bucket.
| |
| DeleteLifecycleConfiguration(DeleteLifecycleConfigurationRequest) | Deletes the lifecycle configuration for the specified bucket. If you delete a configuration that does not exist, Amazon S3 will return a success (not an error message). Lifecycle configuration provides a way to define the lifetime of objects for a keyspace. Objects are automatically deleted after the predefined lifetime. For more information on lifecycle configurations, refer: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ | |
| DeleteObject(DeleteObjectRequest) |
The DeleteObject operation removes the specified object from Amazon S3.
Once deleted, there is no method to restore or undelete an object.
If you delete an object that does not exist, Amazon S3 will return a
success (not an error message).
| |
| DeleteObjects(DeleteObjectsRequest) |
The DeleteObjects operation removes the specified object from Amazon S3.
Once deleted, there is no method to restore or undelete the objects.
DeleteObjectsException will be thrown if any of the deletes fail.
| |
| DisableBucketLogging(DisableBucketLoggingRequest) |
The DisableBucketLogging will turn off bucket logging for the bucket specified
in the request.
An Amazon S3 bucket can be configured to create access log records for the
requests made against it. An access log record contains details about the
request such as the request type, the resource with which the request worked,
and the time and date that the request was processed. Server access logs are
useful for many applications, because they give bucket owners insight into
the nature of requests made by clients not under their control.
| |
| Dispose()()()() |
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
(Inherited from IDisposable.) | |
| EnableBucketLogging(EnableBucketLoggingRequest) |
The EnableBucketLogging operation will turn on bucket logging for the bucket
specified in the request.
An Amazon S3 bucket can be configured to create access log records for the
requests made against it. An access log record contains details about the
request such as the request type, the resource with which the request worked,
and the time and date that the request was processed. Server access logs are
useful for many applications, because they give bucket owners insight into
the nature of requests made by clients not under their control.
| |
| EndAbortMultipartUpload(IAsyncResult) |
Finishes the asynchronous execution of the AbortMultipartUpload operation.
| |
| EndCompleteMultipartUpload(IAsyncResult) |
Finishes the asynchronous execution of the CompleteMultipartUpload operation.
| |
| EndCopyObject(IAsyncResult) |
Finishes the asynchronous execution of the CopyObject operation.
| |
| EndCopyPart(IAsyncResult) |
Finishes the asynchronous execution of the CopyPart operation.
| |
| EndDeleteBucket(IAsyncResult) |
Finishes the asynchronous execution of the DeleteBucket operation.
| |
| EndDeleteBucketPolicy(IAsyncResult) |
Finishes the asynchronous execution of the DeleteBucketPolicy operation.
| |
| EndDeleteBucketWebsite(IAsyncResult) |
Finishes the asynchronous execution of the DeleteBucketWebsite operation.
| |
| EndDeleteLifecycleConfiguration(IAsyncResult) |
Finishes the asynchronous execution of the DeleteLifecycleConfiguration operation.
| |
| EndDeleteObject(IAsyncResult) |
Finishes the asynchronous execution of the DeleteObject operation.
| |
| EndDeleteObjects(IAsyncResult) |
Finishes the asynchronous execution of the DeleteObjects operation.
DeleteObjectsException will be thrown if any of the deletes fail.
| |
| EndDisableBucketLogging(IAsyncResult) |
Finishes the asynchronous execution of the DisableBucketLogging operation.
| |
| EndEnableBucketLogging(IAsyncResult) |
Finishes the asynchronous execution of the EnableBucketLogging operation.
| |
| EndGetACL(IAsyncResult) |
Finishes the asynchronous execution of the GetACL operation.
| |
| EndGetBucketLocation(IAsyncResult) |
Finishes the asynchronous execution of the GetBucketLocation operation.
| |
| EndGetBucketLogging(IAsyncResult) |
Finishes the asynchronous execution of the GetBucketLogging operation.
| |
| EndGetBucketPolicy(IAsyncResult) |
Finishes the asynchronous execution of the GetBucketPolicy operation.
| |
| EndGetBucketVersioning(IAsyncResult) |
Finishes the asynchronous execution of the GetBucketVersioning operation.
| |
| EndGetBucketWebsite(IAsyncResult) |
Finishes the asynchronous execution of the GetBucketWebsite operation.
| |
| EndGetLifecycleConfiguration(IAsyncResult) |
Finishes the asynchronous execution of the GetLifecycleConfiguration operation.
| |
| EndGetNotificationConfiguration(IAsyncResult) |
Finishes the asynchronous execution of the GetNotificationConfiguration operation.
| |
| EndGetObject(IAsyncResult) |
Finishes the asynchronous execution of the GetObject operation.
| |
| EndGetObjectMetadata(IAsyncResult) |
Finishes the asynchronous execution of the GetObjectMetadata operation.
| |
| EndInitiateMultipartUpload(IAsyncResult) |
Finishes the asynchronous execution of the InitiateMultipartUpload operation.
| |
| EndListBuckets(IAsyncResult) |
Finishes the asynchronous execution of the ListBuckets operation.
| |
| EndListMultipartUploads(IAsyncResult) |
Finishes the asynchronous execution of the ListMultipartUploads operation.
| |
| EndListObjects(IAsyncResult) |
Finishes the asynchronous execution of the ListObjects operation.
| |
| EndListParts(IAsyncResult) |
Finishes the asynchronous execution of the ListParts operation.
| |
| EndListVersions(IAsyncResult) |
Finishes the asynchronous execution of the ListVersions operation.
| |
| EndPutBucket(IAsyncResult) |
Finishes the asynchronous execution of the PutBucket operation.
| |
| EndPutBucketPolicy(IAsyncResult) |
Finishes the asynchronous execution of the PutBucketPolicy operation.
| |
| EndPutBucketWebsite(IAsyncResult) |
Finishes the asynchronous execution of the PutBucketWebsite operation.
| |
| EndPutLifecycleConfiguration(IAsyncResult) |
Finishes the asynchronous execution of the PutLifecycleConfiguration operation.
| |
| EndPutObject(IAsyncResult) |
Finishes the asynchronous execution of the PutObject operation.
| |
| EndSetACL(IAsyncResult) |
Finishes the asynchronous execution of the SetACL operation.
| |
| EndSetBucketVersioning(IAsyncResult) |
Finishes the asynchronous execution of the SetBucketVersioning operation.
| |
| EndSetNotificationConfiguration(IAsyncResult) |
Finishes the asynchronous execution of the SetNotificationConfiguration operation.
| |
| EndUploadPart(IAsyncResult) |
Finishes the asynchronous execution of the UploadPart operation.
| |
| GetACL(GetACLRequest) |
The GetACL operation gets the S3AccessControlList for a given bucket or object.
Each bucket and object in Amazon S3 has an ACL that defines its access control
policy, which is a list of grants. A grant consists of one grantee and one permission.
ACLs only grant permissions; they do not deny them.
| |
| GetBucketLocation(GetBucketLocationRequest) |
The GetBucketLocation operation takes in a bucket's name and lists the location
of the bucket. This information can be used to determine the bucket's geographical
location.
To determine the location of a bucket, you must be the bucket owner.
| |
| GetBucketLogging(GetBucketLoggingRequest) |
The GetBucketLogging operating gets the logging status for the bucket specified.
For more information about S3Bucket Logging
see http://docs.amazonwebservices.com/AmazonS3/latest/ServerLogs.html | |
| GetBucketPolicy(GetBucketPolicyRequest) | Retrieves the policy for the specified bucket. Only the owner of the bucket can retrieve the policy. If no policy has been set for the bucket, then an error will be thrown. Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy can be specified per-bucket. For more information on forming bucket polices, refer: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ | |
| GetBucketVersioning(GetBucketVersioningRequest) |
The GetBucketVersioning operation takes in a bucket's name and get the versioning
status of the bucket.
| |
| GetBucketWebsite(GetBucketWebsiteRequest) |
This operation retrieves the website configuration for a bucket. The contents of this response
is identical to the content submitted by the user during the PutBucketWebsite operation if it has ever been configured.
| |
| GetLifecycleConfiguration(GetLifecycleConfigurationRequest) | Retrieves the lifecycle configuration for the specified bucket. If no configuration has been set for the bucket, the Configuration property of the response will be null. Lifecycle configuration provides a way to define the lifetime of objects for a keyspace. Objects are automatically deleted after the predefined lifetime. For more information on lifecycle configurations, refer: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ | |
| GetNotificationConfiguration(GetNotificationConfigurationRequest) | Retrieves the notification configuration for the specified bucket. Only the owner of the bucket can retrieve the notification configuration. | |
| GetObject(GetObjectRequest) |
The GetObject operation fetches the most recent version of an S3 object
from the specified S3 bucket. You must have READ access to the object.
If READ access is granted to an anonymous user, an object can be retrieved
without an authorization header. Providing a version-id for the object will
fetch the specific version from S3 instead of the most recent one.
| |
| GetObjectMetadata(GetObjectMetadataRequest) |
The GetObjectMetadata operation is used to retrieve information about a specific object
or object size, without actually fetching the object itself. This is useful if you're
only interested in the object metadata, and don't want to waste bandwidth on the object data.
The response is identical to the GetObject response, except that there is no response body.
| |
| GetPreSignedURL(GetPreSignedUrlRequest) |
The GetPreSignedURL operations creates a signed http request.
Query string authentication is useful for giving HTTP or browser
access to resources that would normally require authentication.
When using query string authentication, you create a query,
specify an expiration time for the query, sign it with your
signature, place the data in an HTTP request, and distribute
the request to a user or embed the request in a web page.
A PreSigned URL can be generated for GET, PUT and HEAD
operations on your bucket, keys, and versions.
| |
| InitiateMultipartUpload(InitiateMultipartUploadRequest) |
This method initiates a multipart upload and returns an InitiateMultipartUploadResponse
which contains an upload ID. This upload ID associates all the
parts in the specific upload. You specify this upload ID in each of
your subsequent Upload Part requests. You also include
this upload ID in the final request to either complete, or abort
the multipart upload request.
| |
| ListBuckets()()()() |
The ListBuckets operation returns a list of all of the buckets
owned by the authenticated sender of the request.
| |
| ListBuckets(ListBucketsRequest) |
The ListBuckets operation returns a list of all of the buckets
owned by the authenticated sender of the request.
| |
| ListMultipartUploads(ListMultipartUploadsRequest) |
This operation lists in-progress multipart uploads. An in-progress
multipart upload is a multipart upload that has been initiated,
using the InitiateMultipartUpload request, but has not yet been
completed or aborted.
This operation returns at most 1,000 multipart uploads in the response by default. The number of multipart uploads can be further limited using the MaxUploads property on the request parameter. If there are additional multipart uploads that satisfy the list criteria, the response will contain an IsTruncated property with the value set to true. To list the additional multipart uploads use the KeyMarker and UploadIdMarker properties on the request parameters. | |
| ListObjects(ListObjectsRequest) |
The ListObjects operation lists the objects/keys in a bucket ordered
lexicographically (from a-Z). The list can be filtered via the Marker
property of the ListObjectsRequest.
In order to List Objects, you must have READ access to the bucket.
| |
| ListParts(ListPartsRequest) |
This method lists the parts that have been uploaded
for a particular multipart upload.
This method must include the upload ID, returned by the InitiateMultipartUpload request. This request returns a maximum of 1000 uploaded parts by default. You can restrict the number of parts returned by specifying the MaxParts property on the ListPartsRequest. If your multipart upload consists of more parts than allowed in the ListParts response, the response returns a IsTruncated field with value true, and a NextPartNumberMarker property. In subsequent ListParts request you can include the PartNumberMarker property and set its value to the NextPartNumberMarker property value from the previous response. | |
| ListVersions(ListVersionsRequest) |
The ListVersions operation returns a list of object versions in the bucket
specified ordered first by key and then by version. Keys are sorted lexicographically
(i.e. alphabetically from a-Z); versions are sorted from most to least recent.
Both versions with data and delete markers are included in the results.
In order to List Versions, you must have READ access to the bucket. When the list is not filtered by a specific key, only the metadata associated with the latest version of objects in the bucket is returned. The use of KeyMarker and VersionIdMarker allow you to filter results. | |
| PutBucket(PutBucketRequest) |
The PutBucket operation creates a new S3 Bucket.
Depending on your latency and legal requirements, you can specify a location
constraint that will affect where your data physically resides.
| |
| PutBucketPolicy(PutBucketPolicyRequest) | Sets the policy associated with the specified bucket. Only the owner of the bucket can set a bucket policy. If a policy already exists for the specified bucket, the new policy will replace the existing policy. Bucket policies provide access control management at the bucket level for both the bucket resource and contained object resources. Only one policy may be specified per-bucket. For more information on forming bucket polices, refer: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ | |
| PutBucketWebsite(PutBucketWebsiteRequest) |
This operation enables/configures an S3 Website using the corresponding bucket as the content source.
The website will have one default domain name associated with it, which is the bucket name.
If you attempt to configure an S3 website for a bucket whose name is not compatible with DNS,
Amazon S3 returns an InvalidBucketName error. For more information on bucket names and DNS,
refer to Bucket Restrictions and Limitations.
To visit the S3 bucket as a website a new endpoint is created in the following pattern
http://<bucketName>.s3-website-<region>.amazonaws.com/. This is a sample url for a bucket
called example-bucket in the us-east-1 region. http://example-bucket.s3-website-us-east-1.amazonaws.com/
| |
| PutLifecycleConfiguration(PutLifecycleConfigurationRequest) | Sets the lifecycle configuration that should be applied for the bucket. If a configuration already exists for the specified bucket, the new configuration will replace the existing configuration. Lifecycle configuration provides a way to define the lifetime of objects for a keyspace. Objects are automatically deleted after the predefined lifetime. For more information on lifecycle configurations, refer: http://docs.amazonwebservices.com/AmazonS3/latest/dev/ | |
| PutObject(PutObjectRequest) |
The PutObject operation adds an object to an S3 Bucket.
The response indicates that the object has been successfully stored.
Amazon S3 never stores partial objects: if you receive a successful
response, then you can be confident that the entire object was stored.
To ensure data is not corrupted over the network, use the Content-MD5
header. When you use the Content-MD5 header, Amazon S3 checks the object
against the provided MD5 value. If they do not match, Amazon S3 returns an error.
Additionally, you can calculate the MD5 while putting an object to
Amazon S3 and compare the returned Etag to the calculated MD5 value.
If an object already exists in a bucket, the new object will overwrite
it because Amazon S3 stores the last write request. However, Amazon S3
is a distributed system. If Amazon S3 receives multiple write requests
for the same object nearly simultaneously, all of the objects might be
stored, even though only one wins in the end. Amazon S3 does not provide
object locking; if you need this, make sure to build it into your application
layer.
If you specify a location constraint when creating a bucket, all objects
added to the bucket are stored in the bucket's location.
You must have WRITE access to the bucket to add an object.
| |
| SetACL(SetACLRequest) |
The SetACL operation gets the S3AccessControlList for a given bucket or object.
Each bucket and object in Amazon S3 has an ACL that defines its access control
policy, which is a list of grants. A grant consists of one grantee and one permission.
ACLs only grant permissions; they do not deny them.
| |
| SetBucketVersioning(SetBucketVersioningRequest) |
The SetBucketVersioning operation takes in a bucket's name and the versioning
status you want to set on the bucket.
Valid values for the Versioning Status are Enabled and Suspended. Once Versioning has been "Enabled" on a bucket, it can be "Suspended" but cannot be switched "Off". | |
| SetNotificationConfiguration(SetNotificationConfigurationRequest) | The notification configuration of a bucket provides near realtime notifications of events the user is interested in, using SNS as the delivery service. Notification is turned on by enabling configuration on a bucket, specifying the events and the SNS topic. This configuration can only be turned on by the bucket owner. If a notification configuration already exists for the specified bucket, the new notification configuration will replace the existing notification configuration. To remove the notification configuration pass in an empty request. Currently, buckets may only have a single event and topic configuration. S3 is eventually consistent. It may take time for the notification status of a bucket to be propagated throughout the system. | |
| UploadPart(UploadPartRequest) |
This method uploads a part in a multipart upload. You must initiate a
multipart upload before you can upload any part.
Your UploadPart request must include an upload ID and a part number. The upload ID is the ID returned by Amazon S3 in response to your Initiate Multipart Upload request. Part number can be any number between 1 and 10,000, inclusive. A part number uniquely identifies a part and also defines its position within the object being uploaded. If you upload a new part using the same part number as an existing part, that part is overwritten. To ensure data is not corrupted traversing the network, specify the Content-MD5 header in the Upload Part request. Amazon S3 checks the part data against the provided MD5 value. If they do not match, Amazon S3 returns an error. When you upload a part, the UploadPartResponse response contains an ETag property. You should record this ETag property value and the part number. After uploading all parts, you must send a CompleteMultipartUpload request. At that time Amazon S3 constructs a complete object by concatenating all the parts you uploaded, in ascending order based on the part numbers. The CompleteMultipartUpload request requires you to send all the part numbers and the corresponding ETag values. |