# Working with project
## Overview
A Project is a term on vStorage that represents a storage package with a specific capacity that you purchase on GreenNode. **With Region HAN02, at a time ****you can own up to 10 Projects**** and use them to organize your data storage.**
***
## **Project scope**
**Project naming rules**
The following rules apply to project naming in vStorage:
* Project name must be between 1 (minimum) and 40 (maximum) characters long.
* Project names can only contain uppercase and lowercase letters (a-z, A-Z), numbers (0-9), periods (.), spaces ( ), underscores (\_), hyphens (-), and the @ character.
* Project names should not contain sensitive information (e.g. IP addresses, account names, login passwords, etc.).
* The project name must be unique across a GreenNode account within or across regions until the project is deleted. We recommend that your business project or product name be used as the name of the project stored in vStorage.
**Example**
* The following example project names are valid and follow the recommended naming guidelines:
* project du an 1
* du-an-nam-2022
* ...
* The following example project names are valid but we do not recommend using them:
* [docexamplewebsite.com](http://docexamplewebsite.com/)
* [www.docexamplewebsite.com](http://www.docexamplewebsite.com/)
* ...
* The following example project names are invalid:
* Project efficiency 80 % (contains %)
* project\_1/2022 (contains / character)
* ...
***
## Create a project
Create a project by following the steps below:
1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list). If you don't have an account, register for free [here](https://register.vngcloud.vn/signup).
2. Select **Region HAN02.**
3. Select **Create a Project.**
4. Enter **Project Name**
5. Select the appropriate **Billing method** according to your needs. We will provide you with 2 types **Pay monthly** and **Pay as you go**.
6. Select the appropriate **Project type** (package) according to your needs. Currently in region HAN02, we will provide you with 2 types of storage packages **Gold** and **Instant Archive**. For more information on pricing, please refer to [Pricing](/vng-cloud-document/vstorage/object-storage/cach-tinh-phi.md).
7. Select **the Quota** (storage capacity) you want.
8. Select **Period** according to your needs.
9. **Go through the Checkout** steps and your **Project** will be created.
***
## View project information
You can view and use properties for the project including general project information, generated S3 key pairs, auto-scaling configuration if any, impact history as well as project connection information to S3,...
To view the properties for a project, you can:
1. Log in to [https://vstorage.console.vngcloud.vn/storage](https://vstorage.console.vngcloud.vn/storage/list).
2. Select **Region: HAN02**
3. Select the icon in the **project** you want to see details.
4. **On the project** details page , you can view and use properties for the project.
* **Information** : Provides general project information such as Total quota, Total usage, Project type, Account URL, Project Owner.
* **S3 key** : Provides information about S3 key pairs that are initialized for the project from vStorage Portal. To initialize S3 key, please refer here.
* **History** : Provides historical information affecting the project including action type, action status, time the action occurred, and a detailed description of the action if available.
* **Connection Information** : Provides commands and configuration files to connect the project to S3.
***
## Resize a project
You have initialized the project with an initial quota that matches your storage needs. Now your business needs have changed and the old capacity cannot meet them. To solve this problem, you can change the storage quota through the Change Quota feature that we provide.
To change the quota for a project, you can:
1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list).Select the checkbox at the project you want to increase or decrease the limit and select the icon or you can also select the icon then select Resize.
2. **The Resize project** screen is displayed **.** Select the storage **quota you want to increase, the storage quota** you can increase or decrease to the maximum or minimum **quota** provided by the hosting package. You cannot adjust the storage **quota** to be smaller or larger than this value.
3. Select **Resize project.**
4. Select **Checkout** after reviewing your shopping cart and payment method.
5. Select **Continue to checkout** and make payment after choosing the appropriate payment method.
After you successfully complete the above 6 steps, the new total **quota** value after change will be updated on the general information of the project you selected.
***
## Renew a project
You have started your project with a short retention period. Now your business needs have changed and you want to increase this retention period. To solve this problem, you can change the retention period through the renew feature we provide.
To renew a project, you can:
1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list).
2. Select the checkbox at **the project** you want to increase or decrease the limit and select the icon or you can also select the icon then select **Renew**.
3. Select the desired storage period to renew. We offer storage periods of **1 month, 3 months, 6 months, 12 months, 24 months, 36 months . When you select a renewal period, the system will automatically calculate the effective time of the new storage period and the total amount you need to pay for project** renewal.
4. Select **Checkout** after reviewing your shopping cart and payment method.
5. Select **Continue to checkout** and make payment after choosing the appropriate payment method.
After you successfully complete the above 5 steps, the new retention period after project renewal will be updated on the general information of the project you selected.
***
## Auto-renew a project
In addition to manually renewing a project, we also support you to set up automatic renewal through the Auto-renew feature.
The automatic renewal feature is a system feature that supports automatic renewal of expired services more easily for prepaid customers. Customers do not need to worry about when the service expires to access the vStorage Portal to renew, pay,...
7 days before the service expires, the system will send an email notification about the automatic service renewal. During these 7 days, you will receive 1 notification email each day.
The system will automatically renew 3 days before the service expires:
* If you have enough credits, all services will be renewed. When the renewal is successful or failed, we will send you an email containing information about the successful/failed renewal. The service renewal payment history will also be stored on the vConsole system. For more information, visit [the vConsole Dashboard](https://dashboard.console.vngcloud.vn/payment-history).
* If there are not enough credits, the system will try to renew the services until there are no more credits. When the renewal is successful or failed, we will send you an email containing the successful/failed renewal information. The service renewal payment history will also be stored on the vConsole system. For more information, visit the vConsole [Dashboard](https://dashboard.console.vngcloud.vn/payment-history).
Set up auto-renewal when creating a project
1. Thực hiện các bước khởi tạo project theo hướng dẫn tại [Khởi tạo project](broken://pages/SL64seEpMQMd2ph6wytt).
2. Tại thời điểm thiết lập thông tin về project cần mua, chọn **Gia hạn tự động**.
3. Chọn **chu kỳ gia hạn tự động**. Chúng tôi cung cấp các chu kỳ gia hạn bao gồm: 1 tháng, 3 tháng, 6 tháng, 12 tháng, 24 tháng, 36 tháng. Khi bạn thực hiện chọn chu kỳ gia hạn, hệ thống sẽ tự động tính toán thời gian có hiệu lực của chu kỳ lưu trữ mới và tổng số tiền bạn cần chi trả cho việc gia hạn **project**.
Để biết danh sách các loại hình thức thanh toán của vStorage và cách tính phí gia hạn project, hãy xem [Cách tính phí](broken://pages/SeteDnRJLCSGyZbS6BCa).
Sau khi bạn thực hiện thành công các bước trên, chu kỳ lưu trữ mới sau khi gia hạn project sẽ được cập nhật trên thông tin chung của project mà bạn chọn.
Set up auto-renewal on previously created projects
1. Đăng nhập vào [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list).
2. Chọn biểu tượng tại **project** bạn muốn thực hiện thiết lập gia hạn tự động. Chọn Enable Auto-renew.
3. Màn hình **Enable Auto-renew** được hiển thị**.** Chọn **Period** gia hạn mà bạn mong muốn.
4. Chọn **OK.**
Sau khi bạn thực hiện thành công các bước trên, chu kỳ lưu trữ mới sau khi gia hạn project sẽ được cập nhật trên thông tin chung của project mà bạn chọn.
Remove auto-renewal on a project that was previously set to auto-renewal
1. Đăng nhập vào [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list).
2. Chọn biểu tượng tại **project** bạn muốn thực hiện tắt thiết lập gia hạn tự động. Chọn **Disable Auto-renew.**
3. Màn hình **Disable Auto-renew** được hiển thị**.**
4. Chọn **OK.**
Sau khi bạn thực hiện thành công các bước trên, tính năng gia hạn tự động cho project đã được tắt.
***
## Delete project
You have created a project with the appropriate hosting package. Now your business needs have changed and you no longer need the project. We recommend that you delete the project to optimize costs.
To delete a project, you can:
1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list).
2. Select the icon in the project you want to delete. Select **Delete**.
3. Enter the string **delete me** and select **Delete.**
After you delete the project, the deleted project will disappear from your project list. At this time, the deleted project will be in **the Trash** , your deleted project will be stored in **the Trash** for 7 days without any charge. During these 7 days, you can restore the deleted project. To restore, see the instructions in the Restore project section. If after 7 days you do not restore the project, the project and all data inside will be completely deleted from the system and cannot be restored.
If you delete a project before the initial retention period, we will refund you, and if you restore a project, we will also charge you a restore fee. For details on how vStorage charges for project refunds and restores, see How it's Charged.
Because deleting a project is risky, we recommend that you consider carefully and create a backup version of the project before deleting it.
***
## Auto-scale Quota
The Auto-scale Quota feature in vStorage allows you to set up automatic storage expansion based on your usage and needs. This guide will provide details on how to configure and manage this feature through the vStorage Portal.
To set up automatic growth for a project, you can:
1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list).
2. In the project that needs to set Auto-scale Quota, select the icon then select **Auto-scale** and continue to select **Configure Auto-scale** or select the icon then select **Set Auto-scale**.
3. **At the Auto-scale** configuration screen , set up the necessary parameters for **Auto Scale** . Specifically:
* **Set Quota Unit:** you can choose 1 of 2 types of units including **GB** or **Percent**.
* **Set Quota Threshold or Quota Remain:** If you choose **Quota Unit** as **Percent** , here you will enter the percentage of usage threshold that when reached will trigger the quota increase. If you choose **Quota Unit** as **GB** , here you will enter the remaining quota that when reached will trigger the quota increase.
* **Set Quota Increment Level** : enter desired increment level in **GB** or **Percent**.
4. **Choose to receive email** notification when quota increase is successful if desired.
5. Enable **Auto-scale** at the icon . When this icon becomes it means you have successfully enabled **Auto-scale.**
{% hint style="info" %}
**Attention:**
* **The vStorage system will perform a 5-minute** auto-scaling check to automatically increase capacity based on the set threshold.
* The price is applied according to the **standard vStorage** price list , the feature only increases capacity without changing the Storage Class.
* Users need to ensure that they have **sufficient credit balance** for their account (prepaid) before performing Auto-scaling.
* If the capacity increase **fails** , the user will receive an email notification. After two consecutive auto-scaling failures, our system will stop sending email notifications to you. You need to proactively access vStorage to manually resize the project according to the instructions above.
{% endhint %}
***
## Usage alert
The **Usage alert** feature in vStorage allows you to set up automatic alert based on your usage and needs. This guide will provide details on how to configure and manage this feature through the vStorage Portal.
To set up automatic alert for a project, you can:
1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list).
2. In the project that needs to set Usage alert, select the icon then select **Usage alert** and continue to select **Configure Usage alert**.
3. At the **Usage alert** configuration screen , set up the necessary parameters for **Usage alert**. Specifically:
* Set **Quota Unit:** you can choose 1 of 2 types of units including **GB** or **Percent**.
* Set **Quota Threshold** or **Quota Remain:** If you choose **Quota Unit** as **Percent** , here you will enter the percentage of usage threshold that when reached will trigger the usage alert. If you choose **Quota Unit** as **GB** , here you will enter the remaining quota that when reached will trigger the usage alert.
4. Enable **Usage alert** at the icon . When this icon becomes it means you have successfully enabled **Usage alert.**
5. Click **Manage your notification recievers** if you want to set up additional email lists to receive alerts.
{% hint style="info" %}
**Attention:**
* **The vStorage system will perform a 2-times per day** usage alert check to automatically alert usage based on the set threshold.
{% endhint %}
***
## Create a POC project
When you are a user on the vStorage system, by default you will not be able to perform POC projects. POC is a program that helps customers experience the service through the value (in credit in the POC wallet) provided by GreenNode to customers. Normally, POC wallets will be granted through promotional programs, promotional campaigns of GreenNode. Thereby, customers can experience creating certain services within a specified period of time. To perform POC projects, please contact the Sales staff or the staff who directly supports you or open a support ticket on our system. The POC wallet granted has a certain value and is used within a specified period of time depending on the company's policy. After the validity period expires, you can request to extend the POC wallet's usage period or pay an additional fee to maintain the service.
Once we confirm that we have provided a POC wallet to your account, to use the POC wallet please follow the instructions below:
Create a project using POC wallet balance
1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list).
2. Select **region hcm02.**
3. Select **Create a project.**
4. **The Create New Project** screen is displayed. In **Project Name** , enter a name that complies with our regulations for your project.
5. Choose a hosting **Quota** according to your needs. Quota is the maximum hosting package size you can create. For each hosting package, we have provided a minimum and maximum size so you can choose to change based on your actual needs.
6. **Turn off the Enable auto-renewal** option. Now we show the **PoC** option.
7. Select **PoC**.
8. Select **Create a project.**
9. Select **Checkout PoC** after reviewing your cart information.
After you complete the 9 steps described above, your project has been created through the payment method of POC wallet. This **project** has the prefix **\[POC]. By default, this project will have a start date as the project creation time and an end date as the expiration date of the POC wallet you were provided.**
The default POC resource usage time coincides with the POC wallet expiration time. We only support you to use the POC wallet to pay for POC resources. For POC resources, the price of POC resource usage is calculated similarly to that of regular resources. For more details, please refer to How to calculate fees.
Renew a project using POC wallet
After you create a project using POC wallet, you can continue to extend the project using Poc wallet. For details, follow these steps:
1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list).
2. Select the icon at **the project** you want to renew. Select **Renew.**
3. **You can extend the project using POC wallet if you have extended the POC wallet usage period. After you extend the POC wallet usage period, the time you can extend the project is the period from the current end date to the new expiration date of the POC wallet** . To extend the POC wallet usage period, please contact the Sales staff or the staff who directly supports you or open a support ticket on our system. Select **Extend**.
4. Select **Checkout PoC**.
Once you complete the 4 steps described above, your project has been renewed via the POC wallet payment method.
The process and pricing method are similar to regular project extensions. For more details, please refer to How to calculate fees.
Delete project using POC wallet
After you initialize a project using POC wallet, if you no longer need to use this project, you can delete it according to the instructions at Delete project.
Now the **project will be completely remove** from vStorage.
Stop POC a project
1. Log in to [https://vstorage.console.vngcloud.vn](https://vstorage.console.vngcloud.vn/storage/list).
2. Select the icon at **the project** you want to stop POC. Select **Stop POC**.
3. Select **Stop POC**.
Once you successfully stop the POC, your project will be converted to a prepaid resource type with expired status.
* If you really don't need to use this project anymore, you can completely delete the project from our system following the instructions at Delete project.
* **If you want to renew this expired project to continue using it, follow the instructions to Renew Project. When renew a project that has just been stopped from POC, you need to select a new renewal cycle and make a payment with your real money (credit wallet balance, Momo wallet, Zalopay wallet,...).**
* You also cannot enable POC usage after you have performed POC Stop. If you have any problems at this point, please contact your Sales or support staff directly or open a support ticket on our system.
POC implementation deadline expired
At the time of POC wallet expiry, we will:
* **Stop the POC** for all POC resources in use. The process is similar to when you actively stop the POC on a resource.
* **Disable POC wallet** : you will not be allowed to use resources in POC form until the POC wallet is enabled again.
***
## Create a trial project
Currently, with region HAN02 we do not support you to create trial project..
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.vngcloud.vn/vng-cloud-document/vstorage/object-storage/object-storage-han02/features-of-object-storage/working-with-project.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
then select **Auto-scale** and continue to select **Configure Auto-scale** or select the icon 
then select **Set Auto-scale**.
3. **At the Auto-scale** configuration screen , set up the necessary parameters for **Auto Scale** . Specifically:
* **Set Quota Unit:** you can choose 1 of 2 types of units including **GB** or **Percent**.
* **Set Quota Threshold or Quota Remain:** If you choose **Quota Unit** as **Percent** , here you will enter the percentage of usage threshold that when reached will trigger the quota increase. If you choose **Quota Unit** as **GB** , here you will enter the remaining quota that when reached will trigger the quota increase.
* **Set Quota Increment Level** : enter desired increment level in **GB** or **Percent**.
4. **Choose to receive email** notification when quota increase is successful if desired.
5. Enable **Auto-scale** at the icon 
. When this icon becomes 
it means you have successfully enabled **Auto-scale.**
{% hint style="info" %}
**Attention:**
* **The vStorage system will perform a 5-minute** auto-scaling check to automatically increase capacity based on the set threshold.
* The price is applied according to the **standard vStorage** price list , the feature only increases capacity without changing the Storage Class.
* Users need to ensure that they have **sufficient credit balance** for their account (prepaid) before performing Auto-scaling.
* If the capacity increase **fails** , the user will receive an email notification. After two consecutive auto-scaling failures, our system will stop sending email notifications to you. You need to proactively access vStorage to manually resize the project according to the instructions above.
{% endhint %}