Compartilhar via


Restaurar Compartilhamento

A Restore Share operação restaura (ou desdeleta) um compartilhamento que já havia sido excluído temporariamente. Essa API tem suporte total, mas é uma API de gerenciamento herdada. Em vez disso, use Compartilhamentos de Arquivos – Restauração, fornecidos pelo provedor de recursos de armazenamento (Microsoft.Storage). Para saber mais sobre como interagir programaticamente com FileShare recursos usando o provedor de recursos de armazenamento, consulte Operações em FileShares.

O compartilhamento é restaurado junto com todos os seus dados, metadados e instantâneos. O recurso de compartilhamento inclui metadados e propriedades para o compartilhamento.

Disponibilidade do protocolo

Protocolo de compartilhamento de arquivos habilitado Disponível
SMB Sim
NFS Não

Solicitação

Você pode construir a solicitação da Restore Share seguinte maneira. HTTPS é recomendado.

Método URI da solicitação Versão HTTP
PUT https://myaccount.file.core.windows.net/restoredShareName?restype=share&comp=undelete HTTP/1.1

Substitua os componentes do caminho mostrados no URI da solicitação pelos seus próprios, como segue:

Componente Demarcador Descrição
myaccount O nome da sua conta de armazenamento.
restoredShareName O nome a ser usado para o compartilhamento restaurado. Se já existir um compartilhamento com esse nome, a operação falhará.

Para obter detalhes sobre restrições de nomenclatura de caminho, consulte Nomenclatura e referência de compartilhamentos, diretórios, arquivos e metadados.

Parâmetros do URI

Você pode especificar o parâmetro adicional a seguir no URI da solicitação.

Parâmetro Descrição
timeout Opcional. O parâmetro timeout é expresso em segundos. Para obter mais informações, consulte Configurando tempos limite para operações de Arquivos do Azure.

Cabeçalhos da solicitação

A tabela a seguir descreve os cabeçalhos de solicitação necessários e opcionais

Cabeçalho da solicitação Descrição
Authorization Obrigatórios. Especifica o esquema de autenticação, o nome da conta e a assinatura. Para obter mais informações, consulte Autenticação para os serviços de Armazenamento do Azure.
x-ms-date Obrigatórios. Especifica a hora do Tempo Universal Coordenado (UTC) para a solicitação. Para obter mais informações, consulte Autenticação para os serviços de Armazenamento do Azure.
x-ms-version Obrigatório para todas as solicitações autenticadas. Especifica a versão da operação a ser usada para esta solicitação. Para obter mais informações, consulte Controle de versão para os Serviços de Armazenamento do Azure.
x-ms-deleted-share-name Obrigatórios. Identifica o compartilhamento de arquivos excluído temporariamente a ser restaurado. Esse valor deve corresponder ao valor de restoredShareName.
x-ms-deleted-share-version Obrigatórios. Identifica exclusivamente o compartilhamento de arquivos com exclusão reversível por sua versão.
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres kib (1 kibibyte) que é registrado nos logs quando o registro em log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Monitorar Armazenamento de Blobs do Azure.

Corpo da solicitação

Nenhum.

Solicitação de exemplo

PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=undelete HTTP/1.1   

Request Headers:  
x-ms-version: 2019-12-12   
x-ms-deleted-share-name: myshare 
x-ms-deleted-share-version: 01D2AC0C18EDFE36   
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ= 

Resposta

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Código de status

Uma operação bem-sucedida retorna o código de status 201 (Criado). Se o nome do compartilhamento de arquivo de destino for usado por um compartilhamento de arquivo não excluído válido, a solicitação falhará com um 409 (Conflito). Se o compartilhamento de arquivos de origem não for excluído temporariamente, já tiver sido restaurado ou se o compartilhamento de arquivo de origem tiver passado por seu período de retenção e tiver expirado, a solicitação falhará com um 404 (Não Encontrado).

Para obter informações sobre códigos de status, consulte Códigos de status e de erro.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Cabeçalho de resposta Descrição
ETag Contém um valor que representa a versão do compartilhamento, entre aspas.
Last-Modified Retorna a data e a hora em que o compartilhamento foi modificado pela última vez. Para obter mais informações, consulte Representação de valores de data e hora em cabeçalhos.

Qualquer operação que modifique o compartilhamento, ou suas propriedades ou metadados, atualiza a hora da última modificação. As operações em arquivos não afetam a hora da última modificação do compartilhamento.
x-ms-request-id Identifica exclusivamente a solicitação que foi feita e pode ser usada para solucionar problemas da solicitação. Para obter mais informações, consulte Solução de problemas de operações de API.
x-ms-version Indica a versão do Arquivos do Azure usada para executar a solicitação.
Date Um valor de data/hora UTC que indica a hora em que a resposta foi iniciada. O serviço gera esse valor.
x-ms-client-request-id Pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho será igual ao valor de x-ms-client-request-id header, se ele estiver presente na solicitação. O valor é no máximo 1.024 caracteres ASCII visíveis. Se o x-ms-client-request-id header não estiver presente na solicitação, ele não estará presente na resposta.

Corpo da resposta

Nenhum.

Resposta de exemplo

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
x-ms-request-id: 78c46801-f01a-0089-31fb-486017000000 
x-ms-version: 2019-12-12   
Content-Length: 0 
Date: <date>   
ETag: "0x8CB14C3E29B7E82"   
Last-Modified: <date>   
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0 

Autorização

O proprietário da conta de armazenamento pode chamar essa operação. Além disso, os usuários com tokens de assinatura de acesso compartilhado de conta válidos podem chamar essa operação. O token deve incluir permissões de gravação para o recurso de contêiner autorizar essa operação.

Comentários

Não é possível restaurar um compartilhamento para um nome diferente. Quando você restaura um compartilhamento, se houver outro compartilhamento com o mesmo nome, a operação falhará com status código 409 (Conflito). O compartilhamento com o mesmo nome deve primeiro ser excluído, antes que o compartilhamento com exclusão reversível possa ser não excluído.

Quando um compartilhamento é excluído, um compartilhamento com o mesmo nome não pode ser restaurado por pelo menos 30 segundos. Enquanto o compartilhamento está sendo excluído, as tentativas de restaurar um compartilhamento de mesmo nome falham com status código 409 (Conflito). O serviço retorna informações de erro adicionais, indicando que o compartilhamento está sendo excluído.

Confira também

Operações em compartilhamentos (Arquivos do Azure)