Inserisci BLOB dall'URL

Articolo
10/22/2024

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 Block From URL insieme a Put Block List.

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

Richiesta

È possibile costruire il 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 del 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 dimensioni BLOB di un massimo di 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`	Opzionale. Il parametro `timeout` è espresso in secondi. Per altre informazioni, vedere Impostare 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 l'ora UTC (Coordinated Universal Time) per la richiesta. 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 utilizzare 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. Il valore deve essere codificato con URL come apparirebbe in un URI della 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 `Content-Length` valido, la richiesta ha esito negativo con il codice di stato 409 (Conflitto). Ecco alcuni esempi di URL di oggetti 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>`	Opzionale. Specifica lo schema di autorizzazione e la firma per l'origine della copia. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure. Nota: per Microsoft Entra è supportato solo uno schema di connessione. Nota: se l'oggetto di origine è accessibile pubblicamente o l'oggetto di origine si trova in un account di archiviazione e si usa un token di firma di accesso condiviso passato in `x-ms-copy-source:name`, questa intestazione non è necessaria. Questa intestazione è supportata nelle versioni 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`	Opzionale. Tipo di contenuto MIME del BLOB. Il tipo predefinito è `application/octet-stream`.
`Content-Encoding`	Opzionale. Specifica le codifiche del contenuto applicate al BLOB. Questo valore viene restituito al client quando viene eseguita l'operazione di get blob sulla risorsa BLOB. Quando viene restituito questo valore, il client può usarlo per decodificare il contenuto del BLOB.
`Content-Language`	Opzionale. Specifica i linguaggi naturali usati da questa risorsa.
`Cache-Control`	Opzionale. Archiviazione BLOB archivia questo valore, ma non lo usa o lo modifica.
`x-ms-source-content-md5`	Opzionale. 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 si specifica questa intestazione, 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, l'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`	Opzionale. Hash CRC64 del contenuto del BLOB. Questo hash viene usato 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 una richiesta 400 (richiesta non valida).
`x-ms-blob-content-type`	Opzionale. Imposta il tipo di contenuto del BLOB.
`x-ms-blob-content-encoding`	Opzionale. Imposta la codifica del contenuto del BLOB.
`x-ms-blob-content-language`	Opzionale. Imposta la lingua del contenuto del BLOB.
`x-ms-blob-content-md5`	Opzionale. Imposta l'hash MD5 del BLOB.
`x-ms-blob-cache-control`	Opzionale. Imposta il controllo cache del BLOB.
`x-ms-meta-name:value`	Opzionale. 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`	Opzionale. Ambito di crittografia da usare per crittografare il contenuto della richiesta. Questa intestazione è supportata nella versione 2019-02-02 e successive.
`x-ms-tags`	Opzionale. Imposta i tag con codifica query-stringa specificati nel BLOB. Per altre informazioni, vedere la sezione Osservazioni. Supportato nella versione 2019-12-12 e successive.
`x-ms-copy-source-tag-option`	Opzionale. I valori possibili sono REPLACE o COPY (con distinzione tra maiuscole e minuscole). Il valore predefinito è REPLACE. Se si specifica 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 i tag BLOB nel BLOB di destinazione. Ciò comporta una chiamata aggiuntiva all'operazione di get blob dell'sull'account di origine. REPLACE imposta i tag specificati dall'intestazione `x-ms-tags` nel BLOB di destinazione. Se si usa REPLACE e non vengono specificati tag da `x-ms-tags`, nel BLOB di destinazione non vengono impostati tag. Se si specifica COPY e `x-ms-tags` si ottiene un 409 (conflitto). Supportato nella versione 2021-04-10 e successive.
`x-ms-copy-source-blob-properties`	Opzionale. Specifica il comportamento delle proprietà del BLOB di origine di 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`	Opzionale. 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 di File di Azure.
`x-ms-source-if-unmodified-since`	Opzionale. 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, l'archiviazione BLOB restituisce il codice di stato 412 (precondizione non riuscita). Questa intestazione non può essere specificata se l'origine è una condivisione di File di Azure.
`x-ms-source-if-match`	Opzionale. 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, l'archiviazione BLOB restituisce il codice di stato 412 (Precondizione non riuscita). Questa intestazione non può essere specificata se l'origine è una condivisione di File di Azure.
`x-ms-source-if-none-match`	Opzionale. 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, l'archiviazione BLOB restituisce il codice di stato 412 (precondizione non riuscita). Questa intestazione non può essere specificata se l'origine è una condivisione di File di Azure.
`If-Modified-Since`	Opzionale. 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`	Opzionale. 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, l'archiviazione BLOB restituisce il codice di stato 412 (Precondizione non riuscita).
`If-Match`	Opzionale. Valore ETag. Specificare un valore ETag per questa intestazione condizionale per inserire il BLOB solo se il valore ETag specificato corrisponde al valore `ETag` 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`	Opzionale. Valore ETag o 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>`	Obbligatorio se il BLOB ha un lease attivo. Per eseguire questa operazione in un BLOB con un lease attivo, specificare l'ID lease valido per questa intestazione.
`x-ms-blob-content-disposition`	Opzionale. Imposta l'intestazione `Content-Disposition` del BLOB. Disponibile per la versione 2013-08-15 e successive. Il campo intestazione della risposta `Content-Disposition` fornisce informazioni aggiuntive su come elaborare il payload della risposta e può essere usato per allegare metadati aggiuntivi. Ad esempio, se l'intestazione è impostata su `attachment`, indica che l'agente utente non deve visualizzare la risposta. Verrà invece visualizzata una finestra di dialogo Salva con nome diverso dal nome del BLOB specificato. La risposta dell'Get BLOB e get blob Properties operazioni include l'intestazione `content-disposition`.
`Origin`	Opzionale. Specifica l'origine da cui viene emessa la richiesta. La presenza di questa intestazione genera intestazioni CORS (Cross-Origin Resource Sharing) nella risposta. Per altre informazioni, vedere supporto CORS per i servizi di archiviazione di Azure.
`x-ms-client-request-id`	Opzionale. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log di analisi quando la registrazione di Analisi archiviazione è abilitata. È consigliabile usare questa intestazione per correlare le attività sul lato client alle richieste ricevute dal server.
`x-ms-access-tier`	Opzionale. Indica il livello da impostare nel BLOB. I valori validi per i livelli BLOB in blocchi sono `Hot`, `Cool`, `Cold`e `Archive`. Nota: il livello `Cold` è supportato per la versione 2021-12-02 e successive. `Hot`, `Cool`e `Archive` sono supportati per la versione 2018-11-09 e successive. Per altre informazioni sulla suddivisione in livelli BLOB in blocchi, vedere livelli di archiviazione ad accesso frequente, ad accesso sporadico e archivio.
`x-ms-expiry-option`	Opzionale. Versione 2023-08-03 e 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`	Opzionale. Versione 2023-08-03 e successive. Specifica l'ora di scadenza del BLOB. 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 le intestazioni condizionali per le operazioni di archiviazione BLOB.

