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

# Managing objects in Object Storage buckets

In Object Storage, you work with files and folders called *objects* and place them in containers called buckets. This guide will help you manage objects in buckets.

## Prerequisites

<Tabs>
  <Tab title="Web console">
    Make sure you are in a [group](/iam/authorization/groups/index) that has at least the `editor` role within your tenant; for example, the default `editors` group. You can check this in the [Administration → IAM](https://console.nebius.com/iam) section of the web console.
  </Tab>

  <Tab title="AWS CLI">
    Install and configure the AWS CLI. It provides simple commands for object management, like `aws s3 cp` to move objects between a bucket and a local computer and `aws s3 rm` to delete them.

    For more details on installing and configuring, see [How to get started with Object Storage: Create your first bucket](/object-storage/quickstart) and the guide on the [AWS CLI](/object-storage/interfaces/aws-cli).
  </Tab>
</Tabs>

### Object naming requirements

Each Object Storage object has a *key* — object ID in a `string` format. This key can contain [prefixes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) — they act similar to directories, organizing objects into groups.

To avoid issues with your objects, follow these requirements:

* Object keys can be up to 1024 bytes long, case sensitive.
* Use UTF-8 alphanumeric characters, slashes (`/`) and certain [special characters](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines).

For more information on character usage and which characters to avoid, see the [AWS object naming guidelines](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines).

## How to view objects

<Tabs group="interfaces">
  <Tab title="Web console">
    1. In the sidebar, go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/storage.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=0a2dad6b48aea10e85f6f3e2343aee26" width="16" height="16" data-path="_assets/sidebar/storage.svg" /> **Storage** → **Object Storage**.
    2. Select the bucket to view the objects in. The page shows a table with the following columns: **Key**, **Size**, **Storage class** and **Last modified**.
    3. To see the contents of a folder, click the folder name in the **Key** column.
  </Tab>

  <Tab title="AWS CLI">
    * To list all the prefixes and all the first-level objects in your Object Storage bucket:

      ```sh theme={null}
      aws s3 ls s3://<bucket_name>/[<prefix_for_object_keys>]
      ```

    * To list all the objects with a specific prefix in your Object Storage bucket:

      ```sh theme={null}
      aws s3 ls s3://<bucket_name>/[<prefix_for_object_keys>] --recursive --human-readable --summarize
      ```

    * To list all the objects arranged alphabetically by prefix in your Object Storage bucket:

      ```sh theme={null}
      aws s3 ls s3://<bucket_name>/ --recursive --human-readable --summarize
      ```

    You can find more information on the `ls` command in the [AWS CLI reference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/ls.html).
  </Tab>
</Tabs>

## How to rename an object

<Note>
  Renaming objects is not supported in the web console.
</Note>

You can rename an object in your Object Storage bucket using the following manual sequence:

1. Copy the object in question with a new name. You can also update an object's prefix:

   ```sh theme={null}
   aws s3 cp \
       s3://<bucket_name>/[<prefix_for_old_object_key>] \ # prefix and name of the object to rename
       s3://<bucket_name>/[<prefix_for_new_object_key>]   # desired prefix and name of the object
   ```

2. Remove the old copy of the renamed object:

   ```sh theme={null}
   aws s3 rm s3://<bucket_name>/[<prefix_for_old_object_key>]
   ```

## How to delete objects

### Deleting a single object

<Tabs group="interfaces">
  <Tab title="Web console">
    1. In the sidebar, go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/storage.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=0a2dad6b48aea10e85f6f3e2343aee26" width="16" height="16" data-path="_assets/sidebar/storage.svg" /> **Storage** → **Object Storage**.
    2. Select the bucket that contains the object.
    3. Next to the object, click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **Delete**.
    4. In the **Delete object** window, type the object name in the confirmation field and click **Delete object**.
  </Tab>

  <Tab title="AWS CLI">
    To remove the object with a specified key:

    ```sh theme={null}
    aws s3 rm s3://<bucket_name>/<object_key>
    ```

    You can find more information on the `rm` command in the [AWS CLI reference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/rm.html).
  </Tab>
</Tabs>

### Deleting multiple objects

<Tabs group="interfaces">
  <Tab title="Web console">
    1. In the sidebar, go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/storage.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=0a2dad6b48aea10e85f6f3e2343aee26" width="16" height="16" data-path="_assets/sidebar/storage.svg" /> **Storage** → **Object Storage**.
    2. Select the bucket that contains the objects.
    3. In the **Select** column, select the checkbox next to each object to delete. To select all the objects in the bucket, use the checkbox in the column header.
    4. In the banner that appears at the bottom of the page, click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/trash-bin.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=b9b80db3d011e608480c36552df703a0" width="16" height="16" data-path="_assets/trash-bin.svg" /> **Delete**.
    5. In the **Delete objects** window, type the bucket name in the confirmation field and click **Delete objects**.
  </Tab>

  <Tab title="AWS CLI">
    To delete all the objects with a specified prefix:

    ```sh theme={null}
    aws s3 rm --recursive s3://<bucket_name>/[<prefix_for_object_keys>]
    ```

    You can find more information on the `rm` command in the [AWS CLI reference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/rm.html).
  </Tab>
</Tabs>

When an object is deleted from a bucket in Object Storage, it becomes immediately inaccessible and cannot be restored. The actual object data is then physically deleted from Nebius AI Cloud servers within 4 days.

## See also

* [Working with Object Storage buckets and objects using the AWS CLI](../interfaces/aws-cli)
* [cp in AWS CLI reference](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html)
* [ls in AWS CLI reference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/ls.html)
* [rm in AWS CLI reference](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/rm.html)