All Products
Search

This Product

    File Storage NAS:CreateFileSystem

    Document Center

    File Storage NAS:CreateFileSystem

    Last Updated:Jul 03, 2026

    Membuat sistem file.

    Deskripsi operasi

    • Sebelum menggunakan operasi ini, pastikan Anda memahami penagihan File Storage NAS. Untuk informasi selengkapnya, lihat Penagihan dan Harga.

    • Untuk membuat instans sistem file, selesaikan verifikasi nama asli terlebih dahulu. Untuk informasi selengkapnya, lihat Verifikasi nama asli.

    • Saat Anda memanggil operasi ini, peran tertaut layanan yang diperlukan untuk operasi akan dibuat secara otomatis. Untuk informasi selengkapnya, lihat Mengelola peran tertaut layanan untuk NAS.

    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:CreateFileSystem

    create

    *FileSystem

    acs:nas:{#regionId}:{#accountId}:filesystem/*
    • nas:EncryptedType
    • nas:FileSystemType
    		 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    FileSystemType

    string

    No

    Tipe sistem file.

    Nilai valid:

    • standard (default): Sistem file NAS tujuan umum.

    • extreme: Sistem file NAS ekstrem.

    • cpfs: Cloud Parallel File Storage (CPFS) (redundan lokal).

    • cpfsse: Cloud Parallel File System (CPFS) SE (redundan zona).

    Valid values:

    • standard :

      Sistem file NAS tujuan umum.

    • cpfs :

      Cloud Parallel File System (CPFS) (redundan lokal)

    • cpfsse :

      Cloud Parallel File System (CPFS) SE (redundan zona)

    • extreme :

      Sistem file NAS ekstrem.

    standard
    ChargeType

    string

    No

    Metode penagihan.

    Nilai valid:

    • PayAsYouGo (default): Bayar sesuai pemakaian.

    • Subscription: Langganan.

    Valid values:

    • PayAsYouGo :

      Bayar sesuai pemakaian.

    • Subscription :

      Langganan.

    PayAsYouGo
    Duration

    integer

    No

    Durasi langganan.

    Unit: bulan. Parameter ini wajib dan hanya berlaku ketika ChargeType diatur ke Subscription.

    Jika Instans langganan tidak diperpanjang saat masa berlaku berakhir, instans kedaluwarsa dan dirilis secara otomatis.

    1
    Capacity

    integer

    No

    Kapasitas sistem file. Unit: GiB. Parameter ini wajib dan hanya berlaku ketika FileSystemType diatur ke extreme, cpfs, atau cpfsse.

    Untuk nilai yang tersedia, Tampilan spesifikasi di halaman pembelian:

    100
    Bandwidth

    integer

    No

    Throughput maksimum sistem file.

    Unit: MB/s.

    Untuk nilai yang tersedia, Tampilan spesifikasi di halaman pembelian.

    Halaman pembelian sistem file paralel CPFS bayar sesuai pemakaian

    150
    StorageType

    string

    Yes

    Tipe penyimpanan.

    • Jika FileSystemType diatur ke standard, nilai valid: Performance, Capacity, dan Premium.

    • Jika FileSystemType diatur ke extreme, nilai valid: standard dan advance.

    • Jika FileSystemType diatur ke cpfs, nilai valid: advance_100 (garis dasar 100 MB/s/TiB), advance_200 (garis dasar 200 MB/s/TiB), dan economic.

    • Jika FileSystemType diatur ke cpfsse, nilai valid: advance_100 (garis dasar 100 MB/s/TiB).

    Valid values:

    • standard :

      Extreme NAS Jenis Penyimpanan Standar.

    • Capacity :

      NAS kapasitas.

    • advance_200 :

      Cloud Parallel File System (CPFS) garis dasar 200 MB/s/TiB.

    • advance_100 :

      Cloud Parallel File System (CPFS) garis dasar 100 MB/s/TiB.

    • Premium :

      NAS premium.

    • Performance :

      NAS performa.

    • economic :

      Cloud Parallel File System (CPFS) ekonomi.

    • advance :

      Extreme NAS lanjutan.

    Performance
    ZoneId

    string

    No

    ID zona.

    Zona adalah area fisik independen dalam suatu wilayah yang memiliki catu daya dan jaringan sendiri.

    Jika FileSystemType diatur ke standard, parameter ini bersifat opsional. Secara default, zona aktif yang cocok dengan ProtocolType dan StorageType yang ditentukan akan dipilih secara acak.

    Jika FileSystemType diatur ke extreme atau cpfs, parameter ini wajib.

    Catatan

    • Sistem file dan Instans ECS di zona berbeda dalam wilayah yang sama dapat saling berkomunikasi.

    • Tempatkan sistem file dan Instans ECS di zona yang sama untuk menghindari latensi lintas zona.

    cn-hangzhou-b
    ProtocolType

    string

    Yes

    Tipe protokol transfer file.

    • Jika FileSystemType diatur ke standard, nilai valid: NFS dan SMB.

    • Jika FileSystemType diatur ke extreme, nilai valid: NFS.

    • Jika FileSystemType diatur ke cpfs, nilai valid: cpfs.

    • Jika FileSystemType diatur ke cpfsse, nilai valid: cpfs.

    Valid values:

    • cpfs :

      Protokol cpfs.

    • SMB :

      Protokol SMB.

    • NFS :

      Protokol NFS.

    NFS
    EncryptType

    integer

    No

    Apakah akan mengenkripsi sistem file.

    Menggunakan kunci yang dikelola oleh Key Management Service (KMS) untuk mengenkripsi data yang disimpan di sistem file. Data terenkripsi tidak perlu didekripsi saat dibaca atau ditulis.

    Nilai valid:

    • 0 (default): Tidak dienkripsi.

    • 1: Kunci yang dikelola NAS. Didukung ketika FileSystemType diatur ke standard atau extreme.

    • 2: Kunci Kustom (KMS). Didukung ketika FileSystemType diatur ke standard atau extreme.

    Catatan

    • Extreme NAS: Fitur Kunci Kustom (KMS) didukung di semua wilayah kecuali Cloud Keuangan China (Hangzhou).

    • NAS tujuan umum: Fitur Kunci Kustom (KMS) didukung di semua wilayah.

    Valid values:

    • 0 :

      Tidak dienkripsi.

    • 1 :

      Kunci yang dikelola NAS.

    • 2 :

      Kunci Kustom (KMS).

    1
    SnapshotId

    string

    No

    ID snapshot.

    Parameter ini hanya didukung untuk sistem file Extreme NAS dengan tipe penyimpanan Advanced.

    Catatan

    Sistem file yang dibuat dari snapshot memiliki versi yang sama dengan sistem file sumber snapshot. Misalnya, jika versi sistem file sumber adalah 1 dan Anda ingin membuat sistem file versi 2, pertama-tama buat sistem file A dari snapshot, lalu buat sistem file B yang memenuhi spesifikasi versi 2, salin data dari sistem file A ke sistem file B, lalu migrasikan beban kerja Anda ke sistem file B.

    s-extreme-snapsho****
    VpcId

    string

    No

    ID VPC.

    • Jika FileSystemType diatur ke cpfs atau cpfsse, parameter ini wajib.

    • Jika FileSystemType diatur ke standard atau extreme, parameter ini dicadangkan dan tidak berlaku. Anda tidak perlu mengonfigurasinya.

    vpc-bp18cx9a7zoh0h9b4****
    VSwitchId

    string

    No

    ID vSwitch.

    • Jika FileSystemType diatur ke cpfs, parameter ini wajib.

    • Jika FileSystemType tidak diatur ke cpfs, parameter ini dicadangkan dan tidak berlaku. Anda tidak perlu mengonfigurasinya.

    vsw-bp131dkqilvw5pnlt****
    Description

    string

    No

    Deskripsi sistem file.

    Batasan:

    • Deskripsi harus memiliki panjang 2 hingga 128 karakter.

    • Deskripsi harus diawali dengan huruf dan tidak dapat diawali dengan http:// atau https://.

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

    此文件系统的描述。
    ClientToken

    string

    No

    Memastikan idempotensi permintaan. Hasilkan nilai unik dari Klien Anda untuk memastikan bahwa nilai tersebut unik di antara permintaan yang berbeda. ClientToken hanya mendukung karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

    Catatan

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

    123e4567-e89b-12d3-a456-42665544****
    KmsKeyId

    string

    No

    ID kunci KMS.

    Parameter ini hanya wajib ketika EncryptType diatur ke 2.

    fcbd****-62**-4a**-b605-c58cc1d5****
    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 FileSystemId kosong.

    • false (default): Mengirim permintaan normal. Setelah pemeriksaan berhasil, instans akan dibuat.

    true
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    Anda dapat melihat ID kelompok sumber daya di Konsol Resource Management.

    rg-acfmwavnfdf****

    Tag

    array<object>

    No

    Tag.

    Panjang array: 1 hingga 20. Jika array berisi beberapa objek tag, kunci tag (Key) harus unik.

    object

    No

    Objek tag.

    Key

    string

    No

    Kunci tag.

    Batasan:

    • Kunci tag tidak boleh kosong.

    • Kunci tag dapat memiliki panjang hingga 128 karakter.

    • Kunci tag tidak dapat diawali dengan aliyun atau acs:.

    • Kunci tag tidak dapat berisi http:// atau https://.

    nastest
    Value

    string

    No

    Nilai tag.

    Batasan:

    • Nilai tag tidak boleh kosong.

    • Nilai tag dapat memiliki panjang hingga 128 karakter.

    • Nilai tag tidak dapat berisi http:// atau https://.

    testValue
    RedundancyType

    string

    No

    Tipe redundansi penyimpanan. Parameter ini hanya berlaku untuk CPFS SE. Nilai valid: ZRS.

    Valid values:

    • ZRS :

      Redundan zona.

    ZRS
    RedundancyVSwitchIds

    array

    No

    Daftar ID vSwitch redundan zona. Ketika RedundancyType diatur ke ZRS, parameter ini wajib. Anda harus menentukan tiga ID vSwitch, masing-masing dari zona yang berbeda.

    string

    No

    Daftar ID vSwitch redundan zona.

    vsw-123xxx

    Catatan tentang idempotensi API:
    Karena operasi CreateFileSystem melibatkan pembuatan sumber daya cloud dan penagihan, jika permintaan mengalami waktu tunggu habis atau terjadi error server internal, klien dapat mencoba ulang permintaan. Atur parameter ClientToken untuk menghindari pesanan duplikat yang disebabkan oleh beberapa percobaan ulang.

    Catatan

    Saat ini, operasi ini hanya mendukung idempotensi ketika FileSystemType diatur ke extreme atau cpfs. Ketika FileSystemType diatur ke standard, operasi ini tidak mendukung idempotensi.

    Detail tentang parameter ClientToken:

    • ClientToken adalah string unik yang peka huruf besar/kecil yang dihasilkan oleh klien yang berisi hingga 64 karakter ASCII. Contoh: ClientToken=123e4567-e89b-12d3-a456-42665544****

    • Jika Anda memberikan ClientToken yang pernah digunakan sebelumnya tetapi dengan parameter permintaan yang berbeda, NAS akan mengembalikan kode error IdempotentParameterMismatch.

    Catatan

    Parameter SignatureNonce, Timestamp, dan Signature harus berubah saat percobaan ulang karena NAS menggunakan SignatureNonce untuk mencegah serangan replay dan Timestamp untuk menandai waktu setiap permintaan. Oleh karena itu, percobaan ulang harus menggunakan nilai SignatureNonce dan Timestamp yang berbeda, yang juga mengubah nilai Signature.

    • Setelah parameter ClientToken ditentukan:

      • Jika tanggapan adalah HTTP 200, percobaan ulang akan mengembalikan hasil yang sama dengan permintaan sebelumnya tanpa memengaruhi status server.

      • Jika tanggapan adalah HTTP 4xx dan pesan error tidak menunjukkan skenario "coba lagi nanti", percobaan ulang tidak akan pernah berhasil. Lakukan pemecahan masalah berdasarkan pesan error dan ubah parameter permintaan sebelum mencoba ulang.

      • Jika tanggapan adalah HTTP 5xx, permintaan mungkin mengalami waktu tunggu habis atau terjadi error server internal. Kirim ulang permintaan yang sama (dengan ClientToken dan parameter permintaan bisnis yang sama) untuk mengonfirmasi hasilnya.

    • ClientToken berlaku selama 30 hari.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Struktur tanggapan.

    RequestId

    string

    ID permintaan.

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

    string

    ID sistem file yang dibuat.

    1ca404****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "FileSystemId": "1ca404****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    202 RequestAccepted The request has been accepted by the server.
    400 IdempotentParameterMismatch The same client token was passed in to different parameters.
    400 InvalidParameter.KmsServiceNotEnabled Key Management Service is not enabled.
    400 DryRunOperation The request is validated with DryRun flag set.
    400 SubAccount.NoExtremeSLRPermission The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasExtreme. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.
    400 SubAccount.NoStandardSLRPermission The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasStandard. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.
    400 SubAccount.NoEncryptionSLRPermission The RAM user does not have the permission to create service linked role AliyunServiceRoleForNasEncryption. Please authorize the RAM user the permission ram:CreateServiceLinkedRole.
    400 InvalidParam.NotSupportBYOK The specified file system type does not support the BYOK encryption function.
    400 MissingParameter.KmsKeyId When parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request.
    400 InvalidParameter.InvalidKmsKeyId The specified KMS key ID is invalid.
    400 InvalidParameter.KmsKeyIdNotFound The specified KMS key ID does not exist.
    403 OperationDenied.InvalidState The operation is not permitted when the status is processing.
    403 InvalidFileSystem.AlreadyExisted The specified file system already exists.
    403 Resource.OutOfStock The inventory of the specified zone is insufficient.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.