Intestazioni della richiesta (chiavi di crittografia fornite dal cliente)

È possibile specificare le intestazioni seguenti nella richiesta per crittografare un BLOB con una chiave fornita dal cliente. La crittografia con una chiave fornita dal cliente (e il set di intestazioni corrispondente) è facoltativa.

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 utilizzare per la crittografia. Il valore di questa intestazione deve essere `AES256`.

Corpo della richiesta

Nessuno.

Richiesta di esempio

L'esempio seguente mostra una richiesta di creazione di 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

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

Codice di stato

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

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

Intestazioni di risposta

La risposta per questa operazione include le intestazioni seguenti. La risposta può includere anche intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1 .

Intestazione della risposta	Descrizione
`ETag`	L'ETag contiene un valore che il client può usare per eseguire operazioni di `PUT` condizionali usando l'intestazione della richiesta `If-Match`. Il valore ETag è racchiuso tra virgolette.
`Last-Modified`	Data/ora dell'ultima modifica del BLOB. Il formato della data segue RFC 1123. Per altre informazioni, vedere Rappresentare valori di data/ora nelle intestazioni. Qualsiasi operazione di scrittura sul BLOB (inclusi gli aggiornamenti sui metadati o sulle proprietà del BLOB) modifica l'ora dell'ultima modifica del BLOB.
`Content-MD5`	Restituito per un BLOB in blocchi in modo che il client possa controllare l'integrità del contenuto del messaggio. Il valore restituito `Content-MD5` viene calcolato dall'archiviazione BLOB. Questa intestazione viene restituita anche quando la richiesta non include intestazioni `Content-MD5` o `x-ms-blob-content-md5`.
`x-ms-content-crc64`	Restituito per un BLOB in blocchi in modo che il client possa controllare l'integrità del contenuto del messaggio. Il valore restituito `x-ms-content-crc64` viene calcolato dall'archiviazione BLOB. Questa intestazione viene sempre restituita.
`x-ms-request-id`	Identifica in modo univoco la richiesta effettuata ed è possibile usarla per risolvere i problemi della richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni API.
`x-ms-version`	Versione dell'archivio BLOB usata per eseguire la richiesta.
`Date`	Valore di data/ora UTC generato dal servizio, che indica l'ora di avvio della risposta.
`Access-Control-Allow-Origin`	Restituito se la richiesta include un'intestazione `Origin` e CORS è abilitata con una regola corrispondente. Questa intestazione restituisce il valore dell'intestazione della richiesta di origine se esiste una corrispondenza.
`Access-Control-Expose-Headers`	Restituito se la richiesta include un'intestazione `Origin` e CORS è abilitata con una regola corrispondente. Restituisce l'elenco di intestazioni di risposta che devono essere esposte al client o all'autorità emittente della richiesta.
`Access-Control-Allow-Credentials`	Restituito se la richiesta include un'intestazione `Origin` e CORS è abilitata con una 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 fornita.
`x-ms-encryption-scope`	Restituito se la richiesta ha usato un ambito di crittografia, in modo che il client possa garantire che il contenuto della richiesta venga crittografato correttamente usando l'ambito di crittografia.
`x-ms-version-id: <DateTime>`	Restituisce un valore `DateTime` opaco che identifica in modo univoco 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 un'operazione di accesso ai dati in Archiviazione di Azure. È possibile autorizzare l'operazione di Put Blob From URL come descritto di seguito.

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

