Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Get Blob Properties

 

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

Il Get Blob Properties richiesta può essere costruita come indicato di seguito. È consigliato HTTPS. Sostituire myaccount con il nome dell'account di archiviazione:

URI della richiesta HEAD (metodo)

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 porta del servizio Blob come 127.0.0.1:10000, seguito dal nome dell'account di archiviazione emulato:

URI della richiesta HEAD (metodo)

Versione HTTP

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

HTTP/1.1

Per ulteriori informazioni, vedere utilizzando l'emulatore di archiviazione di Azure per lo sviluppo e Testing.

I seguenti parametri aggiuntivi possono essere specificati nell'URI della richiesta.

Parametro

Descrizione

snapshot

Parametro facoltativo. Il parametro snapshot è opaco DateTime che, se presente, specifica lo snapshot blob da recuperare. Per ulteriori informazioni sull'utilizzo degli snapshot blob, vedere Creazione di uno Snapshot di un Blob

timeout

Parametro facoltativo. Il timeout parametro viene espresso in secondi. Per ulteriori informazioni, vedere Impostazione dei 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 di schema di autenticazione, nome dell'account e firma. Per ulteriori informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

Date o x-ms-date

Obbligatorio. Specifica il tempo universale coordinato (UTC) per la richiesta. Per ulteriori informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

x-ms-version

Obbligatorio per tutte le richieste autenticate, facoltative per le richieste anonime. Specifica la versione dell'operazione da usare per questa richiesta. Per ulteriori informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

x-ms-lease-id: <ID>

Parametro facoltativo. Se questa intestazione viene specificata, il 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 entrambe le condizioni non vengono soddisfatte, la richiesta avrà esito negativo e il Get Blob Properties operazione avrà esito negativo con codice di stato 412 (Precondition Failed).

x-ms-client-request-id

Parametro 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. Uso di questa intestazione è fortemente consigliato per correlazione delle attività lato client con le richieste ricevute dal server. Per ulteriori informazioni, vedere Informazioni sulla registrazione di analisi archiviazione e registrazione di Azure: Uso dei log per tenere traccia delle richieste di archiviazione.

Questa operazione supporta anche l'utilizzo di intestazioni condizionali per restituire le proprietà del blob e metadati solo se viene soddisfatta una condizione specificata. Per ulteriori informazioni, vedere Specifica di intestazioni condizionali per le operazioni del servizio Blob.

La risposta include un codice di stato HTTP e un set di intestazioni di risposta.

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

Per informazioni sui codici di stato, vedere Lo stato e i codici di errore.

La risposta per questa operazione include le intestazioni seguenti. La risposta può inoltre includere intestazioni HTTP standard aggiuntive. Rispettare tutte le intestazioni standard di specifica del protocollo HTTP/1.1.

Intestazione della risposta

Descrizione

Last-Modified

Data e ora dell'ultima modifica apportata al blob. Il formato di data è conforme a RFC 1123. Per ulteriori informazioni, vedere Rappresentazione di valori di data e ora nelle intestazioni.

Qualsiasi operazione di modifica del blob, incluso un aggiornamento dei metadati del blob o proprietà, modifica l'ora dell'ultima modifica del blob.

x-ms-meta-name:value

Un set di coppie nome-valore che corrispondono ai metadati definiti dall'utente associati al blob.

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

Il tipo di blob.

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

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

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

La versione 2012-02-12 e successive, viene visualizzata solo quando x-ms-copy-status è failed o pending. Descrive causa dell'errore dell'operazione di copia irreversibile o non irreversibile. Questa intestazione non viene visualizzata se il blob non è mai stato la destinazione in un Copy Blob operazione, o se è stato modificato dopo un concluso Copy Blob operazione utilizzando Set Blob Properties, Put Blob, o Put Block List.

x-ms-copy-id: <id>

