Todos os produtos
Search
Central de documentação

File Storage NAS:ListRecentlyRecycledDirectories

Última atualização: Sep 03, 2026

Consulta diretórios nos quais operações de exclusão foram realizadas recentemente.

Descrição da operação

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

Antes de começar

Antes de chamar esta operação, certifique-se de que o recurso de lixeira esteja ativado para o sistema de arquivos. Se a lixeira não estiver ativada, esta operação não poderá retornar a lista de diretórios excluídos recentemente.

Ativar a lixeira

Para ativar o recurso de lixeira, chame a operação EnableRecycleBin. Após a ativação da lixeira, os diretórios excluídos no sistema de arquivos são movidos para a lixeira. Você pode chamar esta operação para consultar a lista de diretórios excluídos recentemente.

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

NextToken

string

Não

O token de paginação para a próxima página. Não é necessário especificar este parâmetro na primeira solicitação.

Se uma única consulta não retornar todos os diretórios, o parâmetro NextToken será retornado com um valor. Você pode especificar um valor válido de NextToken nas solicitações subsequentes para continuar a consulta.

1256****25

MaxResults

integer

Não

O número máximo de diretórios a serem 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.

9E15E394-38A6-457A-A62A-D9797C9A****

NextToken

string

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

Se uma única consulta não retornar todos os diretórios, o parâmetro NextToken será retornado com um valor. Você pode especificar um valor válido de NextToken nas solicitações subsequentes para continuar a consulta.

1256****25

Entries

array<object>

As informações sobre diretórios nos quais operações de exclusão foram realizadas recentemente.

object

FileId

string

O ID do diretório.

04***08

Path

string

O caminho absoluto do diretório.

/a/b

Name

string

O nome do diretório.

b

LastDeleteTime

string

A hora em que a operação de exclusão mais recente foi realizada no diretório. A hora segue o padrão ISO 8601 em UTC. Formato: yyyy-MM-ddTHH:mm:ssZ.

2021-05-30T10:08:08Z

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "9E15E394-38A6-457A-A62A-D9797C9A****",
  "NextToken": "1256****25",
  "Entries": [
    {
      "FileId": "04***08",
      "Path": "/a/b",
      "Name": "b",
      "LastDeleteTime": "2021-05-30T10:08:08Z"
    }
  ]
}

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