All Products
Search

This Product

    Cloud Parallel File Storage:CreateFileset

    Document Center

    Cloud Parallel File Storage:CreateFileset

    Last Updated:Jun 12, 2026

    Membuat fileset.

    Deskripsi operasi

    • Catatan penggunaan untuk CPFS.

      • Hanya CPFS 2.2.0 dan versi yang lebih baru yang mendukung pembuatan fileset. Anda dapat melihat informasi versi pada halaman detail sistem file di Konsol.

      • Maksimum 10 fileset dapat dibuat untuk satu sistem file CPFS.

      • Direktori induk harus berupa direktori yang sudah ada.

      • Kedalaman maksimum jalur fileset adalah 8 level, dengan direktori root / sebagai level 0. Misalnya, jalur fileset /test/aaa/ccc/ memiliki kedalaman 3 level.

      • Penempatan fileset di dalam fileset lain tidak didukung. Jika direktori induk sudah ditentukan sebagai fileset, subdirektorinya tidak dapat ditentukan sebagai fileset.

      • Satu fileset mendukung maksimum 1 juta file. Jika jumlah file melebihi batas ini, penambahan file baru akan mengembalikan Paket error no space.

    • Catatan penggunaan untuk CPFS for Lingjun

      • Hanya CPFS for Lingjun 2.7.0 dan versi yang lebih baru yang mendukung pembuatan fileset. Anda dapat melihat informasi versi pada halaman detail sistem file di Konsol.

      • Maksimum 500 fileset dapat dibuat untuk satu sistem file CPFS.

      • Jalur fileset harus berupa jalur baru dan tidak boleh berupa jalur yang sudah ada. Penggantian nama jalur fileset tidak didukung, dan jalur tidak boleh berupa tautan simbolik.

      • Kedalaman maksimum jalur fileset adalah 8 level, dengan direktori root / sebagai level 0. Misalnya, jalur fileset /test/aaa/ccc/ memiliki kedalaman 3 level.

      • Jika jalur fileset berisi beberapa level direktori, direktori induk harus berupa direktori yang sudah ada.

      • Penempatan fileset di dalam fileset lain tidak didukung. Jika direktori induk sudah ditentukan sebagai fileset, subdirektorinya tidak dapat ditentukan sebagai fileset. Setiap jalur fileset hanya mendukung satu kuota.

      • Kuota kapasitas minimum untuk fileset adalah 10 GiB, dan kapasitas dapat ditingkatkan dalam penambahan 1 GiB.

      • Satu fileset mendukung maksimum 10 miliar file atau direktori, dengan minimum 10.000 dan penambahan 1.

      • Saat Anda memodifikasi kuota direktori, kapasitas kuota atau jumlah file harus lebih besar dari kapasitas atau jumlah file yang digunakan.

      • Statistik kuota memiliki keterlambatan 15 menit. Penggunaan aktual berlaku 15 menit kemudian.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    nas:CreateFileset

    create

    *Fileset

    acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    FileSystemId

    string

    Yes

    ID sistem file.

    • CPFS: ID harus diawali dengan cpfs-, misalnya cpfs-099394bd928c****.

    • CPFS for Lingjun: ID harus diawali dengan bmcpfs-, misalnya bmcpfs-290w65p03ok64ya****.

    bmcpfs-290w65p03ok64y*****
    FileSystemPath

    string

    Yes

    Jalur mutlak fileset yang akan dibuat.

    • Pembatasan jalur untuk CPFS:

      • Direktori induk dari direktori yang ditentukan harus berupa direktori yang sudah ada di sistem file.

      • Panjang jalur harus 2 hingga 1.024 karakter.

      • Direktori yang ditentukan harus diawali dan diakhiri dengan garis miring (/).

    • Pembatasan jalur untuk CPFS for Lingjun:

      • Panjang jalur harus 2 hingga 1.024 karakter.

      • Direktori yang ditentukan harus diawali dan diakhiri dengan garis miring (/).

      • Jalur fileset harus berupa jalur baru dan tidak boleh berupa jalur yang sudah ada. Penggantian nama jalur fileset tidak didukung, dan jalur tidak boleh berupa tautan simbolik.

      • Kedalaman maksimum jalur fileset adalah 8 level, dengan direktori root / sebagai level 0. Misalnya, jalur fileset /test/aaa/ccc/ memiliki kedalaman 3 level.

      • Jika jalur fileset berisi beberapa level direktori, direktori induk harus berupa direktori yang sudah ada.

      • Penempatan fileset di dalam fileset lain tidak didukung. Jika direktori induk sudah ditentukan sebagai fileset, subdirektorinya tidak dapat ditentukan sebagai fileset. Setiap jalur fileset hanya mendukung satu kuota.

      • Panjang total jalur tidak boleh melebihi 990 karakter.

    /test/
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run untuk permintaan ini.

    Dry run memeriksa validitas parameter dan ketersediaan sumber daya tanpa benar-benar membuat instans atau menimbulkan biaya.

    Nilai valid:

    • true: Mengirim permintaan dry run tanpa membuat instans. Item pemeriksaan mencakup parameter wajib, format permintaan, batas layanan, dan ketersediaan sumber daya NAS. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode status HTTP 200 dikembalikan, tetapi FsetId kosong.

    • false (default): Mengirim permintaan Normal dan membuat instans setelah pemeriksaan berhasil.

    false
    DeletionProtection

    boolean

    No

    Properti perlindungan rilis instans. Apakah instans dapat dirilis menggunakan Konsol atau operasi DeleteFileset.

    • true: Mengaktifkan perlindungan rilis untuk instans.

    • false (default): Menonaktifkan perlindungan rilis untuk instans.

    Catatan

    Properti ini hanya membatasi operasi pelepasan manual dan tidak berlaku untuk operasi pelepasan yang diinisiasi sistem.

    false
    Description

    string

    No

    Deskripsi fileset.

    • Panjang deskripsi harus 2 hingga 128 karakter.

    • Deskripsi harus diawali dengan huruf atau karakter Tionghoa dan tidak boleh diawali dengan http:// atau https://.

    • Deskripsi dapat berisi angka, titik dua (:), garis bawah (_), atau tanda hubung (-).

    内部事务目录
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara permintaan yang berbeda.

    Token hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dapat berbeda untuk setiap permintaan API.

    123e4567-e89b-12d3-a456-4266554*****
    Quota

    object

    No

    Informasi kuota.

    Catatan

    Parameter ini hanya didukung untuk CPFS for Lingjun 2.7.0 dan versi yang lebih baru.

    FileCountLimit

    integer

    No

    Batas jumlah file untuk kuota. Nilai valid:

    • Nilai minimum: 10.000.

    • Nilai maksimum: 10.000.000.000.

    10000
    SizeLimit

    integer

    No

    Batas kapasitas total untuk kuota. Unit: bytes.

    Nilai valid:

    • Nilai minimum: 10.737.418.240 (10 GiB).

    • Penambahan: 1.073.741.824 (1 GiB).

    10737418240

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    98696EF0-1607-4E9D-B01D-F20930B6****
    FsetId

    string

    ID fileset.

    fset-1902718ea0ae****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "FsetId": "fset-1902718ea0ae****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 IllegalCharacters The parameter contains illegal characters.
    400 MissingFileSystemId FileSystemId is mandatory for this action.
    400 MissingFileSystemPath FileSystemPath is mandatory for this action.
    400 InvalidFilesystemType.NotSupport This Api does not support this fileSystem type.
    400 InvalidFilesystemVersion.NotSupport This Api does not support this fileSystem version.
    400 InvalidRequest The request is invalid.
    400 Quota.Invalid.Limit Quota limit is invalid.
    400 Resource.Exceed.Limit Resource exceed limit.
    400 Resource.Check.Fail Resource check failed.
    400 Fileset.Path.Duplicate Fileset path is duplicate.
    400 Fileset.Path.Nested Fileset path is nested.
    400 Fileset.Path.NotExist Fileset.Path.Not.Exist.
    400 Fileset.Path.Exist Fileset already exist.
    403 OperationDenied.AlreadyExists The operation is denied due to IdirName already exists in parent path.
    403 OperationDenied.TooManyFilesets The operation is denied due to too many fileset in filesystem.
    403 OperationDenied.TooManyDepths The operation is denied due to Fileset path too deep.
    403 OperationDenied.NestedDir The operation is denied due to nested directory.
    403 OperationDenied.DependencyViolation The operation is denied due to dependancy violation.
    403 OperationDenied.FilesetNotSupported The operation is not supported.
    404 InvalidFileSystem.NotFound The specified file system does not exist.
    404 InvalidFileSystemPath.ParentNotFound The specified parent path does not exist.
    404 InvalidFileSystemPath.NotDirectory The specified idir parent path is not directory.
    404 InvalidFileSystemPath.InvalidCharacters The specified fileset path contains invalid characters.
    404 InvalidFilesetPath.InvalidParameter Fileset path is invalid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.