CreateAgenticSpace - - Alibaba Cloud Dokümantasyon Merkezi

Bir Agentic alanı oluşturur.

Operation description

Başlamadan önce

Bu işlemi çağırmadan önce aşağıdaki hazırlıkları tamamlayın:

Bir Agentic dosya sistemi oluşturulur: Bir dosya sistemi oluşturmak için CreateFileSystem çağrısı yaparken aşağıdaki parametreleri ayarlayın:
- StorageType: Agentic olarak ayarlayın.
- ProtocolType: NFS olarak ayarlayın.
- Desteklenen bölgeler: Agentic depolama türü yalnızca belirli bölgelerde ve kullanılabilirlik bölgelerinde kullanılabilir. Ayrıntılar için konsolu kontrol edin.

Kullanım notları

Bu işlem yalnızca Agentic dosya sistemleri için geçerlidir.
Tam çağrı zinciri örneği:
1. Bir Agentic dosya sistemi oluşturmak için CreateFileSystem çağrısı yapın (StorageType=Agentic, ProtocolType=NFS).
2. Dosya sistemi oluşturulduktan sonra (durum Running olduğunda), bir Agentic alanı oluşturmak için bu CreateAgenticSpace işlemini çağırın.
3. Agentic alanı yapılandırmasını değiştirmek için ModifyAgenticSpace işlemini çağırın.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

nas:CreateAgenticSpace

create

*Fileset

acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

None

Request parameters

Parameter	Type	Required	Description	Example
FileSystemId	string	Yes	Dosya sistemi kimliği.	31a8e4****
Azone	string	Yes	Kullanılabilirlik bölgesi kimliği.	cn-hangzhou-i
FileSystemPath	string	Yes	Dosyanın mutlak yolu. Yalnızca birinci düzey dizinler desteklenir.	/path/
Description	string	No	Agentic alanının açıklaması. Sınırlar: Açıklama 2 ila 128 karakter uzunluğunda olmalıdır. Açıklama bir harf veya Çince karakterle başlamalıdır ve `http://` veya `https://` ile başlayamaz. Açıklama rakamlar, iki nokta üst üste (:), alt çizgi (_) veya tire (-) içerebilir.	AgenticSpace Description
Quota	object	Yes	Kota bilgileri.
FileCountLimit	integer	Yes	Kota tarafından izin verilen maksimum dosya sayısı. Geçerli değerler: Minimum değer: 10.000. Maksimum değer: 100.000.000.	10000
SizeLimit	integer	Yes	Kotanın toplam kapasite sınırı. Birim: bayt. Geçerli değerler: Minimum değer: 10.737.418.240 (10 GiB). Maksimum değer: 1.099.511.627.776.000 (1.024.000 GiB). Artış: 1.073.741.824 (1 GiB).	10737418240
DryRun	boolean	No	Bu istek için deneme çalıştırması (dry run) yapılıp yapılmayacağını belirtir. Deneme çalıştırması, örneği gerçekten değiştirmeden veya ücretlendirmeden parametre geçerliliğini ve bağımlılıkları kontrol eder. Geçerli değerler: true: Protokol hizmetini değiştirmeden bir deneme çalıştırması isteği gönderir. Sistem, gerekli parametrelerin belirtilip belirtilmediğini, istek biçiminin geçerli olup olmadığını ve iş sınırlarının ve bağımlılıkların karşılanıp karşılanmadığını kontrol eder. Kontrol başarısız olursa, ilgili hata döndürülür. Kontrol başarılı olursa, HTTP durum kodu 200 döndürülür. false (varsayılan): Normal bir istek gönderir. Kontrol geçildikten sonra, protokol hizmeti doğrudan değiştirilir.	false
ClientToken	string	No	İsteğin yinelenemezliğini (idempotence) sağlamak için kullanılan istemci belirteci. Belirteci oluşturmak için istemciyi kullanabilirsiniz, ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olun. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz. Daha fazla bilgi için Yinelenemezlik nasıl sağlanır konusuna bakın. Not Bu parametreyi belirtmezseniz, sistem otomatik olarak API isteğinin RequestId değerini ClientToken olarak kullanır. RequestId her API isteği için farklılık gösterebilir.	123e4567-e89b-12d3-a456-42665544****

Response elements

Element	Type	Description	Example
	object
RequestId	string	İstek kimliği.	98696EF0-1607-4E9D-B01D-F20930B6****
AgenticSpaceId	string	Agentic alanı kimliği. Bu, Agentic alanı (AgenticFS'de tek bir aracı son kullanıcıya tahsis edilen bağımsız bir çalışma alanı) oluşturulduktan sonra sistem tarafından atanan global olarak benzersiz bir tanımlayıcıdır.	agentic-229oypxjgpau2****

Examples

Success response

JSON format

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "AgenticSpaceId": "agentic-229oypxjgpau2****"
}

Error codes

HTTP status code	Error code	Error message
400	IllegalCharacters	The parameter contains illegal characters.
400	MissingFileSystemId	FileSystemId is mandatory for this action.
400	MissingFileSystemPath	FileSystemPath is mandatory for this action.
400	InvalidFilesystemType.NotSupport	This Api does not support this fileSystem type.
400	InvalidFilesystemVersion.NotSupport	This Api does not support this fileSystem version.
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.
400	Fileset.Path.Nested	Fileset path is nested.
400	Fileset.Path.NotExist	Fileset.Path.Not.Exist.
400	Fileset.Path.Exist	Fileset already exist.
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.
403	OperationDenied.TooManyDepths	The operation is denied due to Fileset path too deep.
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.
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.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.