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

Restaura um arquivo da lixeira.

Descrição da operação

Apenas sistemas de arquivos NAS de uso geral suportam este recurso.
Um único sistema de arquivos pode executar apenas uma tarefa de restauração ou limpeza de arquivos por vez. Enquanto um arquivo está sendo restaurado, você não pode iniciar uma nova tarefa de restauração ou limpeza de arquivos.
Uma única tarefa de restauração pode restaurar apenas um arquivo ou diretório. A restauração de um diretório especificado restaura recursivamente todos os arquivos no diretório.
Após a restauração de um arquivo, é realizada uma reorganização de dados. O desempenho das solicitações de leitura diminui ligeiramente durante a reorganização de dados.

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. Obrigatório. Como obter: Chame DescribeFileSystems para consultar a lista de sistemas de arquivos e obter o FileSystemId. Chame CreateFileSystem para criar um sistema de arquivos e obter o FileSystemId na resposta. Notas de uso: Esta operação aplica-se apenas a sistemas de arquivos NAS de uso geral. Antes de chamar esta operação, certifique-se de que o recurso de lixeira esteja ativado para o sistema de arquivos.	1ca404****
FileId	string	Sim	O FileId do arquivo ou diretório a ser restaurado. Você pode chamar a operação ListRecycledDirectoriesAndFiles para consultar o FileId dos dados excluídos.	04***08
TargetFileId	string	Sim	O FileId do diretório para o qual o arquivo será restaurado. Você pode chamar a operação ListRecentlyRecycledDirectories para consultar o TargetFileId de diretórios dos quais arquivos foram excluídos. Você pode chamar a operação ListDirectoriesAndFiles para consultar o TargetFileId de diretórios existentes no sistema de arquivos. Notas especiais: O FileId do diretório raiz de um sistema de arquivos é fixo como `2`. Você pode usar diretamente este valor como TargetFileId para restaurar um arquivo no diretório raiz sem precisar consultá-lo.	13***15
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Gere um valor a partir do seu cliente para garantir que o valor seja único entre diferentes solicitações. O valor do ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência. Nota Se você não especificar o ClientToken, o sistema usará automaticamente o RequestId da solicitação de API como o ClientToken. O RequestId pode variar para cada solicitação de API.	123e4567-e89b-12d3-a456-42665544****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	98696EF0-1607-4E9D-B01D-F20930B6****
JobId	string	O ID da tarefa.	rb-10**491ff-r-162**165400

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "JobId": "rb-10****491ff-r-162****165400"
}

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	MissingTargetFileId	TargetFileId is mandatory for this action.	O parâmetro TargetFileId está ausente.
400	MissingFileId	FileId is mandatory for this action.	O parâmetro FileId está ausente.
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.
403	OperationDenied.RecycleBinDisabled	The operation is denied because the recycle bin is disabled.	A solicitação não pode ser realizada quando a lixeira está desativada.
403	OperationDenied.Conflict	The operation is in conflict with (% JobId). Please try again later.	A solicitação entra em conflito com outro job. Tente novamente mais tarde.
403	OperationDenied.TooManyRunningJobs	The maximum number of running job is one. Please try again later.	O número de jobs em execução não pode exceder 1. Tente novamente mais tarde.
403	InvalidTargetFileId.NotDirectory	The specified TargetFileId(% TargetFileId) is not directory.	O destino especificado não é um diretório.
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	InvalidTargetFileId.NotFound	The specified TargetFileId(%TargetFileId) does not exist.	O diretório de destino especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.