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

Request Parameters for Managing an Object ACL

Request parameters for setting a pre-defined object ACL:

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.

object_info

obs_object_info *

Yes

Object name and version ID. For non-multi-version objects, set version to 0.

canned_acl

obs_canned_acl

Yes

For details, see Table 1.

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.

Request parameters for directly setting an object ACL:

Table 2 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.

aclinfo

manager_acl_info *

Yes

Structure for managing ACL permission information

aclinfo->object_info

obs_object_info *

Yes

Object name and version ID. For non-multi-version objects, set version to 0.

aclinfo->owner_id

char *

No

Account (domain) ID of the bucket owner.

aclinfo->acl_grant_count_return

int *

Yes

Pointer to the number of returned aclinfo->acl_grants

aclinfo->acl_grants

obs_acl_grant *

Yes

Pointer to the permissions information structure. For details, see obs_acl_grant in Configuring a Bucket ACL (SDK for C).

aclinfo->object_delivered

obs_object_delivered

No

Indicates whether the object ACL inherits the ACL of the bucket. Valid values are OBJECT_DELIVERED_TRUE and OBJECT_DELIVERED_FALSE. The default value is OBJECT_DELIVERED_TRUE.

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.