DescribeFileSystems - Cloud Parallel File Storage - Alibaba Cloud Documentation Center

Mengkueri informasi sistem file.

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

get

*FileSystem

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
FileSystemId	string	No	ID sistem file. General-purpose NAS: 31a8e4**. Extreme NAS: Harus diawali dengan extreme-, seperti extreme-0015. Cloud Parallel File Storage (CPFS) (versi redundan lokal): Harus diawali dengan cpfs-, seperti cpfs-125487. CPFS SE (versi redundan zona): Harus diawali dengan cpfsse-, seperti cpfsse-022c71b134**.	31a8e4****
FileSystemType	string	No	Tipe sistem file. Nilai valid: all (default): mengkueri semua tipe. standard: General-purpose NAS. extreme: Extreme NAS. cpfs: Cloud Parallel File Storage (CPFS) (versi redundan lokal). cpfsse: CPFS SE (versi redundan zona). Catatan Untuk mengkueri beberapa tipe, pisahkan dengan koma (,).	standard
VpcId	string	No	ID virtual private cloud (VPC). VPC harus sama dengan VPC server Elastic Computing Service (ECS) tempat Anda ingin memasang sistem file.	vpc-bp1sevsgtqvk5gxbl****
PageSize	integer	No	Jumlah sistem file pada setiap halaman selama kueri berhalaman. Nilai valid: 1 hingga 100. Nilai default: 10.	1
PageNumber	integer	No	Nomor halaman daftar sistem file. Nilai awal (nilai default): 1.	1
StorageType	string	No	Tipe penyimpanan. Saat ini, hanya spesifikasi CPFS untuk Lingjun yang didukung untuk kueri terfilter. Tipe sistem file lain (FileSystemType) tidak didukung. Spesifikasi berikut didukung: bm_advance_400 bm_advance_400_large bm_advance_new bm_advance_100 cpfslight_100 bm_p100_stepsize_300 bm_p400_stepsize_1 bm_p400_stepsize_300 Anda dapat menentukan beberapa spesifikasi yang dipisahkan dengan koma (,). Contoh: bm_advance_400,bm_advance_new.	bm_advance_400
Tag	array<object>	No	Kumpulan informasi tag.
	object	No	Kumpulan informasi tag.
Key	string	No	Kunci tag. Batasan: Nilai valid N: 1 hingga 20. Panjang kunci tag dapat mencapai 128 karakter. Kunci tag tidak dapat diawali dengan `aliyun` atau `acs:`. Kunci tag tidak dapat mengandung `http://` atau `https://`.	testKey
Value	string	No	Nilai tag. Batasan: Nilai valid N: 1 hingga 20. Panjang nilai tag dapat mencapai 128 karakter. Nilai tag tidak dapat diawali dengan `aliyun` atau `acs:`. Nilai tag tidak dapat mengandung `http://` atau `https://`.	testValue
ResourceGroupId	string	No	ID kelompok sumber daya. Anda dapat melihat ID kelompok sumber daya di Konsol Manajemen Sumber Daya.	rg-acfmwavnfef****

Elemen respons

Element	Type	Description	Example
	object
FileSystems	object
FileSystem	array<object>	Daftar sistem file.
	array<object>
