Partilhar via


Partilha de Instantâneos

A partir da versão 2017-04-17, a Snapshot Share operação cria um instantâneo só de leitura de uma partilha.

Disponibilidade do protocolo

Protocolo de partilha de ficheiros ativado Disponível Estado
SMB Yes GA
NFS Yes GA

Pedir

Pode construir o pedido da Snapshot Share seguinte forma. É recomendado HTTPS.

Método URI do pedido Versão HTTP
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot 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.
myshare O nome da partilha de ficheiros.

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 timeout parâmetro é expresso em segundos. Para obter mais informações, veja Setting timeouts for Azure Files operations (Definir tempos limite para operações dos 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 autorização, o nome da conta e a assinatura. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
Date ou x-ms-date Obrigatório. Especifica a hora Hora Universal Coordenada (UTC) do pedido. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
x-ms-version Necessário para todos os pedidos autorizados. 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-meta-name:value Opcional. Especifica um par de nome-valor definido pelo utilizador, associado ao instantâneo de partilha. Se não especificar nenhum par nome-valor, a operação copia os metadados de partilha base para o instantâneo.
Se especificar um ou mais pares nome-valor, o instantâneo de partilha é criado com os metadados especificados. Neste caso, os metadados não são copiados da partilha base.
Os nomes de metadados têm de cumprir as regras de nomenclatura dos identificadores C#.
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 o Armazenamento de Blobs do Azure.

Corpo do pedido

Nenhum.

Pedido de exemplo

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

Request Headers:
x-ms-version: 2017-04-17
x-ms-date: Mon, 10 May 2017 22:50:32 GMT
x-ms-meta-Name: StorageSample
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). 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 do instantâneo de partilha, entre aspas.

Não é possível modificar um instantâneo de partilha, pelo que o ETag instantâneo de uma determinada partilha nunca é alterado. No entanto, se tiver fornecido novos metadados com o Snapshot Share pedido, o ETag instantâneo da partilha difere do da partilha base. Se não especificou nenhum metadados com o pedido, o ETag instantâneo da partilha é idêntico ao da partilha base, no momento em que o instantâneo de partilha foi tirado.
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.

Não é possível modificar um instantâneo de partilha, pelo que a hora da última modificação de um instantâneo de partilha específica nunca é alterada. No entanto, se tiver fornecido novos metadados com o Snapshot Share pedido, a hora da última modificação do instantâneo de partilha difere da da partilha base. Se não especificou metadados com o pedido, a hora da última modificação do instantâneo de partilha é idêntica à da partilha base, no momento em que o instantâneo de partilha foi tirado.
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 dos Ficheiros do Azure utilizada para executar o pedido.
Date ou x-ms-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-snapshot Um DateTime valor que identifica exclusivamente o instantâneo de partilha. Pode utilizar o valor deste cabeçalho em pedidos subsequentes para aceder ao instantâneo de partilha. Este valor é opaco.
x-ms-client-request-id Pode ser utilizado para resolver problemas de pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho, se estiver presente no pedido. O valor é, no máximo, 1024 carateres ASCII visíveis. Se o x-ms-client-request-id cabeçalho 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:
Content-Length: 0
Date: Mon, 10 May 2017 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 10 May 2017 23:00:06 GMT
x-ms-version: 2017-04-17
x-ms-snapshot: 2017-05-10T17:52:33.9551861Z
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

Autorização

Apenas o proprietário da conta pode chamar esta operação.

Observações

Os instantâneos de partilha fornecem versões só de leitura de partilhas. Depois de criar um instantâneo de partilha, não pode modificá-lo. Um instantâneo de partilha fornece uma forma conveniente de criar uma cópia de segurança consistente de todos os ficheiros numa partilha.

Sempre que chamar a Snapshot Share operação, é criado um novo instantâneo de partilha, com um valor exclusivo DateTime que identifica o instantâneo de partilha em relação à respetiva partilha base. Pode utilizar este DateTime valor para efetuar mais operações no instantâneo de partilha e nos respetivos conteúdos. Deve tratar este DateTime valor como opaco.

O DateTime valor identifica o instantâneo de partilha no URI do pedido. Por exemplo, um ficheiro na partilha base e os respetivos instantâneos têm URIs semelhantes aos seguintes exemplos:

  • Ficheiro na partilha: http://myaccount.file.core.windows.net/myshare/myfile
  • Ficheiro no instantâneo de partilha: http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>

Uma partilha pode suportar a criação de 200 instantâneos de partilha. Se tentar criar mais de 200 instantâneos de partilha, o serviço devolve o código de erro 409 (Conflito). Se tentar criar um instantâneo de partilha enquanto uma operação anterior Snapshot Share está em curso, o serviço também devolve o código de erro 409 (Conflito).

Os instantâneos de partilha existentes nunca são substituídos. Têm de ser eliminados explicitamente. Para eliminar explicitamente instantâneos de partilha, chame Eliminar Partilha e defina o x-ms-include-snapshots cabeçalho, juntamente com o sharesnapshot parâmetro de consulta, para o valor adequado.

Pode ver instantâneos de partilha NFS num cliente NFS com o diretório virtual de instantâneo (.snapshot), que normalmente está localizado na raiz do ponto de montagem de partilha. O acesso a este diretório pode ser desativado ao definir o x-ms-enable-snapshot-virtual-directory-access cabeçalho como falso na API Definir Propriedades da Partilha . Também pode definir este cabeçalho no momento da criação da partilha como parte da operação Criar Partilha .