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		GA
NFS		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 Nomenclatura e referência de partilhas, diretórios, ficheiros e metadados.

Parâmetros 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 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 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 nomes-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 name-value, 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 1 caráter kibibyte (KiB) que é registado nos registos quando o registo está 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

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, em 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 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 dos valores de data/hora nos cabeçalhos. Não é possível modificar um instantâneo de partilha, pelo que a última hora modificada de um instantâneo de partilha específica nunca é alterado. No entanto, se forneceu novos metadados com o Snapshot Share pedido, a última hora modificada do instantâneo de partilha difere da da partilha base. Se não especificou metadados com o pedido, a última hora modificada 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 do 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.