Put Blob From URL

L'operazione Put Blob From URL crea un nuovo BLOB in blocchi in cui il contenuto del BLOB viene letto da un URL specificato. Questa API è disponibile a partire dalla versione 2020-04-08.

Gli aggiornamenti parziali non sono supportati con Put Blob From URL. Il contenuto di un BLOB esistente viene sovrascritto con il contenuto del nuovo BLOB. Per eseguire aggiornamenti parziali al contenuto di un BLOB in blocchi usando un URL di origine, usare l'API Put BLOB from URL in combinazione con Put Block List.

Le dimensioni del BLOB di origine possono avere una lunghezza massima di 5.000 mebibyte (MiB).

Richiesta

È possibile costruire l'oggetto Put Blob From URL come indicato di seguito. È consigliabile usare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione:

URI della richiesta del metodo PUT Versione HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob HTTP/1.1

Richiesta di servizio di archiviazione emulata

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

URI della richiesta del metodo PUT Versione HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

L'emulatore di archiviazione supporta solo le dimensioni dei BLOB fino a 2 gibibyte (GiB).

Per altre informazioni, vedere Usare l'emulatore Azurite per lo sviluppo locale di Archiviazione di Azure.

Parametri URI

È possibile specificare i parametri aggiuntivi seguenti nell'URI della richiesta:

Parametro Descrizione
timeout Facoltativa. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostare i timeout per le operazioni del servizio BLOB.

Intestazioni della richiesta

Le intestazioni di richiesta obbligatorie e facoltative sono descritte nella tabella seguente:

Intestazione della richiesta Descrizione
Authorization Obbligatorio. Specifica lo schema di autorizzazione, il nome dell'account e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
Date o x-ms-date Obbligatorio. Specifica la data per la richiesta nel fuso orario UTC (Coordinated Universal Time). Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
x-ms-version Obbligatorio per tutte le richieste autorizzate. Specifica la versione dell'operazione da usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.
Content-Length Obbligatorio. Specifica il numero di byte trasmessi nel corpo della richiesta. Il valore di questa intestazione deve essere impostato su 0. Quando la lunghezza non è 0, l'operazione non riesce con il codice di stato 400 (richiesta non valida).
x-ms-copy-source:name Obbligatorio. Specifica l'URL del BLOB di origine. Il valore può essere un URL di lunghezza massima di 2 kibibyte (KiB) che specifica un BLOB. La codifica del valore deve essere di tipo URL in quanto viene visualizzato in un URI di richiesta. Il BLOB di origine deve essere pubblico o essere autorizzato tramite una firma di accesso condiviso. Se il BLOB di origine è pubblico, non è necessaria alcuna autorizzazione per eseguire l'operazione. Se le dimensioni del BLOB di origine sono maggiori di 5000 MiB o se l'origine non restituisce un valore valido Content-Length , la richiesta non riesce con il codice di stato 409 (Conflitto). Ecco alcuni esempi di URL oggetto di origine:

- https://myaccount.blob.core.windows.net/mycontainer/myblob
- https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>
- https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>
x-ms-copy-source-authorization: <scheme> <signature> facoltativo. Specifica lo schema di autorizzazione e la firma per l'origine di copia. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
Per Azure Active Directory è supportato solo il bearer dello schema.
Questa intestazione è supportata nella versione 2020-10-02 e successive.
x-ms-blob-type: BlockBlob Obbligatorio. Specifica il tipo di BLOB da creare, che deve essere BlockBlob. Se il tipo di BLOB non BlockBlobè , l'operazione non riesce con codice di stato 400 (richiesta non valida).
Content-Type facoltativo. Tipo di contenuto MIME del Blob. Il tipo predefinito è application/octet-stream.
Content-Encoding facoltativo. Specifica le codifiche di contenuto applicate al Blob. Questo valore viene restituito al client quando l'operazione Get BLOB viene eseguita sulla risorsa BLOB. Quando viene restituito questo valore, il client può usarlo per decodificare il contenuto del BLOB.
Content-Language facoltativo. Specifica i linguaggi naturali usati dalla risorsa.
Cache-Control facoltativo. Archiviazione BLOB archivia questo valore, ma non lo usa o lo modifica.
x-ms-source-content-md5 facoltativo. Hash MD5 del contenuto del BLOB dall'URI. Questo hash viene usato per verificare l'integrità del BLOB durante il trasporto dei dati dall'URI. Quando questa intestazione viene specificata, il servizio di archiviazione confronta l'hash del contenuto che è arrivato dall'origine di copia con questo valore di intestazione. Se questa intestazione viene omessa, Archiviazione BLOB genera un hash MD5.

