VENDAS: 1-800-867-1389
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original.
Tradução
Original

Obter intervalos de página

 

O Get Page Ranges operação retorna a lista de intervalos de página válidos para um blob de página ou um instantâneo de um blob de página.

O Get Page Ranges solicitação pode ser construída da seguinte maneira. HTTPS é recomendado. Substitua myaccount com o nome da sua conta de armazenamento:

URI de solicitação do método GET

Versão de HTTP

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=pagelist

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=pagelist&snapshot=<DateTime>

HTTP/1.1

Ao fazer uma solicitação no serviço de armazenamento emulado, especifique o nome de host do emulador e a porta do serviço Blob como 127.0.0.1:10000, seguido pelo nome da conta de armazenamento emulado:

URI de solicitação do método GET

Versão de HTTP

http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=pagelist

HTTP/1.1

Para obter mais informações, consulte usando o emulador de armazenamento do Azure para desenvolvimento e teste.

Os seguintes parâmetros adicionais podem ser especificados no URI de solicitação.

PARAMETER

Descrição

snapshot

Opcional. O parâmetro de instantâneo é opaco DateTime valor que, quando presente, especifica o instantâneo de blob para recuperar informações. Para obter mais informações sobre como trabalhar com instantâneos de blob, consulte Criando um instantâneo de um Blob.

timeout

Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, consulte Configurando os tempos limite para operações de serviço do Blob.

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho de solicitação

Descrição

Authorization

Obrigatório. Especifica o esquema de autenticação, o nome da conta e a assinatura. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Azure.

Date ou x-ms-date

Obrigatório. Especifica o Tempo Universal Coordenado (UTC) para a solicitação. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Azure.

x-ms-version

Obrigatório para todas as solicitações autenticadas, opcional para solicitações anônimas. 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.

Range

Opcional. Especifica o intervalo de bytes no qual listar intervalos, inclusive. Se ele for omitido, todos os intervalos do blob serão retornados.

x-ms-range

Opcional. Especifica o intervalo de bytes no qual listar intervalos, inclusive.

Se ambos os Range e x-ms-range for especificado, o serviço usa o valor de x-ms-range. Consulte Especificando o cabeçalho de intervalo para operações de serviço Blob para obter mais informações.

x-ms-lease-id:<ID>

Opcional. Se esse cabeçalho for especificado, a operação será executada apenas se as seguintes condições forem atendidas:

  • A concessão do blob está atualmente ativa.

  • A ID de concessão especificada na solicitação corresponde à do blob.

Se esse cabeçalho for especificado e nenhuma dessas condições for atendida, a solicitação não será feita e ocorrerá uma falha na operação com o código de status 412 (Falha na Pré-condição).

x-ms-client-request-id

Opcional. Fornece um valor opaco gerado pelo cliente com limite de caractere de 1 KB que será registrado nos logs de análise quando o registro em log da análise de armazenamento for habilitado. O uso desse cabeçalho é altamente recomendável para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre o log de análise de armazenamento e log do Azure: Usando Logs para rastrear solicitações de armazenamento.

Essa operação também dará suporte ao uso de cabeçalhos condicionais para obter intervalos de página somente se uma determinada condição for atendida. Para obter mais informações, consulte Especificando cabeçalhos condicionais para operações de serviço Blob.

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e o corpo de resposta.

Uma operação bem-sucedida retorna o código de status 200 (OK).

Para obter informações sobre códigos de status, consulte Status e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem a especificação de protocolo HTTP/1.1.

Sintaxe

Descrição

Last-Modified

A data e a hora da última modificação feita no blob. O formato da data segue RFC 1123.

Qualquer operação que modificar o blob, incluindo uma atualização dos metadados ou das propriedades do blob, alterará a hora da última modificação do blob.

ETag

A ETag contém um valor que o cliente pode usar para executar a operação de forma condicional. Se a versão da solicitação for a 2011-08-18 ou mais recente, o valor de ETag será exibido entre aspas.

x-ms-blob-content-length

O tamanho do blob em bytes.

x-ms-request-id

Esse cabeçalho identifica a solicitação que foi feita de forma exclusiva e pode ser usado para solucionar problemas na solicitação. Para obter mais informações, consulte Solucionando problemas nas operações de API.

x-ms-version

Indica a versão do serviço Blob usado para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e mais recente.

Esse cabeçalho será retornado também para solicitações anônimas sem uma versão especificada se o contêiner foi marcado para acesso público usando a versão 2009-09-19 do serviço Blob.

Date

Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.

O corpo da resposta inclui uma lista de intervalos de página válidos não sobrepostos, classificados pelo aumento do intervalo de páginas de endereço. O formato do corpo da resposta é o seguinte:

<?xml version="1.0" encoding="utf-8"?> <PageList> <PageRange> <Start>Start Byte</Start> <End>End Byte</End> </PageRange> <PageRange> <Start>Start Byte</Start> <End>End Byte</End> </PageRange> </PageList>

Se o conjunto inteiro do blob de páginas tiver sido limpo, o corpo da resposta não incluirá nenhum intervalo de páginas.

Essa operação poderá ser executada pelo proprietário da conta ou por qualquer pessoa que estiver usando uma assinatura de acesso compartilhado que tenha permissão para ler o blob. Se a ACL do contêiner estiver definido para permitir acesso anônimo, qualquer cliente poderá chamar essa operação.

Os deslocamentos de bytes de início e de término para cada intervalo de páginas são inclusivos.

Em um blob de página altamente fragmentado com um grande número de gravações, um Get Page Ranges solicitação pode falhar devido a um tempo limite interno do servidor. Os aplicativos que recuperam intervalos de um blob de página com um grande número de operações de gravação devem recuperar um subconjunto de intervalos de página por vez. Para obter mais informações, consulte Obtendo os intervalos de página de um Blob de página grande em segmentos.

Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários
Mostrar:
© 2016 Microsoft