All Products
Search
Document Center

Cloud Storage Gateway:Manage iSCSI volumes

Last Updated:May 07, 2026

This topic describes how to create, modify, delete, and view iSCSI volumes in the Alibaba Cloud Storage Gateway (CSG) console.

Prerequisites

  • You have created an iSCSI gateway. For more information, see Create an iSCSI gateway.

  • To create an iSCSI volume in cache mode, you must have a cache. For more information, see Create a cache.

Note

A cache is not required for volumes in write-through mode.

Create an iSCSI volume

  1. On the Gateways page, click the ID of the iSCSI gateway. On the page that appears, click Volumes > Create.

  2. In the wizard, configure the parameters described in the following table.

    Configuration example

    Step

    Parameter

    Description

    Bucket Settings

    OSS Endpoint

    Select an endpoint for the region in which the bucket is located.

    Bucket Name

    Specify the name of the bucket. An iSCSI gateway does not support a bucket in the Archive storage class or with a back-to-origin routing configuration.

    Use SSL to Connect Bucket

    If you select Yes, the bucket is connected over SSL.

    Basic Information

    Volume Name

    Specify a name for the volume. The name must be 1 to 32 characters in length, and can contain lowercase letters and digits. The name must start with a lowercase letter.

    Recover

    Select whether to recover the volume based on the specified OSS bucket. Valid values:

    • Yes: When the OSS bucket has been used as the backend storage of the volume, the system attempts to recover the volume based on the metadata in the bucket, such as the size of the volume.

    • No: The system uses the associated OSS bucket to create a volume.

    Capacity

    If you set Recover to No, you must set the Capacity parameter. The capacity must be greater than or equal to 1 GB and less than or equal to 256 TB.

    Mode

    The mode that the gateway uses to read and write files. Valid values:

    • Write Through Mode: In Write Through mode, data reads and writes are sent directly to the OSS bucket.

    • Cache Mode: In Cache mode, data reads and writes are preferentially performed in the on-premises cache disk. Generally, iSCSI gateways have better read and write performance in Cache mode.

    Cache

    If you set Mode to Cache Mode, you must select a cache disk.

    Note

    Make sure that you have added a cache disk to the iSCSI gateway. Otherwise, no cache disk is available.

    Storage Allocation Unit

    If you set Recover to No, you must set the Storage Allocation Unit parameter.

    The supported allocation unit sizes are 8K, 16K, 32K, 64K, and 128K. The default allocation unit size is 32K.

    Authorization

    The one-way Challenge-Handshake Authentication Protocol (CHAP) authentication.

    If you select CHAP from the Authorization drop-down list, you must set the following parameters:

    • CHAP Username of Initiator: Enter a CHAP username.

    • CHAP Password of Initiator: Enter a CHAP password. The password must be 12 to 16 characters in length.

Related operations

On the Volumes page, you can also perform the following operations.

Actions

Description

Modify an iSCSI volume

Find the target iSCSI volume and click Edit.

Delete an iSCSI volume

Find the target iSCSI volume and click Delete.

When you delete a volume, you can choose to also delete its data from the backing OSS bucket.

Warning

If you choose to delete the data in the OSS bucket, all content on the volume is permanently deleted. This action cannot be undone. Proceed with caution.

View iSCSI volume details

Find the target iSCSI volume and click the plus sign (+) to expand its details. The details include the operation status, total data downloaded, address, capacity, port, CHAP status, total data uploaded, SSL connection status, LUN ID, volume status, and enabled status.

Next steps