Importante

Microsoft consiglia di usare l'ID Microsoft Entra con identità gestite per autorizzare le richieste ad Archiviazione di Azure. Microsoft Entra ID offre maggiore sicurezza e facilità d'uso rispetto all'autorizzazione con chiave condivisa.

Microsoft Entra ID (scelta consigliata)
firme di accesso condiviso
chiave condivisa

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 sul servizio BLOB.

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

Autorizzazioni

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

'azione controllo degli accessi in base al ruolo di Azure:
- Creare un nuovo BLOB in blocchi: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
- Creare un BLOB in blocchi nuovo o sovrascritto esistente: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Ruolo predefinito con privilegi minimi:Collaboratore ai dati dei BLOB di archiviazione

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

Una firma di accesso condiviso fornisce accesso delegato sicuro alle risorse in un account di archiviazione. Con una firma di accesso condiviso è possibile controllare in modo granulare il modo in cui un client può accedere ai dati. È possibile specificare quale risorsa può accedere al client, quali autorizzazioni hanno per tali risorse e per quanto tempo la firma di accesso condiviso è valida.

L'operazione di supporta tre tipi di firme di accesso condiviso: delega utente sas, firma di accesso condiviso del servizio e account sas.

Come procedura consigliata per la sicurezza, è consigliabile usare le credenziali di Microsoft Entra anziché la chiave dell'account di archiviazione, che può essere compromessa più facilmente. Se la progettazione dell'applicazione richiede firme di accesso condiviso, usare le credenziali di Microsoft Entra per creare una firma di accesso condiviso di delega utente, quando possibile.

Quando l'accesso con chiave condivisa non è consentito per l'account di archiviazione, un token di firma di accesso condiviso del servizio o un token di firma di accesso condiviso dell'account non sarà consentito in una richiesta di archiviazione BLOB. Per altre informazioni, vedere Comprendere in che modo la chiave condivisa influisce sui token di firma di accesso condiviso.

Firma di accesso condiviso delega utente

Una firma di accesso condiviso della delega utente è protetta con le credenziali di Microsoft Entra e anche dalle autorizzazioni specificate per la firma di accesso condiviso.

Per chiamare l'operazione di Put Blob From URL usando un token di firma di accesso condiviso delegato a un contenitore o a una risorsa BLOB, è necessaria l'autorizzazione seguente come parte del token di firma di accesso condiviso della delega utente:

Operazione	Autorizzazione firmata
Put Blob From URL (creare un nuovo BLOB in blocchi)	Creare (c) o Scrivere (w)
Put Blob From URL (sovrascrivere blob in blocchi esistenti)	Scrittura (w)

Per altre informazioni sulla firma di accesso condiviso della delega utente, vedere Creare una firma di accesso condiviso di delega utente.

Firma di accesso condiviso del servizio

Una firma di accesso condiviso del servizio è protetta con la chiave dell'account di archiviazione. Una firma di accesso condiviso del servizio delega l'accesso a una risorsa in un singolo servizio di archiviazione di Azure, ad esempio l'archiviazione BLOB.

