Partilha de Instantâneos (API FileREST) – Ficheiros do Azure

Artigo
06/13/2024

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

Partilhar via