DescribePolarFsObjects - PolarDB: Central de Documentação do Alibaba Cloud

Lista os arquivos e subdiretórios em um caminho especificado.

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.

Sintaxe da solicitação

GET / HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
PolarFsInstanceId	string	Sim	O ID da instância PolarFs.	pfs-2ze0i74ka607*****
Path	string	Sim	O caminho absoluto do diretório.	/test

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A consulta foi bem-sucedida.
PolarFsInstanceId	string	O ID da instância PolarFs.	pfs-2ze0i7*****
Items	array<object>	A lista de entradas de diretório.
	object	O objeto de entrada de diretório.
Path	string	O caminho absoluto do diretório.	/test
Type	string	O tipo de arquivo.	directory
Capacity	string	A capacidade.	100
CreationTime	integer	A hora de criação.	2025-03-25T09:37:10Z
Nlink	integer	O número de links.	test
Mode	string	As permissões do sistema de arquivos.	755
Owner	string	O proprietário.	test
LastModified	integer	A hora da última modificação.	2025-03-25T09:37:10Z
LinkTarget	string	O caminho real do link simbólico.	test
TotalRecordCount	string	O número total de registros.	50
Path	string	O caminho absoluto do diretório.	/test
PageSize	string	O número de registros por página. Valores válidos: 30, 50 e 100. Valor padrão: 30.	30
PageRecordCount	string	O número máximo de registros que podem ser exibidos na página atual.	30
RequestId	string	O ID da solicitação.	CDB3258F-B5DE-43C4-8935-CBA0CA******

Exemplos

Resposta de sucesso

JSON formato

{
  "PolarFsInstanceId": "pfs-2ze0i7*****",
  "Items": [
    {
      "Path": "/test",
      "Type": "directory",
      "Capacity": "100",
      "CreationTime": 0,
      "Nlink": 0,
      "Mode": "755",
      "Owner": "test",
      "LastModified": 0,
      "LinkTarget": "test"
    }
  ],
  "TotalRecordCount": "50",
  "Path": "/test",
  "PageSize": "30",
  "PageRecordCount": "30",
  "RequestId": "CDB3258F-B5DE-43C4-8935-CBA0CA******"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.