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

*All Resource

*

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

Elemen respons

Element	Type	Description	Example
	object	Kueri 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) dari titik akses.	acs:nas:cn-hangzhou:178321033379**:accesspoint/ap-ie15yd**
AccessPointId	string	ID titik akses.	ap-ie15y*****
Description	string	Deskripsi titik akses.	Description
FileSystemId	string	ID sistem file.	bmcpfs-290r9c75fnb0il8d8v1
CreateTime	string	Waktu pembuatan titik akses. Waktu mengikuti standar ISO 8601 dalam UTC. Format: yyyy-MM-ddTHH:mm:ssZ.	2026-03-28T06:32:14Z
ModifyTime	string	Waktu terakhir modifikasi titik akses. Waktu mengikuti standar ISO 8601 dalam UTC. Format: yyyy-MM-ddTHH:mm:ssZ.	2025-03-28T06:32:14Z
Status	string	Status saat ini dari titik akses. Nilai valid: Active: tersedia Inactive: tidak tersedia Pending: sedang dibuat Deleting: sedang dihapus Catatan Sistem file hanya dapat dimount ketika statusnya Active.	Active
RootDirectory	object	Informasi direktori root.
RootPath	string	Direktori root.	/path
RootPathStatus	string	Status saat ini dari direktori root. Nilai valid: Unknown: Status jalur root tidak diketahui. NotExist: Jalur root tidak ada. Mungkin telah dihapus oleh pengguna. Ready: Status jalur root normal.	Ready
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"
      }
    }
  ],
  "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.
400	InvalidFilesystemType.NotSupport	This Api does not support this fileSystem type.	Operasi saat ini tidak mendukung tipe sistem file ini.
400	FeatureOrAPI.NotSupported	The Feature/API is not supported in this region now.
403	Forbbiden.Ram	User not authorized to operate on the specified resource, or this API doesn't support RAM.	Pengguna tidak diizinkan untuk melakukan operasi pada Sumber daya yang ditentukan, atau API ini tidak mendukung RAM.
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.