AccessPointCount	string	Jumlah titik akses.	1
AutoSnapshotPolicyId	string	ID kebijakan snapshot otomatis.	sp-extreme-09npwxadu1eqvw****
AutoUpgradeConfig	object	Konfigurasi ekspansi otomatis.
capacityUsedRatio	integer	Ambang batas penggunaan, dalam persentase.	80
enabled	boolean	Apakah akan mengaktifkan ekspansi otomatis. Nilai valid: true: Mengaktifkan ekspansi otomatis. false: Menonaktifkan ekspansi otomatis.
step	integer	Ukuran langkah ekspansi. Unit: GiB.	100
time	integer	Ambang batas durasi. Unit: menit.	30
Bandwidth	integer	Bandwidth sistem file. Unit: MB/s. Bidang ini tidak dikembalikan untuk sistem file General-purpose NAS.	150
Capacity	integer	Kapasitas sistem file. Unit: GiB.	100
ChargeType	string	Jenis penagihan. Nilai valid: Subscription: Langganan. PayAsYouGo: Bayar sesuai pemakaian. Package: Paket penyimpanan terikat.	PayAsYouGo
CreateTime	string	Waktu pembuatan sistem file. Waktu ditampilkan dalam zona waktu lokal CST dengan format yyyy-MM-ddTHH:mm:ssCST. Contoh: 2026-07-20T14:31:42CST.	2026-07-20T14:31:42CST
Description	string	Deskripsi sistem file.	test
EncryptType	integer	Jenis enkripsi. Nilai valid: 0: Tidak dienkripsi. 1: Kunci yang dikelola NAS. 2: Kunci Kustom (KMS).	1
ExpiredTime	string	Waktu kedaluwarsa sistem file. Waktu mengikuti standar ISO 8601 dalam UTC. Format: yyyy-MM-ddTHH:mm:ssZ.	2020-01-05T16:00:00Z
FileSystemId	string	ID sistem file.	109c04****
FileSystemType	string	Jenis sistem file. Nilai valid: standard: General-purpose NAS. extreme: Extreme NAS. cpfs: Cloud Parallel File Storage (redundan secara lokal). cpfsse: Cloud Parallel File Storage SE (redundan secara zona).	standard
KMSKeyId	string	ID kunci KMS.	0e478b7a-4262-4802-b8cb-00d3fb40****
Ldap	object	Informasi konfigurasi LDAP. Parameter ini hanya dikembalikan untuk sistem file CPFS.
BindDN	string	Distinguished name (DN) yang digunakan untuk mengikat ke server LDAP.	cn=alibaba,dc=com
SearchBase	string	Basis pencarian LDAP.	dc=example
URI	string	Alamat server LDAP.	ldap://ldap.example.example
MeteredArchiveSize	integer	Penggunaan penyimpanan kelas penyimpanan arsip. Unit: byte.	1611661312
MeteredIASize	integer	Penggunaan penyimpanan kelas penyimpanan IA. Unit: byte.	362832
MeteredSize	integer	Penggunaan penyimpanan standar sistem file. Ini bukan penggunaan waktu nyata. Ini mewakili penggunaan maksimum pada jam sebelumnya. Unit: byte. Catatan Untuk menampilkan total kapasitas penyimpanan sistem file, lihat Mengkueri penggunaan sumber daya sistem file.	1611661312
MountTargets	object
MountTarget	array<object>	Informasi Titik pemasangan.
	array<object>
AccessGroupName	string	Nama grup izin yang digunakan oleh Titik pemasangan.	test-001
ClientMasterNodes	object
ClientMasterNode	array<object>	Informasi node manajemen klien. Parameter ini hanya dikembalikan untuk sistem file CPFS.
	object
DefaultPasswd	string	Kata sandi logon default node manajemen.	123456
EcsId	string	ID Instans ECS yang digunakan sebagai node manajemen.	i-hp3i3odi5ory1buo****
EcsIp	string	Alamat IP Instans ECS yang digunakan sebagai node manajemen.	192.168.1.0
DualStackMountTargetDomain	string	Domain Titik pemasangan dual-stack (IPv4 dan IPv6). Catatan Hanya sistem file Extreme NAS di wilayah di daratan Tiongkok yang mendukung IPv6.	174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com
MountTargetDomain	string	Domain Titik pemasangan.	109c042666-w****.cn-hangzhou.nas.aliyuncs.com
NetworkType	string	Jenis jaringan. Nilainya adalah vpc, yang menunjukkan virtual private cloud (VPC).	vpc
Status	string	Status Titik pemasangan. Nilai valid: Active: Tersedia. Inactive: Tidak tersedia. Pending: Tugas sedang diproses. Deleting: Titik pemasangan sedang dihapus. Hibernating: Titik pemasangan sedang memasuki hibernasi. Hibernated: Titik pemasangan sedang dalam hibernasi.	Active
Tags	object
Tag	array<object>	Informasi tag Titik pemasangan.
	object
Key	string	Kunci tag.	testKey
Value	string	Nilai tag.	testValue
VpcId	string	ID VPC yang terkait dengan Titik pemasangan. Bidang ini hanya dikembalikan untuk sistem file General-purpose NAS.	vpc-bp1sevsgtqvk5gxbl****
VswId	string	ID vSwitch yang terkait dengan Titik pemasangan. Bidang ini hanya dikembalikan untuk sistem file General-purpose NAS.	vsw-bp1omfzsszekkvaxn****
Options	object	Opsi.
EnableABE	boolean	Apakah fitur kontrol akses SMB Access-Based Enumeration (ABE) diaktifkan.	true
EnableDataInsight	boolean	Apakah fitur Lensa EBS diaktifkan.	false
EnableOplock	boolean	Apakah fitur OpLock diaktifkan. Nilai valid: true: Diaktifkan. false: Tidak diaktifkan. Catatan Hanya sistem file dengan Jenis Protokol SMB yang mendukung fitur ini.	true
VscAccessPointAccessOnly	boolean	Apakah Titik pemasangan VSC untuk komputasi AI hanya mendukung akses melalui titik akses.	false
Packages	object
Package	array<object>	Informasi paket penyimpanan.
	object
