# Manage files and folders in Lightsail buckets
<a name="amazon-lightsail-viewing-objects-in-a-bucket"></a>

You can view all objects stored in your bucket in the Amazon Lightsail object storage service by using the Lightsail console. You can also use the AWS Command Line Interface (AWS CLI) and AWS SDKs to list object keys in your bucket. For more information about buckets, see [Object storage](buckets-in-amazon-lightsail.md).

## Filter objects using the Lightsail console
<a name="view-objects-lightsail-console"></a>

Complete the following procedure to view objects stored in a bucket using the Lightsail console.

1. Sign in to the [Lightsail console](https://lightsail.aws.amazon.com/).

1. In the left navigation pane, choose **Storage**.

1. Choose the name of the bucket for which you want to view objects.

1. The **Objects browser** pane in the **Objects tab** displays the objects and folders that are stored in your bucket.  
![The object browser pane in the Lightsail console](http://docs.aws.amazon.com/lightsail/latest/userguide/images/amazon-lightsail-bucket-object-browser-pane.png)

1. Browse to the location of the object for which you want to view properties.

1. Add a check mark next to the object for which you want to view properties.

1. The **Object properties** pane on the right side of the page displays information about the object.  
![The object properties pane in the Lightsail console](http://docs.aws.amazon.com/lightsail/latest/userguide/images/amazon-lightsail-bucket-object-properties-pane.png)

   The information displayed includes:

   1. Links to view and download the object.

   1. Actions menu (⋮) to copy or delete the object. For more information about copying and deleting objects, see [Copy or move objects in a bucket in Amazon Lightsail](amazon-lightsail-copying-moving-bucket-objects.md) and [Delete bucket objects](amazon-lightsail-deleting-bucket-objects.md).

   1. Object size, and last modified timestamp.

   1. The access permission of the individual object, which could be private or public (read-only). For more information about object permissions, see [Bucket permissions](amazon-lightsail-understanding-bucket-permissions.md).

   1. The metadata of the object. The content type (`ContentType`) key is the only metadata supported by the Lightsail object storage service at this time.

   1. The object key value tags. For more information, see [Tag bucket objects](amazon-lightsail-tagging-bucket-objects.md).

   1. The option to manage stored versions of the object. For more information, see [Enable and suspend object versioning in a bucket](amazon-lightsail-managing-bucket-object-versioning.md).
**Note**  
When you select multiple objects, the **Object properties** pane displays only the total size of the selected objects.

## View objects using the AWS CLI
<a name="view-objects-aws-cli"></a>

Complete the following procedure to list object keys in a bucket using the AWS Command Line Interface (AWS CLI). You do this by using the `list-objects-v2` command. For more information, see [list-objects-v2](https://docs.aws.amazon.com/cli/latest/reference/s3api/list-objects-v2.html) in the *AWS CLI Command Reference*.

**Note**  
You must install the AWS CLI and configure it for Lightsail and Amazon S3 before continuing with this procedure. For more information, see [Configure the AWS Command Line Interface to work with Amazon Lightsail](lightsail-how-to-set-up-and-configure-aws-cli.md).

1. Open a Command Prompt or Terminal window.

1. Enter one of the following commands.
   + Enter the following command to list all object keys in your bucket.

     ```
     aws s3api list-objects-v2 --bucket {{BucketName}} --query "Contents[].{Key: Key, Size: Size}"
     ```

     In the command, replace {{BucketName}} with the name of the bucket for which you want to list all objects.
   + Enter the following command to list objects that start with a specific object key name prefix.

     ```
     aws s3api list-objects-v2 --bucket {{BucketName}} --prefix {{ObjectKeyNamePrefix}} --query "Contents[].{Key: Key, Size: Size}"
     ```

     In the command, replace the following example text with your own:
     + {{BucketName}} - The name of the bucket for which you want to list all objects.
     + {{ObjectKeyNamePrefix}} - An object key name prefix to limit the response to keys that begin with the specified prefix.
**Note**  
These commands use the `--query` parameter to filter the response of the `list-objects-v2` request to the key value and size of each object.

   Examples:

   Listing all object keys in a bucket:

   ```
   aws s3api list-objects-v2 --bucket {{amzn-s3-demo-bucket}} --query "Contents[].{Key: Key, Size: Size}"
   ```

   For the preceding command, you should see a result similar to the following example.  
![Result of the AWS CLI list-objects-v2 command](http://docs.aws.amazon.com/lightsail/latest/userguide/images/amazon-lightsail-s3api-list-objects-v2-result.png)

   Listing object keys that start with the `archived/` object key name prefix:

   ```
   aws s3api list-objects-v2 --bucket {{amzn-s3-demo-bucket}} --prefix {{archived/}} --query "Contents[].{Key: Key, Size: Size}"
   ```

   For the preceding command, you should see a result similar to the following example.  
![Result of the AWS CLI list-objects-v2 command](http://docs.aws.amazon.com/lightsail/latest/userguide/images/amazon-lightsail-s3api-list-objects-v2-prefix-result.png)

## Manage buckets and objects
<a name="viewing-objects-managing-buckets-and-objects"></a>

These are the general steps to manage your Lightsail object storage bucket:

1. Learn about objects and buckets in the Amazon Lightsail object storage service. For more information, see [Object storage in Amazon Lightsail](buckets-in-amazon-lightsail.md).

1. Learn about the names that you can give your buckets in Amazon Lightsail. For more information, see [Bucket naming rules in Amazon Lightsail](bucket-naming-rules-in-amazon-lightsail.md).

1. Get started with the Lightsail object storage service by creating a bucket. For more information, see [Creating buckets in Amazon Lightsail](amazon-lightsail-creating-buckets.md).

1. Learn about security best practices for buckets and the access permissions that you can configure for your bucket. You can make all objects in your bucket public or private, or you can choose to make individual objects public. You can also grant access to your bucket by creating access keys, attaching instances to your bucket, and granting access to other AWS accounts. For more information, see [Security Best Practices for Amazon Lightsail object storage](amazon-lightsail-bucket-security-best-practices.md) and [Understanding bucket permissions in Amazon Lightsail](amazon-lightsail-understanding-bucket-permissions.md).

   After learning about bucket access permissions, see the following guides to grant access to your bucket:
   + [Block public access for buckets in Amazon Lightsail](amazon-lightsail-block-public-access-for-buckets.md)
   + [Configuring bucket access permissions in Amazon Lightsail](amazon-lightsail-configuring-bucket-permissions.md)
   + [Configuring access permissions for individual objects in a bucket in Amazon Lightsail](amazon-lightsail-configuring-individual-object-access.md)
   + [Creating access keys for a bucket in Amazon Lightsail](amazon-lightsail-creating-bucket-access-keys.md)
   + [Configuring resource access for a bucket in Amazon Lightsail](amazon-lightsail-configuring-bucket-resource-access.md)
   + [Configuring cross-account access for a bucket in Amazon Lightsail](amazon-lightsail-configuring-bucket-cross-account-access.md)

1. Learn how to enable access logging for your bucket, and how to use access logs to audit the security of your bucket. For more information, see the following guides.
   + [Access logging for buckets in the Amazon Lightsail object storage service](amazon-lightsail-bucket-access-logs.md)
   + [Access log format for a bucket in the Amazon Lightsail object storage service](amazon-lightsail-bucket-access-log-format.md)
   + [Enabling access logging for a bucket in the Amazon Lightsail object storage service](amazon-lightsail-enabling-bucket-access-logs.md)
   + [Using access logs for a bucket in Amazon Lightsail to identify requests](amazon-lightsail-using-bucket-access-logs.md)

1. Create an IAM policy that grants a user the ability to manage a bucket in Lightsail. For more information, see [IAM policy to manage buckets in Amazon Lightsail](amazon-lightsail-bucket-management-policies.md).

1. Learn about the way that objects in your bucket are labeled and identified. For more information, see [Understanding object key names in Amazon Lightsail](understanding-bucket-object-key-names-in-amazon-lightsail.md).

1. Learn how to upload files and manage objects in your buckets. For more information, see the following guides.
   + [Uploading files to a bucket in Amazon Lightsail](amazon-lightsail-uploading-files-to-a-bucket.md)
   + [Uploading files to a bucket in Amazon Lightsail using multipart upload](amazon-lightsail-uploading-files-to-a-bucket-using-multipart-upload.md)
   + [Viewing objects in a bucket in Amazon Lightsail](#amazon-lightsail-viewing-objects-in-a-bucket)
   + [Copying or moving objects in a bucket in Amazon Lightsail](amazon-lightsail-copying-moving-bucket-objects.md)
   + [Downloading objects from a bucket in Amazon Lightsail](amazon-lightsail-downloading-bucket-objects.md)
   + [Filtering objects in a bucket in Amazon Lightsail](amazon-lightsail-filtering-bucket-objects.md)
   + [Tagging objects in a bucket in Amazon Lightsail](amazon-lightsail-tagging-bucket-objects.md)
   + [Deleting objects in a bucket in Amazon Lightsail](amazon-lightsail-deleting-bucket-objects.md)

1. Enable object versioning to preserve, retrieve, and restore every version of every object stored in your bucket. For more information, see [Enabling and suspending object versioning in a bucket in Amazon Lightsail](amazon-lightsail-managing-bucket-object-versioning.md).

1. After enabling object versioning, you can restore previous versions of objects in your bucket. For more information, see [Restoring previous versions of objects in a bucket in Amazon Lightsail](amazon-lightsail-restoring-bucket-object-versions.md).

1. Monitor the utilization of your bucket. For more information, see [Viewing metrics for your bucket in Amazon Lightsail](amazon-lightsail-viewing-bucket-metrics.md).

1. Configure an alarm for bucket metrics to be notified when the utilization of your bucket crosses a threshold. For more information, see [Creating bucket metric alarms in Amazon Lightsail](amazon-lightsail-adding-bucket-metric-alarms.md).

1. Change the storage plan of your bucket if it's running low on storage and network transfer. For more information, see [Changing the plan of your bucket in Amazon Lightsail](amazon-lightsail-changing-bucket-plans.md).

1. Learn how to connect your bucket to other resources. For more information, see the following tutorials.
   + [Tutorial: Connecting a WordPress instance to an Amazon Lightsail bucket](amazon-lightsail-connecting-buckets-to-wordpress.md)
   + [Tutorial: Using an Amazon Lightsail bucket with a Lightsail content delivery network distribution](amazon-lightsail-using-distributions-with-buckets.md)

1. Delete your bucket if you're no longer using it. For more information, see [Deleting buckets in Amazon Lightsail](amazon-lightsail-deleting-buckets.md).

**Topics**
+ [Filter objects using the Lightsail console](#view-objects-lightsail-console)
+ [View objects using the AWS CLI](#view-objects-aws-cli)
+ [Manage buckets and objects](#viewing-objects-managing-buckets-and-objects)
+ [API actions for Lightsail objects](object-storage-s3-actions.md)
+ [Copy and move objects](amazon-lightsail-copying-moving-bucket-objects.md)
+ [Delete objects](amazon-lightsail-deleting-bucket-objects.md)
+ [Download objects](amazon-lightsail-downloading-bucket-objects.md)
+ [Filter objects](amazon-lightsail-filtering-bucket-objects.md)
+ [Manage object versioning](amazon-lightsail-managing-bucket-object-versioning.md)
+ [Restore object versions](amazon-lightsail-restoring-bucket-object-versions.md)
+ [Tag objects](amazon-lightsail-tagging-bucket-objects.md)