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.
Inherited Members
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. |