Se i due hash non corrispondono, l'operazione non riesce con codice di errore 400 (richiesta non valida).
x-ms-content-crc64 facoltativo. Hash CRC64 del contenuto del BLOB. Questo hash viene utilizzato per verificare l'integrità del Blob durante il trasporto. Quando si specifica questa intestazione, il servizio di archiviazione controlla l'hash che è arrivato rispetto a quello inviato. Se i due hash non corrispondono, l'operazione non riesce con codice di errore 400 (richiesta non valida). Questa intestazione è supportata nella versione 02-02-2019 e successive.

Se sono presenti intestazioni Content-MD5 e x-ms-content-crc64, la richiesta ha esito negativo con 400 (richiesta non valida).
x-ms-blob-content-type facoltativo. Imposta il tipo di contenuto del BLOB.
x-ms-blob-content-encoding facoltativo. Imposta la codifica del contenuto del Blob.
x-ms-blob-content-language facoltativo. Imposta il linguaggio del contenuto del Blob.
x-ms-blob-content-md5 facoltativo. Imposta l'hash MD5 del Blob.
x-ms-blob-cache-control facoltativo. Imposta il controllo della cache del Blob.
x-ms-meta-name:value facoltativo. Coppie nome-valore associate al BLOB come metadati.

Nota: a partire dalla versione 2009-09-19, i nomi dei metadati devono rispettare le regole di denominazione per gli identificatori C#.
x-ms-encryption-scope facoltativo. Ambito di crittografia da usare per crittografare il contenuto della richiesta. Questa intestazione è supportata nella versione 2019-02-02 e successiva.
x-ms-tags facoltativo. Imposta i tag con codifica query-stringa specificati nel BLOB. Per altre informazioni, passare alla sezione Osservazioni . Supportato nella versione 2019-12-12 e versioni successive.
x-ms-copy-source-tag-option facoltativo. I valori possibili sono REPLACE o COPY (distinzione tra maiuscole e minuscole). Il valore predefinito è REPLACE.

Se viene specificato COPY, i tag del BLOB di origine vengono copiati nel BLOB di destinazione. Il BLOB di origine deve essere privato e la richiesta deve avere l'autorizzazione per ottenere tag BLOB nel BLOB di origine e impostare tag BLOB nel BLOB di destinazione. Ciò comporta una chiamata aggiuntiva all'operazione Recupera tag BLOB nell'account di origine.

REPLACE imposta i tag specificati dall'intestazione nel x-ms-tags BLOB di destinazione. Se replace viene usato e non vengono specificati tag da x-ms-tags, non vengono impostati tag nel BLOB di destinazione. Specificare COPY e x-ms-tags risultati in un 409 (conflitto).

