All Products
Search
Document Center

File Storage NAS:ModifyAgenticSpace

Last Updated:Sep 03, 2026

Mengubah Agentic space.

Deskripsi operasi

Prasyarat

Sebelum Anda memanggil operasi ini, selesaikan persiapan berikut:

  1. Dapatkan AgenticSpaceId: Panggil operasi CreateAgenticSpace untuk membuat Agentic space dan dapatkan AgenticSpaceId.

  2. Buat sistem file Agentic: Saat Anda memanggil operasi 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. Periksa 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 CreateAgenticSpace untuk membuat Agentic space.

    3. Panggil operasi ini (ModifyAgenticSpace) untuk mengubah konfigurasi Agentic space.

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

AgenticSpaceId

string

Yes

ID AgenticSpace.

agentic-229oypxjgpau2****

Description

string

No

Deskripsi Agentic space.

Deskripsi Agentic Space

DryRun

boolean

No

Apakah akan menjalankan dry run untuk permintaan ini.

Dry run memeriksa validitas parameter dan ketersediaan Sumber daya tanpa benar-benar membuat atau mengubah instans, dan tidak menimbulkan biaya.

Nilai valid:

  • true: Mengirim permintaan dry run tanpa mengubah instans. Item pemeriksaan mencakup parameter wajib, format permintaan, batas layanan, dan inventaris File Storage NAS. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode status HTTP 200 dikembalikan, tetapi FileSystemId kosong.

  • false (default): Mengirim permintaan normal. Setelah pemeriksaan berhasil, instans 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

RequestId

string

ID permintaan.

BC7C825C-5F65-4B56-BEF6-98C56C7C****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****"
}

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 MissingFsetId FsetId is mandatory for this action. Parameter ID Fileset tidak ditentukan.
400 InvalidFilesetId.NotFound Invalid FilesetId. Fileset tidak 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 InvalidFsetId.NotFound The specified Fileset ID does not exist. Fileset yang ditentukan tidak ada.
404 InvalidAgenticSpace.NotFound The specified AgenticSpace is not found. AgenticSpace yang ditentukan tidak ditemukan.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.