GetProtocolMountTarget - Cloud Parallel File Storage - Alibaba Cloud Documentation Center

Mengkueri informasi direktori ekspor layanan protokol.

Deskripsi operasi

Mengkueri informasi direktori ekspor layanan protokol.

Sebelum Anda memulai

Sebelum memanggil operasi ini, pastikan setiap Sumber daya dependen dalam model Sumber daya tiga lapisan berikut sudah ada:

Sistem file (FileSystem): Panggil DescribeFileSystems untuk mendapatkan FileSystemId.
Layanan protokol (ProtocolService): Panggil DescribeProtocolService untuk mendapatkan ProtocolServiceId, atau panggil CreateProtocolService untuk membuatnya.
Direktori ekspor (ProtocolMountTarget): Panggil CreateProtocolMountTarget untuk membuat direktori ekspor dan mendapatkan ExportId, atau panggil DescribeProtocolMountTarget untuk mengkueri ExportId.

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
NextToken	string	No	Jika respons terpotong, Anda dapat menggunakan NextToken untuk mengirim permintaan berikutnya guna mengambil konten setelah titik pemotongan saat ini.	M18xMA==
MaxResults	integer	No	Jumlah maksimum hasil yang dikembalikan per kueri. Nilai valid: 10 hingga 100. Nilai default: 20.	20
FileSystemId	string	Yes	ID sistem file. CPFS: ID harus dimulai dengan `cpfs-`, seperti cpfs-125487**. CPFS for Lingjun: ID harus dimulai dengan `bmcpfs-`, seperti bmcpfs-0015. CPFS SE: ID harus dimulai dengan `cpfsse-`, seperti cpfsse-022c71b134**.	cpfs-099394bd928c****
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara berbagai permintaan. Token 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 secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	123e4567-e89b-12d3-a456-42665544****
ProtocolServiceId	string	Yes	ID layanan protokol. Wajib. Cara mendapatkan: Panggil operasi DescribeProtocolService untuk mengkueri daftar layanan protokol dan mendapatkan ProtocolServiceId dari tanggapan.	ptc-197ed6a00f2b****
ExportId	string	Yes	ID direktori ekspor layanan protokol. Wajib. Cara mendapatkan: Panggil CreateProtocolMountTarget untuk membuat direktori ekspor dan mendapatkan ExportId dari tanggapan. Atau panggil DescribeProtocolMountTarget untuk mengkueri daftar direktori ekspor dan mendapatkan ExportId dari tanggapan.	exp-19abf5beab8d****

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
RequestId	string	ID permintaan.	6299428C-3861-435D-AE54-9B330A00****
NextToken	string	Jika respons terpotong, Anda dapat menggunakan NextToken untuk mengirim permintaan berikutnya guna mengambil konten setelah titik pemotongan saat ini.	M18xMA==
ProtocolMountTarget	object	Informasi direktori ekspor layanan protokol.
ExportId	string	ID direktori ekspor.	exp-19abf5beab8d****
ProtocolMountTargetDomain	string	Nama domain direktori ekspor layanan protokol.	cpfs-0229cb80bcc0**-x**.cn-***.cpfs.aliyuncs.com
ProtocolType	string	Jenis protokol sistem file. Nilai valid: NFS: Protokol NFS SMB: Protokol SMB cpfs: jenis protokol yang didukung oleh sistem file CPFS	NFS
VpcId	string	ID virtual private cloud (VPC) dari ekspor layanan protokol.	vpc-bp1h5mxoqfuo3xurf****
VSwitchId	string	ID vSwitch dari ekspor layanan protokol.	vsw-8vb2qjnxs6hiobzve****
VSwitchIds	array	Daftar ID vSwitch dari ekspor layanan protokol.
	string	ID vSwitch dari ekspor layanan protokol.	vsw-bp1q3ro8erikjjrb2****
FsetId	string	ID Fileset.	fset-299b4ca04de8****
Path	string	Jalur direktori CPFS yang dikueri. Format: Panjang jalur adalah 1 hingga 1.024 karakter. Jalur dienkode dalam UTF-8. Jalur harus dimulai dan diakhiri dengan garis miring (/). Direktori root adalah `/`.	/
AccessGroupName	string	Nama grup izin. Grup izin default: DEFAULT_VPC_GROUP_NAME.	DEFAULT_VPC_GROUP_NAME
CreateTime	string	Waktu pembuatan. Format: yyyy-MM-dd HH:mm:ss	2025-12-22 17:49:25
Status	string	Status direktori ekspor layanan protokol. Nilai valid: CREATING: Sedang dibuat. AVAILABLE: Tersedia. MODIFYING: Sedang diubah. DELETING: Sedang dihapus. STOPPING: Sedang dihentikan.	AVAILABLE
Description	string	Deskripsi ekspor layanan protokol.	Deskripsi ekspor layanan protokol ini

Contoh

Respons sukses

JSONformat

{
  "RequestId": "6299428C-3861-435D-AE54-9B330A00****",
  "NextToken": "M18xMA==",
  "ProtocolMountTarget": {
    "ExportId": "exp-19abf5beab8d****",
    "ProtocolMountTargetDomain": "cpfs-0229cb80bcc0****-x******.cn-*****.cpfs.aliyuncs.com",
    "ProtocolType": "NFS",
    "VpcId": "vpc-bp1h5mxoqfuo3xurf****",
    "VSwitchId": "vsw-8vb2qjnxs6hiobzve****",
    "VSwitchIds": [
      "vsw-bp1q3ro8erikjjrb2****"
    ],
    "FsetId": "fset-299b4ca04de8****",
    "Path": "/",
    "AccessGroupName": "DEFAULT_VPC_GROUP_NAME",
    "CreateTime": "2025-12-22 17:49:25",
    "Status": "AVAILABLE",
    "Description": "此协议服务导出的描述。"
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	MissingFileSystemId	FileSystemId is mandatory for this action.	Parameter FileSystemId tidak ditentukan.
400	MissingExportId	ExportId is mandatory for this action.	Parameter ExportId tidak ditentukan.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	Sistem file yang ditentukan tidak ada.
404	Resource.NotFound	The specified resource does not exist.	Sumber daya yang ditentukan tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.