All Products
Search

This Product

    :CreateFileSystem

    Document Center

    :CreateFileSystem

    Last Updated:May 28, 2026

    Membuat sistem file.

    • Sebelum memanggil operasi ini, pastikan Anda memahami metode penagihan dan harga Apsara File Storage NAS. Untuk informasi selengkapnya, lihat Billing dan Pricing.

    • Anda harus menyelesaikan verifikasi nama asli sebelum membuat sistem file.

    • Saat memanggil operasi ini, peran terkait layanan NAS akan dibuat secara otomatis. Untuk informasi selengkapnya, lihat Manage the service-linked roles of NAS.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

    Request parameters

    Parameter

    Type

    Required

    Example

    Description

    Action

    String

    Yes

    CreateFileSystem

    Operasi yang ingin Anda lakukan.

    Tetapkan nilainya ke CreateFileSystem.

    FileSystemType

    String

    No

    standard

    Jenis sistem file.

    Nilai yang valid:

    • standard (nilai default): General-purpose NAS file system

    • extreme: Extreme NAS file system

    • cpfs: Cloud Parallel File Storage (CPFS) file system

      Catatan

      Sistem file CPFS hanya tersedia di situs Alibaba Cloud China (aliyun.com).

    ChargeType

    String

    No

    PayAsYouGo

    Metode penagihan.

    Nilai yang valid:

    • PayAsYouGo (nilai default): pay-as-you-go

    • Subscription: subscription

    Duration

    Integer

    No

    1

    Durasi langganan.

    Parameter ini hanya berlaku dan wajib jika parameter ChargeType diatur ke Subscription. Satuan: bulan.

    Jika Anda tidak memperpanjang sistem file berlangganan saat masa berlakunya habis, sistem file tersebut akan dilepas secara otomatis.

    Capacity

    Long

    No

    100

    Kapasitas sistem file. Satuan: GiB.

    Parameter ini berlaku dan wajib jika parameter FileSystemType diatur ke extreme atau cpfs.

    Tentukan nilai berdasarkan spesifikasi pada halaman pembelian berikut:

    Extreme NAS file system (Pay-as-you-go)

    Bandwidth

    Long

    No

    150

    Throughput maksimum sistem file.

    Satuan: MB/s.

    Tentukan nilai berdasarkan spesifikasi pada halaman pembelian berikut.

    StorageType

    String

    Yes

    Performance

    Jenis penyimpanan.

    • Jika parameter FileSystemType diatur ke standard, Anda dapat mengatur parameter StorageType ke Performance atau Capacity.

    • Jika parameter FileSystemType diatur ke extreme, Anda dapat mengatur parameter StorageType ke standard atau advance.

    • Jika parameter FileSystemType diatur ke cpfs, Anda dapat mengatur parameter StorageType ke advance_100 (garis dasar 100 MB/s/TiB) atau advance_200 (garis dasar 200 MB/s/TiB). Nilai ini hanya tersedia di situs Alibaba Cloud China (aliyun.com).

    ZoneId

    String

    No

    cn-hangzhou-b

    ID zona.

    Setiap wilayah memiliki beberapa lokasi terisolasi yang dikenal sebagai zona. Setiap zona memiliki catu daya dan jaringan independen sendiri.

    Parameter ini tidak wajib jika parameter FileSystemType diatur ke standard. Secara default, zona acak dipilih berdasarkan jenis protokol dan jenis penyimpanan.

    Parameter ini wajib jika parameter FileSystemType diatur ke extreme atau cpfs.

    Catatan

    • Nilai cpfs hanya tersedia di situs Alibaba Cloud China (aliyun.com).

    • Instance Elastic Compute Service (ECS) dan sistem file NAS yang berada di zona berbeda dalam wilayah yang sama dapat saling mengakses.

    • Kami menyarankan agar Anda memilih zona tempat instance ECS berada. Hal ini mencegah latensi lintas zona antara sistem file dan instance ECS.

    ProtocolType

    String

    Yes

    NFS

    Jenis protokol.

    • Jika parameter FileSystemType diatur ke standard, Anda dapat mengatur parameter ProtocolType ke NFS atau SMB.

    • Jika parameter FileSystemType diatur ke extreme, Anda dapat mengatur parameter ProtocolType ke NFS.

    • Jika parameter FileSystemType diatur ke cpfs, Anda dapat mengatur parameter ProtocolType ke cpfs. Nilai ini hanya tersedia di situs Alibaba Cloud China (aliyun.com).

    EncryptType

    Integer

    No

    1

    Menentukan apakah data dalam sistem file dienkripsi.

    Anda dapat menggunakan kunci yang dikelola oleh Key Management Service (KMS) untuk mengenkripsi data yang disimpan dalam sistem file. Saat membaca dan menulis data terenkripsi, data tersebut didekripsi secara otomatis.

    Nilai yang valid:

    • 0: Data dalam sistem file tidak dienkripsi.

    • 1: Kunci yang dikelola NAS digunakan untuk mengenkripsi data dalam sistem file. Nilai ini hanya berlaku jika parameter FileSystemType diatur ke standard atau extreme.

    • 2: Kunci yang dikelola KMS digunakan untuk mengenkripsi data dalam sistem file. Nilai ini hanya berlaku jika parameter FileSystemType diatur ke extreme.

    Catatan

    Anda hanya dapat menggunakan kunci yang dikelola KMS di wilayah-wilayah berikut: AS (Silicon Valley), AS (Virginia), Inggris (London), Australia (Sydney), Jerman (Frankfurt), dan Singapura.

    SnapshotId

    String

    No

    s-xxx

    ID snapshot.

    Parameter ini hanya tersedia untuk sistem file Extreme NAS.

    Catatan

    Anda dapat membuat sistem file dari snapshot. Dalam kasus ini, versi sistem file sama dengan versi sistem file sumber. Misalnya, sistem file sumber snapshot menggunakan versi 1. Untuk membuat sistem file versi 2, Anda dapat membuat Sistem File A dari snapshot tersebut dan membuat Sistem File B versi 2. Anda kemudian dapat menyalin data dan memigrasikan bisnis Anda dari Sistem File A ke Sistem File B.

    VpcId

    String

    No

    None.

    ID virtual private cloud (VPC).

    Parameter ini wajib hanya jika Anda mengatur parameter FileSystemType ke cpfs. Parameter ini hanya tersedia di situs Alibaba Cloud China (aliyun.com).

    Parameter ini dicadangkan dan tidak wajib jika Anda mengatur parameter FileSystemType ke standard atau extreme.

    VSwitchId

    String

    No

    None.

    ID vSwitch

    Parameter ini wajib hanya jika Anda mengatur parameter FileSystemType ke cpfs. Parameter ini hanya tersedia di situs Alibaba Cloud China (aliyun.com).

    Parameter ini dicadangkan dan tidak wajib jika Anda mengatur parameter FileSystemType ke standard atau extreme.

    Description

    String

    No

    This is a file system.

    Deskripsi sistem file.

    Batasan:

    • Panjang deskripsi harus 2 hingga 128 karakter.

    • Deskripsi harus dimulai dengan huruf, tetapi tidak boleh dimulai dengan http:// atau https://.

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

    ClientToken

    String

    No

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

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan token ini di sisi klien, tetapi harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat How do I ensure the idempotence?

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan ID permintaan sebagai token klien. Nilai RequestId mungkin berbeda untuk setiap permintaan API.

    KmsKeyId

    String

    No

    None.

    ID kunci yang dikelola oleh KMS.

    Parameter ini wajib hanya jika parameter EncryptType diatur ke 2.

    DryRun

    Boolean

    No

    true

    Menentukan apakah akan melakukan dry run.

    Selama dry run, sistem memeriksa apakah parameter permintaan valid dan apakah resource yang diminta tersedia. Selama dry run, tidak ada sistem file yang dibuat dan tidak ada biaya yang dikenakan.

    Nilai yang valid:

    • true: melakukan dry run. Sistem memeriksa parameter yang diperlukan, sintaksis permintaan, batasan, dan resource NAS yang tersedia. Jika permintaan gagal dalam dry run, pesan kesalahan dikembalikan. Jika permintaan lolos dry run, kode status HTTP 200 dikembalikan. Tidak ada nilai yang dikembalikan untuk parameter FileSystemId.

    • false (nilai default): melakukan dry run dan mengirim permintaan. Jika permintaan lolos dry run, sistem file dibuat.

    Perhatikan informasi berikut mengenai idempotensi API:

    Operasi CreateFileSystem membuat sistem file dan menimbulkan biaya. Oleh karena itu, jika permintaan mengalami timeout atau terjadi kesalahan internal, klien mungkin mencoba mengirim ulang permintaan. Dalam kasus ini, Anda dapat menentukan parameter ClientToken dalam permintaan untuk memastikan bahwa permintaan tidak diproses berulang kali oleh klien.

    Catatan

    Operasi ini mendukung idempotensi hanya jika parameter FileSystemType diatur ke extreme atau cpfs. Operasi ini tidak mendukung idempotensi ketika parameter FileSystemType diatur ke standard.

    Daftar berikut memberikan detail lebih lanjut tentang parameter ClientToken.

    • Token klien adalah string unik dan case-sensitive yang dihasilkan oleh klien. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Contoh:

      ClientToken=123e4567-e89b-12d3-a456-42665544****

    • Jika Anda menentukan token klien yang sudah digunakan dan mengubah parameter permintaan lainnya, NAS akan mengembalikan kode kesalahan IdempotentParameterMismatch.

      Catatan

      Jika Anda memanggil operasi lagi, Anda harus mengubah nilai parameter SignatureNonce, Timestamp, dan Signature. Hal ini karena NAS menggunakan parameter SignatureNonce untuk mencegah serangan replay dan menggunakan parameter Timestamp untuk mengidentifikasi stempel waktu setiap permintaan. Oleh karena itu, permintaan ulang memerlukan nilai parameter SignatureNonce dan Timestamp yang berbeda, sehingga nilai parameter Signature juga berubah.

    • Jika Anda menentukan parameter ClientToken dan permintaan gagal, permintaan dikirim ulang berdasarkan kode status HTTP dan pesan kesalahan berikut:

      • Jika kode status HTTP 200 dikembalikan, klien dapat menerima hasil yang sama seperti permintaan sebelumnya setelah permintaan dikirim ulang. Namun, status server Anda tidak terpengaruh.

      • Jika kode status HTTP 4xx dikembalikan dan pesan kesalahan tidak menunjukkan "try it later", parameter permintaan tidak valid. Dalam kasus ini, Anda harus memodifikasi parameter permintaan berdasarkan pesan kesalahan yang dikembalikan, lalu mengirim ulang permintaan.

      • Jika kode status HTTP 5xx dikembalikan, terjadi timeout jaringan atau kesalahan internal. Dalam kasus ini, Anda dapat mengirim ulang permintaan yang sama dengan token klien dan parameter permintaan yang identik.

    • Token klien berlaku selama 30 hari.

    Response parameters

    Parameter

    Type

    Example

    Description

    RequestId

    String

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

    ID permintaan.

    FileSystemId

    String

    1ca404****

    ID sistem file yang dibuat.

    Examples

    Contoh permintaan

    http(s)://[Endpoint]/?Action=CreateFileSystem
