VENDITE: 1-800-867-1389

Get Blob Properties

Aggiornamento: giugno 2014

L'operazione Get Blob Properties restituisce tutti i metadati definiti dall'utente, le operazioni HTTP standard e le proprietà di sistema per il Blob. Non restituisce il contenuto del Blob.

La richiesta Get Blob Properties 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 HEAD Versione HTTP

https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?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 HEAD Versione HTTP

http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob

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 recuperare. 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 usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

x-ms-lease-id: <ID>

Facoltativo. Se questa intestazione viene specificata, l'operazione Get Blob Properties 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 tutte e due le condizioni non vengono soddisfatte, la richiesta ha esito negativo e l'operazione Get Blob Properties restituisce 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 restituire metadati e proprietà del Blob 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 e un set di intestazioni per la 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.

 

Intestazione della risposta Descrizione

Last-Modified

Data e ora dell'ultima modifica del Blob. Il formato data è conforme a RFC 1123. Per altre informazioni, vedere Rappresentazione di valori di data e ora nelle intestazioni.

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

x-ms-meta-name:value

Set di coppie nome-valore che corrispondono ai metadati definiti dall'utente associati al Blob.

x-ms-blob-type:<BlockBlob|PageBlob>

Tipo di Blob.

x-ms-copy-completion-time:<datetime>

Versione 2012-02-12 e successive. Ora di fine dell'operazione Copy Blob tentata per ultima in cui questo Blob è il Blob di destinazione. Questo valore può specificare l'ora di un tentativo di copia completato, interrotto o non riuscito. Questa intestazione non compare se una copia è in sospeso, se questo Blob non è mai stato la destinazione in un'operazione Copy Blob o se è stato modificato dopo un'operazione Copy Blob completata utilizzando Set Blob Properties, Put Blob o Put Block List.

x-ms-copy-status-description: <error string>

Versione 2012-02-12 e successive: compare solo quando x-ms-copy-status è failed o pending. Descrive la causa dell'errore di copia irreversibile o non. Questa intestazione non compare se questo Blob non è mai stato la destinazione in un'operazione Copy Blob o se è stato modificato dopo un'operazione Copy Blob completata utilizzando Set Blob Properties, Put Blob o Put Block List.

x-ms-copy-id: <id>

Versione 2012-02-12 e successive. Identificatore di stringa per l'operazione Copy Blob tentata per ultima in cui questo Blob è il Blob di destinazione. Questa intestazione non compare se questo Blob non è mai stato la destinazione in un'operazione Copy Blob o se è stato modificato dopo un'operazione Copy Blob completata utilizzando Set Blob Properties, Put Blob o Put Block List.

x-ms-copy-progress: <bytes copied/bytes total>

Versione 2012-02-12 e successive. Contiene il numero di byte copiati e il numero totale di byte nell'origine nell'operazione Copy Blob tentata per ultima in cui questo Blob è il Blob di destinazione. Valore che può essere compreso tra 0 e Content-Length byte copiati. Questa intestazione non compare se questo Blob non è mai stato la destinazione in un'operazione Copy Blob o se è stato modificato dopo un'operazione Copy Blob completata utilizzando Set Blob Properties, Put Blob o Put Block List.

x-ms-copy-source: url

Versione 2012-02-12 e successive. URL di lunghezza massima pari a 2 KB che specifica il Blob di origine utilizzato nell'operazione Copy Blob tentata per ultima in cui questo Blob è il Blob di destinazione. Questa intestazione non compare se questo Blob non è mai stato la destinazione in un'operazione Copy Blob o se è stato modificato dopo un'operazione Copy Blob completata utilizzando Set Blob Properties, Put Blob o Put Block List.

x-ms-copy-status: <pending | success | aborted | failed>

