ListDirectoriesAndFiles - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ListDirectoriesAndFiles	A operação a ser executada. Defina o valor como ListDirectoriesAndFiles.
FileSystemId	String	Sim	31a8e4****	O ID do sistema de arquivos.
Path	String	Sim	/pathway/to/folder	O caminho absoluto do diretório. O caminho deve começar com uma barra (/) e existir no destino de montagem.
NextToken	String	Não	TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=	Token usado para iniciar a próxima solicitação. Se a resposta atual for truncada, use este token para fazer outra solicitação e obter os registros restantes.
StorageType	String	Sim	InfrequentAccess	O tipo de armazenamento dos arquivos. Valor padrão: InfrequentAccess (IA).
DirectoryOnly	Boolean	Não	false	Define se apenas diretórios serão consultados. Valores válidos: false (valor padrão): consulta diretórios e arquivos. true: consulta apenas diretórios.
MaxResults	Long	Não	100	Número máximo de diretórios ou arquivos a serem incluídos nos resultados de cada consulta. Valores válidos: 10 a 128. Valor padrão: 100.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
NextToken	String	TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=	Token usado para iniciar a próxima solicitação. Se a resposta atual for truncada, use este token para fazer outra solicitação e obter os registros restantes.
RequestId	String	2D69A58F-345C-4FDE-88E4-BF518948****	O ID da solicitação.
Entries	Array of Entry		Detalhes sobre os arquivos ou diretórios.
Type	String	File	O tipo do resultado da consulta. Valores válidos: File Directory
HasInfrequentAccessFile	Boolean	true	Indica se os arquivos contêm dados transferidos para a mídia de armazenamento IA. Este parâmetro é retornado e válido somente se o valor do parâmetro Type for Directory. Valores válidos: true: Os arquivos contêm dados transferidos para a mídia de armazenamento IA. false: Os arquivos não contêm dados transferidos para a mídia de armazenamento IA.
Ctime	String	2021-02-11T10:08:10Z	O momento em que os dados brutos foram modificados. O horário segue o padrão ISO 8601 no formato `yyyy-MM-ddTHH:mm:ssZ`. Este parâmetro é retornado e válido somente se o valor do parâmetro Type for File.
Mtime	String	2021-02-11T10:08:08Z	O momento da última modificação do arquivo. O horário segue o padrão ISO 8601 no formato `yyyy-MM-ddTHH:mm:ssZ`. Este parâmetro é retornado e válido somente se o valor do parâmetro Type for File.
Size	Long	1024	O tamanho dos arquivos. Unidade: bytes. Este parâmetro é retornado e válido somente se o valor do parâmetro Type for File.
StorageType	String	InfrequentAccess	O tipo de armazenamento dos arquivos. Este parâmetro é retornado e válido somente se o valor do parâmetro Type for File. Valores válidos: standard: Sistema de arquivos NAS de uso geral InfrequentAccess: Mídia de armazenamento IA
Atime	String	2021-02-01T10:08:08Z	O intervalo de tempo da consulta. O horário segue o padrão ISO 8601 no formato `yyyy-MM-ddTHH:mm:ssZ`. Este parâmetro é retornado e válido somente se o valor do parâmetro Type for File.
Name	String	file.txt	O nome do arquivo ou diretório.
RetrieveTime	String	2021-02-11T10:08:08Z	O momento em que a última tarefa de recuperação de dados foi executada. O horário segue o padrão ISO 8601 no formato `yyyy-MM-ddTHH:mm:ssZ`. Este parâmetro é retornado e válido somente se o valor do parâmetro Type for File.
Inode	String	66	O inode do arquivo ou diretório.
FileId	String	66	O ID do diretório ou arquivo.
Owner	String	37862c****	O ID da conta portátil. Este parâmetro é retornado e válido somente se o valor do parâmetro ProtocolType for SMB e o controle de acesso baseado em RAM estiver ativado.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=ListDirectoriesAndFiles
&FileSystemId=31a8e4****
&Path=/pathway/to/folder
&NextToken=TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=    
&StorageType=InfrequentAccess
&DirectoryOnly=false
&MaxResults=100
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ListDirectoriesAndFilesResponse>
    <NextToken>TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=</NextToken>
    <RequestId>2D69A58F-345C-4FDE-88E4-BF518948****</RequestId>
    <Entries>
        <Type>File</Type>
        <HasInfrequentAccessFile>true</HasInfrequentAccessFile>
        <Ctime>2021-02-11T10:08:10Z</Ctime>
        <Mtime>2021-02-11T10:08:08Z</Mtime>
        <Size>1024</Size>
        <StorageType>InfrequentAccess</StorageType>
        <Atime>2021-02-01T10:08:08Z</Atime>
        <Name>file.txt</Name>
        <RetrieveTime>2021-02-11T10:08:08Z</RetrieveTime>
        <Inode>66</Inode>
        <FileId>66</FileId>
        <Owner>37862c****</Owner>
    </Entries>
</ListDirectoriesAndFilesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "TGlzdFJlc291cmNlU****mVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0=",
  "RequestId" : "2D69A58F-345C-4FDE-88E4-BF518948****",
  "Entries" : [ {
    "Type" : "File",
    "HasInfrequentAccessFile" : true,
    "Ctime" : "2021-02-11T10:08:10Z",
    "Mtime" : "2021-02-11T10:08:08Z",
    "Size" : 1024,
    "StorageType" : "InfrequentAccess",
    "Atime" : "2021-02-01T10:08:08Z",
    "Name" : "file.txt",
    "RetrieveTime" : "2021-02-11T10:08:08Z",
    "Inode" : "66",
    "FileId" : "66",
    "Owner" : "37862c****"
  } ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationDenied.InvalidNextToken	The specified NextToken is invalid.	Mensagem de erro retornada porque o parâmetro NextToken especificado é inválido.
404	InvalidFileSystem.NotFound	The specified file system does not exist.	Mensagem de erro retornada porque o sistema de arquivos especificado não existe.
404	InvalidParameter.PathNotExist	The specified path does not exist.	Mensagem de erro retornada porque o caminho especificado não existe.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.