Restaurar Partilha
A Restore Share operação restaura (ou anula) uma partilha que tinha sido eliminada de forma recuperável anteriormente. Esta API é totalmente suportada, mas é uma API de gestão legada. Em vez disso, utilize Partilhas de Ficheiros – Restauro, fornecido pelo fornecedor de recursos de armazenamento (Microsoft.Storage). Para saber mais sobre como interagir programaticamente com recursos com FileShare o fornecedor de recursos de armazenamento, veja Operações em FileShares.
A partilha é restaurada juntamente com todos os respetivos dados, metadados e instantâneos. O recurso de partilha inclui metadados e propriedades para a partilha.
Disponibilidade do protocolo
| Protocolo de partilha de ficheiros ativado | Disponível |
|---|---|
| SMB |
|
| NFS |
|
Pedir
Pode construir o pedido da Restore Share seguinte forma. É recomendado HTTPS.
| Método | URI do pedido | Versão HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/restoredShareName?restype=share&comp=undelete |
HTTP/1.1 |
Substitua os componentes de caminho apresentados no URI do pedido pelo seu, da seguinte forma:
| Componente caminho | Description |
|---|---|
myaccount |
O nome da sua conta de armazenamento. |
restoredShareName |
O nome a utilizar para a partilha restaurada. Se já existir uma partilha com este nome, a operação falhará. |
Para obter detalhes sobre as restrições de nomenclatura de caminhos, veja Naming and referencing shares, directories, files, and metadata (Atribuir nomes e referenciar partilhas, diretórios, ficheiros e metadados).
Parâmetros do URI
Pode especificar o seguinte parâmetro adicional no URI do pedido.
| Parâmetro | Description |
|---|---|
timeout |
Opcional. O parâmetro de tempo limite é expresso em segundos. Para obter mais informações, veja Setting timeouts for Ficheiros do Azure operations (Definir tempos limite para operações de Ficheiros do Azure). |
Cabeçalhos do pedido
A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.
| Cabeçalho do pedido | Description |
|---|---|
Authorization |
Obrigatório. Especifica o esquema de autenticação, o nome da conta e a assinatura. Para obter mais informações, veja Authentication for the Azure Storage services (Autenticação dos serviços de Armazenamento do Azure). |
x-ms-date |
Obrigatório. Especifica a hora Hora Universal Coordenada (UTC) do pedido. Para obter mais informações, veja Authentication for the Azure Storage services (Autenticação dos serviços de Armazenamento do Azure). |
x-ms-version |
Necessário para todos os pedidos autenticados. Especifica a versão da operação a utilizar para este pedido. Para obter mais informações, veja Controlo de versões dos serviços de Armazenamento do Azure. |
x-ms-deleted-share-name |
Obrigatório. Identifica a partilha de ficheiros eliminada de forma recuperável a restaurar. Este valor tem de corresponder ao valor de restoredShareName. |
x-ms-deleted-share-version |
Obrigatório. Identifica exclusivamente a partilha de ficheiros eliminada de forma recuperável pela respetiva versão. |
x-ms-client-request-id |
Opcional. Fornece um valor opaco gerado pelo cliente com um limite de carateres de 1 kibibyte (KiB) que é registado nos registos quando o registo é configurado. Recomendamos vivamente que utilize este cabeçalho para correlacionar as atividades do lado do cliente com os pedidos que o servidor recebe. Para obter mais informações, veja Monitorizar Armazenamento de Blobs do Azure. |
Corpo do pedido
Nenhum.
Pedido 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 estado HTTP e um conjunto de cabeçalhos de resposta.
Código de estado
Uma operação bem-sucedida devolve o código de estado 201 (Criado). Se o nome da partilha de ficheiros de destino for utilizado por uma partilha de ficheiros não eliminada válida, o pedido falhará com um 409 (Conflito). Se a partilha de ficheiros de origem não tiver sido eliminada de forma recuperável, já tiver sido restaurada ou se a partilha de ficheiros de origem tiver passado o período de retenção e tiver expirado, o pedido falhará com um erro 404 (Não Encontrado).
Para obter informações sobre códigos de estado, veja Códigos de estado e de erro.
Cabeçalhos de resposta
A resposta para esta operação inclui os seguintes cabeçalhos. 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 da partilha, entre aspas. |
Last-Modified |
Devolve a data e hora em que a partilha foi modificada pela última vez. Para obter mais informações, veja Representação de Valores de data/hora em cabeçalhos. Qualquer operação que modifique a partilha, ou as respetivas propriedades ou metadados, atualiza a hora da última modificação. As operações em ficheiros não afetam a hora da última modificação da partilha. |
x-ms-request-id |
Identifica exclusivamente o pedido que foi feito e pode ser utilizado para resolver o pedido. Para obter mais informações, veja Resolver problemas de operações da API. |
x-ms-version |
Indica a versão do Ficheiros do Azure utilizado para executar o pedido. |
Date |
Um valor de data/hora UTC que indica a hora em que a resposta foi iniciada. O serviço gera este valor. |
x-ms-client-request-id |
Pode ser utilizado para resolver problemas de pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor de x-ms-client-request-id header, se estiver presente no pedido. O valor é, no máximo, 1024 carateres ASCII visíveis. Se o x-ms-client-request-id header não estiver presente no pedido, não estará presente na resposta. |
Corpo da resposta
Nenhum.
Resposta de amostra
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 esta operação. Além disso, os utilizadores com tokens de assinatura de acesso partilhado de conta válidos podem chamar esta operação. O token tem de incluir permissões de escrita para o recurso de contentor autorizar esta operação.
Observações
Não pode restaurar uma partilha para um nome diferente. Quando restaura uma partilha, se existir outra partilha com o mesmo nome, a operação falha com o código de estado 409 (Conflito). A partilha com o mesmo nome tem de ser eliminada primeiro, antes de a partilha de eliminação recuperável poder ser eliminada.
Quando uma partilha é eliminada, não é possível restaurar uma partilha com o mesmo nome durante, pelo menos, 30 segundos. Enquanto a partilha está a ser eliminada, as tentativas de restauro de uma partilha com o mesmo nome falham com o código de estado 409 (Conflito). O serviço devolve informações de erro adicionais, indicando que a partilha está a ser eliminada.