Supportato nella versione 2021-04-10 e versioni successive.
x-ms-copy-source-blob-properties facoltativo. Specifica il comportamento delle proprietà del BLOB di origine copia. Se impostato su True, le proprietà del BLOB di origine verranno copiate nel nuovo BLOB. Il valore predefinito è True.
x-ms-source-if-modified-since facoltativo. Valore DateTime. Specificare questa intestazione condizionale per inserire il BLOB solo se il BLOB di origine è stato modificato dopo la data/ora specificata. Se il BLOB di origine non è stato modificato, l'archiviazione BLOB restituisce il codice di stato 412 (Precondizione non riuscita). Questa intestazione non può essere specificata se l'origine è una condivisione File di Azure.
x-ms-source-if-unmodified-since facoltativo. Valore DateTime. Specificare questa intestazione condizionale per inserire il BLOB solo se il BLOB di origine non è stato modificato dopo la data/ora specificata. Se il BLOB di origine è stato modificato, Archiviazione BLOB restituisce il codice di stato 412 (Precondizione non riuscita). Questa intestazione non può essere specificata se l'origine è una condivisione File di Azure.
x-ms-source-if-match facoltativo. Valore ETag. Specificare questa intestazione condizionale per inserire il BLOB di origine solo se il relativo ETag corrisponde al valore specificato. Se i valori ETag non corrispondono, Archiviazione BLOB restituisce il codice di stato 412 (Precondizione non riuscita). Questa intestazione non può essere specificata se l'origine è una condivisione File di Azure.
x-ms-source-if-none-match facoltativo. Valore ETag. Specificare questa intestazione condizionale per inserire il BLOB solo se il relativo ETag non corrisponde al valore specificato. Se i valori sono identici, Archiviazione BLOB restituisce il codice di stato 412 (Precondizione non riuscita). Questa intestazione non può essere specificata se l'origine è una condivisione File di Azure.
If-Modified-Since facoltativo. Valore DateTime. Specificare questa intestazione condizionale per inserire il BLOB solo se il BLOB di destinazione è stato modificato dopo la data/ora specificata. Se il BLOB di destinazione non è stato modificato, l'archiviazione BLOB restituisce il codice di stato 412 (Precondizione non riuscita).
If-Unmodified-Since facoltativo. Valore DateTime. Specificare questa intestazione condizionale per inserire il BLOB solo se il BLOB di destinazione non è stato modificato dopo la data/ora specificata. Se il BLOB di destinazione è stato modificato, Archiviazione BLOB restituisce il codice di stato 412 (Precondizione non riuscita).
If-Match facoltativo. Valore ETag. Specificare un valore ETag per questa intestazione condizionale per inserire il BLOB solo se il valore ETag specificato corrisponde al ETag valore per un BLOB di destinazione esistente. Se L'ETag per il BLOB di destinazione non corrisponde all'ETag specificato per If-Match, l'archiviazione BLOB restituisce il codice di stato 412 (Precondizione non riuscita).
If-None-Match facoltativo. Valore ETag o il carattere jolly (*).

Specificare un valore ETag per questa intestazione condizionale per inserire il BLOB solo se il valore ETag specificato non corrisponde al valore ETag per il BLOB di destinazione.

Specificare il carattere jolly (*) per eseguire l'operazione solo se il BLOB di destinazione non esiste.

Se la condizione specificata non viene soddisfatta, l'archiviazione BLOB restituisce il codice di stato 412 (Precondizione non riuscita).
x-ms-lease-id:<ID> Obbligatoria se il Blob presenta un lease attivo. Per eseguire questa operazione su un Blob con un lease attivo, specificare l'ID lease valido per questa intestazione.
x-ms-blob-content-disposition facoltativo. Imposta l'intestazione Content-Disposition del BLOB. Disponibile per la versione 2013-08-15 e versioni successive.

Il Content-Disposition campo intestazione della risposta fornisce informazioni aggiuntive su come elaborare il payload della risposta e può essere usato per collegare metadati aggiuntivi. Ad esempio, se l'intestazione è impostata su attachment, indica che l'agente utente non deve visualizzare la risposta. Deve invece visualizzare una finestra di dialogo Salva con nome di file diverso dal nome del BLOB specificato.

La risposta dalle operazioni Get BLOB e Get BLOB Properties include l'intestazione content-disposition .
Origin facoltativo. Specifica l'origine da cui proviene la richiesta. La presenza di questa intestazione determina la presenza di intestazioni di condivisione delle risorse multiorigine (CORS) nella risposta. Per altre informazioni, vedere SUPPORTO CORS per i servizi di archiviazione di Azure.
x-ms-client-request-id facoltativo. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log di analisi quando è abilitata la registrazione dell'analisi di archiviazione. È consigliabile usare questa intestazione per correlare le attività lato client con le richieste ricevute dal server.
x-ms-access-tier facoltativo. Indica il livello da impostare nel BLOB. I valori validi per i livelli BLOB in blocchi sono Hot, Cool, Colde Archive. Nota: Cold il livello è supportato per la versione 2021-12-02 e successiva. Hot, Coole Archive sono supportati per la versione 2018-11-09 e versioni successive. Per altre informazioni sul livello BLOB a blocchi, vedere Livelli di archiviazione ad accesso frequente, sporadico e archivio.
x-ms-expiry-option facoltativo. Versione 2023-08-03 e versioni successive. Specifica l'opzione data di scadenza per la richiesta. Per altre informazioni, vedere ExpiryOption. Questa intestazione è valida per gli account con spazio dei nomi gerarchico abilitato.
x-ms-expiry-time facoltativo. Versione 2023-08-03 e versioni successive. Specifica l'ora in cui il BLOB è impostato per la scadenza. Il formato per la data di scadenza varia in base a x-ms-expiry-option. Per altre informazioni, vedere ExpiryOption. Questa intestazione è valida per gli account con spazio dei nomi gerarchico abilitato.

