StoreAddACL

Last update:

May 18, 2026

Warning:

This function is removed in ColdFusion (2025 release). View IAM and Bucket policies in S3 for more information.

Description
Adds ACL to existing ACL for object or bucket.

Returns
Nothing

Syntax

StoreAddACL(url, ACLObject)

Parameters

Parameter	Description
url	Amazon S3 URLs (content or object).
ACLObject	An array of struct where each struct represents a permission or grant as discussed in ACLObject.

History

ColdFusion (2025 release): Removed the function.

ColdFusion 9 Update 1: Added this function

Usage
Use this function to add permissions to the existing ones.

Example

<cfset dir = "s3://bucket_name/"> 

<cfset perm = structnew()> 

<cfset perm.group = "authenticated"> 

<cfset perm.permission = "READ"> 

<cfset perm1 = structnew()> 

<cfset perm1.email = "email_ID"> 

<cfset perm1.permission = "READ_ACP"> 

<cfset myarrray = [perm,perm1]> 

<cfif NOT DirectoryExists(dir)> 

<cfset directoryCreate(dir)> 

</cfif> 

<cfset fileWrite("#dir#/Sample.txt","This is to test StoreAddACL")> 

<cfset StoreAddACL("#dir#","#myarrray#")> 

<cfset test = StoreGetACL(dirkey)> 

<cfdump var="#test#"> 

<cfcatch> 

<cfdump var="#cfcatch#"> 

</cfcatch> 

</cftry>

StoreAddACL

More like this

On this page