查詢 Agentic 空間。
介面說明
適用於 agentic 類型檔案系統。
前置條件
呼叫本介面前，需按以下順序完成資源建立：
-
建立 Agentic 類型檔案系統：呼叫 CreateFileSystem 建立檔案系統時，需設定以下參數：
StorageType：設定為AgenticProtocolType：設定為NFS支援的地域（Region）：Agentic 儲存類型僅在部分地域和可用區開放，具體以主控台為準。
-
查詢 AgenticSpace 清單：在檔案系統建立完成後（狀態為 Running），呼叫本介面 DescribeAgenticSpaces 查詢該檔案系統下的 AgenticSpace 清單。
如果該檔案系統下已建立 AgenticSpace，傳回完整清單
如果該檔案系統下未建立 AgenticSpace，傳回空清單
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| FileSystemId |
string |
是 |
檔案系統 ID。 |
1ca404**** |
| Filters |
array<object> |
否 |
篩選鍵的資訊合集。 |
|
|
object |
否 |
篩選鍵的資訊。 |
||
| Key |
string |
否 |
篩選鍵的名稱。取值：
枚舉值：
|
AgenticSpaceIds |
| Value |
string |
否 |
篩選鍵的值。該參數不支援萬用字元。
|
06229oypxjgox0u**** |
| NextToken |
string |
否 |
查詢憑證（Token），取值為上一次 API 呼叫傳回的 NextToken 參數值。 |
MTc3OTkzNTA0Mjg0NTc1MDI4OCM0MDQ0MzA****= |
| MaxResults |
integer |
否 |
每次查詢結果的個數。 取值範圍：10~100。預設值：20。 |
20 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
BC7C825C-5F65-4B56-BEF6-98C56C7C**** |
| NextToken |
string |
查詢憑證（Token），取值為上一次 API 呼叫傳回的 NextToken 參數值。 |
MTc2NTg1MTUyMzA1OTczNTc1OCM0NjQxMzQ****= |
| AgenticSpaces |
object |
||
| AgenticSpace |
array<object> |
AgenticSpace 資訊。 |
|
|
array<object> |
AgenticSpace 資訊。 |
||
| FileSystemId |
string |
檔案系統 ID。 |
0322djegiekcia5**** |
| AgenticSpaceId |
string |
AgenticSpace Id。 |
agentic-229oypxjgpau2**** |
| Description |
string |
AgenticSpace 描述。 |
Description |
| FileSystemPath |
string |
檔案絕對路徑。 |
/test/ |
| Azone |
string |
可用區 ID。 |
cn-hangzhou-i |
| Status |
string |
AgenticSpace 的狀態。取值：
|
Running |
| CreateTimeUtc |
string |
AgenticSpace 建立時間。執行 ISO8601 標準表示，傳回格式：yyyy-MM-ddTHH:mm:ssZ。 |
2026-06-10T10:08:08Z |
| UpdateTimeUtc |
string |
AgenticSpace 更新時間。執行 ISO8601 標準表示，傳回格式：yyyy-MM-ddTHH:mm:ssZ。 |
2026-06-10T10:08:08Z |
| Quota |
object |
配額資訊。 |
|
| FileCountLimit |
integer |
配額檔案數量限制。取值範圍：
|
10000000 |
| SizeLimit |
integer |
配額總容量限制。單位：Byte。 取值範圍：
|
10737418240 |
| FileCountUsage |
integer |
檔案數量使用量。 |
100 |
| SpaceUsage |
integer |
容量使用量。單位：Byte。 |
1024 |
樣本
正常返回樣本
JSON格式
{
"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
}
]
}
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | IllegalCharacters | The parameter contains illegal characters. | 參數無效。 |
| 400 | MissingFileSystemId | FileSystemId is mandatory for this action. | 未指定 FileSystemId 參數。 |
| 400 | InvalidParameter.SortOrder | Invalid sort order. | 參數 SortOrder 錯誤。 |
| 400 | InvalidParameter.SortOrderField | Invalid sort order field. | 參數 SortOrderField 錯誤。 |
| 400 | InvalidFilesystemType.NotSupport | The API operation does not support the file system type. | 目前介面不支援該類型檔案系統。 |
| 403 | OperationDenied.FilesetNotSupported | The operation is not supported. | 該檔案系統不支援 Fileset。 |
| 404 | InvalidFileSystem.NotFound | The specified file system does not exist. | 指定的檔案系統不存在。 |
| 404 | InvalidFilterParam | The specified Filter.N.Key is invalid. | 指定的 Filter.N.Key 參數非法。 |
| 404 | InvalidFilterValue | The specified Filter.N.Value is invalid. | Filter.1.Value 值非法。 |
| 404 | InvalidParameter.InvalidNextToken | The specified NextToken is invaild. | |
| 404 | InvalidParameter.InvalidMaxResults | The specified MaxResults is invalid. | 指定的 MaxResults 非法。 |
| 404 | InvalidAgenticSpace.NotFound | The specified AgenticSpace is not found. | 找不到指定的 AgenticSpace。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。