CreateFileSystem - File Storage NAS - Alibaba Cloud Documentation Center

Membuat sistem file.

Deskripsi operasi

Sebelum memanggil operasi ini, pastikan Anda sepenuhnya memahami penagihan dan harga File Storage NAS. Untuk informasi lebih lanjut, lihat Penagihan dan Harga.
Untuk membuat instans sistem file, selesaikan verifikasi nama asli. Untuk informasi lebih lanjut, lihat Verifikasi nama asli.
Memanggil operasi ini secara otomatis membuat peran terkait layanan NAS yang diperlukan untuk operasi tersebut. Untuk informasi lebih lanjut, lihat Mengelola peran terkait 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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
FileSystemType	string	No	Tipe sistem file. Nilai valid: standard (default): General-purpose NAS. extreme: Extreme NAS. cpfs: Cloud Parallel File Storage (CPFS) (redundansi lokal). cpfsse: CPFS SE (redundansi zona). Valid values: standard : General-purpose NAS. cpfs : Cloud Paralleled File System (CPFS) (redundansi lokal) cpfsse : Cloud Paralleled File System (CPFS) SE (redundansi zona) extreme : Extreme NAS.	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 diisi dan hanya berlaku ketika ChargeType diatur ke Subscription. Jika Instansi langganan tidak diperpanjang sebelum instance kedaluwarsa, instans akan dirilis secara otomatis saat kedaluwarsa.	1
Capacity	integer	No	Kapasitas sistem file. Unit: GiB. Parameter ini wajib diisi dan hanya berlaku ketika FileSystemType diatur ke extreme, cpfs, atau cpfsse. Untuk nilai yang tersedia, lihat spesifikasi aktual di Tampilan halaman pembelian: Tampilan halaman pembelian Extreme NAS bayar sesuai pemakaian Tampilan halaman pembelian sistem file paralel CPFS bayar sesuai pemakaian	100
Bandwidth	integer	No	Throughput maksimum sistem file. Unit: MB/s. Untuk nilai spesifikasi yang tersedia, lihat spesifikasi aktual di Tampilan halaman pembelian. Tampilan halaman pembelian sistem file paralel CPFS bayar sesuai pemakaian	150
StorageType	string	Yes	Tipe penyimpanan. Jika FileSystemType diatur ke standard, nilai valid: Performance, Capacity, Premium, dan Agentic (AgenticFS). 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: Agentic : Agentic. Capacity : Capacity. Premium : Premium. Performance : Performance. economic : Ekonomi Extreme NAS. advance : Advanced Extreme NAS.	Performance
ZoneId	string	No	ID zona. Zona adalah area fisik independen dalam wilayah yang memiliki catu daya dan jaringan sendiri. Jika FileSystemType diatur ke standard, parameter ini bersifat opsional. Secara default, zona aktif yang memenuhi konfigurasi ProtocolType dan StorageType akan dipilih secara acak. Jika FileSystemType diatur ke extreme atau cpfs, parameter ini wajib diisi. Catatan Sistem file dan instans Elastic Computing Service (ECS) di zona berbeda dalam wilayah yang sama dapat berkomunikasi satu sama lain. Tempatkan sistem file dan server Elastic Computing Service (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: dual : Protokol ganda NFS+SMB. 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 pada sistem file. Dekripsi tidak diperlukan saat membaca atau menulis data terenkripsi. 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: Kunci Kustom (KMS) didukung di semua wilayah kecuali China (Hangzhou) Cloud Keuangan. General-purpose NAS: Kunci Kustom (KMS) didukung di semua wilayah. Valid values: 0 : tidak dienkripsi. 1 : Enkripsi kunci yang dikelola NAS. 2 : Enkripsi 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 dari snapshot tersebut. 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 konfigurasi versi 2, salin data dari sistem file A ke sistem file B, dan migrasikan beban kerja Anda ke sistem file B setelah penyalinan selesai.	s-extreme-snapsho****
VpcId	string	No	ID VPC. Jika FileSystemType diatur ke cpfs atau cpfsse, parameter ini wajib diisi. 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 diisi. 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: Panjang deskripsi harus 2 hingga 128 karakter. Deskripsi harus dimulai dengan huruf dan tidak boleh dimulai dengan `http://` atau `https://`. Deskripsi dapat berisi angka, titik dua (:), garis bawah (_), dan tanda hubung (-).	Deskripsi sistem file ini
ClientToken	string	No	Memastikan idempotensi permintaan. Hasilkan nilai parameter unik dari klien Anda. Nilai ClientToken hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi. Catatan Jika Anda tidak menentukan parameter ini, sistem menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	123e4567-e89b-12d3-a456-42665544****
KmsKeyId	string	No	ID kunci KMS. Parameter ini hanya wajib diisi ketika EncryptType diatur ke 2.	fcbd**-62-4a-b605-c58cc1d5**
DryRun	boolean	No	Apakah akan melakukan 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 bisnis, dan inventaris 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 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 atau berupa string kosong. Panjang kunci tag maksimal 128 karakter. Kunci tag tidak boleh dimulai dengan `aliyun` atau `acs:`. Kunci tag tidak boleh berisi `http://` atau `https://`.	nastest
Value	string	No	Nilai tag. Batasan: Nilai tag tidak boleh kosong atau berupa string kosong. Panjang nilai tag maksimal 128 karakter. Nilai tag tidak boleh berisi `http://` atau `https://`.	testValue
RedundancyType	string	No	Tipe redundansi penyimpanan. Parameter ini hanya berlaku untuk CPFS SE. Nilai valid: ZRS. Valid values: ZRS : redundansi zona.	ZRS
RedundancyVSwitchIds	array	No	Daftar ID vSwitch redundansi zona. Ketika RedundancyType diatur ke ZRS, parameter ini wajib diisi. Anda harus menentukan tiga ID vSwitch dari tiga zona berbeda.
	string	No	Daftar ID vSwitch redundansi zona.	vsw-123xxx

Catatan tentang idempotensi API:
Karena operasi CreateFileSystem melibatkan pembuatan Sumber daya cloud dan penagihan, jika permintaan mengalami waktu habis atau terjadi kesalahan server internal, klien dapat mencoba ulang permintaan. Atur parameter ClientToken dalam permintaan untuk mencegah 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 parameter ClientToken adalah sebagai berikut:

ClientToken adalah string unik yang peka huruf besar/kecil yang dihasilkan oleh klien yang berisi tidak lebih dari 64 karakter ASCII. Contoh: ClientToken=123e4567-e89b-12d3-a456-42665544****
Jika Anda memberikan ClientToken yang telah digunakan sebelumnya tetapi dengan parameter permintaan yang berbeda, NAS mengembalikan kode error IdempotentParameterMismatch.

Catatan

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

Setelah parameter ClientToken ditambahkan:
- Jika tanggapannya adalah kode status HTTP 200, percobaan ulang mengembalikan hasil yang sama dengan permintaan sebelumnya tanpa memengaruhi status sisi server Anda.
- Jika tanggapannya adalah kode status HTTP 4xx dan pesan error tidak menunjukkan pesan jenis "coba lagi nanti", percobaan ulang tidak akan pernah berhasil. Atasi masalah berdasarkan pesan error dan modifikasi parameter permintaan sebelum mencoba ulang.
- Jika tanggapannya adalah kode status HTTP 5xx, permintaan mungkin telah mengalami waktu habis atau terjadi kesalahan 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.	Permintaan telah diterima oleh backend.
400	IdempotentParameterMismatch	The same client token was passed in to different parameters.	Parameter berbeda ditentukan untuk ClientToken yang sama.
400	InvalidParameter.KmsServiceNotEnabled	Key Management Service is not enabled.	KMS tidak diaktifkan.
400	DryRunOperation	The request is validated with DryRun flag set.	Permintaan lulus validasi.
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.	Pengguna Resource Access Management (RAM) saat ini tidak memiliki izin untuk membuat peran terkait layanan AliyunServiceRoleForNasExtreme. Berikan otorisasi ram:CreateServiceLinkedRole kepada pengguna RAM.
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.	Pengguna Resource Access Management (RAM) saat ini tidak memiliki izin untuk membuat peran terkait layanan AliyunServiceRoleForNasStandard. Berikan otorisasi ram:CreateServiceLinkedRole kepada pengguna RAM.
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.	Pengguna Resource Access Management (RAM) saat ini tidak memiliki izin untuk membuat peran terkait layanan AliyunServiceRoleForNasEncryption. Berikan otorisasi ram:CreateServiceLinkedRole kepada pengguna RAM.
400	InvalidParam.NotSupportBYOK	The specified file system type does not support the BYOK encryption function.	Jenis sistem file yang ditentukan tidak mendukung enkripsi Custom Key (KMS).
400	MissingParameter.KmsKeyId	When parameter EncryptType equals 2, the parameter KmsKeyId is mandatory for your request.	Parameter KmsKeyId diperlukan ketika tipe enkripsi adalah Custom Key (KMS).
400	InvalidParameter.InvalidKmsKeyId	The specified KMS key ID is invalid.	Nilai KeyId KMS tidak valid.
400	InvalidParameter.KmsKeyIdNotFound	The specified KMS key ID does not exist.	KeyId KMS tidak ada.
403	OperationDenied.InvalidState	The operation is not permitted when the status is processing.	Operasi ini tidak diizinkan saat status sedang diproses.
403	InvalidFileSystem.AlreadyExisted	The specified file system already exists.	Sistem file yang ditentukan sudah ada. Anda dapat memanggil DescribeFileSystems dan menentukan ID sistem file untuk melihat informasi terkait.
403	Resource.OutOfStock	The inventory of the specified zone is insufficient.	Stok di zona yang ditentukan tidak mencukupi.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.