Freigeben über


az storage blob copy

Note

Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Erfahren Sie mehr über Erweiterungen.

Verwalten von BLOB-Kopiervorgängen. Verwenden Sie az storage blob show, um den Status der Blobs zu überprüfen.

Befehle

Name Beschreibung Typ Status
az storage blob copy cancel

Abbrechen eines laufenden Kopiervorgangs.

Core GA
az storage blob copy start

Kopieren Sie ein Blob asynchron. Verwenden Sie az storage blob show, um den Status der Blobs zu überprüfen.

Core GA
az storage blob copy start (storage-blob-preview Erweiterung)

Starten Sie einen Kopier-BLOB-Auftrag.

Extension GA
az storage blob copy start-batch

Kopieren Sie mehrere Blobs in einen BLOB-Container. Verwenden Sie az storage blob show, um den Status der Blobs zu überprüfen.

Core GA

az storage blob copy cancel

Abbrechen eines laufenden Kopiervorgangs.

Dadurch bleibt ein Ziel-BLOB mit null Länge und vollständigen Metadaten erhalten. Dadurch wird ein Fehler ausgelöst, wenn der Kopiervorgang bereits beendet wurde.

az storage blob copy cancel --copy-id
                            --destination-blob
                            --destination-container
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--lease-id]
                            [--sas-token]
                            [--timeout]

Erforderliche Parameter

--copy-id

Der kopiervorgang, der abgebrochen werden soll. Dies kann entweder eine ID-Zeichenfolge oder eine Instanz von BlobProperties sein.

--destination-blob -b

Name des Ziel-BLOB. Wenn sie vorhanden ist, wird sie überschrieben.

--destination-container -c

Der Containername.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--account-name

Speicherkontoname. Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent erreicht werden.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Eigenschaft Wert
Zulässige Werte: key, login
--blob-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--lease-id

Erforderlich, wenn das Ziel-BLOB über eine aktive unendliche Lease verfügt.

--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az storage blob copy start

Kopieren Sie ein Blob asynchron. Verwenden Sie az storage blob show, um den Status der Blobs zu überprüfen.