Versione 2012-02-12 e successive. Stato dell'operazione di copia identificata da x-ms-copy-id, con questi valori:

  • success: copia completata correttamente.

  • pending: copia in corso. Controllare x-ms-copy-status-description se intermittente. Gli errori non irreversibili impediscono l'avanzamento della copia, ma non ne causano l'esito negativo.

  • aborted: copia terminata da Abort Blob Copy.

  • failed: copia non riuscita. Per informazioni dettagliate sull'errore, vedere x-ms-copy-status-description.

Questa intestazione non compare se questo Blob non è mai stato la destinazione in un'operazione Copy Blob o se è stato modificato dopo un'operazione Copy Blob completata utilizzando Set Blob Properties, Put Blob o Put Block List.

x-ms-lease-duration: <infinite | fixed>

Quando un lease è associato a un Blob, specifica se il lease è di durata infinita o fissa. Incluso per le richieste effettuate utilizzando la versione 2012-02-12 e successive.

x-ms-lease-state: <available | leased | expired | breaking | broken>

Stato del lease del Blob. Incluso per le richieste effettuate utilizzando la versione 12/02/2012 e successive.

x-ms-lease-status:<locked| unlocked>

Stato del lease del Blob.

Content-Length

Dimensioni in byte del Blob. Per un Blob di pagine, questa intestazione restituisce il valore dell'intestazione x-ms-blob-content-length archiviata con il Blob.

Content-Type

Tipo di contenuto specificato per il Blob. Se non è specificato alcun tipo di contenuto, il tipo di contenuto predefinito è application/octet-stream.

Etag

Il valore ETag contiene un valore che è possibile utilizzare per eseguire le operazioni in modo condizionale. Per ulteriori informazioni, vedere Specifica di intestazioni condizionali per le operazioni del servizio Blob. Se la versione della richiesta è 2011-08-18 o successive, il valore ETag sarà racchiuso tra virgolette.

Content-MD5

Se l'intestazione Content-MD5 è stata impostata per il Blob, l'intestazione della risposta viene restituita in modo che il client possa controllare l'integrità del contenuto del messaggio.

Nella versione 2012-02-12 e successive, Put Blob imposta il valore MD5 di un Blob in blocchi anche se la richiesta Put Blob non include un'intestazione MD5.

Content-Encoding

Se l'intestazione della richiesta Content-Encoding è stata precedentemente impostata per il Blob, questo valore viene restituito in questa intestazione.

Content-Language

Se l'intestazione della richiesta Content-Language è stata precedentemente impostata per il Blob, questo valore viene restituito in questa intestazione.

Content-Disposition

Se l'intestazione della richiesta Content-Disposition è stata precedentemente impostata per il BLOB, questo valore viene restituito in questa intestazione per le richieste effettuate sulla versione 2013-08-15 e successive.

Il campo di intestazione di risposta Content-Disposition contiene informazioni aggiuntive su come elaborare il payload di risposta e può inoltre essere utilizzato per collegare i metadati aggiuntivi. Ad esempio, se impostato su attachment, indica che l'agente utente non deve visualizzare la risposta, bensì una finestra di dialogo Salva con nome.

Cache-Control

Se l'intestazione della richiesta Cache-Control è stata precedentemente impostata per il Blob, questo valore viene restituito in questa intestazione.

x-ms-blob-sequence-number

Numero di sequenza corrente per un Blob di pagine.

Questa intestazione non viene restituita per i Blob in blocchi.

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.

Accept-Ranges: bytes

Indica che il servizio supporta le richieste di contenuto parziale del Blob. Incluso per le richieste effettuate utilizzando la versione 15/08/2013 e successive.

Response Status:
HTTP/1.1 200 OK

Response Headers:
x-ms-meta-Name: myblob.txt
x-ms-meta-DateUploaded: Sun, 23 Oct 2013 18:45:18 GMT
x-ms-blob-type: BlockBlob
x-ms-lease-status: unlocked
x-ms-lease-state: available
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: Sun, 23 Oct 2013 19:49:38 GMT
ETag: "0x8CAE97120C1FF22"
Accept-Ranges: bytes
x-ms-version: 2013-08-15
Last-Modified: Wed, 23 Oct 2013 19:49
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Se l'elenco di controllo di accesso del contenitore è impostato per consentire l'accesso anonimo al Blob, qualsiasi client può chiamare questa operazione. Se il contenitore è privato, 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 per il Blob.

