VENDITE: 1-800-867-1389

Get Page Ranges

Aggiornamento: gennaio 2014

L'operazione Get Page Ranges restituisce l'elenco degli intervalli di pagine valide per un Blob di pagine o uno snapshot di un Blob di pagine.

La richiesta Get Page Ranges può essere costruita nel modo seguente. Si consiglia di utilizzare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione:

 

  URI della richiesta del metodo GET Versione 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

Quando si effettua una richiesta nel servizio di archiviazione emulato, specificare il nome host dell'emulatore e la porta del servizio Blob come 127.0.0.1:10000, seguiti dal nome dell'account di archiviazione emulato:

 

  URI della richiesta del metodo GET Versione HTTP

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

HTTP/1.1

Per altre informazioni, vedere Uso dell'emulatore di archiviazione di Azure per lo sviluppo e il test.

Nell'URI della richiesta è possibile specificare i parametri aggiuntivi seguenti.

 

Parametro Descrizione

snapshot

Facoltativo. Il parametro snapshot è un valore DateTime opaco che, se presente, specifica lo snapshot Blob da cui recuperare informazioni. Per altre informazioni sull'uso degli snapshot Blob, vedere Creazione di uno snapshot di un Blob.

timeout

Facoltativo. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostazione di timeout per le operazioni del servizio Blob.

Nella tabella seguente vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

 

Intestazione della richiesta Descrizione

Authorization

Obbligatorio. Specifica lo schema di autenticazione, il nome dell'account e la firma. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

Date o x-ms-date

Obbligatorio. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

x-ms-version

Obbligatoria per tutte le richieste autenticate, facoltativa per le richieste anonime. Specifica la versione dell'operazione da utilizzare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

Range

Facoltativo. Specifica l'intervallo di byte su cui elencare gli intervalli, in modo inclusivo. Se omesso, verranno restituiti tutti gli intervalli per il Blob.

x-ms-range

Facoltativo. Specifica l'intervallo di byte su cui elencare gli intervalli, in modo inclusivo.

Se Range e x-ms-range sono entrambi specificati, il servizio utilizza il valore di x-ms-range. Per altre informazioni, vedere Specifica dell'intestazione di intervallo per le operazioni del servizio Blob.

x-ms-lease-id:<ID>

Facoltativo. Se questa intestazione viene specificata, l'operazione viene eseguita solo se vengono soddisfatte entrambe le condizioni seguenti:

  • Il lease del Blob è attualmente attivo.

  • L'ID lease specificato nella richiesta corrisponde a quello del Blob.

Se questa intestazione viene specificata e tutte e due le condizioni non vengono soddisfatte, la richiesta ha esito negativo e viene restituito il codice di stato 412 (Condizione preliminare non riuscita).

x-ms-client-request-id

Facoltativo. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 KB che viene registrato nei log di analisi quando la registrazione di Analisi archiviazione è abilitata. L'utilizzo di questa intestazione è consigliato per la correlazione tra le attività sul lato client e le richieste ricevute dal server. Per altre informazioni vedere Informazioni sulla registrazione di Analisi archiviazione e l'articolo relativo all'utilizzo di log per tenere traccia delle richiesta di archiviazione nella registrazione di Azure.

Questa operazione supporta anche l'utilizzo delle intestazioni condizionali per ottenere intervalli di pagine solo se viene soddisfatta una determinata condizione. Per altre informazioni, vedere Specifica di intestazioni condizionali per le operazioni del servizio Blob.

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni della risposta e il corpo della risposta.

Un'operazione completata correttamente restituisce il codice di stato 200 (OK).

Per informazioni sui codici di stato, vedere Codici ed errori di stato.

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

 

Sintassi Descrizione

Last-Modified

Data e ora dell'ultima modifica del Blob. Il formato data è conforme a RFC 1123.

Qualsiasi operazione che comporta la modifica del Blob, incluso un aggiornamento dei metadati o delle proprietà del Blob, comporta la modifica dell'ora dell'ultima modifica del Blob.

ETag

Il valore ETag contiene un valore che il client può utilizzare per eseguire l'operazione in modo condizionale. Se la versione della richiesta è 2011-08-18 o successive, il valore ETag sarà racchiuso tra virgolette.

x-ms-blob-content-length

Dimensioni in byte del Blob.

x-ms-request-id

Questa intestazione identifica in modo univoco la richiesta effettuata e può essere utilizzata per risolvere i problemi relativi alla richiesta. Per altre informazioni, vedere Risoluzione dei problemi relativi alle operazioni dell'API.

x-ms-version

Indica la versione del servizio Blob utilizzata per eseguire la richiesta. Questa intestazione viene restituita per le richieste effettuate nella versione 2009-09-19 e successive.

Questa intestazione viene restituita anche per le richieste anonime senza una versione specificata se il contenitore è stato contrassegnato per l'accesso pubblico utilizzando la versione 2009-09-19 del servizio Blob.

Date

Valore data/ora UTC generato dal servizio che indica l'ora in cui è stata avviata la risposta.

Il corpo della risposta include un elenco di intervalli di pagine validi non sovrapposti, in ordine crescente. Il formato del corpo della risposta è il seguente.

<?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 l'intero set di pagine del Blob è stato cancellato, il corpo della risposta non includerà alcun intervallo di pagine.

Questa operazione può essere eseguita dal proprietario dell'account e da qualsiasi utente che utilizza una firma di accesso condiviso con l'autorizzazione di lettura del Blob. Se l'elenco di controllo di accesso del contenitore è impostato per consentire l'accesso anonimo, qualsiasi client può chiamare questa operazione.

Gli offset di byte di inizio e fine per ogni intervallo di pagine sono inclusivi.

In un Blob di pagine molto frammentato con un numero elevato di scritture, una richiesta Get Page Ranges può avere esito negativo a causa di un timeout del server interno. Le applicazioni che recuperano gli intervalli di un Blob di pagine con un numero elevato di operazioni di scrittura devono recuperare un subset degli intervalli di pagine alla volta. Per altre informazioni, vedere la pagina che spiega come ottenere gli intervalli di pagine di un Blob di pagine di grandi dimensioni in segmenti.

Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.
Mostra:
© 2014 Microsoft