Show / Hide Table of Contents

Class CopyObjectDetails

The parameters required by Object Storage to process a request to copy an object to another bucket.
To use any of the API operations, you must be authorized in an IAM policy. If you are not authorized, talk to an administrator. If you are an administrator who needs to write policies to give users access, see Getting Started with Policies.

Inheritance
object
CopyObjectDetails
Inherited Members
object.Equals(object)
object.Equals(object, object)
object.GetHashCode()
object.GetType()
object.MemberwiseClone()
object.ReferenceEquals(object, object)
object.ToString()
Namespace: Oci.ObjectstorageService.Models
Assembly: OCI.DotNetSDK.Objectstorage.dll
Syntax
public class CopyObjectDetails

Properties

DestinationBucket

Declaration
[Required(ErrorMessage = "DestinationBucket is required.")]
[JsonProperty(PropertyName = "destinationBucket")]
public string DestinationBucket { get; set; }
Property Value
Type Description
string

The destination bucket the object will be copied to.

Remarks

Required

DestinationNamespace

Declaration
[Required(ErrorMessage = "DestinationNamespace is required.")]
[JsonProperty(PropertyName = "destinationNamespace")]
public string DestinationNamespace { get; set; }
Property Value
Type Description
string

The destination Object Storage namespace the object will be copied to.

Remarks

Required

DestinationObjectIfMatchETag

Declaration
[JsonProperty(PropertyName = "destinationObjectIfMatchETag")]
public string DestinationObjectIfMatchETag { get; set; }
Property Value
Type Description
string

The entity tag (ETag) to match against that of the destination object (an object intended to be overwritten). Used to confirm that the destination object stored under a given name is the version of that object storing a specified entity tag.

DestinationObjectIfNoneMatchETag

Declaration
[JsonProperty(PropertyName = "destinationObjectIfNoneMatchETag")]
public string DestinationObjectIfNoneMatchETag { get; set; }
Property Value
Type Description
string

The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object already exists in the destination bucket.

DestinationObjectMetadata

Declaration
[JsonProperty(PropertyName = "destinationObjectMetadata")]
public Dictionary<string, string> DestinationObjectMetadata { get; set; }
Property Value
Type Description
Dictionary<string, string>

Arbitrary string keys and values for the user-defined metadata for the object. Keys must be in "opc-meta-*" format. Avoid entering confidential information. Metadata key-value pairs entered in this field are assigned to the destination object. If you enter no metadata values, the destination object will inherit any existing metadata values associated with the source object.

DestinationObjectName

Declaration
[Required(ErrorMessage = "DestinationObjectName is required.")]
[JsonProperty(PropertyName = "destinationObjectName")]
public string DestinationObjectName { get; set; }
Property Value
Type Description
string

The name of the destination object resulting from the copy operation. Avoid entering confidential information.

Remarks

Required

DestinationObjectStorageTier

Declaration
[JsonProperty(PropertyName = "destinationObjectStorageTier")]
[JsonConverter(typeof(StringEnumConverter))]
public StorageTier? DestinationObjectStorageTier { get; set; }
Property Value
Type Description
StorageTier?

The storage tier that the object should be stored in. If not specified, the object will be stored in the same storage tier as the bucket.

DestinationRegion

Declaration
[Required(ErrorMessage = "DestinationRegion is required.")]
[JsonProperty(PropertyName = "destinationRegion")]
public string DestinationRegion { get; set; }
Property Value
Type Description
string

The destination region the object will be copied to, for example "us-ashburn-1".

Remarks

Required

SourceObjectIfMatchETag

Declaration
[JsonProperty(PropertyName = "sourceObjectIfMatchETag")]
public string SourceObjectIfMatchETag { get; set; }
Property Value
Type Description
string

The entity tag (ETag) to match against that of the source object. Used to confirm that the source object with a given name is the version of that object storing a specified ETag.

SourceObjectName

Declaration
[Required(ErrorMessage = "SourceObjectName is required.")]
[JsonProperty(PropertyName = "sourceObjectName")]
public string SourceObjectName { get; set; }
Property Value
Type Description
string

The name of the object to be copied.

Remarks

Required

SourceVersionId

Declaration
[JsonProperty(PropertyName = "sourceVersionId")]
public string SourceVersionId { get; set; }
Property Value
Type Description
string

VersionId of the object to copy. If not provided then current version is copied by default.

In this article
Back to top