Create Bucket

Create a new AWS S3 bucket.

Options

Field Definition Type Required

Region

Region for your AWS S3 bucket. Choose a region for your AWS S3 bucket.

Dropdown

TRUE

Canned ACL

From the dropdown menu, choose a type of Canned Access Control List (ACL) to apply to the object.

If you select None from the dropdown menu, the card generates the following input fields:

  • Grant Full Control

  • Grant Read

  • Grant Read ACP

  • Grant Write ACP

If you select an option other than None, the card doesn't generate those input fields. Instead, the selected Canned ACL option is applied to the uploaded object.

Dropdown

TRUE

Input

Field Definition Type Required

Bucket

Name of the bucket to create.

Text

TRUE

Bucket Object Lock Enabled

If Yes, specifies that you want AWS S3 Object Lock to be enabled for the new bucket.

Otherwise choose False.

True/False

FALSE

Object Ownership

Ownership permission of the object.

  • Bucket Owner Preferred: Objects uploaded to the bucket change ownership to the bucket owner if the objects are uploaded with the bucket-owner-full-control canned ACL.

  • Object Writer: The uploading account will own the object if the object is uploaded with the bucket-owner-full-control canned ACL.

  • Bucket Owner Enforced: Access control lists (ACLs) are disabled and no longer affect permissions. The bucket owner automatically owns and has full control over every object in the bucket. The bucket only accepts PUT requests that don't specify an ACL or bucket owner full control ACLs, such as the bucket-owner-full-control canned ACL or an equivalent form of this ACL expressed in the XML format.

Dropdown

FALSE

Grant Full Control

Grants the listed accounts read, write, read ACP, and write ACP permissions on the bucket.

Specify each grantee as a key and value pair, where the key is one of the following:

  • ID: Use if the value specified is the canonical user ID of an AWS account.
  • URI: Use if you're granting permissions to a predefined group.

  • Email address: Use if the value specified is the email address of an AWS account.

For example, ID=11112222333.

This field is automatically generated if you select None for the Canned ACL field.

List of Text

FALSE

Grant Read

Grants the listed accounts the permission to list the objects in the bucket.

Specify each grantee as a key and value pair, where the key is one of the following:

  • ID: Use if the value specified is the canonical user ID of an AWS account.
  • URI: Use if you're granting permissions to a predefined group.

  • Email address: Use if the value specified is the email address of an AWS account.

For example, ID=11112222333.

This field is automatically generated if you select None for the Canned ACL field.

List of Text

FALSE

Grant Read ACP

Grants the listed accounts the permission to read the ACL for the bucket.

Specify each grantee as a key and value pair, where the key is one of the following:

  • ID: Use if the value specified is the canonical user ID of an AWS account.
  • URI: Use if you're granting permissions to a predefined group.

  • Email address: Use if the value specified is the email address of an AWS account.

For example, ID=11112222333.

This field is automatically generated if you select None for the Canned ACL field.

List of Text

FALSE

Grant Write

Grants the listed accounts the permission to create new objects in the bucket.

Specify each grantee as a key and value pair, where the key is one of the following:

  • ID: Use if the value specified is the canonical user ID of an AWS account.
  • URI: Use if you're granting permissions to a predefined group.

  • Email address: Use if the value specified is the email address of an AWS account.

For example, ID=11112222333.

This field is automatically generated if you select None for the Canned ACL field.

List of Text

FALSE

Grant Write ACP

Grants the listed accounts the permission to write the ACL for the bucket.

Specify each grantee as a key and value pair, where the key is one of the following:

  • ID: Use if the value specified is the canonical user ID of an AWS account.
  • URI: Use if you're granting permissions to a predefined group.

  • Email address: Use if the value specified is the email address of an AWS account.

For example, ID=11112222333.

This field is automatically generated if you select None for the Canned ACL field.

List of Text

FALSE

Output

Field Definition Type

Response

Status Code

Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example:

  • A 201 Created status code indicates success where a new resource was created.
  • A 403 Forbidden error indicates that the HTTP request wasn't processed because the necessary permissions were missing.

For a full list of possible status codes, see HTTP status codes.

Number

Related topics

AWS S3 connector

Workflow elements

AWS S3 Rest API overview