DescribeAgenticSpaces - File Storage NAS - Alibaba Cloud Documentation Center

Mengkueri Agentic space.

Deskripsi operasi

Berlaku untuk sistem file Agentic.

Sebelum Anda memulai

Sebelum memanggil operasi ini, buat resource dalam urutan berikut:

Membuat sistem file Agentic: Panggil CreateFileSystem untuk membuat sistem file dengan parameter berikut:
- StorageType: Atur ke Agentic.
- ProtocolType: Atur ke NFS.
- Wilayah yang didukung: Jenis penyimpanan Agentic hanya tersedia di wilayah dan zona tertentu. Lihat Konsol untuk detailnya.
Mengkueri daftar AgenticSpace: Setelah sistem file dibuat (status Berjalan), panggil operasi DescribeAgenticSpaces ini untuk mengkueri daftar AgenticSpaces dalam sistem file.
- Jika AgenticSpaces telah dibuat dalam sistem file, daftar lengkap akan dikembalikan.
- Jika tidak ada AgenticSpaces yang dibuat dalam sistem file, daftar kosong akan dikembalikan.

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.	1ca404****
Filters	array<object>	No	Kumpulan kondisi filter.
	object	No	Kondisi filter.
Key	string	No	Nama kunci filter. Nilai valid: AgenticSpaceIds Valid values: AgenticSpaceIds : Nama filter untuk kumpulan ID AgenticSpace.	AgenticSpaceIds
Value	string	No	Nilai kunci filter. Wildcard tidak didukung. AgenticSpaceIds: Hanya satu ID yang dapat ditentukan.	06229oypxjgox0u****
NextToken	string	No	Token paginasi. Atur parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya.	MTc3OTkzNTA0Mjg0NTc1MDI4OCM0MDQ0MzA****=
MaxResults	integer	No	Jumlah hasil per kueri. Nilai valid: 10 hingga 100. Nilai default: 20.	20

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	BC7C825C-5F65-4B56-BEF6-98C56C7C****
NextToken	string	Token paginasi. Atur parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya.	MTc2NTg1MTUyMzA1OTczNTc1OCM0NjQxMzQ****=
AgenticSpaces	object
AgenticSpace	array<object>	Informasi AgenticSpace.
	array<object>	Informasi AgenticSpace.
FileSystemId	string	ID sistem file.	0322djegiekcia5****
AgenticSpaceId	string	ID AgenticSpace.	agentic-229oypxjgpau2****
Description	string	Deskripsi AgenticSpace.	Description
FileSystemPath	string	Jalur mutlak file.	/test/
Azone	string	ID zona.	cn-hangzhou-i
Status	string	Status AgenticSpace. Nilai valid: Running	Running
CreateTimeUtc	string	Waktu pembuatan AgenticSpace. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ.	2026-06-10T10:08:08Z
UpdateTimeUtc	string	Waktu pembaruan terakhir AgenticSpace. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ.	2026-06-10T10:08:08Z
Quota	object	Informasi Kuota.
FileCountLimit	integer	Jumlah maksimum file yang diizinkan oleh Kuota. Nilai valid: Nilai minimum: 10.000. Nilai maksimum: 100.000.000.	10000000
SizeLimit	integer	Kapasitas total maksimum yang diizinkan oleh Kuota. Unit: byte. Nilai valid: Nilai minimum: 10.737.418.240 (10 GiB). Nilai maksimum: 1.099.511.627.776.000 (1.024.000 GiB). Kenaikan: 1.073.741.824 (1 GiB).	10737418240
FileCountUsage	integer	Jumlah file yang digunakan.	100
SpaceUsage	integer	Kapasitas yang digunakan. Unit: byte.	1024

Contoh

Respons sukses

JSONformat

{
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "NextToken": "MTc2NTg1MTUyMzA1OTczNTc1OCM0NjQxMzQ****=",
  "AgenticSpaces": {
    "AgenticSpace": [
      {
        "FileSystemId": "0322djegiekcia5****",
        "AgenticSpaceId": "agentic-229oypxjgpau2****",
        "Description": "Description",
        "FileSystemPath": "/test/",
        "Azone": "cn-hangzhou-i",
        "Status": "Running",
        "CreateTimeUtc": "2026-06-10T10:08:08Z",
        "UpdateTimeUtc": "2026-06-10T10:08:08Z",
        "Quota": {
          "FileCountLimit": 10000000,
          "SizeLimit": 10737418240
        },
        "FileCountUsage": 100,
        "SpaceUsage": 1024
      }
    ]
  }
}

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	InvalidParameter.SortOrder	Invalid sort order.	Parameter SortOrder tidak valid.
400	InvalidParameter.SortOrderField	Invalid sort order field.	Parameter SortOrderField tidak valid.
400	InvalidFilesystemType.NotSupport	The API operation does not support the file system type.	Operasi saat ini tidak mendukung jenis sistem file ini.
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	InvalidFilterParam	The specified Filter.N.Key is invalid.	Parameter Filter.N.Key yang ditentukan tidak valid.
404	InvalidFilterValue	The specified Filter.N.Value is invalid.	Nilai Filter.1.Value tidak valid.
404	InvalidParameter.InvalidNextToken	The specified NextToken is invaild.
404	InvalidParameter.InvalidMaxResults	The specified MaxResults is invalid.	Nilai MaxResults yang ditentukan tidak valid.
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.