Agentic スペースを照会します。
操作説明
Agentic ファイルシステムに適用されます。
開始する前に
この操作を呼び出す前に、次の順序でリソースを作成する必要があります。
-
Agentic ファイルシステムの作成: CreateFileSystem (開発者リファレンス) を呼び出してファイルシステムを作成するときは、次のパラメーターを設定する必要があります。
StorageType: 値をAgenticに設定します。ProtocolType: 値をNFSに設定します。サポートされているリージョン: Agentic ストレージタイプは、特定のリージョンとゾーンでのみ使用できます。詳細については、コンソールを参照してください。
-
AgenticSpace リストのクエリ: ファイルシステムが作成され、そのステータスが Running に変わったら、DescribeAgenticSpaces 操作を呼び出して、ファイルシステム内の Agentic スペースをクエリします。
ファイルシステム内に Agentic スペースが作成されている場合は、完全なリストが返されます。
ファイルシステム内に Agentic スペースが作成されていない場合は、空のリストが返されます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
nas:DescribeAgenticSpaces |
list |
*ファイルシステム。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| FileSystemId |
string |
必須 |
ファイルシステムの ID。 |
1ca404**** |
| Filters |
array<object> |
任意 |
フィルターフォーマットのコレクション。 |
|
|
object |
任意 |
フィルターフォーマット。 |
||
| Key |
string |
任意 |
フィルターキーの名前。有効な値:
列挙値:
|
AgenticSpaceIds |
| Value |
string |
任意 |
フィルターキーの値。このパラメーターではワイルドカードはサポートされていません。
|
06229oypxjgox0u**** |
| NextToken |
string |
任意 |
クエリトークン。値は、前の API 呼び出しから返された NextToken 値です。 |
MTc3OTkzNTA0Mjg0NTc1MDI4OCM0MDQ0MzA****= |
| MaxResults |
integer |
任意 |
クエリごとに返すエントリ数。 有効な値: 10 ~ 100。デフォルト値: 20。 |
20 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| AgenticSpaces |
object |
||
| AgenticSpace |
array<object> |
Agentic スペースフォーマット。 |
|
|
array<object> |
Agentic スペースフォーマット。 |
||
| AgenticSpaceId |
string |
AgenticSpace の ID。 |
agentic-229oypxjgpau2**** |
| Azone |
string |
ゾーンの ID。 |
cn-hangzhou-i |
| CreateTimeUtc |
string |
Agentic スペースが作成された時間。時間は ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ フォーマットに従います。 |
2026-06-10T10:08:08Z |
| Description |
string |
Agentic スペースの説明。 |
Description |
| FileCountUsage |
integer |
使用されているファイル数。 |
100 |
| FileSystemId |
string |
ファイルシステムの ID。 |
0322djegiekcia5**** |
| FileSystemPath |
string |
ファイルの絶対パス。 |
/test/ |
| Quota |
object |
クォータフォーマット。 |
|
| FileCountLimit |
integer |
クォータのファイル数制限。有効な値:
|
10000000 |
| SizeLimit |
integer |
クォータの合計容量制限。単位: バイト。 有効な値:
|
10737418240 |
| SpaceUsage |
integer |
使用済み容量。単位: バイト。 |
1024 |
| Status |
string |
Agentic スペースのステータス。有効な値:
|
Running |
| UpdateTimeUtc |
string |
Agentic スペースが更新された時間。時間は ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ フォーマットに従います。 |
2026-06-10T10:08:08Z |
| NextToken |
string |
クエリトークン。値は、前の API 呼び出しから返された NextToken 値です。 |
MTc2NTg1MTUyMzA1OTczNTc1OCM0NjQxMzQ****= |
| RequestId |
string |
リクエストの ID。 |
BC7C825C-5F65-4B56-BEF6-98C56C7C**** |
例
成功レスポンス
JSONJSON
{
"AgenticSpaces": {
"AgenticSpace": [
{
"AgenticSpaceId": "agentic-229oypxjgpau2****",
"Azone": "cn-hangzhou-i",
"CreateTimeUtc": "2026-06-10T10:08:08Z",
"Description": "Description",
"FileCountUsage": 100,
"FileSystemId": "0322djegiekcia5****",
"FileSystemPath": "/test/",
"Quota": {
"FileCountLimit": 10000000,
"SizeLimit": 10737418240
},
"SpaceUsage": 1024,
"Status": "Running",
"UpdateTimeUtc": "2026-06-10T10:08:08Z"
}
]
},
"NextToken": "MTc2NTg1MTUyMzA1OTczNTc1OCM0NjQxMzQ****=",
"RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 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. | 現在の API オペレーションでは、このタイプのファイルシステムはサポートされていません。 |
| 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 が見つかりませんでした。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。