Documentation Index

Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

Manage buckets

Prev Next

Available in Classic and VPC

A bucket created in Ncloud Storage is a space to store objects. Once you create at least 1 bucket, the Ncloud Storage subscription starts.

To create and manage buckets in the NAVER Cloud Platform console:

Create bucket

To create a bucket in the Ncloud Storage service:

  1. From the NAVER Cloud Platform console, navigate to Menu > Services > Storage > Ncloud Storage > Bucket Management.
  2. Click [Create bucket] in the Bucket Management interface.
  3. Enter the required information in the Enter basic information step.
    • Region: Specify the Region to create a bucket to.
    • Bucket name: Enter the name of the bucket to create. (See Bucket name rules.)
      • Once a bucket has been created, you cannot change its name or Region.
  4. Click [Next].
  5. Select whether to manage bucket versions, if necessary.
    • Bucket version management: Once enabled, you cannot disable it. You can only pause the feature when you are not using it.
    • For more information about version management, see Bucket version management guide.
  6. Select the encryption type for the bucket, if necessary.
    • For all buckets created in Ncloud Storage, the server-side encryption using NCP-managed key (SSE-S3) is applied as the default encryption.
    • For more information about how to set encryption, see Encryption management.
  7. After confirming the information you entered, click [Create bucket].
  8. A bucket is created.
    • You can create up to 100 buckets by Region.
Note

If you need to increase the bucket creation limit, request as follows:

Bucket name rules

The string rules for bucket names in Ncloud Storage are as follows:

  • You must enter a unique name for each Region. If there is an identical bucket name, you cannot register it.
  • You can enter between 3 and 63 characters.
  • You can only use English lowercase letters, numbers, and/or hyphens (-). It must start and end with a letter or a number.
  • You cannot use the following prefixes: xn--, sthree-, sthree-configurator, and amzn-s3-demo-.
  • You cannot use the following suffixes: -s3alias, --ol-s3, .mrap, and --x-s3.
Caution

You cannot change the name of the bucket you entered upon creation.

Manage buckets

You can set options or view details in the bucket management menu. To manage buckets:

  1. From the NAVER Cloud Platform console, navigate to Menu > Services > Storage > Ncloud Storage.
  2. Select a bucket from the bucket list on the Bucket Management interface.
  3. View the bucket details, bucket version management, lifecycle management, and encryption management status.

BucketManagement.png

Component Description
① Management menu
② View information Details of the bucket.
③ Version management View whether the Bucket version management feature is enabled.
④ Lifecycle management View whether the Lifecycle management feature is enabled.
⑤ Encryption management View whether the Data encryption feature is enabled and its type.
⑥ Set CORS View whether the Set CORS feature is enabled.

Delete bucket

To delete a bucket:

  1. Select the bucket you want to delete from the bucket list and click [Delete bucket].
  2. Enter the bucket name in the bucket deletion popup, then click [OK].
  3. Check that the task is completed in the deletion popup and close it.
Caution

When you delete a bucket, all objects stored in the bucket are deleted. Deleted objects cannot be recovered.

Cancel bucket deletion

During bucket deletion, the Cancel bucket deletion button is enabled so that you can cancel the deletion. To cancel bucket deletion, click [Save] in the Cancel bucket deletion popup.

Note

Even if you cancel the deletion, you cannot recover objects that have already been deleted. Only objects that have not been deleted yet remain.

Details

The following are the bucket details you can view from the console:

  • Bucket name: Name of the selected bucket.
  • Size: Total size of objects stored in the selected bucket.
  • Number of objects: Total number of objects stored in the selected bucket.
  • Whether there are incomplete multipart uploads: If you upload large-scale objects using multipart upload, whether any incomplete multipart upload remain.
Caution

If incomplete multipart uploads remain, storage fees are incurred based on the size of the part already uploaded. Complete multipart uploads or cancel incomplete uploads to avoid incurring excessive fees.

Bucket version management

