DescribeCpfsAccessPoints - Cloud Parallel File Storage - Alibaba Cloud Documentation Center

Mengkueri titik akses CPFS for Lingjun.

Deskripsi operasi

Mengkueri titik akses CPFS for Lingjun.

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

list

*Semua sumber daya

*

None

Sintaks permintaan

GET / HTTP/1.1

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah.	cn-hangzhou
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-290rg9crq96m362ups2
AccessPointId	string	No	ID titik akses.	ap-ie15yd****
PageSize	integer	No	Jumlah hasil per kueri. Nilai valid: 1 hingga 100. Nilai default: 10.	10
PageNumber	integer	No	Nomor halaman daftar.	1
		No	Daftar tag titik akses CPFS.

Elemen respons

Element	Type	Description	Example
	object	Permintaan berhasil.
RequestId	string	ID permintaan.	A323836B-5BC6-45A6-8048-60675C23****
AccessPoints	array<object>	Informasi titik akses.
	array<object>	Informasi titik akses.
RegionId	string	ID wilayah.	cn-hangzhou
ARN	string	Nama Sumber Daya Alibaba Cloud (ARN) titik akses.	acs:nas:cn-hangzhou:178321033379**:accesspoint/ap-ie15yd**
AccessPointId	string	ID titik akses.	ap-ie15y*****
Description	string	Deskripsi titik akses.	Deskripsi
FileSystemId	string	ID sistem file.	bmcpfs-290r9c75fnb0il8d8v1
CreateTime	string	Pengatur waktu ketika titik akses dibuat. Pengatur waktu mengikuti standar ISO 8601 dalam UTC. Format: yyyy-MM-ddTHH:mm:ssZ.	2026-03-28T06:32:14Z
ModifyTime	string	Pengatur waktu ketika titik akses terakhir dimodifikasi. Pengatur waktu mengikuti standar ISO 8601 dalam UTC. Format: yyyy-MM-ddTHH:mm:ssZ.	2025-03-28T06:32:14Z
Status	string	Status titik akses saat ini. Nilai valid: Active: tersedia. Inactive: tidak tersedia. Pending: sedang dibuat. Deleting: sedang dihapus. Catatan Anda dapat memasang sistem file hanya ketika statusnya Active.	Active
RootDirectory	object	Informasi direktori root.
RootPath	string	Direktori root.	/path
RootPathStatus	string	Status direktori root saat ini. Nilai valid: Unknown: status jalur root tidak diketahui. NotExist: jalur root tidak ada. Mungkin telah dihapus oleh pengguna. Ready: status jalur root normal.	Ready
Tags	array<object>	Daftar tag titik akses CPFS.
	object	Tag titik akses CPFS.
Key	string	Kunci tag titik akses CPFS.	TestKey
Value	string	Nilai tag titik akses CPFS.	TestValue
TotalCount	integer	Jumlah total titik akses.	6
PageSize	integer	Jumlah hasil per halaman. Nilai valid: 1 hingga 100. Nilai default: 10.	10
PageNumber	integer	Nomor halaman daftar.	1

Contoh

Respons sukses

JSONformat

{
  "RequestId": "A323836B-5BC6-45A6-8048-60675C23****",
  "AccessPoints": [
    {
      "RegionId": "cn-hangzhou",
      "ARN": "acs:nas:cn-hangzhou:178321033379****:accesspoint/ap-ie15yd****",
      "AccessPointId": "ap-ie15y*****\n",
      "Description": "Description",
      "FileSystemId": "bmcpfs-290r9c75fnb0il8d8v1",
      "CreateTime": "2026-03-28T06:32:14Z",
      "ModifyTime": "2025-03-28T06:32:14Z",
      "Status": "Active",
      "RootDirectory": {
        "RootPath": "/path",
        "RootPathStatus": "Ready"
      },
      "Tags": [
        {
          "Key": "TestKey",
          "Value": "TestValue"
        }
      ]
    }
  ],
  "TotalCount": 6,
  "PageSize": 10,
  "PageNumber": 1
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidRequest	The request is invalid.	Permintaan tidak valid.
400	InvalidParameter.FileSystem	Invalid FileSystem in ResourceIds.	Sistem file yang ditentukan dalam ResourceIds tidak valid.
400	InvalidFilesystemType.NotSupport	This Api does not support this fileSystem type.	Operasi saat ini tidak mendukung jenis sistem file ini.
400	FeatureOrAPI.NotSupported	The Feature/API is not supported in this region now.	Fitur atau API tidak didukung di wilayah ini.
403	Forbbiden.Ram	User not authorized to operate on the specified resource, or this API doesn't support RAM.	Verifikasi izin RAM akun Anda gagal. Buka konsol RAM untuk memastikan bahwa izin terkait NAS telah diberikan.
404	InvalidAccessPoint.NotFound	The specified AccessPoint does not exist.	Titik akses yang ditentukan tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.