---
title: "Set Canned ACLOn File"
slug: "set-canned-aclon-file"
updated: 2025-08-14T15:09:54Z
published: 2025-08-14T15:09:54Z
canonical: "documentation.decisions.com/set-canned-aclon-file"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Canned ACLOn File

| Step Details |
| --- |
| **Introduced in Version** | 9.0.0 |
| **Last Modified in Version** | 9.0.0 |
| **Location** | Integration > Amazon AWS > S3 |

The **Set Canned ACLOn File** step is used to set the chosen canned ACL wrapper via the ACL to set input on a specified file via the File Name input.

### Prerequisites

- This step requires the [Amazon AWS Module](https://documentation.decisions.com/docs/aws) to be [installed](https://documentation.decisions.com/docs/installing-modules-decisions) before it will be available in the toolbox, and an active [AWS account](https://signin.aws.amazon.com/signin?redirect_uri=https%3A%2F%2Fconsole.aws.amazon.com%2Fconsole%2Fhome%3FhashArgs%3D%2523%26isauthcode%3Dtrue%26nc2%3Dh_ct%26src%3Dheader-signin%26state%3DhashArgsFromTB_eu-north-1_c1412528899e4833&client_id=arn%3Aaws%3Asignin%3A%3A%3Aconsole%2Fcanvas&forceMobileApp=0&code_challenge=HQku5BPrRUboP5p1wGr4Ai_nBIQNSqsR2eHJNCBfxhQ&code_challenge_method=SHA-256). The [Amazon WebServices Settings](https://documentation.decisions.com/docs/setting-up-amazon-webservices-integration) must also be configured.
- A [dependency](https://documentation.decisions.com/docs/project-dependencies) must be created after installing the module in order for the the steps to be properly used.

---

## Properties

#### Inputs

| Property | Description | Data Type |
| --- | --- | --- |
| Bucket Name | Name of bucket containing file to be modified. | String |
| Cannonical User Id | 64 character user Id associated with the ACL. | String |
| File Name | Name of file to have a canned ACL applied to. | String |
| Permissions To Set | Permissions to establish on the file via canned ACL. | List of S3PeremissionWrapper |
| Region | The Amazon AWS Region the instance is located on. | AmazonAWSRegion |
| Override Role Credentials | Optional input allowing the user to alter the default role used to create the folder. | AssumeRoleCredentials |

#### Override Settings

| Property | Description | Data Type |
| --- | --- | --- |
| Access Key ID | ID used to connect to Amazon S3. | String |
| Secret Access Key | Secret Access Key used to connect to Amazon S3. | String |

![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2025-08-05_12h44_50.png)

---

## Common Errors

### Exception invoking method SetACLOnFile on class AmazonS3Steps

If one or more input values are not declared, the step will cause an error. To correct this, ensure all input values have been filled out properly.

#### Exception Message:

```csharp
DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Set ACLOn File 1[SetACLOnFile] in flow [S3 Step Flows]: Exception invoking method SetACLOnFile on class AmazonS3Steps
 ---> DecisionsFramework.LoggedException: Exception invoking method SetACLOnFile on class AmazonS3Steps
 ---> System.ArgumentException: BucketName is a required property and must be set before making this call. (Parameter 'GetACLRequest.BucketName')
 at Amazon.S3.Model.Internal.MarshallTransformations.GetACLRequestMarshaller.Marshall(GetACLRequest getObjectAclRequest)
 at Amazon.S3.Model.Internal.MarshallTransformations.GetACLRequestMarshaller.Marshall(AmazonWebServiceRequest input)
 at Amazon.Runtime.Internal.Marshaller.PreInvoke(IExecutionContext executionContext)
 at Amazon.Runtime.Internal.Marshaller.InvokeAsync[T](IExecutionContext executionContext)
 at Amazon.S3.Internal.AmazonS3PreMarshallHandler.InvokeAsync[T](IExecutionContext executionContext)
 at Amazon.Runtime.Internal.CallbackHandler.InvokeAsync[T](IExecutionContext executionContext)
 at Amazon.S3.Internal.AmazonS3ExceptionHandler.InvokeAsync[T](IExecutionContext executionContext)
 at Amazon.Runtime.Internal.ErrorCallbackHandler.InvokeAsync[T](IExecutionContext executionContext)
 at Amazon.Runtime.Internal.MetricsHandler.InvokeAsync[T](IExecutionContext executionContext)
 at Decisions.AmazonAWS.S3.AmazonS3Steps.SetACLOnFile(String BucketName, String FileName, String CannonicalUserId, S3PermissionWrapper[] PermissionsToSet, AmazonAWSRegion Region, AssumeRoleCredentials overrideCredentials, String accessKeyId, String secretAccessKey)
 at DecisionsFramework.Design.Flow.StepImplementations.InvokeMethodStep.Run(StepStartData data)
   --- End of inner exception stack trace ---
```

---

Related Information

Related Article:

[Amazon AWS S3](https://documentation.decisions.com/docs/aws-s3-step-glossary)