Help Center/ Object Storage Service/ SDK Reference/ C/ Parameters/ Request Parameters for Copying an Object
Updated on 2026-08-03 GMT+08:00

Request Parameters for Copying an Object

Table 1 List of request parameters

Parameter

Type

Mandatory (Yes/No)

Description

options

const obs_options *

Yes

The context of the requested bucket. Refer to Configuring option (SDK for C) to set the AK, SK, endpoint, bucket, timeout, and temporary credentials through obs_options.

key

char *

Yes

Object name

version_id

char *

No

Object version ID

object_info

obs_copy_destination_object_info *

Yes

Information about the object copy.

object_info->destination_bucket

char *

Yes

Bucket where the destination object is located

object_info->destination_key

char *

Yes

Destination object name

object_info->last_modified_return

int64_t *

Yes

Latest time when the object was modified

object_info->etag_return_size

int

Yes

Cache size of ETag

object_info->etag_return

char *

Yes

Cache of ETag

is_copy

unsigned int

Yes

Indicates whether the metadata of the destination object is copied from the source object or replaced with the metadata contained in the request.

put_properties

obs_put_properties*

No

Properties of the uploaded object

encryption_params

server_side_encryption_params *

No

Server-side encryption configuration

handler

obs_response_handler *

Yes

A callback structure where all members are pointers to callback functions, used to set the callback functions that handle response data. You can set a callback function to copy the response data from the server to your custom callback_data.

callback_data

void *

No

Custom callback data.