Todos os produtos
Search
Central de documentação

File Storage NAS:ListRecycledDirectoriesAndFiles

Última atualização: Sep 03, 2026

Consulta arquivos ou diretórios excluídos.

Descrição da operação

Apenas sistemas de arquivos NAS de uso geral suportam este recurso.

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****

FileId

string

Sim

O FileId do diretório a ser consultado.

Este campo é o número de inode NFS. Quando a lixeira estiver vazia, você pode chamar esta operação com FileId=2 (inode do diretório raiz) para verificar a acessibilidade da operação ou consultar o conteúdo da lixeira no diretório raiz. Outros valores válidos de FileId podem ser obtidos chamando a operação ListRecentlyRecycledDirectories.

04***08

NextToken

string

Não

O token de paginação para a próxima página. Você não precisa especificar este parâmetro na primeira consulta.

Se uma única consulta não retornar todos os arquivos e diretórios, um NextToken não vazio será retornado. Você pode passar o NextToken correto nas consultas subsequentes para continuar recuperando os resultados.

1256****25

MaxResults

integer

Não

O número de arquivos ou diretórios retornados por consulta.

Valores válidos: 10 a 1000.

Valor padrão: 100.

100

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

RequestId

string

O ID da solicitação.

98696EF0-1607-4E9D-B01D-F20930B6****

NextToken

string

O token de paginação para a próxima página.

Se uma única consulta não retornar todos os arquivos e diretórios, um NextToken não vazio será retornado. Você pode passar o NextToken correto nas consultas subsequentes para continuar recuperando os resultados.

None

Entries

array<object>

A coleção de arquivos ou diretórios na lixeira.

object

FileId

string

O FileId do arquivo ou diretório.

04***08

Type

string

O tipo de objeto. Valores válidos:

  • File: arquivo

  • Directory: pasta

File

Name

string

O nome do arquivo ou diretório antes da exclusão.

test001

DeleteTime

string

A hora em que o arquivo ou diretório foi excluído. A hora segue o padrão ISO 8601 em UTC. Formato: yyyy-MM-ddTHH:mm:ssZ.

2021-05-30T10:08:08Z

Inode

string

O inode do arquivo ou diretório.

04***08

ATime

string

A hora de acesso mais recente. A hora segue o padrão ISO 8601 em UTC. Formato: yyyy-MM-ddTHH:mm:ssZ.

2019-10-30T10:08:08Z

MTime

string

A hora de modificação mais recente. A hora segue o padrão ISO 8601 em UTC. Formato: yyyy-MM-ddTHH:mm:ssZ.

2019-10-30T10:08:08Z

CTime

string

A hora de modificação de metadados mais recente. A hora segue o padrão ISO 8601 em UTC. Formato: yyyy-MM-ddTHH:mm:ssZ.

2019-10-30T10:08:08Z

Size

integer

O tamanho do arquivo. Unidade: bytes.

Quando Type está definido como Directory, o valor 0 é retornado.

1073741824

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "NextToken": "None",
  "Entries": [
    {
      "FileId": "04***08",
      "Type": "File",
      "Name": "test001",
      "DeleteTime": "2021-05-30T10:08:08Z",
      "Inode": "04***08",
      "ATime": "2019-10-30T10:08:08Z",
      "MTime": "2019-10-30T10:08:08Z",
      "CTime": "2019-10-30T10:08:08Z",
      "Size": 1073741824
    }
  ]
}

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.KMSKeyId.KMSUnauthorized KMS is not authorized. O serviço KMS não está autorizado para acesso.
400 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK needs to be enabled. A CMK especificada está desativada e deve estar no estado ativado.
404 InvalidFileSystem.NotFound The specified file system does not exist. O sistema de arquivos especificado não existe.
404 InvalidFileId.NotFound The specified FileId(%FileId) does not exist. O arquivo ou diretório especificado não existe.
404 InvalidParameter.InvalidNextToken The specified NextToken is invaild.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.