Per determinare se un'operazione Copy Blob è stata completata, verificare che il valore dell'intestazione x-ms-copy-id corrisponda all'ID copia specificato nella chiamata originale a Copy Blob. Una corrispondenza assicura che un'altra applicazione non interrompa la copia e avvii una nuova operazione Copy Blob. Verificare la presenza dell'intestazione x-ms-copy-status: success. Tenere presente, tuttavia, che tutte le operazioni di scrittura su un Blob ad eccezione di Lease, Put Page e Put Block, comportano la rimozione di tutte le proprietà x-ms-copy-* dal Blob. Queste proprietà non vengono copiate dalle operazioni Copy Blob che utilizzano le versioni precedenti alla 2012-02-12.

In x-ms-copy-status-description sono contenute altre informazioni sull'errore Copy Blob. Nella tabella seguente sono elencati i valori x-ms-copy-status-description con i relativi significati.

Nella tabella seguente vengono descritti i tre campi di ogni valore x-ms-copy-status-description.

 

Componente Descrizione

Codice di stato HTTP

Numero intero a tre cifre standard che specifica l'errore.

Codice di errore

Parola chiave che descrive l'errore fornita da Azure nell'elemento <ErrorCode>. Se non è presente alcun elemento <ErrorCode>, viene utilizzata una parola chiave contenente il testo dell'errore standard associato al codice di stato HTTP a tre cifre nella specifica HTTP. Vedere Codici di errore comuni dell'API REST.

Informazioni

Descrizione dettagliata dell'errore, tra virgolette.

Nella tabella seguente vengono descritti i valori x-ms-copy-status e x-ms-copy-status-description degli scenari di errore comuni.

ImportantImportante
Il testo descrittivo mostrato qui può cambiare senza preavviso, anche se la versione non cambia, pertanto non cercare una corrispondenza esatta con questo testo.

 

Scenario valore di x-ms-copy-status valore di x-ms-copy-status-description

Operazione di copia completata correttamente.

esito positivo

empty

Operazione di copia interrotta dall'utente prima che venga completata.

aborted

empty

Si è verificato un errore durante la lettura dal Blob di origine durante un'operazione di copia, ma verrà effettuato un altro tentativo.

in sospeso

502 Gateway non valido "Errore non irreversibile durante la lettura dell'origine. Verrà effettuato un altro tentativo. Ora dell'errore: <time>"

Si è verificato un errore durante la scrittura nel Blob di destinazione di un'operazione di copia, ma verrà effettuato un altro tentativo.

in sospeso

500 InternalServerError "Errore non irreversibile. Verrà effettuato un altro tentativo. Ora dell'errore: <time>"

Si è verificato un errore irreversibile durante la lettura dal Blob di origine di un'operazione di copia.

non riuscito

404 ResourceNotFound "Copia non riuscita durante la lettura dell'origine".

noteNota
Quando viene segnalato questo errore sottostante, viene restituito ResourceNotFound nell'elenco <ErrorCode>. Se nella risposta non compare alcun elemento <ErrorCode>, viene visualizzata una rappresentazione in forma di stringa standard dello stato HTTP come NotFound.

Il periodo di timeout che limita tutte le operazioni di copia è trascorso. (Il periodo di timeout è attualmente 2 settimane.)

non riuscito

500 OperationCancelled "La copia ha superato il tempo massimo consentito".

Si sono verificati troppi errori durante la lettura dall'origine, pertanto non è stato raggiunto un rapporto minimo di tentativi rispetto alle operazioni completate. (Questo timeout impedisce di effettuare nuovi tentativi su un'origine di scarsa qualità per più di 2 settimane prima di restituire un errore).

non riuscito

500 OperationCancelled "Copia non riuscita durante la lettura dell'origine".

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