ExpiredTime	string	Waktu kedaluwarsa paket penyimpanan. Waktu mengikuti standar ISO 8601 dalam UTC. Format: yyyy-MM-ddTHH:mm:ssZ.	2020-01-05T16:00:00Z
PackageId	string	ID paket penyimpanan.	naspackage-0be9c4b624-37****
PackageType	string	Jenis paket penyimpanan. Nilai valid: ssd: Sistem file NAS Performa. hybrid: Sistem file NAS Kapasitas.	hybrid
Size	integer	Kapasitas paket penyimpanan. Unit: byte.	107374182400
StartTime	string	Waktu mulai paket penyimpanan. Waktu mengikuti standar ISO 8601 dalam UTC. Format: yyyy-MM-ddTHH:mm:ssZ.	2019-12-05T01:40:56Z
ProtocolType	string	Jenis protokol sistem file. Nilai valid: NFS: Protokol NFS. SMB: Protokol SMB. cpfs: jenis protokol yang didukung oleh sistem file CPFS atau CPFS SE.	NFS
QuorumVswId	string	ID vSwitch.	vsw-bp1omfzsszekkvaxn****
RedundancyType	string	Jenis redundansi penyimpanan. Bidang ini memiliki nilai hanya untuk sistem file CPFS SE.	ZRS
RedundancyVSwitchIds	object
RedundancyVSwitchId	array	Daftar ID vSwitch redundan zona.
	string	Daftar ID vSwitch redundan zona. Bidang ini memiliki nilai ketika RedundancyType diatur ke ZRS.	vsw-123xxx
RegionId	string	ID wilayah.	cn-hangzhou
ResourceGroupId	string	ID kelompok sumber daya.	rg-acfmwavnfef****
Status	string	Status sistem file. Nilai valid: Pending: Sistem file sedang memproses tugas. Running: Sistem file aktif. Anda dapat melakukan operasi berikutnya (seperti membuat Titik pemasangan) hanya ketika statusnya Running. Stopped: Sistem file tidak tersedia. Extending: Sistem file sedang diskalakan keluar. Stopping: Sistem file sedang dihentikan. Deleting: Sistem file sedang dihapus.	Pending
StorageType	string	Jenis penyimpanan. Nilai valid: General-purpose NAS: Capacity, Performance, atau Premium Extreme NAS: standard atau advance CPFS: advance_100 (garis dasar 100 MB/s/TiB), advance_200 (garis dasar 200 MB/s/TiB), atau economic CPFS SE: advance_100 (garis dasar 100 MB/s/TiB) AgenticFS: Agentic (hanya tersedia ketika FileSystemType diatur ke standard) CPFS for Lingjun: bm_advance_400, bm_advance_400_large, bm_advance_new, bm_advance_100, cpfslight_100, bm_p100_stepsize_300, bm_p400_stepsize_1, atau bm_p400_stepsize_300	Performance
SupportedFeatures	object
SupportedFeature	array	Fitur yang didukung oleh sistem file.
	string	Fitur yang didukung oleh sistem file. Nilai valid: Lifecycle: manajemen siklus hidup. ACL: daftar kontrol akses. Ipv6: IPv6. Catatan Saat ini, hanya sistem file Extreme NAS di wilayah di daratan Tiongkok yang mendukung IPv6.	Lifecycle
Tags	object
Tag	array<object>	Informasi tag sistem file.
	object
Key	string	Kunci tag.	testKey
Value	string	Nilai tag.	testValue
Version	string	Nomor versi sistem file. Bidang ini berlaku untuk sistem file Extreme NAS dan CPFS.	2.3.4
VpcId	string	ID VPC yang terkait dengan sistem file. Bidang ini hanya dikembalikan untuk sistem file CPFS general-purpose.	vpc-bp1sevsgtqvk5gxbl****
VscTarget	string	Catatan Parameter ini belum tersedia untuk digunakan.	cpfs-370y1tv921vpuj4****-000001.cn-wulanchabu.cpfs.aliyuncs.com
VswIds	object
VswId	array	Informasi vSwitch.
	string	ID vSwitch yang terkait dengan sistem file. Bidang ini hanya dikembalikan untuk sistem file CPFS general-purpose.	vsw-2zeu1ncsckw5mv2j481gw
