Resources » S3

Resource Creation

You can create S3 buckets using the convox resources create command:

$ convox resources create s3
Creating s3-3785 (s3)... CREATING

This will provision an S3 bucket. Creation will take a few moments. To check the status use convox resources info.

Additional Options

See convox resources options s3 for a list of available options.

Resource Information

To see relevant info about the database, use the convox resources info command:

$ convox resources info s3-3785
Name    s3-3785
Status  running
URL     s3://ACCESS:SECRET@s3.amazonaws.com/BUCKET

Resource Linking

You can add this URL as an environment variable to any application with convox env set:

$ convox env set S3_URL='s3://ACCESS:SECRET@s3.amazonaws.com/BUCKET' --app example-app

Resource Update

You can change options with convox resources update:

$ convox resources update s3-3785 Topic=arn:...
Updating s3-3785... UPDATING

Resource Deletion

To delete the S3 bucket, use the convox resources delete command:

$ convox resources delete s3-3785
Deleting s3-3785... DELETING

This action will cause an unrecoverable loss of data.