Questa operazione supporta anche l'uso di intestazioni condizionali per scrivere il BLOB solo se viene soddisfatta una determinata condizione. Per altre informazioni, vedere Specificare intestazioni condizionali per le operazioni di archiviazione BLOB.

Intestazioni di richiesta (chiavi di crittografia fornite dal cliente)

Le intestazioni seguenti possono essere specificate nella richiesta per crittografare un BLOB con una chiave fornita dal cliente. La crittografia con una chiave fornita dal cliente (e il set corrispondente di intestazioni) è facoltativo.

Intestazione della richiesta Descrizione
x-ms-encryption-key Obbligatorio. Chiave di crittografia AES-256 con codifica Base64.
x-ms-encryption-key-sha256 Obbligatorio. Hash SHA256 con codifica Base64 della chiave di crittografia.
x-ms-encryption-algorithm: AES256 Obbligatorio. Specifica l'algoritmo da usare per la crittografia. Il valore di questa intestazione deve essere AES256.

Testo della richiesta

Nessuno.

Richiesta di esempio

Nell'esempio seguente viene illustrata una richiesta per creare un Blob in blocchi:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-04-08  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-content-disposition: attachment; filename="fname.ext"  
x-ms-blob-type: BlockBlob  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
x-ms-copy-source: https://myaccount.blob.core.windows.net/mycontainer/myblob
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codice stato

Un'operazione completata correttamente restituisce il codice di stato 201 (Creato).

Per altre informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni di risposta

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

Intestazione risposta Descrizione
ETag Il valore ETag contiene un valore che il client può utilizzare per eseguire operazioni PUT condizionali utilizzando l'intestazione della richiesta If-Match. Il valore ETag è racchiuso tra virgolette.
Last-Modified Data/ora dell'ultima modifica del BLOB. Il formato data è conforme a RFC 1123. Per altre informazioni, vedere Rappresentare valori di data/ora nelle intestazioni.

Qualsiasi operazione di scrittura sul Blob, inclusi aggiornamenti dei metadati o delle proprietà del Blob, comporta la modifica dell'ora dell'ultima modifica del Blob.
Content-MD5 Restituito per un BLOB a blocchi in modo che il client possa controllare l'integrità del contenuto del messaggio. Il Content-MD5 valore restituito viene calcolato da Archiviazione BLOB. Questa intestazione viene restituita anche quando la richiesta non include Content-MD5 o x-ms-blob-content-md5 intestazioni.
x-ms-content-crc64 Restituito per un BLOB a blocchi in modo che il client possa controllare l'integrità del contenuto del messaggio. Il x-ms-content-crc64 valore restituito viene calcolato da Archiviazione BLOB. Questa intestazione viene sempre restituita.
x-ms-request-id Identifica in modo univoco la richiesta effettuata e puoi usarla per risolvere la risoluzione dei problemi della richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni api.
x-ms-version Versione dell'archiviazione BLOB usata per eseguire la richiesta.
Date Valore di data/ora UTC generato dal servizio, che indica l'ora in cui è stata avviata la risposta.
Access-Control-Allow-Origin Restituito se la richiesta include un'intestazione Origin e la condivisione CORS è abilitata con una regola di corrispondenza. Questa intestazione restituisce il valore dell'intestazione della richiesta di origine se è presente una corrispondenza.
Access-Control-Expose-Headers Restituito se la richiesta include un'intestazione Origin e la condivisione CORS è abilitata con una regola di corrispondenza. Restituisce l'elenco delle intestazioni di risposta che devono essere esposte al client o all'emittente della richiesta.
Access-Control-Allow-Credentials Restituito se la richiesta include un'intestazione e CORS è abilitata con una Origin regola corrispondente che non consente tutte le origini. Questa intestazione è impostata su true.
x-ms-request-server-encrypted: true/false Il valore di questa intestazione è impostato su true se il contenuto della richiesta viene crittografato correttamente usando l'algoritmo specificato. In caso contrario, il valore è impostato su false.
x-ms-encryption-key-sha256 Restituito se la richiesta ha usato una chiave fornita dal cliente per la crittografia, in modo che il client possa assicurarsi che il contenuto della richiesta venga crittografato correttamente usando la chiave specificata.
x-ms-encryption-scope Restituito se la richiesta ha usato un ambito di crittografia, in modo che il client possa assicurarsi che il contenuto della richiesta venga crittografato correttamente usando l'ambito di crittografia.
x-ms-version-id: <DateTime> Restituisce un valore opaco che identifica in modo univoco DateTime il BLOB. Il valore di questa intestazione indica la versione del BLOB e può essere usata nelle richieste successive per accedere al BLOB.