ZoneId	string	Zona tempat sistem file berada.	cn-hangzhou-b
PageNumber	integer	Nomor halaman daftar sistem file.	1
PageSize	integer	Jumlah sistem file pada setiap halaman.	1
RequestId	string	ID permintaan.	035B3A3A-E514-4B41-B906-5D906CFB****
TotalCount	integer	Jumlah total sistem file.	1

Contoh

Respons sukses

JSONformat

{
  "FileSystems": {
    "FileSystem": [
      {
        "AccessPointCount": "1",
        "AutoSnapshotPolicyId": "sp-extreme-09npwxadu1eqvw****",
        "AutoUpgradeConfig": {
          "capacityUsedRatio": 80,
          "enabled": false,
          "step": 100,
          "time": 30
        },
        "Bandwidth": 150,
        "Capacity": 100,
        "ChargeType": "PayAsYouGo",
        "CreateTime": "2026-07-20T14:31:42CST",
        "Description": "test",
        "EncryptType": 1,
        "ExpiredTime": "2020-01-05T16:00:00Z",
        "FileSystemId": "109c04****",
        "FileSystemType": "standard",
        "KMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****",
        "Ldap": {
          "BindDN": "cn=alibaba,dc=com",
          "SearchBase": "dc=example",
          "URI": "ldap://ldap.example.example"
        },
        "MeteredArchiveSize": 1611661312,
        "MeteredIASize": 362832,
        "MeteredSize": 1611661312,
        "MountTargets": {
          "MountTarget": [
            {
              "AccessGroupName": "test-001",
              "ClientMasterNodes": {
                "ClientMasterNode": [
                  {
                    "DefaultPasswd": "123456",
                    "EcsId": "i-hp3i3odi5ory1buo****",
                    "EcsIp": "192.168.1.0"
                  }
                ]
              },
              "DualStackMountTargetDomain": "174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com",
              "MountTargetDomain": "109c042666-w****.cn-hangzhou.nas.aliyuncs.com",
              "NetworkType": "vpc",
              "Status": "Active",
              "Tags": {
                "Tag": [
                  {
                    "Key": "testKey",
                    "Value": "testValue"
                  }
                ]
              },
              "VpcId": "vpc-bp1sevsgtqvk5gxbl****",
              "VswId": "vsw-bp1omfzsszekkvaxn****"
            }
          ]
        },
        "Options": {
          "EnableABE": true,
          "EnableDataInsight": false,
          "EnableOplock": true,
          "VscAccessPointAccessOnly": false
        },
        "Packages": {
          "Package": [
            {
              "ExpiredTime": "2020-01-05T16:00:00Z",
              "PackageId": "naspackage-0be9c4b624-37****",
              "PackageType": "hybrid",
              "Size": 107374182400,
              "StartTime": "2019-12-05T01:40:56Z"
            }
          ]
        },
        "ProtocolType": "NFS",
        "QuorumVswId": "vsw-bp1omfzsszekkvaxn****",
        "RedundancyType": "ZRS",
        "RedundancyVSwitchIds": {
          "RedundancyVSwitchId": [
            "vsw-123xxx"
          ]
        },
        "RegionId": "cn-hangzhou",
        "ResourceGroupId": "rg-acfmwavnfef****",
        "Status": "Pending",
        "StorageType": "Performance",
        "SupportedFeatures": {
          "SupportedFeature": [
            "Lifecycle"
          ]
        },
        "Tags": {
          "Tag": [
            {
              "Key": "testKey",
              "Value": "testValue"
            }
          ]
        },
        "Version": "2.3.4",
        "VpcId": "vpc-bp1sevsgtqvk5gxbl****",
        "VscTarget": "cpfs-370y1tv921vpuj4****-000001.cn-wulanchabu.cpfs.aliyuncs.com",
        "VswIds": {
          "VswId": [
            "vsw-2zeu1ncsckw5mv2j481gw"
          ]
        },
        "ZoneId": "cn-hangzhou-b"
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 1,
  "RequestId": "035B3A3A-E514-4B41-B906-5D906CFB****",
  "TotalCount": 1
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	Region.NotSupported	The specified Region is not supported for this API now.	Fitur ini tidak didukung di wilayah saat ini.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	Sistem file yang ditentukan tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.