La versione 2012-02-12 e successive. Identificatore di stringa per l'ultimo tentativo Copy Blob operazione in cui questo blob è il blob di destinazione. Questa intestazione non viene visualizzata se il blob non è mai stato la destinazione in un Copy Blob operazione, o se è stato modificato dopo un concluso Copy Blob operazione utilizzando Set Blob Properties, Put Blob, o Put Block List.

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

La versione 2012-02-12 e successive. Contiene il numero di byte copiati e i numero totale di byte di origine nell'ultimo tentativo Copy Blob operazione in cui questo blob è il blob di destinazione. Può essere compreso tra 0 e Content-Length byte copiati. Questa intestazione non viene visualizzata se il blob non è mai stato la destinazione in un Copy Blob operazione, o se è stato modificato dopo un concluso Copy Blob operazione utilizzando Set Blob Properties, Put Blob, o Put Block List.

x-ms-copy-source: url

La versione 2012-02-12 e successive. URL a 2 KB di lunghezza che specifica il blob di origine utilizzato nell'ultimo tentativo Copy Blob operazione in cui questo blob è il blob di destinazione. Questa intestazione non viene visualizzata se il blob non è mai stato la destinazione in un Copy Blob operazione, o se è stato modificato dopo un concluso Copy Blob operazione utilizzando Set Blob Properties, Put Blob, o Put Block List.

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

La versione 2012-02-12 e successive. Stato dell'operazione di copia identificata da x-ms-copy-id, con i seguenti 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'errore.

  • aborted: Copia terminata da Abort Copy Blob.

  • failed: Copia non riuscita. Vedere x-ms-copy-status-description per informazioni dettagliate sull'errore.

Questa intestazione non viene visualizzata se il blob non è mai stato la destinazione in un Copy Blob operazione, o se è stato modificato dopo aver completato un Copy Blob operazione utilizzando Set Blob Properties, Put Blob, o Put Block List.

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

Quando esiste un lease per un blob, specifica se il lease di durata infinita o fissa. Incluso per le richieste utilizzando la versione 2012-02-12 e successive.

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

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

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

Lo stato di lease del blob.

Content-Length

La dimensione del blob in byte. Per un blob di pagine, questa intestazione restituisce il valore di x-ms-blob-content-length intestazione archiviata con il blob.

Content-Type

Il tipo di contenuto specificato per il blob. Se è stato 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 operazioni in modo condizionale. Vedere Specifica di intestazioni condizionali per le operazioni del servizio Blob Per ulteriori informazioni. Se la versione richiesta è 2011-08-18 o successive, il valore ETag sarà racchiuso tra virgolette.

Content-MD5

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

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

Content-Encoding

Se il Content-Encoding intestazione della richiesta è stata precedentemente impostata per il blob, verrà restituito il valore in questa intestazione.

Content-Language

Se il Content-Language intestazione della richiesta è stata precedentemente impostata per il blob, verrà restituito il valore in questa intestazione.

Content-Disposition

Se il Content-Disposition intestazione della richiesta è stata precedentemente impostata per il blob, verrà restituito il valore in questa intestazione per le richieste di versione 2013-08-15 e versioni successive.

Il Content-Disposition campo di intestazione di risposta contiene informazioni aggiuntive su come elaborare il payload di risposta e può anche essere usato per collegare metadati aggiuntivi. Ad esempio, se impostato su attachment, indica che l'agente utente non visualizza la risposta, ma invece Mostra una finestra di dialogo Salva con nome.

Cache-Control

Se il Cache-Control intestazione della richiesta è stata precedentemente impostata per il blob, verrà restituito il valore in questa intestazione.

x-ms-blob-sequence-number

Il numero di sequenza corrente per un blob di pagine.

Questa intestazione non viene restituito per i BLOB in blocchi o BLOB di aggiunta.

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 la richiesta di risoluzione dei problemi. Per ulteriori informazioni, vedere Risoluzione dei problemi relativi a operazioni dell'API.

