エージェントスペースを作成します。
操作説明
開始前に
この操作の呼び出しの前に、以下の準備を完了してください。
- エージェントファイルシステムが作成されていること: CreateFileSystem 開発者リファレンス を呼び出してファイルシステムを作成する際、以下のパラメーターをセットします。
FileSystemType:standardにセットします。StorageType:Agenticにセットします。ProtocolType:NFSにセットします。サポートされているリージョン: エージェントストレージタイプは、特定のリージョンとゾーンでのみ利用可能です。利用可能なリージョンとゾーンをビューするには、NAS コンソール に移動するか、Alibaba Cloud テクニカルサポートの連絡先に問い合わせて、サポートされているリージョンの最新リストを入手してください。
使用上の注意
この操作は、エージェントファイルシステムにのみ適用されます。
- 完全な呼び出しチェーンの例:
CreateFileSystem を呼び出して、エージェントファイルシステム (FileSystemType=standard、StorageType=Agentic、ProtocolType=NFS) を作成します。
ファイルシステムが作成され、そのステータスが Running に変更された後、この CreateAgenticSpace 操作を呼び出してエージェントスペースを作成します。
エージェントスペースの構成を変更するには、ModifyAgenticSpace 開発者リファレンス 操作を呼び出します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
nas:CreateAgenticSpace |
create |
*Fileset。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| FileSystemId |
string |
必須 |
ファイルシステムの ID。 |
31a8e4**** |
| Azone |
string |
必須 |
ゾーンの ID。 |
cn-hangzhou-i |
| FileSystemPath |
string |
必須 |
ファイルの絶対パス。第 1 レベルのディレクトリのみサポートされます。 |
/path/ |
| Description |
string |
任意 |
エージェントスペースの説明。 使用制限:
|
AgenticSpace Description |
| Quota |
object |
必須 |
クォータ情報のフォーマット。 |
|
| FileCountLimit |
integer |
必須 |
クォータで許可されるファイルの最大数。有効な値:
|
10000 |
| SizeLimit |
integer |
必須 |
クォータの合計容量制限。単位: バイト。 有効な値:
|
10737418240 |
| DryRun |
boolean |
任意 |
変更リクエストに対してドライランを実行するかどうかを指定します。ドライランでは、実際にインスタンスを変更済み状態にしたり、料金を発生させたりすることなく、パラメーターと依存関係の有効性を確認します。 有効な値:
|
false |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用して値を生成でき、異なるリクエストの呼び出し間で値が一意であることを確認する必要があります。 クライアントトークンのフォーマットは ASCII 文字のみを使用でき、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」を参照してください。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。各 API リクエストの RequestId は異なる場合があります。 |
123e4567-e89b-12d3-a456-42665544**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID。 |
98696EF0-1607-4E9D-B01D-F20930B6**** |
| AgenticSpaceId |
string |
Agentic スペースの ID。Agentic スペース (AgenticFS 内の単一のエージェントエンドユーザーに割り当てられる独立したワークスペース) が作成された後、システムはこのグローバルに一意な識別子をスペースに割り当てます。 |
agentic-229oypxjgpau2**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
"AgenticSpaceId": "エージェント-229oypxjgpau2****"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | IllegalCharacters | The parameter contains illegal characters. | パラメーターが無効です。 |
| 400 | MissingFileSystemId | FileSystemId is mandatory for this action. | FileSystemId パラメーターが指定されていません。 |
| 400 | MissingFileSystemPath | FileSystemPath is mandatory for this action. | FileSystemPath パラメーターがありません。 |
| 400 | InvalidFilesystemType.NotSupport | This Api does not support this fileSystem type. | 現在の API オペレーションでは、このタイプのファイルシステムはサポートされていません。 |
| 400 | InvalidFilesystemVersion.NotSupport | This Api does not support this fileSystem version. | 現在の API オペレーションでは、このファイルシステムのバージョンはサポートされていません。 |
| 400 | InvalidRequest | The request is invalid. | リクエストが無効です。 |
| 400 | Quota.Invalid.Limit | Quota limit is invalid. | クォータは無効です。 |
| 400 | Resource.Exceed.Limit | Resource exceed limit. | リソース数が制限を超えています。 |
| 400 | Resource.Check.Fail | Resource check failed. | リソースのチェックが失敗したことを示します。 |
| 400 | Fileset.Path.Duplicate | Fileset path is duplicate. | Fileset パスはすでに存在します。 |
| 400 | Fileset.Path.Nested | Fileset path is nested. | Fileset パスがネストされています。 |
| 400 | Fileset.Path.NotExist | Fileset.Path.Not.Exist. | Fileset の親ディレクトリパスが存在しません。 |
| 400 | Fileset.Path.Exist | Fileset already exist. | Fileset パスはすでに存在します。 |
| 403 | OperationDenied.AlreadyExists | The operation is denied due to IdirName already exists in parent path. | 指定されたディレクトリ名は、親ディレクトリ内に既に存在します。 |
| 403 | OperationDenied.TooManyFilesets | The operation is denied due to too many fileset in filesystem. | ファイルシステム内の Fileset ディレクトリの数がしきい値を超えています。 |
| 403 | OperationDenied.TooManyDepths | The operation is denied due to Fileset path too deep. | Fileset ディレクトリのパスの深さがしきい値を超えています。 |
| 403 | OperationDenied.NestedDir | The operation is denied due to nested directory. | ネストされたディレクトリが存在するため、自動更新構成を作成できません。 |
| 403 | OperationDenied.DependencyViolation | The operation is denied due to dependancy violation. | この操作の前提条件が満たされていません。 |
| 403 | OperationDenied.FilesetNotSupported | The operation is not supported. | ファイルシステムでは fileset がサポートされていません。 |
| 404 | InvalidFileSystem.NotFound | The specified file system does not exist. | 指定されたファイルシステムが存在しません。 |
| 404 | InvalidFileSystemPath.ParentNotFound | The specified parent path does not exist. | 指定された親ディレクトリが存在しません。 |
| 404 | InvalidFileSystemPath.NotDirectory | The specified idir parent path is not directory. | 指定された親ディレクトリはディレクトリではありません。 |
| 404 | InvalidFileSystemPath.InvalidCharacters | The specified fileset path contains invalid characters. | 指定されたファイルセットパスに無効な文字が含まれています。 |
| 404 | InvalidFilesetPath.InvalidParameter | Fileset path is invalid. | 指定されたファイルセットのパスは無効です。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。