All Products
Search

This Product

    Cloud Parallel File Storage:ModifyProtocolService

    Document Center

    Cloud Parallel File Storage:ModifyProtocolService

    Last Updated:Sep 03, 2026

    Mengubah layanan protokol. Anda dapat mengubah deskripsi layanan protokol.

    Deskripsi operasi

    Operasi ini hanya berlaku untuk sistem file Cloud Parallel File Storage (CPFS).

    • Operasi ini memungkinkan Anda mengubah deskripsi layanan protokol.

    • Anda dapat memperoleh ID layanan protokol (ProtocolServiceId) dengan menggunakan salah satu metode berikut:

    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. Anda dapat memperoleh ID layanan protokol dari tanggapan operasi CreateProtocolService, atau mencarinya dengan memanggil operasi DescribeProtocolService.

    ptc-197ed6a00f2b****
    FileSystemId

    string

    Yes

    ID sistem file.

    cpfs-099394bd928c****
    Description

    string

    No

    Deskripsi 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 (_), atau tanda hubung (-).

    • Spasi dan karakter khusus lainnya tidak diperbolehkan. Contoh valid: My-Protocol-Service_01.

    My-Protocol-Service_01
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run untuk permintaan modifikasi ini. Dry run memeriksa validitas parameter dan dependensi tanpa benar-benar mengubah instans atau menimbulkan biaya.

    Nilai valid:

    • true: Mengirim permintaan dry run tanpa mengubah layanan protokol. Dry run memeriksa apakah parameter wajib telah ditentukan, apakah format permintaan valid, dan apakah batasan bisnis serta dependensi terpenuhi. 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, layanan protokol langsung diubah.

    false
    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****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    98696EF0-1607-4E9D-B01D-F20930B6****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 MissingFileSystemId FileSystemId is mandatory for this action. Parameter FileSystemId 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 InvalidProtocolSpec.NotSupported The specified protocol spec does not supported. ProtocolSpec yang ditentukan tidak didukung.
    403 PermissionDenied.ThroughputInvalid Standard protocol service should not specified throughput. Layanan protokol serbaguna tidak memungkinkan Anda menentukan bandwidth layanan.
    403 InvalidVSwitchId.IpShortage The specified vswitch ip shortage.
    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.
    403 PermissionDenied.CLThroughputInvalid Throughput of caching protocol service is invalid. Bandwidth layanan protokol jenis cache tidak valid.
    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 InvalidDescription.InvalidFormat Description format is invalid. Format deskripsi yang ditentukan tidak valid.
    404 OperationDenied.NoStock The operation is denied due to no stock. Sistem file habis stok.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.