Compartilhamento de Instantâneos

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

Disponibilidade do protocolo

Protocolo de compartilhamento de arquivos habilitado	Disponível	Status
SMB		GA
NFS		GA

Solicitação

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

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

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 obrigatórios e opcionais.

Cabeçalho da solicitação	Descrição
Authorization	Obrigatórios. Especifica o esquema de autorização, o nome da conta e a assinatura. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
Date ou x-ms-date	Obrigatórios. Especifica a hora do Tempo Universal Coordenado (UTC) para a solicitação. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
x-ms-version	Necessário para todas as solicitações autorizadas. 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-meta-name:value	Opcional. Especifica um par nome-valor definido pelo usuário, associado ao instantâneo de compartilhamento. Se você não especificar nenhum par nome-valor, a operação copiará os metadados de compartilhamento base para o instantâneo. Se você especificar um ou mais pares nome-valor, o instantâneo de compartilhamento será criado com os metadados especificados. Nesse caso, os metadados não são copiados do compartilhamento base. Os nomes de metadados devem seguir as regras de nomenclatura para identificadores C#.
x-ms-client-request-id	Opcional. Fornece um valor opaco gerado pelo cliente com um limite de 1 caractere kibibyte (KiB) 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 o Armazenamento de Blobs do Azure.

Corpo da solicitação

Nenhum.

Solicitação 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 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). 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 instantâneo de compartilhamento, entre aspas. Um instantâneo de compartilhamento não pode ser modificado, portanto, o ETag de um instantâneo de compartilhamento específico nunca é alterado. No entanto, se você forneceu novos metadados com a solicitação Snapshot Share , o ETag do instantâneo de compartilhamento será diferente daquele do compartilhamento base. Se você não especificou nenhum metadado com a solicitação, o ETag do instantâneo de compartilhamento será idêntico ao do compartilhamento base, no momento em que o instantâneo de compartilhamento foi tirado.
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. Um instantâneo de compartilhamento não pode ser modificado, portanto, a hora da última modificação de um instantâneo de compartilhamento específico nunca é alterada. No entanto, se você forneceu novos metadados com a solicitação Snapshot Share , a hora da última modificação do instantâneo de compartilhamento será diferente da do compartilhamento base. Se você não especificou nenhum metadado com a solicitação, a hora da última modificação do instantâneo de compartilhamento será idêntica à do compartilhamento base, no momento em que o instantâneo de compartilhamento foi tirado.
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 dos Arquivos do Azure usada para executar a solicitação.
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 esse valor.
x-ms-snapshot	Um DateTime valor que identifica exclusivamente o instantâneo de compartilhamento. Você pode usar o valor desse cabeçalho em solicitações subsequentes para acessar o instantâneo de compartilhamento. Esse valor é opaco.
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 do x-ms-client-request-id cabeçalho, 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 cabeçalho 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:
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

Somente o proprietário da conta pode chamar essa operação.

Comentários

Os instantâneos de compartilhamento fornecem versões somente leitura de compartilhamentos. Depois de criar um instantâneo de compartilhamento, você não poderá modificá-lo. Um instantâneo de compartilhamento fornece uma maneira conveniente de criar um backup consistente de todos os arquivos em um compartilhamento.

Sempre que você chama a Snapshot Share operação, um novo instantâneo de compartilhamento é criado, com um valor exclusivo DateTime que identifica o instantâneo de compartilhamento em relação ao compartilhamento base. Você pode usar esse DateTime valor para executar outras operações no instantâneo de compartilhamento e seu conteúdo. Você deve tratar esse DateTime valor como opaco.

O DateTime valor identifica o instantâneo de compartilhamento no URI da solicitação. Por exemplo, um arquivo no compartilhamento base e seus instantâneos têm URIs semelhantes aos seguintes exemplos:

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

Um compartilhamento pode dar suporte à criação de 200 instantâneos de compartilhamento. Se você tentar criar mais de 200 instantâneos de compartilhamento, o serviço retornará o código de erro 409 (Conflito). Se você tentar criar um instantâneo de compartilhamento enquanto uma operação anterior Snapshot Share estiver em andamento, o serviço também retornará o código de erro 409 (Conflito).

Instantâneos de compartilhamento existentes nunca são substituídos. Eles devem ser excluídos explicitamente. Para excluir explicitamente instantâneos de compartilhamento, chame Excluir Compartilhamento e defina o x-ms-include-snapshots cabeçalho, juntamente com o sharesnapshot parâmetro de consulta, como o valor apropriado.

Você pode exibir instantâneos de compartilhamento NFS em um cliente NFS usando o diretório virtual de instantâneo (.snapshot), que normalmente está localizado na raiz do ponto de montagem do compartilhamento. O acesso a esse diretório pode ser desabilitado definindo o x-ms-enable-snapshot-virtual-directory-access cabeçalho como false na API Definir Propriedades de Compartilhamento . Você também pode definir esse cabeçalho no momento da criação do compartilhamento como parte da operação Criar Compartilhamento .