x-ms-version

Indica la versione del servizio Blob utilizzato 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

Un valore di 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 2013-08-15 e successive.

x-ms-blob-committed-block-count

Il numero di blocchi con commit presenti nel blob. Questa intestazione viene restituita solo per i BLOB di Accodamento.

Response Status:
HTTP/1.1 200 OK

Response Headers:
x-ms-meta-Name: myblob.txt
x-ms-meta-DateUploaded: <date>
x-ms-blob-type: AppendBlob
x-ms-lease-status: unlocked
x-ms-lease-state: available
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: <date>
ETag: "0x8CAE97120C1FF22"
Accept-Ranges: bytes
x-ms-blob-committed–block-count: 1
x-ms-version: 2015-02-21
Last-Modified: <date>
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6
x-ms-copy-source: <url>
x-ms-copy-status: success
x-ms-copy-progress: 11/11
x-ms-copy-completion-time: <date>

Se l'elenco di controllo del contenitore accesso (ACL) è 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 con una firma di accesso condiviso che dispone dell'autorizzazione per leggere il blob.

Per determinare se un Copy Blob operazione è stata completata, verificare innanzitutto che il x-ms-copy-id valore dell'intestazione corrisponde all'ID copia specificato nella chiamata originale a Copy Blob. Una corrispondenza assicura che un'altra applicazione non interrompa la copia e avviare una nuova Copy Blob operazione. Quindi verificare la presenza di x-ms-copy-status: success intestazione. Tuttavia, si tenga presente che tutte le operazioni su un blob, ad eccezione di scrittura Lease, Put Page e Put Block operazioni Rimuovi tutto x-ms-copy-* le proprietà del BLOB. Queste proprietà non vengono copiate dal Copy Blob operazioni che utilizzano versioni precedenti alla 2012-02-12.

x-ms-copy-status-description vengono fornite ulteriori informazioni sui Copy Blob errore. Nella tabella seguente vengono x-ms-copy-status-description valori e il relativo significato.

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

Componente

Descrizione

Codice di stato HTTP

Intero a 3 cifre standard che specifica l'errore.

Codice di errore

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

Informazioni

Descrizione dettagliata dell'errore, tra virgolette.

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

System_CAPS_importantImportante

Il testo descrittivo mostrato qui può cambiare senza preavviso, anche se una modifica della versione, pertanto non fare affidamento sulla corrispondenza esatta con questo testo.

Scenario

valore di x-ms-copy-status

valore di x-ms-copy-status-description

Operazione di copia completata correttamente.

operazione riuscita

vuoto

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

interrotta

vuoto

Si è verificato un errore durante la lettura dal blob di origine durante un'operazione di copia, ma l'operazione verrà ritentata.

in sospeso

502 gateway "errore non irreversibile durante la lettura di origine. Verranno effettuati tentativi. Ora del problema: < ora > "

Si è verificato un errore durante la scrittura nel blob di destinazione di un'operazione di copia, ma l'operazione verrà ritentata.

in sospeso

500 InternalServerError "errore non irreversibile. Verranno effettuati tentativi. Ora del problema: < ora > "

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

non è riuscita

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

System_CAPS_noteNota

Quando si segnalano questo errore sottostante, Azure restituisce ResourceNotFound nell'elemento < ErrorCode >. Se nella risposta non compare alcun elemento < ErrorCode >, uno standard di rappresentazione di stringa di stato HTTP, ad esempio NotFound apparirà.

Il periodo di timeout limitazione copia tutte le operazioni trascorso. (Attualmente il periodo di timeout è 2 settimane).

non è riuscita

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

L'operazione di copia verificati troppi errori durante la lettura dall'origine e non è stato raggiunto un rapporto minimo di tentativi di operazioni riuscite. (Questo timeout impedisce a nuovi tentativi di oltre 2 settimane prima che si verifichi un'origine di scarsa).

non è riuscita

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

Mostra: