ModifyProtocolMountTarget - Cloud Parallel File Storage - Alibaba Cloud Documentation Center

Mengubah parameter direktori ekspor dari layanan protokol. Anda hanya dapat mengubah grup izin dan deskripsi. ID VPC dan ID vSwitch tidak dapat diubah. Untuk mengubahnya, hapus direktori ekspor lalu buat yang baru.

Deskripsi operasi

Sebelum memulai: Operasi ini hanya berlaku untuk sistem file Cloud Parallel File Storage (CPFS).
Prasyarat status: Sebelum memanggil operasi ini, direktori ekspor yang sesuai dengan ExportId harus berada dalam status AVAILABLE. Panggil DescribeProtocolMountTarget untuk mengkueri status dan tunggu hingga pembuatan selesai sebelum mencoba lagi.
Rantai dependensi:
1. Panggil DescribeFileSystems (dengan FileSystemType diatur ke cpfs) untuk mendapatkan sistem file CPFS.
2. Panggil DescribeProtocolService untuk memverifikasi bahwa layanan protokol berada dalam status Running.
3. Panggil DescribeProtocolMountTarget untuk memverifikasi bahwa direktori ekspor berada dalam status AVAILABLE.
4. Jika tidak ada direktori ekspor, panggil CreateProtocolMountTarget untuk membuatnya terlebih dahulu.

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
ProtocolServiceId	string	Yes	ID layanan protokol. Lihat Referensi API DescribeProtocolService untuk mendapatkan informasi layanan protokol.	ptc-197ed6a00f2b****
ExportId	string	Yes	ID direktori ekspor dari layanan protokol. Lihat Referensi API DescribeProtocolMountTarget untuk mendapatkan informasi direktori ekspor.	exp-19abf5beab8d****
FileSystemId	string	Yes	ID sistem file. Lihat Referensi API DescribeFileSystems (dengan FileSystemType diatur ke cpfs) untuk mendapatkan informasi sistem file.	cpfs-099394bd928c****
Description	string	No	Deskripsi direktori ekspor dari layanan protokol. Batasan: Panjang deskripsi harus 2 hingga 128 karakter. Deskripsi harus dimulai dengan huruf atau karakter Tionghoa dan tidak boleh dimulai dengan `http://` atau `https://`. Deskripsi dapat berisi angka, titik dua (:), garis bawah (_), dan tanda hubung (-).	Deskripsi direktori ekspor ini
DryRun	boolean	No	Apakah akan menjalankan dry run untuk permintaan modifikasi ini. Dry run memeriksa validitas parameter dan kondisi dependensi tanpa benar-benar mengubah direktori ekspor atau menimbulkan biaya. Nilai valid: true: Mengirim permintaan dry run tanpa mengubah direktori ekspor. Item pemeriksaan mencakup parameter wajib, format permintaan, dan kondisi dependensi bisnis. DryRun=true juga melakukan pemeriksaan status Sumber daya (termasuk persyaratan bahwa direktori ekspor berada dalam status AVAILABLE). Jika status direktori ekspor tidak memenuhi persyaratan (seperti CREATING), error yang sesuai akan dikembalikan. DryRun tidak mengabaikan pemeriksaan status. Hanya memvalidasi validitas parameter permintaan dan dependensi dasar. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode status HTTP 200 akan dikembalikan. false (default): Mengirim permintaan normal. Setelah pemeriksaan berhasil, parameter direktori ekspor langsung diubah.	true
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Hasilkan nilai unik dari klien Anda untuk memastikan bahwa permintaan berbeda memiliki nilai ClientToken yang unik. ClientToken hanya mendukung 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 dapat berbeda untuk setiap permintaan API.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

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.
400	MissingAccessGroupName	AccessGroupName is mandatory for this action.	Grup izin tidak ditentukan.
400	MissingProtocolServiceId	ProtocolServiceId is mandatory for this action.	Parameter ProtocolServiceId tidak ditentukan.
403	Instance.IncorrectStatus	The specified instance is in an incorrect status.	Operasi tidak diizinkan dalam status saat ini.
403	OperationDenied.InvalidMntStatus	The operation is denied due to invalid protocol mount targte status.
403	OperationDenied.InvalidPtcStatus	The operation is denied due to invalid protocol service status.	Status layanan protokol saat ini tidak mendukung operasi ini.
403	OperationDenied.InvalidState	The operation is denied due to invalid file system state.
403	OperationDenied.NotSupported	The operation is denied due to not supported.	Sistem file tidak mendukung layanan protokol.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	Sistem file yang ditentukan tidak ada.
404	InvalidProtocolService.NotFound	The specified protocol service does not exist.	Layanan protokol yang ditentukan tidak ada.
404	InvalidExportId.NotFound	The specified ExportId does not exist.	Direktori ekspor layanan protokol yang ditentukan tidak ada.
404	InvalidAccessGroupName.NotFound	The specified access group does not exist.	Grup izin yang ditentukan tidak ada.
404	InvalidAccessGroupName.NotAccessRule	There has no rule in access group.	Grup izin yang ditentukan tidak memiliki aturan.
404	InvalidDescription.InvalidFormat	Description format is invalid.	Format deskripsi yang ditentukan tidak valid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.