Version management is a feature that stores multiple versions of a file for 1 object. When the bucket version management feature is enabled, all versions of objects stored in the bucket are reserved and can be retrieved and restored. This allows you to easily restore an object to a previous version in case of unintended actions, like accidentally deleting it.

To enable bucket version management feature:

Enable in the bucket creation step

In Step 2 of bucket creation, Select whether to enable bucket version management under Manage settings > Bucket version management.

Enable bucket version management in the bucket list

  1. Select the bucket from the bucket list and click i-objectstorage_enlargement in the Bucket version management area.
  2. Select Enable in the bucket version management popup.
  3. Click [Apply].
  4. The bucket version management feature is enabled.
Note
  • Once the bucket version management feature is enabled, you cannot disable it again, but only pause it. Pausing the bucket version management feature stops the creation of new versions of objects and reserves existing object versions.
  • If you enable the bucket version management feature, the features to Delete bucket and delete folders, including sub-objects, are limited in the console. To delete a bucket or folder, set the Show version button at the top of the object management list to ON, then manually delete all versions of the objects beneath it.
  • For more information about how to manage version, see Manage object.
Caution

When you use the version management feature, Storage fees are incurred for all versions of created objects.

Lifecycle management

Lifecycle management is a feature that allows you to use the storage cost efficiently by setting task rules for objects stored in the bucket to transfer the object to a lower-cost storage class or by automatically deleting the expired objects. You can set up to 1,000 rules per bucket. The same rules are applied to the objects stored after the rules are set.

Note

Objects deleted according to the expiration policy cannot be recovered.

Enable lifecycle management

To enable the lifecycle management feature:

  1. Select the bucket from the bucket list and click i-objectstorage_enlargement in the Lifecycle management component.
  2. In the Lifecycle management popup, select Add rule.
  3. In the rule addition popup, set detailed rules and click [Save]. For more information about performing tasks, see Lifecycle management tasks.
  4. The object transfer or expiration tasks are performed according to the rules you set. The same rules are applied to the objects stored after the rules are set.
Note
  • When new lifecycle rules are applied, paused, or deleted, it may take up to a few minutes for the lifecycle configuration to be fully applied.
  • A delay of several days may occur between the time when the conditions for performing the lifecycle rules are met and the time when the actual task is completed.

Lifecycle management tasks

The types of tasks that can be performed through the lifecycle management settings are as follows:

  • Switch the current version of the object: Move the latest version of an object to the specified storage class when the specified period or date is reached. However, the task is carried out only for objects larger than 128 KB.
    • You can configure the specific date option only through the API or CLI, and rules with a date cannot be edited in the console.
  • Switch the previous version of the object: After the latest version of the object is switched to the previous version (after it becomes the non-current version of the object), move the object to the designated storage class when the designated time arrives. If you specify how many previous versions to keep, all previous versions beyond that number are moved to the specified storage class. However, the task is carried out only for objects larger than 128 KB.
  • Delete the current version of the object: When the designated time arrives, delete the latest version of the object and add the deletion marker. Through this, the latest version of the object is switched to the previous version, and the deletion marker becomes the latest version.
    • Here, if the version of the object is more than 1 and the deletion marker is the latest version, the task is not carried out.
  • Delete the previous version of the object: After the latest version of the object is switched to the previous version (after it becomes the non-current version of the object), permanently delete the previous version of the object when the designated time arrives. Objects deleted due to the deletion task can't be recovered.
  • Delete the expired deletion marker: If the latest version of the object is the deletion marker and the previous version of the object does not exist (if the latest object is the only object version), you can delete the deletion marker.
Note

If several lifecycle rules are set in 1 bucket, the priority of performing tasks is in the following order: Permanent deletion, switch, and deletion marker creation.

Caution

If a task with a specific date remains ON after the execution date, the action continues to run. Make sure to delete the rule after the date has passed.

Edit lifecycle management rules

You can edit the lifecycle rules you set.

  1. Select the rule you want to edit from the list of rules in the lifecycle management popup, and click [Edit].
  2. In the Edit rules popup, set detailed rules and click [OK].

Delete lifecycle management rules

You can delete the lifecycle rules you set.

  1. Select the rule you want to delete from the list of rules in the lifecycle management popup, and click [Delete].
  2. Check the instruction in the Delete popup and click [Delete].

Encryption management

Encryption management is a feature that encrypts and stores objects stored in the bucket. For all buckets created in Ncloud Storage, the server-side encryption using NCP-managed key (SSE-S3) is applied as the default encryption. The encryption types provided in Ncloud Storage are as follows:

  • NCP-managed key (SSE-S3): Data is automatically encrypted on the server using the encryption key managed by Ncloud Storage. You do not need to create or manage keys, as data is automatically encrypted upon storage and decrypted upon access. It is provided as the default encryption type. SSE-S3 is applied if you do not specify the encryption management type.
  • KMS master key (SSE-KMS): Data is encrypted on the server using the keys managed by Key Management Service (KMS).
Note
  • The encryption type of existing objects does not change even if you modify the encryption management type. The updated encryption type applies to objects that are newly saved or overwritten.
  • Starting July 29, 2025, NCP-managed key encryption is automatically applied only to objects uploaded after that date. To encrypt a previously uploaded object, create a copy of the object.

Set CORS

You can access objects in the current bucket from another domain’s web application using the CORS feature. You can control access by setting the origin, HTTP methods, and headers to allow resource requests. You can set up to 100 rules. To set CORS policy:

  1. Select the bucket from the bucket list and click i-objectstorage_enlargement in the Set CORS area.
  2. In the CORS setting popup, click Edit.
  3. Enter a JSON-formatted policy in the CORS policy edition popup, and click [OK].
  4. Check the content of the CORS setting popup, and click [OK].
    • If you do not click [OK] in the CORS setting popup, the policy you have written does not apply.

CORS components

The components of CORS are as follows:

Key Required Description Details
AllowedMethods Required HTTP method to allow Allowed value
  • GET
  • PUT
  • POST
  • DELETE
  • HEAD
AllowedOrigins Required List of allowed origins for websites
  • Up to 1 * is allowed.
  • Supported patterns:
    • *: All origins allowed
    • *.example.com: Subdomain wildcard
    • www.example*.com: Mid-position wildcard
    • www.example.*: TLD wildcard
AllowedHeaders Optional List of HTTP headers to allow on browser requests
  • Up to 1 * is allowed (no limits on position).
  • Supported patterns:
    • *: All headers allowed
    • x-amz-*: Prefix wildcard
      • Example: x-amz-date, x-amz-content-sha256
    • *-header: Suffix wildcard
    • x-*-header: Mid-position wildcard
  • Not case-sensitive.
  • Front and back spaces of the input are automatically removed.
  • Header name rule (RFC 7230)
    • Allowed characters:
      • a-z A-Z 0-9 ! # $ % & ' * + - . ^ _ ~
    • Not allowed if the following characters are included:
      • Non-tchar characters, such as @ ( ) { } [ ] / : ; = ? " \ 공백
    • Not allowed if a space is included in the middle of the header name (e.g. x amz date)
ExposeHeaders Optional List of response headers to allow access to the browser
  • Wildcard not supported.
  • Not case-sensitive.
  • Front and back spaces of the input are automatically removed.
  • Header name rule (RFC 7230)
    • Allowed characters:
      • a-z A-Z 0-9 ! # $ % & ' * + - . ^ _ ~
    • Not allowed if the following characters are included:
      • Non-tchar characters, such as @ ( ) { } [ ] / : ; = ? " \ 공백
    • Not allowed if a space is included in the middle of the header name (e.g. x amz date)
MaxAgeSeconds Optional Time for the browser to cache request results (sec) If the value is 0, no caching occurs, and a Preflight request is sent with every request.