All Products
Search

This Product

    Cloud Parallel File Storage:CreateProtocolMountTarget

    Document Center

    Cloud Parallel File Storage:CreateProtocolMountTarget

    Last Updated:Sep 08, 2026

    Membuat direktori ekspor untuk layanan protokol.

    Deskripsi operasi

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

    • Sebelum memulai

      Sistem file CPFS target harus berada dalam status Berjalan, dan layanan protokol harus telah dibuat.

    • Informasi lainnya

      • Blok CIDR VPC dari ekspor layanan protokol tidak boleh tumpang tindih dengan Blok CIDR VPC sistem file.

      • Blok CIDR VPC dari beberapa ekspor pada layanan protokol yang sama tidak boleh saling tumpang tindih.

      • Anda dapat membuat hingga 10 direktori ekspor untuk satu layanan protokol.

      • Pembuatan direktori ekspor layanan protokol mengonsumsi alamat IP dari vSwitch yang ditentukan (hingga 32 alamat IP). Pastikan vSwitch target memiliki resource alamat IP yang mencukupi.

    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.

    ptc-197ed6a00f2b****
    FileSystemId

    string

    Yes

    ID sistem file.

    Catatan

    Sistem file CPFS target harus berada dalam status Berjalan sebelum Anda memanggil operasi ini. Setelah pembuatan, diperlukan waktu sekitar 20 hingga 40 menit agar sistem file mencapai status Berjalan. Anda dapat memanggil DescribeFileSystems untuk melakukan polling pada bidang Status (Berjalan menunjukkan siap).

    cpfs-099394bd928c****
    VpcId

    string

    No

    ID VPC untuk ekspor layanan protokol.

    Catatan

    Blok CIDR VPC yang dipilih tidak boleh tumpang tindih dengan Blok CIDR VPC sistem file CPFS target. Anda dapat memanggil operasi DescribeVpcs dari VPC untuk mengkueri bidang CidrBlock setiap VPC sebagai perbandingan, dan memilih VPC yang tidak konflik dan berada di zona yang sama dengan sistem file.

    vpc-2vct297b8157bth9z****
    VSwitchId

    string

    No

    ID vSwitch untuk ekspor layanan protokol.

    Jika tipe redundansi penyimpanan sistem file bukan zone-redundant storage (ZRS), parameter ini wajib diisi saat VpcId ditentukan.

    Catatan

    vSwitch harus berada di zona yang sama dengan sistem file CPFS target (nilai ZoneId harus cocok). Anda dapat memanggil DescribeFileSystems untuk mengkueri bidang ZoneId sistem file, lalu memilih vSwitch di zona yang sama.

    vsw-2vc3c2lybvdllxyq4****
    FsetId

    string

    No

    ID fileset yang akan diekspor.

    Batasan:

    • Fileset harus sudah ada.

    • Hanya satu direktori ekspor yang dapat dibuat untuk setiap fileset.

    • Anda harus menentukan tepat satu dari FsetId dan Path.

    fset-1902718ea0ae****
    Path

    string

    No

    Jalur direktori CPFS yang akan diekspor.

    Batasan:

    • Direktori harus sudah ada pada sistem file CPFS.

    • Hanya satu ekspor yang dapat dibuat untuk direktori yang sama.

    • Anda harus menentukan tepat satu dari FsetId dan Path.

    Format:

    • Panjang jalur harus 1 hingga 1.024 karakter.

    • Jalur harus dienkode dalam UTF-8.

    • Jalur harus diawali dan diakhiri dengan garis miring (/). Direktori root adalah /.

    /
    AccessGroupName

    string

    No

    Nama grup izin.

    Nilai default: DEFAULT_VPC_GROUP_NAME.

    DEFAULT_VPC_GROUP_NAME
    Description

    string

    No

    Deskripsi direktori ekspor layanan protokol. Ini ditampilkan sebagai Nama Direktori Ekspor di Konsol.

    Batasan:

    • Panjang deskripsi harus 2 hingga 128 karakter dan dapat berisi huruf serta karakter Tionghoa.

    • Deskripsi harus diawali dengan huruf atau karakter Tionghoa. Tidak dapat diawali dengan http:// atau https://.

    • Deskripsi dapat berisi angka, titik dua (:), garis bawah (_), dan tanda hubung (-).

    Deskripsi direktori ekspor ini
    ClientToken

    string

    No

    Memastikan idempotensi permintaan. Buat nilai parameter dari Klien Anda untuk memastikan nilai tersebut unik di berbagai permintaan.

    ClientToken hanya mendukung karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dapat berbeda untuk setiap permintaan API.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    DryRun

    boolean

    No

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

    Nilai valid:

    • true: Mengirim permintaan dry run tanpa membuat direktori ekspor. Item pemeriksaan mencakup apakah parameter wajib ditentukan, format permintaan, dan dependensi batas bisnis. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode status HTTP 200 dikembalikan, tetapi ExportId kosong.

    • false (default): Mengirim permintaan normal. Setelah pemeriksaan berhasil, instans langsung dibuat.

    true
    VSwitchIds

    array

    No

    Daftar ID vSwitch untuk ekspor layanan protokol.

    string

    No

    Daftar ID vSwitch untuk ekspor layanan protokol.

    Jika tipe redundansi penyimpanan sistem file adalah zone-redundant storage (ZRS), Anda harus menentukan ID vSwitch di tiga zona berbeda dalam VPC saat VpcId ditentukan.

    vsw-123xxx

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    ExportId

    string

    ID direktori ekspor layanan protokol.

    exp-19abf5beab8d****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "ExportId": "exp-19abf5beab8d****"
}

    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 InvalidVSwitchId.IpShortage The specified vswitch ip shortage.
    403 InvalidFset.InUse Fset already used by other export. Fileset yang ditentukan sudah digunakan.
    403 MntPathConflict.InvalidParam FilesetId and Path must and can only be specified one. Tepat satu dari Fileset dan Path harus ditentukan.
    403 OperationDenied.TooManyDepth The operation is denied due to Fsets path too deep. Kedalaman jalur direktori cerdas melebihi ambang batas.
    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.CrossVPCExceedLimit Cross vpc mount exceed limit. Jumlah direktori ekspor lintas VPC telah melebihi batas atas spesifikasi layanan protokol saat ini.
    403 OperationDenied.NoMountTargetQuota No mount target quota on this protocol service. Kuota direktori ekspor layanan protokol telah habis.
    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 InvalidVpcId.ConflictVpcCidr Vpc cidr conflict with file system Blok CIDR dari VPC yang ditentukan tumpang tindih dengan Blok CIDR dari VPC sistem file.
    404 InvalidFsetId.NotFound The specified fileset ID does not exist.
    404 Fset.IncorrectStatus The specified fset is in an incorrect status. Fileset yang ditentukan tidak tersedia.
    404 InvalidFileSystemPath.InvalidCharacters The specified fileset path contains invalid characters. Jalur Fileset yang ditentukan berisi karakter tidak valid.
    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.
    404 InvalidParameter.VpcNotFound The specified VPC does not exist. VPC yang ditentukan tidak ada.
    404 InvalidParameter.VswNotFound The specified VSwitch does not exist.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.