&EncryptType=1
&ProtocolType=NFS
&StorageType=Performance
&ZoneId=cn-hangzhou-b
&<Common request parameters>

    Contoh respons sukses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<CreateFileSystemResponse>
    <FileSystemId>1ca404****</FileSystemId>
    <RequestId>98696EF0-1607-4E9D-B01D-F20930B6****</RequestId>
</CreateFileSystemResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

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

    Error codes

    Kode status HTTP

    Kode kesalahan

    Pesan kesalahan

    Deskripsi

    202

    RequestAccepted

    The request has been accepted by the server.

    Pesan yang dikembalikan karena permintaan diterima oleh backend.

    400

    IdempotentParameterMismatch

    The same client token was passed in to different parameters.

    Pesan kesalahan yang dikembalikan karena token klien yang sama ditentukan dalam permintaan yang berbeda.

    400

    InvalidParameter.KmsServiceNotEnabled

    Key Management Service is not enabled.

    Pesan kesalahan yang dikembalikan karena KMS dinonaktifkan.

    400

    DryRunOperation

    The request is validated with DryRun flag set.

    Pesan yang dikembalikan karena permintaan divalidasi.

    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.

    Pesan kesalahan yang dikembalikan karena Pengguna RAM saat ini tidak diizinkan membuat peran terkait layanan AliyunServiceRoleForNasExtreme. Berikan izin ram:CreateServiceLinkedRole kepada Pengguna RAM tersebut.

    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.

    Pesan kesalahan yang dikembalikan karena Pengguna RAM saat ini tidak diizinkan membuat peran terkait layanan AliyunServiceRoleForNasStandard. Berikan izin ram:CreateServiceLinkedRole kepada Pengguna RAM tersebut.

    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.

    Pesan kesalahan yang dikembalikan karena Pengguna RAM saat ini tidak diizinkan membuat peran terkait layanan AliyunServiceRoleForNasEncryption. Berikan izin ram:CreateServiceLinkedRole kepada Pengguna RAM tersebut.

    400

    InvalidParam.NotSupportBYOK

    The specified file system type does not support the BYOK encryption function.

    Pesan kesalahan yang dikembalikan karena jenis sistem file yang ditentukan tidak mendukung enkripsi KMS.

    400

    MissingParameter.KmsKeyId

    When parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request.

    Pesan kesalahan yang dikembalikan karena parameter KmsKeyId tidak ditentukan. Jika enkripsi KMS digunakan, Anda harus menentukan parameter KmsKeyId.

    403

    OperationDenied.InvalidState

    The operation is not permitted when the status is processing.

    Pesan kesalahan yang dikembalikan karena sistem file berada dalam status yang tidak valid.

    403

    InvalidFileSystem.AlreadyExisted

    The specified file system already exists.

    Pesan kesalahan yang dikembalikan karena sistem file yang ditentukan sudah ada.

    403

    Resource.OutOfStock

    The inventory of the specified zone is insufficient.

    Pesan kesalahan yang dikembalikan karena resource yang tersedia di zona yang ditentukan tidak mencukupi.

    Untuk daftar kode kesalahan, kunjungi API Error Center.