az storage blob copy start --destination-blob
                           --destination-container
                           [--account-key]
                           [--account-name]
                           [--auth-mode {key, login}]
                           [--blob-endpoint]
                           [--connection-string]
                           [--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
                           [--destination-if-match]
                           [--destination-if-modified-since]
                           [--destination-if-none-match]
                           [--destination-if-unmodified-since]
                           [--destination-lease-id]
                           [--destination-tags-condition]
                           [--metadata]
                           [--rehydrate-priority]
                           [--requires-sync {false, true}]
                           [--sas-token]
                           [--source-account-key]
                           [--source-account-name]
                           [--source-blob]
                           [--source-container]
                           [--source-if-match]
                           [--source-if-modified-since]
                           [--source-if-none-match]
                           [--source-if-unmodified-since]
                           [--source-lease-id]
                           [--source-path]
                           [--source-sas]
                           [--source-share]
                           [--source-snapshot]
                           [--source-tags-condition]
                           [--source-uri]
                           [--tags]
                           [--tier]
                           [--timeout]

Beispiele

Kopieren Sie ein Blob asynchron. Verwenden Sie "az storage blob show", um den Status der Blobs zu überprüfen.

az storage blob copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos

Kopieren Sie ein Blob asynchron. Verwenden Sie "az storage blob show", um den Status der Blobs zu überprüfen.

az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --sas-token $sas --source-uri https://storage.blob.core.windows.net/photos

Kopieren einer blobspezifischen Version

az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://my-account.blob.core.windows.net/my-container/my-blob?versionId=2022-03-21T18:28:44.4431011Z --auth-mode login

Erforderliche Parameter

--destination-blob -b

Name des Ziel-BLOB. Wenn sie vorhanden ist, wird sie überschrieben.

--destination-container -c

Der Containername.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--account-name

Speicherkontoname. Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent erreicht werden.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Eigenschaft Wert
Zulässige Werte: key, login
--blob-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--destination-blob-type

Definiert den Typ des Blobs am Ziel. Der Wert von "Detect" bestimmt den Typ basierend auf dem Quell-BLOB-Typ.

Eigenschaft Wert
Zulässige Werte: AppendBlob, BlockBlob, Detect, PageBlob
--destination-if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

Eigenschaft Wert
Parameter group: Precondition Arguments
--destination-if-modified-since

Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle Nicht-UTC-Datumstimes in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird es als UTC angenommen. Geben Sie diesen bedingten Header an, um den Blob nur zu kopieren, wenn das Ziel-BLOB seit dem angegebenen Datum/der angegebenen Uhrzeit geändert wurde. Wenn das Ziel-BLOB nicht geändert wurde, gibt der BLOB-Dienst den Statuscode 412 zurück (Vorbedingung fehlgeschlagen).

Eigenschaft Wert
Parameter group: Precondition Arguments
--destination-if-none-match

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlagen Sie den Vorgang fehl, wenn er vorhanden ist.

Eigenschaft Wert
Parameter group: Precondition Arguments
--destination-if-unmodified-since

Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle Nicht-UTC-Datumstimes in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird es als UTC angenommen. Geben Sie diesen bedingten Header an, um den Blob nur zu kopieren, wenn das Ziel-BLOB seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde. Wenn das Ziel-BLOB geändert wurde, gibt der BLOB-Dienst den Statuscode 412 zurück (Vorbedingung fehlgeschlagen).

Eigenschaft Wert
Parameter group: Precondition Arguments
--destination-lease-id

Die für diesen Header angegebene Lease-ID muss mit der Lease-ID des Estination-Blobs übereinstimmen. Wenn die Anforderung die Lease-ID nicht enthält oder ungültig ist, schlägt der Vorgang mit dem Statuscode 412 fehl (Vorbedingung fehlgeschlagen).

--destination-tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden sollen.

Eigenschaft Wert
Parameter group: Precondition Arguments
--metadata

Metadaten in durch Leerzeichen getrennten Schlüssel-Wert-Paaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--rehydrate-priority -r

Geben Sie die Priorität an, mit der ein archiviertes Blob rehydratiert werden soll.

--requires-sync

Erzwingen Sie, dass der Dienst erst dann eine Antwort zurückgibt, wenn die Kopie abgeschlossen ist.

Eigenschaft Wert
Zulässige Werte: false, true
--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--source-account-key

Der Speicherkontoschlüssel des Quell-BLOB.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-account-name

Der Name des Speicherkontos des Quell-BLOB.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-blob

Der Blobname für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-container

Der Containername für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

Eigenschaft Wert
Parameter group: Pre-condition Arguments
--source-if-modified-since

Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle Nicht-UTC-Datumstimes in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird es als UTC angenommen. Geben Sie diesen bedingten Header an, um das Blob nur zu kopieren, wenn das Quellblob seit dem angegebenen Datum/der angegebenen Uhrzeit geändert wurde.

Eigenschaft Wert
Parameter group: Pre-condition Arguments
--source-if-none-match

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlagen Sie den Vorgang fehl, wenn er vorhanden ist.

Eigenschaft Wert
Parameter group: Pre-condition Arguments
--source-if-unmodified-since

Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle Nicht-UTC-Datumstimes in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird es als UTC angenommen. Geben Sie diesen bedingten Header an, um den Blob nur zu kopieren, wenn das Quellblob seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

Eigenschaft Wert
Parameter group: Pre-condition Arguments
--source-lease-id

Geben Sie dies an, um den Kopier-Blob-Vorgang nur auszuführen, wenn die angegebene Lease-ID mit der aktiven Lease-ID des Quell-BLOB übereinstimmt.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-path

Der Dateipfad für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-sas

Die Signatur für den freigegebenen Zugriff für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-share

Der Freigabename für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-snapshot

Die BLOB-Momentaufnahme für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden sollen.

Eigenschaft Wert
Parameter group: Precondition Arguments
--source-uri -u

Eine URL von bis zu 2 KB Länge, die eine Azure-Datei oder ein Blob angibt. Der Wert sollte URL-codiert sein, wie er in einem Anforderungs-URI angezeigt wird. Wenn sich die Quelle in einem anderen Konto befindet, muss die Quelle entweder öffentlich sein oder über eine freigegebene Zugriffssignatur authentifiziert werden. Wenn die Quelle öffentlich ist, ist keine Authentifizierung erforderlich. Beispiele: https://myaccount.blob.core.windows.net/mycontainer/myblob, https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>, https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--tier

Der Ebenenwert, auf den das Blob festgelegt werden soll. Bei Seitenblob korreliert die Ebene mit der Größe des Blobs und der Anzahl zulässiger IOPS. Mögliche Werte sind P10, P15, P20, P30, P4, P40, P50, P6, P60, P60, P70, P80 und dies gilt nur für Seitenblobs auf Premium-Speicherkonten; Bei Block-BLOB sind mögliche Werte "Archive", "Cold", "Cool" und "Hot". Dies gilt nur zum Blockieren von Blobs für Standardspeicherkonten.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az storage blob copy start (storage-blob-preview Erweiterung)

Starten Sie einen Kopier-BLOB-Auftrag.

az storage blob copy start --destination-blob
                           --destination-container
                           [--account-key]
                           [--account-name]
                           [--auth-mode {key, login}]
                           [--blob-endpoint]
                           [--connection-string]
                           [--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
                           [--destination-if-match]
                           [--destination-if-modified-since]
                           [--destination-if-none-match]
                           [--destination-if-unmodified-since]
                           [--destination-lease-id]
                           [--destination-tags-condition]
                           [--metadata]
                           [--rehydrate-priority]
                           [--requires-sync {false, true}]
                           [--sas-token]
                           [--source-account-key]
                           [--source-account-name]
                           [--source-blob]
                           [--source-container]
                           [--source-if-match]
                           [--source-if-modified-since]
                           [--source-if-none-match]
                           [--source-if-unmodified-since]
                           [--source-lease-id]
                           [--source-path]
                           [--source-sas]
                           [--source-share]
                           [--source-snapshot]
                           [--source-tags-condition]
                           [--source-uri]
                           [--tags]
                           [--tier]
                           [--timeout]

Beispiele

Kopieren Sie ein Blob asynchron. Verwenden Sie "az storage blob show", um den Status der Blobs zu überprüfen.

az storage blob copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos

Kopieren Sie ein Blob asynchron. Verwenden Sie "az storage blob show", um den Status der Blobs zu überprüfen.

az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --sas-token $sas --source-uri https://storage.blob.core.windows.net/photos

Erforderliche Parameter

--destination-blob -b

Name des Ziel-BLOB. Wenn sie vorhanden ist, wird sie überschrieben.

--destination-container -c

Der Containername.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--account-name

Speicherkontoname. Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent erreicht werden.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Eigenschaft Wert
Zulässige Werte: key, login
--blob-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--destination-blob-type

Definiert den Typ des Blobs am Ziel. Der Wert von "Detect" bestimmt den Typ basierend auf dem Quell-BLOB-Typ.

Eigenschaft Wert
Zulässige Werte: AppendBlob, BlockBlob, Detect, PageBlob
--destination-if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

Eigenschaft Wert
Parameter group: Precondition Arguments
--destination-if-modified-since

Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle Nicht-UTC-Datumstimes in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird es als UTC angenommen. Geben Sie diesen bedingten Header an, um den Blob nur zu kopieren, wenn das Ziel-BLOB seit dem angegebenen Datum/der angegebenen Uhrzeit geändert wurde. Wenn das Ziel-BLOB nicht geändert wurde, gibt der BLOB-Dienst den Statuscode 412 zurück (Vorbedingung fehlgeschlagen).

Eigenschaft Wert
Parameter group: Precondition Arguments
--destination-if-none-match

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlagen Sie den Vorgang fehl, wenn er vorhanden ist.

Eigenschaft Wert
Parameter group: Precondition Arguments
--destination-if-unmodified-since

Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle Nicht-UTC-Datumstimes in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird es als UTC angenommen. Geben Sie diesen bedingten Header an, um den Blob nur zu kopieren, wenn das Ziel-BLOB seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde. Wenn das Ziel-BLOB geändert wurde, gibt der BLOB-Dienst den Statuscode 412 zurück (Vorbedingung fehlgeschlagen).

Eigenschaft Wert
Parameter group: Precondition Arguments
--destination-lease-id

Die für diesen Header angegebene Lease-ID muss mit der Lease-ID des Estination-Blobs übereinstimmen. Wenn die Anforderung die Lease-ID nicht enthält oder ungültig ist, schlägt der Vorgang mit dem Statuscode 412 fehl (Vorbedingung fehlgeschlagen).

--destination-tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden sollen.

Eigenschaft Wert
Parameter group: Precondition Arguments
--metadata

Metadaten in durch Leerzeichen getrennten Schlüssel-Wert-Paaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--rehydrate-priority -r

Geben Sie die Priorität an, mit der ein archiviertes Blob rehydratiert werden soll.

--requires-sync

Erzwingen Sie, dass der Dienst erst dann eine Antwort zurückgibt, wenn die Kopie abgeschlossen ist.

Eigenschaft Wert
Zulässige Werte: false, true
--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--source-account-key

Der Speicherkontoschlüssel des Quell-BLOB.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-account-name

Der Name des Speicherkontos des Quell-BLOB.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-blob

Der Blobname für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-container

Der Containername für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

Eigenschaft Wert
Parameter group: Pre-condition Arguments
--source-if-modified-since

Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle Nicht-UTC-Datumstimes in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird es als UTC angenommen. Geben Sie diesen bedingten Header an, um das Blob nur zu kopieren, wenn das Quellblob seit dem angegebenen Datum/der angegebenen Uhrzeit geändert wurde.

Eigenschaft Wert
Parameter group: Pre-condition Arguments
--source-if-none-match

Ein ETag-Wert oder das Wildcardzeichen (). Geben Sie diesen Header an, um den Vorgang nur auszuführen, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Geben Sie das Wildcardzeichen () an, um den Vorgang nur auszuführen, wenn die Ressource nicht vorhanden ist, und schlagen Sie den Vorgang fehl, wenn er vorhanden ist.

Eigenschaft Wert
Parameter group: Pre-condition Arguments
--source-if-unmodified-since

Ein DateTime-Wert. Azure erwartet, dass der übergebene Datumswert UTC ist. Wenn die Zeitzone enthalten ist, werden alle Nicht-UTC-Datumstimes in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird es als UTC angenommen. Geben Sie diesen bedingten Header an, um den Blob nur zu kopieren, wenn das Quellblob seit dem angegebenen Datum/der angegebenen Uhrzeit nicht geändert wurde.

Eigenschaft Wert
Parameter group: Pre-condition Arguments
--source-lease-id

Geben Sie dies an, um den Kopier-Blob-Vorgang nur auszuführen, wenn die angegebene Lease-ID mit der aktiven Lease-ID des Quell-BLOB übereinstimmt.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-path

Der Dateipfad für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-sas

Die Signatur für den freigegebenen Zugriff für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-share

Der Freigabename für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-snapshot

Die BLOB-Momentaufnahme für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-tags-condition

Geben Sie eine SQL-Klausel für Blobtags an, die nur für Blobs mit einem übereinstimmenden Wert verwendet werden sollen.

Eigenschaft Wert
Parameter group: Precondition Arguments
--source-uri -u

Eine URL von bis zu 2 KB Länge, die eine Azure-Datei oder ein Blob angibt. Der Wert sollte URL-codiert sein, wie er in einem Anforderungs-URI angezeigt wird. Wenn sich die Quelle in einem anderen Konto befindet, muss die Quelle entweder öffentlich sein oder über eine freigegebene Zugriffssignatur authentifiziert werden. Wenn die Quelle öffentlich ist, ist keine Authentifizierung erforderlich. Beispiele: https://myaccount.blob.core.windows.net/mycontainer/myblob, https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>, https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Bei Tags wird zwischen Groß- und Kleinschreibung unterschieden. Der Tagsatz kann höchstens 10 Tags enthalten. Tagtasten müssen zwischen 1 und 128 Zeichen bestehen, und Tagwerte müssen zwischen 0 und 256 Zeichen bestehen. Gültige Tagschlüssel- und Wertzeichen sind: Klein- und Großbuchstaben, Ziffern (0-9), Leerzeichen ( ), Pluszeichen (+), Minuszeichen (.), Punkt (.), Einfarbig (/), Doppelpunkt (:), gleich (=), Unterstrich (_).

--tier

Der Ebenenwert, auf den das Blob festgelegt werden soll. Bei Seitenblob korreliert die Ebene mit der Größe des Blobs und der Anzahl zulässiger IOPS. Mögliche Werte sind P10, P15, P20, P30, P4, P40, P50, P6, P60, P60, P70, P80 und dies gilt nur für Seitenblobs auf Premium-Speicherkonten; Bei Block-Blobs sind mögliche Werte "Archiv", "Cold", "Cool" und "Hot". Dies gilt nur zum Blockieren von Blobs für Standardspeicherkonten.

--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az storage blob copy start-batch

Kopieren Sie mehrere Blobs in einen BLOB-Container. Verwenden Sie az storage blob show, um den Status der Blobs zu überprüfen.

az storage blob copy start-batch [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--blob-endpoint]
                                 [--connection-string]
                                 [--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
                                 [--destination-container]
                                 [--destination-path]
                                 [--dryrun]
                                 [--pattern]
                                 [--rehydrate-priority]
                                 [--sas-token]
                                 [--source-account-key]
                                 [--source-account-name]
                                 [--source-container]
                                 [--source-sas]
                                 [--source-share]
                                 [--source-uri]
                                 [--tier]

Beispiele

Kopieren Sie mehrere Blobs in einen BLOB-Container. Verwenden Sie "az storage blob show", um den Status der Blobs zu überprüfen. (autogenerated)

az storage blob copy start-batch --account-key 00000000 --account-name MyAccount --destination-container MyDestinationContainer --source-account-key MySourceKey --source-account-name MySourceAccount --source-container MySourceContainer

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--account-name

Speicherkontoname. Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent erreicht werden.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Eigenschaft Wert
Zulässige Werte: key, login
--blob-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--destination-blob-type

Definiert den Typ des Blobs am Ziel. Der Wert von "Detect" bestimmt den Typ basierend auf dem Quell-BLOB-Typ.

Eigenschaft Wert
Zulässige Werte: AppendBlob, BlockBlob, Detect, PageBlob
--destination-container -c

Der BLOB-Container, in den die ausgewählten Quelldateien oder Blobs kopiert werden.

--destination-path

Der Zielpfad, der dem Blobnamen vorangestellt wird.

--dryrun

Listet die Dateien oder Blobs auf, die hochgeladen werden sollen. Es erfolgt keine tatsächliche Datenübertragung.

Eigenschaft Wert
Standardwert: False
--pattern

Das Muster, das zum Globbing von Dateien oder Blobs in der Quelle verwendet wird. Die unterstützten Muster sind '*', '?', '[seq]' und '[!seq]'. Weitere Informationen finden Sie unter https://docs.python.org/3/library/fnmatch.html.

Wenn Sie '*' in --pattern verwenden, entspricht es jedem Zeichen, einschließlich des Verzeichnistrennzeichens '/'.

--rehydrate-priority -r

Geben Sie die Priorität an, mit der ein archiviertes Blob rehydratiert werden soll.

--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Eigenschaft Wert
Parameter group: Storage Account Arguments
--source-account-key

Der Kontoschlüssel für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-account-name

Das Quellspeicherkonto, aus dem die Dateien oder Blobs an das Ziel kopiert werden. Wenn sie weggelassen wird, wird das Zielkonto verwendet.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-container

Der Quellcontainer, aus dem Blobs kopiert werden.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-sas

Die Signatur für den freigegebenen Zugriff für das Quellspeicherkonto.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-share

Die Quellfreigabe, aus der Dateien kopiert werden.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--source-uri

Ein URI, der eine Dateifreigabe oder einen BLOB-Container angibt, aus dem die Dateien oder Blobs kopiert werden.

Wenn sich die Quelle in einem anderen Konto befindet, muss die Quelle entweder öffentlich sein oder mithilfe einer freigegebenen Zugriffssignatur authentifiziert werden.

Eigenschaft Wert
Parameter group: Copy Source Arguments
--tier

Der Ebenenwert, auf den das Blob festgelegt werden soll. Bei Seitenblob korreliert die Ebene mit der Größe des Blobs und der Anzahl zulässiger IOPS. Mögliche Werte sind P10, P15, P20, P30, P4, P40, P50, P6, P60, P60, P70, P80 und dies gilt nur für Seitenblobs auf Premium-Speicherkonten; Bei Block-BLOB sind mögliche Werte "Archive", "Cold", "Cool" und "Hot". Dies gilt nur zum Blockieren von Blobs für Standardspeicherkonten.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False