Operazione	Autorizzazione firmata
Put Blob From URL (creare un nuovo BLOB in blocchi)	Creare (c) o Scrivere (w)
Put Blob From URL (sovrascrivere blob in blocchi esistenti)	Scrittura (w)

Per altre informazioni sulla firma di accesso condiviso del servizio, vedere Creare una firma di accesso condiviso del servizio.

Firma di accesso condiviso dell'account

Una firma di accesso condiviso dell'account è protetta con la chiave dell'account di archiviazione. Una firma di accesso condiviso dell'account delega l'accesso alle risorse in uno o più servizi di archiviazione. Tutte le operazioni disponibili tramite una firma di accesso condiviso del servizio o della delega utente sono disponibili anche tramite una firma di accesso condiviso dell'account.

La tabella seguente indica il tipo di risorsa firmata e le autorizzazioni firmate per specificare quando si delega l'accesso:

Operazione	Servizio firmato	Tipo di risorsa firmato	Autorizzazione firmata
Put Blob From URL (creare un nuovo BLOB in blocchi)	BLOB (b)	Oggetto (o)	Creare (c) o Scrivere (w)
Put Blob From URL (sovrascrivere blob in blocchi esistenti)	BLOB (b)	Oggetto (o)	Scrittura (w)

Per altre informazioni sulla firma di accesso condiviso dell'account, vedere Creare una firma di accesso condiviso dell'account.

L'operazione di Put Blob From URL supporta autorizzazione con chiave condivisa. L'autorizzazione con le chiavi dell'account non è consigliata per la maggior parte degli scenari, perché è meno sicura.

Microsoft consiglia di non consentire l'autorizzazione della chiave condivisa per l'account di archiviazione, quando possibile. Per altre informazioni, vedere Impedire l'autorizzazione con chiave condivisa.

Osservazioni

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

Nella versione 2020-10-02 e successive, l'autorizzazione di Microsoft Entra è supportata per l'origine dell'operazione di copia.

Il BLOB di origine può essere di qualsiasi tipo, incluso un BLOB in blocchi, un BLOB di accodamento o un BLOB di pagine. Il BLOB di destinazione, tuttavia, deve essere un BLOB in 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, vedere Put Block From URL. Il BLOB di destinazione può essere un BLOB in blocchi esistente oppure può essere un nuovo BLOB creato dall'operazione.

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

Proprietà e metadati Put BLOB

Quando si crea un BLOB in 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 richiesta di Put Blob From URL (perché non è presente alcun corpo della richiesta) e la proprietà relativa alla lunghezza del contenuto per il BLOB di destinazione viene dedotta dalle dimensioni dell'origine.

Proprietà personalizzate put BLOB from 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 di indice BLOB

Se i tag per il BLOB di destinazione vengono forniti nell'intestazione x-ms-tags, devono essere codificati in stringhe di query. Le chiavi e i valori dei tag devono essere conformi ai requisiti di denominazione e lunghezza specificati in Set Blob Tags. Inoltre, l'intestazione x-ms-tags può contenere fino a 2 KiB di tag. Se sono necessari più tag, usare l'operazione di 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 sia gli ambiti di crittografia che le chiavi fornite dal cliente, usando rispettivamente le intestazioni x-ms-encryption-scope 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 di Put Blob From URL esegue una riscrittura sul posto sincrona 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 provenire 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 sulla modalità di addebito dell'account. Ad esempio, le transazioni di lettura si accumulano in una categoria di fatturazione diversa rispetto alle transazioni di scrittura. La tabella seguente illustra la categoria di fatturazione per Put Blob From URL richieste in base al tipo di account di archiviazione:

Operazione	Tipo di account di archiviazione	Categoria di fatturazione
Put Blob From URL (account di destinazione¹)	BLOB in blocchi Premium Standard per utilizzo generico v2 Standard per utilizzo generico v1	Operazioni di scrittura
Put BLOB from URL (source account²)	BLOB in blocchi Premium Standard per utilizzo generico v2 Standard per utilizzo generico v1	Operazioni di lettura

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

Inoltre, se gli account di origine e di destinazione si trovano 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 all'interno della stessa area è 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 in base all'utilizzo della capacità dell'account di archiviazione per tali risorse aggiuntive.

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

Vedere anche

Autorizzare le richieste ad Archiviazione di Azure Stato e codici di errore codici di errore del servizio BLOB Impostare i timeout per le operazioni del servizio BLOB

Condividi tramite