Corpo della risposta

Nessuno.

Risposta di esempio

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==  
x-ms-content-crc64: 77uWZTolTHU
Date: <date>  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: <date>  
Access-Control-Allow-Origin: http://contoso.com  
Access-Control-Expose-Headers: Content-MD5  
Access-Control-Allow-Credentials: True  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>  

Autorizzazione

L'autorizzazione è necessaria quando si chiama qualsiasi operazione di accesso ai dati in Archiviazione di Azure. È possibile autorizzare l'operazione Put Blob From URL come descritto di seguito.

Se una richiesta specifica i tag con l'intestazione della richiesta, il chiamante deve soddisfare i requisiti di autorizzazione dell'operazione x-ms-tagsImposta tag BLOB .

Archiviazione di Azure supporta l'uso di Microsoft Entra ID per autorizzare le richieste ai dati BLOB. Con Microsoft Entra ID è possibile usare il controllo degli accessi in base al ruolo di Azure per concedere le autorizzazioni a un'entità di sicurezza. L'entità di sicurezza può essere un utente, un gruppo, un'entità servizio applicazione o un'identità gestita di Azure. L'entità di sicurezza viene autenticata da Microsoft Entra ID per restituire un token OAuth 2.0. Il token può quindi essere usato per autorizzare una richiesta relativa al servizio BLOB.

Per altre informazioni sull'autorizzazione usando Microsoft Entra ID, vedere Autorizzare l'accesso ai BLOB usando Microsoft Entra ID.

Autorizzazioni

Di seguito è riportata l'azione RBAC necessaria per un utente, un gruppo o un'entità servizio di Microsoft Entra per chiamare l'operazione Put Blob From URL e il ruolo di controllo degli accessi in base al ruolo predefinito di Azure con privilegi minimi che include questa azione:

Per altre informazioni sull'assegnazione dei ruoli tramite controllo degli accessi in base al ruolo di Azure, vedere Assegnare un ruolo di Azure per l'accesso ai dati BLOB.

Commenti

L'operazione Put Blob From URL è supportata a partire dalla versione 2020-04-08.

Nella versione 2020-10-02 e successiva, l'autorizzazione di Azure Active Directory è supportata per l'origine dell'operazione di copia.

Il BLOB di origine può essere di qualsiasi tipo, incluso un BLOB a blocchi, un BLOB di accodamento o un BLOB di pagine. Il BLOB di destinazione, tuttavia, deve essere un BLOB a blocchi.

L'operazione Put Blob From URL copia sempre l'intero BLOB di origine. La copia di un intervallo di byte o di un set di blocchi non è supportata. Per eseguire aggiornamenti parziali, fare riferimento a Put Block From URL. Il BLOB di destinazione può essere un BLOB a blocchi esistente oppure può essere un nuovo BLOB creato dall'operazione.

Quando si usa un BLOB a blocchi come oggetto di origine, viene copiato tutto il contenuto BLOB di commit. Tuttavia, l'elenco di blocchi non viene mantenuto e i blocchi non vengono copiati. Il contenuto del BLOB di destinazione è identico a quello dell'origine, ma l'elenco di blocchi di commit non viene mantenuto.

Inserire proprietà e metadati BLOB

