The CopyObjectRequest contains the parameters used for the CopyObject operation.
For more information about the optional parameters, refer:
http://docs.amazonwebservices.com/AmazonS3/latest/RESTObjectCOPY.html
Required Parameters: SourceBucket, SourceKey, DestinationBucket
Optional Parameters: DestinationKey, ETagToMatch, ETagToNotMatch, ModifiedSinceDate, UnmodifiedSinceDate, Directive, Metadata, CannedACL, Timeout, SourceVersionId, StorageClass
Namespace: Amazon.S3.ModelRequired Parameters: SourceBucket, SourceKey, DestinationBucket
Optional Parameters: DestinationKey, ETagToMatch, ETagToNotMatch, ModifiedSinceDate, UnmodifiedSinceDate, Directive, Metadata, CannedACL, Timeout, SourceVersionId, StorageClass
Assembly: AWSSDK (in AWSSDK.dll) Version: 1.4.10.0 (1.4.10.0)
Syntax
Members
| All Members | Constructors | Properties | Methods |
| Member | Description | |
|---|---|---|
| CopyObjectRequest()()()() | Initializes a new instance of the CopyObjectRequest class | |
| AddHeader(String, String) |
Adds the header to the collection of headers for the request.
(Inherited from S3Request.) | |
| AddHeaders(NameValueCollection) |
Adds all of the key/value pairs from collection into our request header.
(Inherited from S3Request.) | |
| CannedACL |
Gets and sets the CannedACL property.
| |
| ContentType |
Gets and sets the ContentType property.
| |
| DestinationBucket |
Gets and sets the DestinationBucket property.
| |
| DestinationKey |
Gets and sets the DestinationKey property.
| |
| Directive |
Gets and sets the Directive property. Default is COPY.
| |
| Equals(Object) | (Inherited from Object.) | |
| ETagToMatch |
Gets and sets the ETagToMatch property.
| |
| ETagToNotMatch |
Gets and sets the ETagToNotMatch property.
| |
| GetHashCode()()()() |
Serves as a hash function for a particular type.
(Inherited from Object.) | |
| GetType()()()() |
Gets the Type of the current instance.
(Inherited from Object.) | |
| InputStream |
Gets and sets the InputStream property.
(Inherited from S3Request.) | |
| ModifiedSinceDate |
Gets and sets the ModifiedSinceDate property.
| |
| ReadWriteTimeout |
Gets and sets of the ReadWriteTimeout property (in milliseconds).
The value of this property is assigned to the
ReadWriteTimeout property of the HTTPWebRequest object
used for S3 COPY requests.
| |
| RemoveCannedACL()()()() |
Resets the S3CannedACL
| |
| RemoveMetaData(String) |
Removes a key from the Metadata list if it was
added previously
| |
| ServerSideEncryptionMethod |
Gets and sets the ServerSideEncryptionMethod property.
Specifies the encryption used on the server to
store the content.
| |
| SourceBucket |
Gets and sets the SourceBucket property.
| |
| SourceKey |
Gets and sets the SourceKey property.
| |
| SourceVersionId |
Gets and sets the SourceVersionId property.
| |
| StorageClass |
Gets and sets the StorageClass property.
Default: The S3StorageClass of the source object.
Set this property only if you want to change the storage
class of the destination object. Please refer
S3StorageClass for
information on S3 Storage Classes.
| |
| Timeout |
Gets and sets of the Timeout property (in milliseconds).
The value of this property is assigned to the
Timeout property of the HTTPWebRequest object used
for S3 COPY requests.
| |
| ToString()()()() | (Inherited from S3Request.) | |
| UnmodifiedSinceDate |
Gets and sets the UnmodifiedSinceDate property.
| |
| WithCannedACL(S3CannedACL) |
Sets the CannedACL property for this request.
If set the S3 Object will have this CannedACL
permission.
| |
| WithContentType(String) |
Sets the ContentType property for this request.
| |
| WithDestinationBucket(String) |
Sets the DestinationBucket property for this request.
This is the S3 Bucket where the copied S3 Object is put.
| |
| WithDestinationKey(String) |
Sets the DestinationKey property for this request.
This is the key for the new S3 Object that is copied.
| |
| WithDirective(S3MetadataDirective) |
Sets the Directive property for this request. The
default value for the directive is COPY.
| |
| WithETagToMatch(String) |
Sets the ETagToMatch property for this request.
Copies the object if its entity tag (ETag) matches
the specified tag; otherwise return a 412 (precondition failed).
Constraints: This property can be used with IfUnmodifiedSince,
but cannot be used with other conditional copy properties.
| |
| WithETagToNotMatch(String) |
Sets the ETagToNotMatch property for this request.
Copies the object if its entity tag (ETag) is different
than the specified Etag; otherwise returns a 412 (failed condition).
Constraints: This header can be used with IfModifiedSince, but cannot
be used with other conditional copy properties.
| |
| WithInputStream(Stream) |
Sets the InputStream property.
(Inherited from S3Request.) | |
| WithMetaData(NameValueCollection) |
Adds a set of key-value pairs to the request
| |
| WithMetaData(String, String) |
Adds a key/value pair to the Metadata property for this request.
The S3 Object that you copy will have this metadata associated
with it.
| |
| WithModifiedSinceDate(DateTime) |
Sets the ModifiedSinceDate property for this request.
Copies the object if it has been modified since the
specified time; otherwise returns a 412 (failed condition).
Constraints: This property can be used with ETagToNotMatch,
but cannot be used with other conditional copy properties.
| |
| WithReadWriteTimeout(Int32) |
Sets the ReadWriteTimeout property (in milliseconds).
The value of this property is assigned to the
ReadWriteTimeout property of the HttpWebRequest.
| |
| WithServerSideEncryptionMethod(ServerSideEncryptionMethod) |
Sets the ServerSideEncryptionMethod property for this request.
Specifies the encryption used on the server to
store the content.
Default is None.
| |
| WithSourceBucket(String) |
Sets the SourceBucket property for this request.
This is the S3Bucket that contains the S3 Object you
want to copy.
| |
| WithSourceKey(String) |
Sets the SourceKey property for this request.
This is the S3Object you want to copy.
| |
| WithSourceVersionId(String) |
Sets the SourceVersionId property for this request.
This is the SourceVersionId for the S3 Object you want to Get.
| |
| WithStorageClass(S3StorageClass) |
Sets the StorageClass property for the destination object.
Default: The S3StorageClass of the source object.
Set this property only if you want to change the storage
class of the destination object. Please refer
S3StorageClass for
information on S3 Storage Classes.
| |
| WithTimeout(Int32) |
Sets the Timeout property (in milliseconds).
Please set the timeout only if you are certain that
the file will not be transferred within the default intervals
for an HttpWebRequest.
| |
| WithUnmodifiedSinceDate(DateTime) |
Sets the UnmodifiedSinceDate property for this request.
Copies the object if it hasn't been modified since the
specified time; otherwise returns a 412 (precondition failed).
Constraints: This property can be used with ETagToMatch,
but cannot be used with other conditional copy properties.
|