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.Model
Assembly: AWSSDK (in AWSSDK.dll) Version: 1.4.10.0 (1.4.10.0)

Syntax

         
 C#  Visual Basic  Visual C++ 
public class CopyObjectRequest : S3Request
Public Class CopyObjectRequest _
	Inherits S3Request
public ref class CopyObjectRequest : public S3Request

Members

            
 All Members  Constructors   Properties   Methods  
 Public

 Protected
 Instance

 Static 
 Declared

 Inherited
 XNA Framework Only 

 .NET Compact Framework Only 

 MemberDescription
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)
Determines whether the specified Object is equal to the current 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.

Inheritance Hierarchy

System..::..Object
  Amazon.S3.Model..::..S3Request
    Amazon.S3.Model..::..CopyObjectRequest

See Also