CreateAgenticSpace - File Storage NAS: Central de Documentação do Alibaba Cloud

Cria um espaço Agentic.

Descrição da operação

Antes de começar

Conclua as seguintes preparações antes de chamar esta operação:

Um sistema de arquivos Agentic foi criado: Ao chamar CreateFileSystem para criar um sistema de arquivos, defina os seguintes parâmetros:
- StorageType: Defina como Agentic.
- ProtocolType: Defina como NFS.
- Regiões suportadas: O tipo de armazenamento Agentic está disponível apenas em regiões e zonas específicas. Verifique o console para obter detalhes.

Notas de uso

Esta operação aplica-se apenas a sistemas de arquivos Agentic.
Exemplo de cadeia de chamadas completa:
1. Chame CreateFileSystem para criar um sistema de arquivos Agentic (StorageType=Agentic, ProtocolType=NFS).
2. Após a criação do sistema de arquivos (status Running), chame esta operação CreateAgenticSpace para criar um espaço Agentic.
3. Para modificar a configuração do espaço Agentic, chame a operação ModifyAgenticSpace.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
FileSystemId	string	Sim	O ID do sistema de arquivos.	31a8e4****
Azone	string	Sim	O ID da zona.	cn-hangzhou-i
FileSystemPath	string	Sim	O caminho absoluto do arquivo. Apenas diretórios de primeiro nível são suportados.	/path/
Description	string	Não	A descrição do espaço Agentic. Limites: A descrição deve ter entre 2 e 128 caracteres. A descrição deve começar com uma letra ou caractere chinês e não pode começar com `http://` ou `https://`. A descrição pode conter dígitos, dois pontos (:), sublinhados (_) ou hifens (-).	AgenticSpace Description
Quota	object	Sim	As informações de cota.
FileCountLimit	integer	Sim	O número máximo de arquivos permitido pela cota. Valores válidos: Valor mínimo: 10000. Valor máximo: 100000000.	10000
SizeLimit	integer	Sim	O limite de capacidade total da cota. Unidade: bytes. Valores válidos: Valor mínimo: 10737418240 (10 GiB). Valor máximo: 1099511627776000 (1024000 GiB). Incremento: 1073741824 (1 GiB).	10737418240
DryRun	boolean	Não	Especifica se deve ser realizado um dry run para esta solicitação. Um dry run verifica a validade dos parâmetros e as dependências sem realmente modificar a instância ou gerar cobranças. Valores válidos: true: Envia uma solicitação de dry run sem modificar o serviço de protocolo. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido e se os limites de negócios e as dependências são atendidos. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de status HTTP 200 será retornado. false (padrão): Envia uma solicitação normal. Após a aprovação na verificação, o serviço de protocolo é modificado diretamente.	false
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas certifique-se de que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como ClientToken. O RequestId pode variar para cada solicitação de API.	123e4567-e89b-12d3-a456-42665544****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	98696EF0-1607-4E9D-B01D-F20930B6****
AgenticSpaceId	string	O ID do espaço Agentic. Este é um identificador globalmente único atribuído pelo sistema após a criação do espaço Agentic (um espaço de trabalho independente alocado a um único usuário final de agente no AgenticFS).	agentic-229oypxjgpau2****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalCharacters	The parameter contains illegal characters.	Parâmetro inválido.
400	MissingFileSystemId	FileSystemId is mandatory for this action.	O parâmetro FileSystemId não foi especificado.
400	MissingFileSystemPath	FileSystemPath is mandatory for this action.	O parâmetro FileSystemPath está ausente.
400	InvalidFilesystemType.NotSupport	This Api does not support this fileSystem type.	A operação atual não suporta este tipo de sistema de arquivos.
400	InvalidFilesystemVersion.NotSupport	This Api does not support this fileSystem version.	A operação atual não suporta esta versão do sistema de arquivos.
400	InvalidRequest	The request is invalid.	A solicitação é inválida.
400	Quota.Invalid.Limit	Quota limit is invalid.	A cota é inválida.
400	Resource.Exceed.Limit	Resource exceed limit.	A contagem de recursos excede o limite.
400	Resource.Check.Fail	Resource check failed.	Falha na verificação do recurso.
400	Fileset.Path.Duplicate	Fileset path is duplicate.	O caminho do Fileset já existe.
400	Fileset.Path.Nested	Fileset path is nested.	Os caminhos do Fileset estão aninhados.
400	Fileset.Path.NotExist	Fileset.Path.Not.Exist.	O caminho do diretório pai do Fileset não existe.
400	Fileset.Path.Exist	Fileset already exist.	O caminho do Fileset já existe.
403	OperationDenied.AlreadyExists	The operation is denied due to IdirName already exists in parent path.	O nome do diretório já existe no diretório pai.
403	OperationDenied.TooManyFilesets	The operation is denied due to too many fileset in filesystem.	O número de diretórios Fileset no sistema de arquivos excede o limite.
403	OperationDenied.TooManyDepths	The operation is denied due to Fileset path too deep.	A profundidade do caminho do diretório Fileset excede o limite.
403	OperationDenied.NestedDir	The operation is denied due to nested directory.	A configuração de atualização automática não pode ser criada porque existem diretórios aninhados.
403	OperationDenied.DependencyViolation	The operation is denied due to dependancy violation.	As condições para esta operação não foram atendidas.
403	OperationDenied.FilesetNotSupported	The operation is not supported.	O sistema de arquivos não suporta Fileset.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	O sistema de arquivos especificado não existe.
404	InvalidFileSystemPath.ParentNotFound	The specified parent path does not exist.	O diretório pai especificado não existe.
404	InvalidFileSystemPath.NotDirectory	The specified idir parent path is not directory.	O diretório pai especificado não é um diretório.
404	InvalidFileSystemPath.InvalidCharacters	The specified fileset path contains invalid characters.	O caminho do Fileset especificado contém caracteres inválidos.
404	InvalidFilesetPath.InvalidParameter	Fileset path is invalid.	O caminho do fileset especificado é inválido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.