All Products
Search

This Product

    File Storage NAS:CreateAgenticSpace

    Document Center

    File Storage NAS:CreateAgenticSpace

    Last Updated:Sep 03, 2026

    Membuat ruang Agentic.

    Deskripsi operasi

    Sebelum Anda memulai

    Selesaikan persiapan berikut sebelum memanggil operasi ini:

    1. Sistem file Agentic telah dibuat: Saat memanggil CreateFileSystem untuk membuat sistem file, atur parameter berikut:

      • StorageType: Atur ke Agentic.

      • ProtocolType: Atur ke NFS.

      • Wilayah yang didukung: Tipe penyimpanan Agentic hanya tersedia di wilayah dan zona tertentu. Lihat Konsol untuk detailnya.

    Catatan penggunaan

    • Operasi ini hanya berlaku untuk sistem file Agentic.

    • Contoh rantai panggilan lengkap:

      1. Panggil CreateFileSystem untuk membuat sistem file Agentic (StorageType=Agentic, ProtocolType=NFS).

      2. Setelah sistem file dibuat (status adalah Running), panggil operasi ini CreateAgenticSpace untuk membuat ruang Agentic.

      3. Untuk mengubah konfigurasi ruang Agentic, panggil operasi ModifyAgenticSpace.

    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
    FileSystemId

    string

    Yes

    ID sistem file.

    31a8e4****
    Azone

    string

    Yes

    ID zona.

    cn-hangzhou-i
    FileSystemPath

    string

    Yes

    Jalur mutlak file. Hanya direktori tingkat pertama yang didukung.

    /path/
    Description

    string

    No

    Deskripsi ruang Agentic.

    Batasan:

    • Panjang deskripsi harus antara 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 (-).

    AgenticSpace Description
    Quota

    object

    Yes

    Informasi kuota.

    FileCountLimit

    integer

    Yes

    Jumlah maksimum file yang diizinkan oleh kuota. Nilai valid:

    • Nilai minimum: 10000.

    • Nilai maksimum: 100000000.

    10000
    SizeLimit

    integer

    Yes

    Batas kapasitas total kuota. Unit: byte.

    Nilai valid:

    • Nilai minimum: 10737418240 (10 GiB).

    • Nilai maksimum: 1099511627776000 (1024000 GiB).

    • Kenaikan: 1073741824 (1 GiB).

    10737418240
    DryRun

    boolean

    No

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

    Nilai valid:

    • true: Mengirim permintaan dry run tanpa memodifikasi layanan protokol. Sistem memeriksa apakah parameter wajib telah ditentukan, apakah format permintaan valid, dan apakah batas 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 lulus, layanan protokol langsung dimodifikasi.

    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

    RequestId

    string

    ID permintaan.

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

    string

    ID ruang Agentic. Ini adalah pengidentifikasi unik global yang ditetapkan oleh sistem setelah ruang Agentic (ruang kerja independen yang dialokasikan untuk satu pengguna akhir agen di AgenticFS) dibuat.

    agentic-229oypxjgpau2****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "AgenticSpaceId": "agentic-229oypxjgpau2****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 IllegalCharacters The parameter contains illegal characters. Parameter tidak valid.
    400 MissingFileSystemId FileSystemId is mandatory for this action. Parameter FileSystemId tidak ditentukan.
    400 MissingFileSystemPath FileSystemPath is mandatory for this action. Parameter FileSystemPath hilang.
    400 InvalidFilesystemType.NotSupport This Api does not support this fileSystem type. Operasi saat ini tidak mendukung jenis sistem file ini.
    400 InvalidFilesystemVersion.NotSupport This Api does not support this fileSystem version. Operasi saat ini tidak mendukung versi sistem file ini.
    400 InvalidRequest The request is invalid. Permintaan tidak valid.
    400 Quota.Invalid.Limit Quota limit is invalid. Kuota tidak valid.
    400 Resource.Exceed.Limit Resource exceed limit. Jumlah sumber daya melebihi batas.
    400 Resource.Check.Fail Resource check failed. Pemeriksaan sumber daya gagal.
    400 Fileset.Path.Duplicate Fileset path is duplicate. Jalur Fileset sudah ada.
    400 Fileset.Path.Nested Fileset path is nested. Jalur Fileset bersarang.
    400 Fileset.Path.NotExist Fileset.Path.Not.Exist. Jalur direktori induk Fileset tidak ada.
    400 Fileset.Path.Exist Fileset already exist. Jalur Fileset sudah ada.
    403 OperationDenied.AlreadyExists The operation is denied due to IdirName already exists in parent path. Nama direktori sudah ada di direktori induk.
    403 OperationDenied.TooManyFilesets The operation is denied due to too many fileset in filesystem. Jumlah direktori Fileset dalam sistem file melebihi ambang batas.
    403 OperationDenied.TooManyDepths The operation is denied due to Fileset path too deep. Kedalaman jalur direktori Fileset melebihi ambang batas.
    403 OperationDenied.NestedDir The operation is denied due to nested directory. Konfigurasi pembaruan otomatis tidak dapat dibuat karena direktori bersarang ada.
    403 OperationDenied.DependencyViolation The operation is denied due to dependancy violation. Kondisi untuk operasi ini tidak terpenuhi.
    403 OperationDenied.FilesetNotSupported The operation is not supported. Sistem file tidak mendukung Fileset.
    404 InvalidFileSystem.NotFound The specified file system does not exist. Sistem file yang ditentukan tidak ada.
    404 InvalidFileSystemPath.ParentNotFound The specified parent path does not exist. Direktori induk yang ditentukan tidak ada.
    404 InvalidFileSystemPath.NotDirectory The specified idir parent path is not directory. Direktori induk yang ditentukan bukan merupakan direktori.
    404 InvalidFileSystemPath.InvalidCharacters The specified fileset path contains invalid characters. Jalur Fileset yang ditentukan berisi karakter tidak valid.
    404 InvalidFilesetPath.InvalidParameter Fileset path is invalid. Jalur fileset yang ditentukan tidak valid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.