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

Consulta um espaço Agentic.

Descrição da operação

Aplicável a sistemas de arquivos Agentic.

Antes de começar

Antes de chamar esta operação, crie recursos na seguinte ordem:

Crie um sistema de arquivos Agentic: Chame CreateFileSystem para criar um sistema de arquivos com 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.
Consulte a lista de AgenticSpace: Após a criação do sistema de arquivos (status Running), chame esta operação DescribeAgenticSpaces para consultar a lista de AgenticSpaces no sistema de arquivos.
- Se AgenticSpaces tiverem sido criados no sistema de arquivos, a lista completa será retornada.
- Se nenhum AgenticSpace tiver sido criado no sistema de arquivos, uma lista vazia será retornada.

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.	1ca404****
Filters	array<object>	Não	A coleção de condições de filtro.
	object	Não	A condição de filtro.
Key	string	Não	O nome da chave de filtro. Valores válidos: AgenticSpaceIds Valores válidos: AgenticSpaceIds : O nome do filtro para uma coleção de IDs de AgenticSpace.	AgenticSpaceIds
Value	string	Não	O valor da chave de filtro. Curingas não são suportados. AgenticSpaceIds: Apenas um único ID pode ser especificado.	06229oypxjgox0u****
NextToken	string	Não	O token de paginação. Defina este parâmetro com o valor de NextToken retornado na chamada de API anterior.	MTc3OTkzNTA0Mjg0NTc1MDI4OCM0MDQ0MzA****=
MaxResults	integer	Não	O número de resultados por consulta. Valores válidos: 10 a 100. Valor padrão: 20.	20

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	BC7C825C-5F65-4B56-BEF6-98C56C7C****
NextToken	string	O token de paginação. Defina este parâmetro com o valor de NextToken retornado na chamada de API anterior.	MTc2NTg1MTUyMzA1OTczNTc1OCM0NjQxMzQ****=
AgenticSpaces	object
AgenticSpace	array<object>	As informações do AgenticSpace.
	array<object>	As informações do AgenticSpace.
FileSystemId	string	O ID do sistema de arquivos.	0322djegiekcia5****
AgenticSpaceId	string	O ID do AgenticSpace.	agentic-229oypxjgpau2****
Description	string	A descrição do AgenticSpace.	Description
FileSystemPath	string	O caminho absoluto do arquivo.	/test/
Azone	string	O ID da zona.	cn-hangzhou-i
Status	string	O status do AgenticSpace. Valores válidos: Running	Running
CreateTimeUtc	string	A hora em que o AgenticSpace foi criado. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ.	2026-06-10T10:08:08Z
UpdateTimeUtc	string	A hora em que o AgenticSpace foi atualizado pela última vez. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ.	2026-06-10T10:08:08Z
Quota	object	As informações de cota.
FileCountLimit	integer	O número máximo de arquivos permitido pela cota. Valores válidos: Valor mínimo: 10.000. Valor máximo: 100.000.000.	10000000
SizeLimit	integer	A capacidade total máxima permitida pela cota. Unidade: bytes. Valores válidos: Valor mínimo: 10.737.418.240 (10 GiB). Valor máximo: 1.099.511.627.776.000 (1.024.000 GiB). Incremento: 1.073.741.824 (1 GiB).	10737418240
FileCountUsage	integer	O número de arquivos utilizados.	100
SpaceUsage	integer	A capacidade utilizada. Unidade: bytes.	1024

Exemplos

Resposta de sucesso

JSON formato

{
  "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
      }
    ]
  }
}

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	InvalidParameter.SortOrder	Invalid sort order.	O parâmetro SortOrder é inválido.
400	InvalidParameter.SortOrderField	Invalid sort order field.	O parâmetro SortOrderField é inválido.
400	InvalidFilesystemType.NotSupport	The API operation does not support the file system type.	A operação atual não suporta este tipo de sistema de arquivos.
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	InvalidFilterParam	The specified Filter.N.Key is invalid.	O parâmetro Filter.N.Key especificado é inválido.
404	InvalidFilterValue	The specified Filter.N.Value is invalid.	O valor de Filter.1.Value é inválido.
404	InvalidParameter.InvalidNextToken	The specified NextToken is invaild.
404	InvalidParameter.InvalidMaxResults	The specified MaxResults is invalid.	O MaxResults especificado é inválido.
404	InvalidAgenticSpace.NotFound	The specified AgenticSpace is not found.	O AgenticSpace especificado não foi encontrado.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.