# Working with objects and directories via vStorage Portal

Below are the basic features when you work with objects.

## Upload object <a href="#upload-download-object" id="upload-download-object"></a>

To upload an object to a bucket, please follow the steps below:

1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list) . Select **the project** and **bucket** you want to upload objects to.
2. Select **Upload** .
3. Select **Choose files to upload** or drag the files from your personal device you want to upload into this area.
4. After dragging or selecting one or more files into this area. Select **Upload.**

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fgit-blob-80d9e55013faa9d23aced4d28014fce4847c48c6%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Attention:**

* When using vStorage Portal, you can only upload objects up to 20GB in size.
  {% endhint %}

***

## Download object <a href="#upload-download-object" id="upload-download-object"></a>

To download one or more objects, please follow the steps below:

1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list) . Select **the project** and **bucket** you want to download the object from.
2. Select the **objects** you want to download.
3. Select the action icon, then select the **Download** button

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fgit-blob-2e17031b9d4dce9cb408698983742fc60001333f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Search object/folder <a href="#tim-kiem-object-folder" id="tim-kiem-object-folder"></a>

To search for an object/ folder, please follow the steps below:

1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list) . Select **the project** and **bucket** you want to search for object/folder
2. In the **Find objects by prefix** box , you can search for objects/folders by prefix by entering the character string that is the prefix you want to search for.
3. Press **Enter** or select the **Search** icon

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fgit-blob-80eb2c8abf7c5784bd315edfc9a5fb703f09cbfb%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Move object <a href="#di-chuyen-object" id="di-chuyen-object"></a>

To move an object, please follow the steps below:

1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list) . Select **the project** and **bucket** containing the object you want to move.
2. Select the **Action** icon and select **Move**

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fgit-blob-21c7d5ddf6faa42715efb47cec3e211281e57249%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Select **the bucket** and **directory** (if any) that you want to move the object to. We also support you to create a new directory if the directory you want to move to does not exist.

You can move objects across buckets within a project. We currently do not support moving objects across projects.

## Copy object <a href="#sao-chep-object" id="sao-chep-object"></a>

To copy an object, please follow the steps below:

1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list) . Select **the project** and **bucket** containing the object you want to copy.
2. Select the **Action** icon and select **Copy.**

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fgit-blob-47d51365dfca48a2cb43f6a21da64b2142540b0f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Select the **bucket** and **directory** (if any) that you want to copy the object to. We also support you to create a new directory if the directory you want to copy to does not exist.

You can copy objects across buckets within a project. Currently we do not support copying objects across different projects.

## Rename object <a href="#doi-ten-object" id="doi-ten-object"></a>

To rename an object, please follow the steps below:

1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list) . Select **the project** and **bucket** containing the object you want to rename.
2. Select the **Action** icon and select **Rename.**

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fgit-blob-0fa54cbcbf6560523c51b89a135e7f28d1f93d56%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Enter the name of the object you want to change, the object name must comply with our description.

When renaming an object, you should not change the file type (e.g. abc.pdf, .pdf is the file type) in the object name. Changing this extension of the object name may change the content type of the object, which may cause errors when you download the object to your personal device.

## Share object <a href="#chia-se-object" id="chia-se-object"></a>

To share an object in a bucket, you can follow the steps below:

1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list) .
2. Select **project, bucket** then select one or more objects **you** want to share.
3. **Select the Action** icon then select **Share**
4. Enter **the Expiration time** you want to share the object: the time the access link to the object is valid. You can limit the number of **days** , **hours** , and **minutes** that the access link to the object exists.
5. Select **Generate**

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fgit-blob-79196b7d56d84832ff260093982acabece454404%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Set up metadata object <a href="#thiet-lap-metadata-object" id="thiet-lap-metadata-object"></a>

To set metadata for an object, please follow the steps below:

1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list) . Select **the project** and **bucket** containing the object you want to set metadata for.
2. Select the **Action** icon and select **Metadata.**

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fgit-blob-f9f362bd46d20cf80fc99206368386b87457cfc7%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

3. **The Metadata Setup** screen is displayed.
4. We provide you with two methods of setting metadata including:

* **Default key** : select a key from the list of available keys we provide.
* **Custom key** : create your own custom key according to your needs with the prefix **X-Object-Meta-Vng-** .

5. Enter the Value **corresponding** to the selected or created **Key . Select Add** then select **Update.**

After performing the above 5 steps, metadata has been successfully set for your object.

We currently support 8 default metadata key types including: **Cache-Control, Content-Encoding, Expires, Content-Language, Content-Type.**

## Delete object <a href="#xoa-object" id="xoa-object"></a>

To delete one or more objects, you can:

1\. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list) .

2\. Select **project, bucket** then select the **objects** you want to delete **.**

3\. Select the **Action** icon then select **Delete**

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fgit-blob-bbc5b381f92342f45a4ecf0b6d68d559b8faa5df%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

After selecting Delete, the system will automatically switch to the main screen. If you see the object you just performed disappears from the list, you have successfully deleted it. The object has now been permanently deleted from the system. Once an object has been deleted from the vStorage system, you cannot restore that object.

## Create directory <a href="#khoi-tao-directory" id="khoi-tao-directory"></a>

To initialize a directory, you can:

1\. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list) .

2\. Select **the project, bucket** you want to create a directory

3\. Select **Create a directory**

4\. Enter **Directory name** , enter a name that complies with our regulations for your directory.

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fgit-blob-1b58c4e466f4ef8e177a76e0570ae486bb195710%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

5. Select **Create**

Once a directory is created, you cannot change its name. We recommend that the directory name should contain lowercase letters, digits and no specific special characters like #, @, $, %, ?, /, \`, \~ ... If you really need to name it with uppercase letters, please note that it may cause some problems when working with supported 3rd party softwares from other vendors.

## Delete directory <a href="#xoa-directory" id="xoa-directory"></a>

To delete a directory, you can:

1\. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list) .

2\. Select **the project, bucket** containing the directory you want to delete

3\. Select the **Action** icon and select **Delete**

<figure><img src="https://1985221522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7rE7M1L7GYcwQzNGd0aB%2Fuploads%2Fgit-blob-188f3cf96b3b6264b0e562f19d858cbb0cea7e84%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
