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 path | 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 de 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 compartilhamento instantâneo. 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 compartilhamento instantâneo 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 caracteres de 1 kibibyte (KiB) 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 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. Uma instantâneo de compartilhamento não pode ser modificada, portanto, o ETag de um compartilhamento específico instantâneo nunca é alterado. No entanto, se você forneceu novos metadados com a solicitaçãoSnapshot Share , o ETag do compartilhamento instantâneo será diferente daquele do compartilhamento base. Se você não especificou nenhum metadado com a solicitação, o ETag do compartilhamento instantâneo é idêntico ao do compartilhamento base, no momento em que o compartilhamento instantâneo foi obtido. |
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. Uma instantâneo de compartilhamento não pode ser modificada, portanto, a hora da última modificação de um compartilhamento específico instantâneo nunca é alterada. No entanto, se você forneceu novos metadados com a solicitação Snapshot Share , a hora da última modificação da 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 compartilhamento instantâneo foi obtido. |
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 do 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 compartilhamento instantâneo. 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 é 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 compartilhamento instantâneo, você não poderá modificá-lo. Uma 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 compartilhamento instantâneo é criado, com um valor exclusivo DateTime
que identifica o compartilhamento instantâneo 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 compartilhamento instantâneo no URI de 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 compartilhamento instantâneo 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.