Quando si crea un BLOB a blocchi da un'origine di copia, le proprietà del BLOB standard vengono copiate per impostazione predefinita dal BLOB di origine. Se i metadati dell'applicazione vengono specificati nella richiesta, vengono archiviati senza copiare i metadati del BLOB di origine. Per impostare in modo esplicito eventuali intestazioni di contenuto HTTP, è possibile specificare l'intestazione corrispondente nella richiesta.

  • Content-Type

  • Content-Encoding

  • Content-Length

  • Cache-Control

  • Content-Disposition

Le dimensioni del BLOB di destinazione corrispondono sempre a quella del BLOB di origine. L'intestazione Content-Length deve essere 0 nella Put Blob From URL richiesta (perché non è presente alcun corpo della richiesta) e la proprietà lunghezza del contenuto per il BLOB di destinazione viene derivata dalle dimensioni dell'origine.

Inserire BLOB da proprietà personalizzate url

Put Blob From Url segue la stessa semantica di Put Blob per impostare proprietà personalizzate associate alle intestazioni HTTP standard. Per altre informazioni, vedere Proprietà personalizzate BLOB

Tag indice del BLOB

Se i tag per il BLOB di destinazione vengono forniti nell'intestazione x-ms-tags , devono essere codificati con stringa di query. I valori e le chiavi tag devono essere conformi ai requisiti di denominazione e lunghezza, come specificato in Set Blob Tags. Inoltre, l'intestazione x-ms-tags può contenere fino a 2 KiB di tag. Se sono necessari altri tag, usare l'operazione Set Blob Tags .

Se i tag non vengono forniti nell'intestazione x-ms-tags , non vengono copiati dal BLOB di origine.

Ambiti di crittografia e chiavi fornite dal cliente

L'API Put BLOB From URL supporta rispettivamente gli ambiti di crittografia e le chiavi fornite dal cliente usando rispettivamente le x-ms-encryption-scope intestazioni e x-ms-encryption-key .

Se l'intestazione x-ms-copy-source fa riferimento allo stesso BLOB di origine del BLOB di destinazione nell'URI della richiesta, l'operazione Put Blob From URL esegue una riscrittura sincrona sul posto del BLOB. Ciò consente di riscrivere un BLOB per usare una chiave di crittografia o un ambito di crittografia diverso.

Fatturazione

Le richieste di prezzi possono derivare dai client che usano le API di archiviazione BLOB, direttamente tramite l'API REST dell'archiviazione BLOB o da una libreria client di Archiviazione di Azure. Queste richieste accumulano addebiti per transazione. Il tipo di transazione influisce sul modo in cui viene addebitato l'account. Ad esempio, le transazioni di lettura si accumulano in una categoria di fatturazione diversa rispetto alle transazioni di scrittura. Nella tabella seguente viene illustrata la categoria di fatturazione per Put Blob From URL le richieste in base al tipo di account di archiviazione:

Operazione Tipo di account di archiviazione Categoria di fatturazione
Inserire BLOB dall'URL (account di destinazione1) BLOB di blocchi Premium
Utilizzo generico v2 Standard
Utilizzo generico standard v1
Operazioni di scrittura
Inserire BLOB dall'URL (account di origine2) BLOB di blocchi Premium
Utilizzo generico v2 Standard
Utilizzo generico standard v1
Operazioni di lettura

1L'account di destinazione viene addebitato per una transazione per avviare la scrittura.
2L'account di origine comporta una transazione per ogni richiesta di lettura all'oggetto di origine.

Inoltre, se gli account di origine e di destinazione risiedono in aree diverse (ad esempio Stati Uniti settentrionali e Stati Uniti meridionali), la larghezza di banda usata per trasferire la richiesta viene addebitata all'account di archiviazione di origine come uscita. L'uscita tra account della stessa area geografica è gratuita.

Infine, la creazione di un nuovo BLOB con un nome diverso all'interno dello stesso account di archiviazione usa risorse di archiviazione aggiuntive, quindi l'operazione comporta un addebito rispetto all'utilizzo della capacità dell'account di archiviazione per tali risorse aggiuntive.

Per informazioni sui prezzi per le categorie di fatturazione specificate, vedere prezzi Archiviazione BLOB di Azure.

Vedi anche

Autorizzare le richieste allo stato di archiviazione di Azuree ai codici di errore codici di errore delservizio BLOBImposta timeout per le operazioni del servizio BLOB