azcopy copy

Copia i dati di origine in un percorso di destinazione.

Nota

AzCopy non supporta scenari in cui l'origine o la destinazione viene modificata attivamente durante il trasferimento.

Riepilogo

Copia i dati di origine in un percorso di destinazione. Le indicazioni supportate sono:

  • local <-> BLOB di Azure (autenticazione SAS o OAuth)
  • local <-> File di Azure (autenticazione sas di condivisione/directory o autenticazione OAuth)
  • local <-> Azure Data Lake Storage (autenticazione SAS, OAuth o SharedKey)
  • BLOB di Azure (SAS o pubblico):> BLOB di Azure (autenticazione SAS o OAuth)
  • Azure Data Lake Storage (SAS o pubblico) -> Azure Data Lake Storage (autenticazione SAS o OAuth)
  • BLOB di Azure (firma di accesso condiviso o autenticazione OAuth) <-> BLOB di Azure (autenticazione SAS o OAuth) - Vedere Linee guida.
  • Azure Data Lake Storage (autenticazione SAS o OAuth) <-> Azure Data Lake Storage (autenticazione SAS o OAuth)
  • Azure Data Lake Storage (autenticazione SAS o OAuth) <-> BLOB di Azure (autenticazione SAS o OAuth)
  • BLOB di Azure (SAS o pubblico):> File di Azure (SAS)
  • File di Azure (autenticazione SAS o OAuth) <-> File di Azure (autenticazione SAS o OAuth)
  • File di Azure (SAS) -> BLOB di Azure (autenticazione SAS o OAuth)
  • AWS S3 (chiave di accesso) -> BLOB in blocchi di Azure (autenticazione SAS o OAuth)
  • Google Cloud Storage (chiave dell'account del servizio) -> BLOB in blocchi di Azure (autenticazione SAS o OAuth)

Per altre informazioni, vedere gli esempi.

Avanzato

AzCopy rileva automaticamente il tipo di contenuto dei file durante il caricamento dal disco locale, in base all'estensione o al contenuto del file (se non è specificata alcuna estensione).

La tabella di ricerca predefinita è piccola, ma in Unix è aumentata dai file mime.types del sistema locale, se disponibili in uno o più di questi nomi:

  • /etc/mime.types
  • /etc/apache2/mime.types
  • /etc/apache/mime.types

In Windows i tipi MIME vengono estratti dal Registro di sistema. Questa funzionalità può essere disattivata con l'aiuto di un flag. Fare riferimento alla sezione flag.

Se si imposta una variabile di ambiente usando la riga di comando, tale variabile è leggibile nella cronologia della riga di comando. Valutare la possibilità di cancellare le variabili che contengono credenziali dalla cronologia della riga di comando. Per impedire la visualizzazione delle variabili nella cronologia, è possibile usare uno script per richiedere all'utente le credenziali e impostare la variabile di ambiente.

azcopy copy [source] [destination] [flags]

Esempi

Caricare un singolo file usando l'autenticazione OAuth. Se non è ancora stato eseguito l'accesso ad AzCopy, eseguire il comando azcopy login prima di eseguire il comando seguente.

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"

Come in precedenza, ma questa volta calcola anche l'hash MD5 del contenuto del file e lo salva come proprietà Content-MD5 del BLOB:

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5

Caricare un singolo file usando un token di firma di accesso condiviso:

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Caricare un singolo file usando un token di firma di accesso condiviso e un piping (solo BLOB in blocchi):

cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob

Caricare un singolo file usando OAuth e piping (solo BLOB in blocchi):

cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob

Caricare un'intera directory usando un token di firma di accesso condiviso:

azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

or

azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --put-md5

Caricare un set di file usando un token di firma di accesso condiviso e i caratteri jolly (*) :

azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"

Caricare file e directory usando un token di firma di accesso condiviso e i caratteri jolly (*) :

azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

Caricare file e directory in Archiviazione di Azure account e impostare i tag codificati della stringa di query nel BLOB.

  • Per impostare tag {key = "bla bla", val = "foo"} e {key = "bla bla 2", val = "bar"}, usare la sintassi seguente:
  • azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"
  • Le chiavi e i valori sono codificati in URL e le coppie chiave-valore sono separate da un e commerciale ('&')
  • Durante l'impostazione dei tag nei BLOB, sono disponibili altre autorizzazioni (non per i tag) nella firma di accesso condiviso senza la quale il servizio restituisce l'errore di autorizzazione.

Scaricare un singolo file usando l'autenticazione OAuth. Se non è ancora stato eseguito l'accesso ad AzCopy, eseguire il comando azcopy login prima di eseguire il comando seguente.

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"

Scaricare un singolo file usando un token di firma di accesso condiviso:

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"

Scaricare un singolo file usando un token di firma di accesso condiviso e quindi inviare l'output a un file (solo BLOB in blocchi):

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"

Scaricare un singolo file usando OAuth e quindi eseguire il piping dell'output in un file (solo BLOB in blocchi):

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"

Scaricare un'intera directory usando un token di firma di accesso condiviso:

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true

Nota sull'uso di un carattere jolly (*) negli URL:

Esistono solo due modi supportati per usare un carattere jolly in un URL.

  • È possibile usarne uno subito dopo la barra finale (/) di un URL. In questo modo tutti i file in una directory vengono copiati direttamente nella destinazione senza inserirli in una sottodirectory.

  • È anche possibile usarne uno nel nome di un contenitore, purché l'URL faccia riferimento solo a un contenitore e non a un BLOB. È possibile usare questo approccio per ottenere file da un subset di contenitori.

Scaricare il contenuto di una directory senza copiare la directory contenitore stessa.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"

Scaricare un intero account di archiviazione.

azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive

Scaricare un subset di contenitori all'interno di un account di archiviazione usando un simbolo jolly (*) nel nome del contenitore.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive

Scaricare tutte le versioni di un BLOB da Archiviazione di Azure elencate in un file di testo (ad esempio: versionidsFile) nella directory locale. Assicurarsi che l'origine sia un BLOB valido, la destinazione sia una cartella locale e versionidsFile sia un file di testo in cui ogni versione viene scritta in una riga separata. Tutte le versioni specificate vengono scaricate nella cartella di destinazione specificata.

azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/another/path/to/dir/[versionidsFile]"

Copiare un singolo BLOB in un altro BLOB usando un token di firma di accesso condiviso.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Copiare un singolo BLOB in un altro BLOB usando un token di firma di accesso condiviso e un token OAuth.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"

Copiare una directory virtuale BLOB in un'altra usando un token di firma di accesso condiviso:

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

Copiare tutti i contenitori BLOB, le directory e i BLOB dall'account di archiviazione a un altro usando un token di firma di accesso condiviso:

azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Copiare un singolo oggetto nell'archiviazione BLOB da Amazon Web Services (AWS) S3 usando una chiave di accesso e un token di firma di accesso condiviso. Prima di tutto, impostare la variabile di ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY per l'origine AWS S3.

azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Copiare un'intera directory in Archiviazione BLOB da AWS S3 usando una chiave di accesso e un token di firma di accesso condiviso. Prima di tutto, impostare la variabile di ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY per l'origine AWS S3.

azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

Fare riferimento a https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html per comprendere meglio il segnaposto [cartella].

Copiare tutti i bucket nell'archiviazione BLOB da Amazon Web Services (AWS) usando una chiave di accesso e un token di firma di accesso condiviso. Prima di tutto, impostare la variabile di ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY per l'origine AWS S3.

azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Copiare tutti i bucket nell'archiviazione BLOB da un'area di Amazon Web Services (AWS) usando una chiave di accesso e un token di firma di accesso condiviso. Prima di tutto, impostare la variabile di ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY per l'origine AWS S3.

azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Copiare un subset di bucket usando un simbolo jolly (*) nel nome del bucket. Come negli esempi precedenti, sono necessari una chiave di accesso e un token di firma di accesso condiviso. Assicurarsi di impostare la variabile di ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY per l'origine AWS S3.

azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Copiare BLOB da un archivio BLOB a un altro e mantenere i tag dall'origine. Per mantenere i tag, usare la sintassi seguente:

azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --s2s-preserve-blob-tags=true

Trasferire file e directory per Archiviazione di Azure account e impostare i tag codificati della stringa di query specificati nel BLOB.

  • Per impostare tag {key = "bla bla", val = "foo"} e {key = "bla bla 2", val = "bar"}, usare la sintassi seguente:

    azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"

  • Le chiavi e i valori sono codificati in URL e le coppie chiave-valore sono separate da un e commerciale ('&')

  • Durante l'impostazione dei tag nei BLOB, sono disponibili autorizzazioni aggiuntive (non per i tag) nella firma di accesso condiviso senza le quali il servizio restituirà l'errore di autorizzazione.

Copiare un singolo oggetto in Archiviazione BLOB da Google Cloud Storage (GCS) usando una chiave dell'account del servizio e un token di firma di accesso condiviso. Impostare prima di tutto la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS per l'origine GCS.

azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Copiare un'intera directory in Archiviazione BLOB da Google Cloud Storage (GCS) usando una chiave dell'account del servizio e un token di firma di accesso condiviso. Impostare prima di tutto la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS per l'origine GCS.

azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

Copiare un intero bucket nell'archiviazione BLOB da Google Cloud Storage (GCS) usando una chiave dell'account del servizio e un token di firma di accesso condiviso. Impostare prima di tutto la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS per l'origine GCS.

azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

Copiare tutti i bucket nell'archiviazione BLOB da Google Cloud Storage (GCS) usando una chiave dell'account del servizio e un token di firma di accesso condiviso. Prima di tutto, impostare le variabili di ambiente GOOGLE_APPLICATION_CREDENTIALS e GOOGLE_CLOUD_PROJECT=<project-id> per l'origine GCS

azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

Copiare un sottoinsieme di bucket usando un simbolo jolly (*) nel nome del bucket da Google Cloud Storage (GCS) usando una chiave dell'account del servizio e un token di firma di accesso condiviso per la destinazione. Prima di tutto, impostare le variabili GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id> di ambiente per l'origine GCS

azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

Per copiare i file modificati prima o dopo l'avvio del processo AzCopy, AzCopy fornisce la data e l'ora nel log del processo nel formato ISO8601 (cercare "ISO 8601 START TIME" nel log del processo) che può essere usato con i --include-after flag e --include-before , vedere gli esempi seguenti. Ciò è utile per le copie incrementali.

Copiare un subset di file modificati in o dopo la data e l'ora specificati (in formato ISO8601) in un contenitore usando il include-after flag .

azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-after="2020-08-19T15:04:00Z"

Copiare un subset di file modificati in o prima della data e dell'ora specificati (in formato ISO8601) in un contenitore usando il include-before flag .

azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-before="2020-08-19T15:04:00Z"

Opzioni

--as-subdir True per impostazione predefinita. Inserisce le origini delle cartelle come sottodirectory nella destinazione. (valore predefinito true)

--backup Attiva SeBackupPrivilege di Windows per i caricamenti o SeRestorePrivilege per i download, per consentire ad AzCopy di visualizzare tutti i file, indipendentemente dalle autorizzazioni del file system e di ripristinare tutte le autorizzazioni. Richiede che l'account che esegue AzCopy disponga già di queste autorizzazioni ( ad esempio, ha diritti di amministratore o è membro del gruppo 'Backup Operators'). Questo flag attiva i privilegi già presenti nell'account

--blob-tags (string) Impostare tag nei BLOB per classificare i dati nell'account di archiviazione

--blob-type (string) Definisce il tipo di BLOB nella destinazione. Viene usato per il caricamento di BLOB e durante la copia tra gli account (impostazione predefinita 'Detect'). I valori validi includono 'Detect', 'BlockBlob', 'PageBlob' e 'AppendBlob'. Quando si esegue la copia tra account, un valore "Detect" fa sì che AzCopy usi il tipo di BLOB di origine per determinare il tipo del BLOB di destinazione. Quando si carica un file, 'Detect' determina se il file è un disco rigido virtuale o un file VHDX in base all'estensione di file. Se il file è un file VHD o VHDX, AzCopy considera il file come BLOB di pagine. (impostazione predefinita "Detect")

--block-blob-tier(stringa) caricare BLOB in blocchi in Archiviazione di Azure usando questo livello BLOB. (valore predefinito "Nessuno")

--block-size-mb(float) Usare questa dimensione del blocco (specificata in MiB) durante il caricamento in Archiviazione di Azure e il download da Archiviazione di Azure. Il valore predefinito viene calcolato automaticamente in base alle dimensioni del file. Le frazioni decimali sono consentite (ad esempio: 0,25). Durante il caricamento o il download, la dimensione massima consentita del blocco è 0,75 * AZCOPY_BUFFER_GB. Per altre informazioni, vedere Ottimizzare l'uso della memoria.

--cache-control (string) Impostare l'intestazione cache-control. Restituito al download.

--check-length Controllare la lunghezza di un file nella destinazione dopo il trasferimento. Se si verifica una mancata corrispondenza tra l'origine e la destinazione, il trasferimento viene contrassegnato come non riuscito. (valore predefinito true)

--check-md5 (string) Specifica la modalità di convalida degli hash MD5 rigorosamente durante il download. Disponibile solo durante il download. Opzioni disponibili: NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing. (impostazione predefinita 'FailIfDifferent') (impostazione predefinita "FailIfDifferent")

--content-disposition (string) Impostare l'intestazione content-disposition. Restituito al download.

--content-encoding (string) Impostare l'intestazione content-encoding. Restituito al download.

--content-language (string) Impostare l'intestazione content-language. Restituito al download.

--content-type (string) Specifica il tipo di contenuto del file. Implica no-guess-mime-type. Restituito al download.

--cpk-by-name (string) Il client ha fornito la chiave in base al nome che fornisce ai client richieste nell'archivio BLOB di Azure un'opzione per fornire una chiave di crittografia per ogni richiesta. Il nome della chiave specificato viene recuperato da Azure Key Vault e viene usato per crittografare i dati

--cpk-by-value False per impostazione predefinita. Il client ha fornito la chiave in base al nome che consente ai client di effettuare richieste nell'archiviazione BLOB di Azure un'opzione per fornire una chiave di crittografia per ogni richiesta. La chiave fornita e il relativo hash vengono recuperati dalle variabili di ambiente

--decompress Decomprime automaticamente i file durante il download, se la codifica del contenuto indica che sono compressi. I valori di codifica del contenuto supportati sono 'gzip' e 'deflate'. Le estensioni di file di '.gz'/'.gzip' o '.zz' non sono necessarie, ma vengono rimosse se presenti.

--disable-auto-decoding False per impostazione predefinita per abilitare la decodifica automatica di caratteri non validi in Windows. Può essere impostato su true per disabilitare la decodifica automatica.

--dry-run False per impostazione predefinita. Stampa i percorsi di file che verrebbero copiati da questo comando. Questo flag non copia i file effettivi. Il flag --overwrite non ha alcun effetto. Se si imposta il flag --overwrite su false, i file nella directory di origine vengono elencati anche se tali file esistono nella directory di destinazione.

--exclude-attributes (string) (solo Windows) Escludere i file i cui attributi corrispondono all'elenco di attributi. Ad esempio: A; S; R

--exclude-blob-type (string) Facoltativamente, specifica il tipo di BLOB (BlockBlob/ PageBlob/ AppendBlob) da escludere durante la copia di BLOB dal contenitore o dall'account. L'uso di questo flag non è applicabile per la copia di dati da non azure-service a servizio. Più BLOB devono essere separati da ';'.

--exclude-container (string) Escludere questi contenitori solo durante il trasferimento dall'account all'account. È possibile separare più contenitori con ';'.

--exclude-path (string) Escludere questi percorsi durante la copia. Questa opzione non supporta caratteri jolly (*). Controlla il prefisso del percorso relativo(ad esempio: myFolder; myFolder/subDirName/file.pdf). Se usato in combinazione con l'attraversamento dell'account, i percorsi non includono il nome del contenitore.

--exclude-pattern (string) Escludere questi file durante la copia. Questa opzione supporta caratteri jolly (*)

--exclude-regex (string) Escludere tutto il percorso relativo dei file allineati alle espressioni regolari. Separare le espressioni regolari con ';'.

--follow-symlinks Seguire i collegamenti simbolici durante il caricamento dal file system locale.

--force-if-read-onlyQuando si sovrascrive un file esistente in Windows o File di Azure, forzare il funzionamento della sovrascrittura anche se nel file esistente è impostato l'attributo di sola lettura

--from-to (string) Facoltativamente, specifica la combinazione di destinazione di origine. Ad esempio: LocalBlob, BlobLocal, LocalBlobFS. Piping: BlobPipe, PipeBlob

-h, --help guida per la copia

--include-after (string) Includere solo i file modificati in o dopo la data/ora specificata. Il valore deve essere in formato ISO8601. Se non viene specificato alcun fuso orario, si presuppone che il valore sia nel fuso orario locale del computer che esegue AzCopy. Ad esempio, 2020-08-19T15:04:00Z per un'ora UTC o 2020-08-19 per la mezzanotte (00:00) nel fuso orario locale. A partire da AzCopy 10.5, questo flag si applica solo ai file, non alle cartelle, quindi le proprietà della cartella non verranno copiate quando si usa questo flag con --preserve-smb-info o --preserve-smb-permissions.

--include-attributes (string) (solo Windows) Includere i file i cui attributi corrispondono all'elenco di attributi. Ad esempio: A; S; R

--include-before (string) Includere solo i file modificati prima o nella data/ora specificata. Il valore deve essere in formato ISO8601. Se non viene specificato alcun fuso orario, si presuppone che il valore sia nel fuso orario locale del computer che esegue AzCopy. ad esempio, 2020-08-19T15:04:00Z per un'ora UTC o 2020-08-19 per la mezzanotte (00:00) nel fuso orario locale. A partire da AzCopy 10.7, questo flag si applica solo ai file, non alle cartelle, quindi le proprietà della cartella non verranno copiate quando si usa questo flag con --preserve-smb-info o --preserve-smb-permissions.

--include-directory-stub False per impostazione predefinita per ignorare gli stub della directory. Gli stub di directory sono BLOB con metadati hdi_isfolder:true. L'impostazione del valore su true manterrà gli stub di directory durante i trasferimenti. L'inclusione di questo flag senza valore è true (ad esempio, azcopy copy --include-directory-stub è uguale azcopy copy --include-directory-stub=truea ).

--include-path (string) Includere solo questi percorsi durante la copia. Questa opzione non supporta caratteri jolly (*). Controlla il prefisso del percorso relativo (ad esempio: myFolder; myFolder/subDirName/file.pdf).

--include-pattern (string) Includere solo questi file durante la copia. Questa opzione supporta caratteri jolly (*). Separare i file usando un ';'.

--include-regex (string) Includere solo il percorso relativo dei file allineati alle espressioni regolari. Separare le espressioni regolari con ';'.

--list-of-versions (string) Specifica un file in cui ogni ID versione è elencato in una riga separata. Assicurarsi che l'origine punti a un singolo BLOB e a tutti gli ID versione specificati nel file usando questo flag devono appartenere solo al BLOB di origine. AzCopy scaricherà le versioni specificate nella cartella di destinazione specificata.

--metadata(string) Caricare in Archiviazione di Azure con queste coppie chiave-valore come metadati.

--no-guess-mime-type Impedisce ad AzCopy di rilevare il tipo di contenuto in base all'estensione o al contenuto del file.

--overwrite (string) Sovrascrivere i file e i BLOB in conflitto nella destinazione se questo flag è impostato su true. (valore predefinito 'true') I valori possibili includono 'true', 'false', 'prompt' e 'ifSourceNewer'. Per le destinazioni che supportano le cartelle, le proprietà a livello di cartella in conflitto vengono sovrascritte se questo flag è "true" o se viene fornita una risposta positiva al prompt. (valore predefinito "true")

--page-blob-tier(string) Caricare BLOB di pagine in Archiviazione di Azure usando questo livello BLOB. (impostazione predefinita 'Nessuno'). (valore predefinito "Nessuno")

--preserve-last-modified-time Disponibile solo quando la destinazione è il file system.

--preserve-owner Ha effetto solo nei download e solo quando --preserve-smb-permissions viene usato. Se true (impostazione predefinita), il proprietario e il gruppo del file vengono mantenuti nei download. Se impostato su false,

--preserve-smb-permissions mantiene comunque gli elenchi di controllo di accesso, ma proprietario e gruppo si basa sull'utente che esegue AzCopy (impostazione predefinita true)

--preserve-permissions False per impostazione predefinita. Mantiene gli ACL tra le risorse con riconoscimento (Windows e File di Azure o Azure Data Lake Storage in Azure Data Lake Storage). Per gli account con uno spazio dei nomi gerarchico, l'entità di sicurezza deve essere l'utente proprietario del contenitore di destinazione oppure deve essere assegnato il ruolo Proprietario dati BLOB di archiviazione, con ambito al contenitore di destinazione, all'account di archiviazione, al gruppo di risorse padre o alla sottoscrizione. Per i download, è necessario anche il --backup flag per ripristinare le autorizzazioni in cui il nuovo proprietario non sarà l'utente che esegue AzCopy. Questo flag si applica sia ai file che alle cartelle, a meno che non venga specificato un filtro solo file , ad esempio un modello di inclusione.

--preserve-posix-properties False per impostazione predefinita. Mantiene le informazioni sulle proprietà ottenute da stat o statx nei metadati dell'oggetto.

--preserve-smb-info Per le posizioni con riconoscimento SMB, il flag è impostato su true per impostazione predefinita. Mantiene le informazioni sulle proprietà SMB (ora dell'ultima scrittura, ora di creazione, bit di attributo) tra le risorse che supportano SMB (Windows e File di Azure). Vengono trasferiti solo i bit di attributo supportati da File di Azure; tutti gli altri vengono ignorati. Questo flag si applica sia ai file che alle cartelle, a meno che non venga specificato un filtro solo file , ad esempio un modello di inclusione. Le informazioni trasferite per le cartelle sono uguali a quelle per i file, ad eccezione del Last Write Time quale non viene mai mantenuta per le cartelle. (valore predefinito true)

--preserve-symlinks Se abilitata, le destinazioni di collegamento simbolico vengono mantenute come contenuto del BLOB, invece di caricare il file o la cartella nell'altra estremità del collegamento simbolico.

--put-blob-size-mbUsare questa dimensione (specificata in MiB) come soglia per determinare se caricare un BLOB come singola richiesta PUT durante il caricamento in Archiviazione di Azure. Il valore predefinito viene calcolato automaticamente in base alle dimensioni del file. Le frazioni decimali sono consentite (ad esempio: 0,25).

--put-md5 Creare un hash MD5 di ogni file e salvare l'hash come proprietà Content-MD5 del BLOB o del file di destinazione. Per impostazione predefinita, l'hash NON viene creato. Disponibile solo durante il caricamento.

--recursive Esaminare le sottodirectory in modo ricorsivo durante il caricamento dal file system locale.

--s2s-detect-source-changed Rilevare se il file o il BLOB di origine cambia durante la lettura. Questo parametro si applica solo alle copie da servizio a servizio, perché il controllo corrispondente è abilitato in modo permanente per i caricamenti e i download.

--s2s-handle-invalid-metadata (string) Specifica la modalità di gestione delle chiavi di metadati non valide. Opzioni disponibili: ExcludeIfInvalid, FailIfInvalid, RenameIfInvalid. (impostazione predefinita 'ExcludeIfInvalid'). (impostazione predefinita "ExcludeIfInvalid")

--s2s-preserve-access-tier Mantenere il livello di accesso durante la copia del servizio. Fare riferimento ad Archiviazione BLOB di Azure: livelli di accesso ad accesso frequente, sporadico e archivio per assicurarsi che l'account di archiviazione di destinazione supporti l'impostazione del livello di accesso. Nei casi in cui l'impostazione del livello di accesso non è supportata, assicurarsi di usare s2sPreserveAccessTier=false per ignorare la copia del livello di accesso. (valore predefinito true). (valore predefinito true)

--s2s-preserve-blob-tags False per impostazione predefinita. Mantenere i tag di indice durante il trasferimento da servizio a servizio da un archivio BLOB a un altro

--s2s-preserve-properties Mantenere le proprietà complete durante la copia da servizio a servizio. Per AWS S3 e l'origine file di Azure non singola, l'operazione di elenco non restituisce proprietà complete di oggetti e file. Per mantenere le proprietà complete, AzCopy deve inviare un'altra richiesta per oggetto o file. (valore predefinito true)

--trailing-dot Abilitato per impostazione predefinita per gestire le operazioni correlate alla condivisione file in modo sicuro. Opzioni disponibili: Enable, Disable. Scegliere Disable di tornare al trattamento legacy (potenzialmente non sicuro) dei file punto finale in cui il servizio file taglia tutti i punti finali nei percorsi. Ciò può comportare un potenziale danneggiamento dei dati se il trasferimento contiene due percorsi che differiscono solo per un punto finale (ad esempio mypath e mypath.). Se questo flag è impostato su Disable e AzCopy rileva un file punto finale, avvisa i clienti nel log di analisi, ma non tenterà di interrompere l'operazione. Se la destinazione non supporta i file punto finale (Windows o Archiviazione BLOB), AzCopy avrà esito negativo se il file punto finale è la radice del trasferimento e ignora eventuali percorsi di punti finali rilevati durante l'enumerazione.

Opzioni ereditate dai comandi padre

--cap-mbps (float) Riduce la velocità di trasferimento, in megabit al secondo. La velocità effettiva momentanea può variare leggermente rispetto al limite. Se questa opzione è impostata su zero o viene omessa, la velocità effettiva non viene limitata.

--log-level (string) Definire il livello di dettaglio del log per il file di log, i livelli disponibili: INFO(tutte le richieste/risposte), WARNING(risposte lente), ERROR(solo richieste non riuscite) e NONE(nessun log di output). (impostazione predefinita "INFO"). (impostazione predefinita "INFO")

--output-type (string) Formato dell'output del comando. Le scelte includono: testo, json. Il valore predefinito è 'text'. (valore predefinito "text")

--trusted-microsoft-suffixes (string) Specifica suffissi di dominio aggiuntivi in cui è possibile inviare i token di accesso di Microsoft Entra. Il valore predefinito è '.core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Tutti gli elementi elencati di seguito vengono aggiunti all'impostazione predefinita. Per motivi di sicurezza, è consigliabile inserire qui solo i domini di Microsoft Azure. Separare più voci con punti e virgola.

Vedi anche