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