az storage blob copy

Verwalten von Blobkopiervorgängen Verwenden Sie az storage blob show zum Überprüfen des Status der Blobs.

Befehle

az storage blob copy cancel

Abbrechen eines laufenden Kopiervorgangs.

az storage blob copy start

Kopieren Eines Blobs asynchron. Wird verwendet az storage blob show , um den Status der Blobs zu überprüfen.

az storage blob copy start-batch

Kopieren Sie mehrere Blobs in einen Blobcontainer. Wird verwendet az storage blob show , um den Status der Blobs zu überprüfen.

az storage blob copy cancel

Abbrechen eines laufenden Kopiervorgangs.

Dadurch wird ein Ziel-Blob mit null Länge und vollständigen Metadaten verlassen. 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-Blobs. Falls vorhanden, wird sie überschrieben.

--destination-container -c

Der Containername

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Name des Speicherkontos 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 getroffen werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacymodus "Schlüssel" versucht, einen Kontoschlüssel abzufragen, wenn keine Authentifizierungsparameter für das Konto bereitgestellt werden. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

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.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--lease-id

Erforderlich, wenn das Ziel-BLOB über eine aktive Lease für unbegrenzte Dauer verfügt.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--timeout

Zeitüberschreitung in Sekunden anfordern. Gilt für jeden Aufruf des Diensts.

az storage blob copy start

Kopieren Sie einen Blob asynchron. Verwenden Sie az storage blob show zum Überprüfen des Status der Blobs.

az storage blob copy start --destination-blob
                           --destination-container
                           [--account-key]
                           [--account-name]
                           [--auth-mode {key, login}]
                           [--blob-endpoint]
                           [--connection-string]
                           [--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 Eines Blobs 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 Eines Blobs 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-Blobs. Wenn es vorhanden ist, wird es überschrieben.

--destination-container -c

Der Containername

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Namen des Speicherkontos oder des Dienstendpunkts verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Name des Speicherkontos 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 getroffen werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacymodus "Schlüssel" versucht, einen Kontoschlüssel abzufragen, wenn keine Authentifizierungsparameter für das Konto bereitgestellt werden. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

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.

--connection-string

Verbindungszeichenfolge des Speicherkontos. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--destination-if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--destination-if-modified-since

Ein DateTime-Wert Azure erwartet, dass der datumswert, der in UTC übergeben wird. Wenn zeitzone enthalten ist, werden alle Nicht-UTC-Datumszeiten in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Ziel-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit geändert wurde. Wenn das Ziel-BLOB nicht geändert wurde, gibt der Blob-Dienst Statuscode 412 (Vorbedingung nicht erfüllt) zurück.

--destination-if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Mit dem Platzhalterzeichen (*) legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource nicht vorhanden ist, und fehlschlägt, wenn die Ressource vorhanden ist.

--destination-if-unmodified-since

Ein DateTime-Wert Azure erwartet, dass der datumswert, der in UTC übergeben wird. Wenn zeitzone enthalten ist, werden alle Nicht-UTC-Datumszeiten in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass es UTC ist. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Ziel-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit nicht geändert wurde. Wenn das Ziel-BLOB geändert wurde, gibt der Blob-Dienst Statuscode 412 (Vorbedingung nicht erfüllt) zurück.

--destination-lease-id

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

--destination-tags-condition

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

--metadata

Metadaten in leer getrennten Schlüssel=Wertpaaren. 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.

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

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--source-account-key

Der Speicherkontoschlüssel des Quell-Blobs.

--source-account-name

Der Name des Speicherkontos des Quell-Blobs.

--source-blob

Der Blobname für das Quellspeicherkonto.

--source-container

Der Containername für das Quellspeicherkonto.

--source-if-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource mit dem angegebenen Wert übereinstimmt.

--source-if-modified-since

Ein DateTime-Wert Azure erwartet, dass der datumswert, der in UTC übergeben wird. Wenn Zeitzone enthalten ist, werden alle nicht UTC-Datumszeiten in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass utc. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Quell-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit geändert wurde.

--source-if-none-match

Ein ETag-Wert oder das Platzhalterzeichen (*). Mit diesem Header legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn das ETag der Ressource nicht mit dem angegebenen Wert übereinstimmt. Mit dem Platzhalterzeichen (*) legen Sie fest, dass der Vorgang nur ausgeführt wird, wenn die Ressource nicht vorhanden ist, und fehlschlägt, wenn die Ressource vorhanden ist.

--source-if-unmodified-since

Ein DateTime-Wert Azure erwartet, dass der datumswert, der in UTC übergeben wird. Wenn Zeitzone enthalten ist, werden alle nicht UTC-Datumszeiten in UTC konvertiert. Wenn ein Datum ohne Zeitzoneninformationen übergeben wird, wird davon ausgegangen, dass utc. Geben Sie diesen bedingten Header an, um das BLOB nur dann zu kopieren, wenn das Quell-BLOB seit dem angegebenen Datum bzw. der angegebenen Uhrzeit nicht geändert wurde.

--source-lease-id

Geben Sie dies an, um den Vorgang "Blob kopieren" nur auszuführen, wenn die angegebene Lease-ID der aktiven Lease-ID des Quell-Blobs entspricht.

--source-path

Der Dateipfad für das Quellspeicherkonto.

--source-sas

Die freigegebene Zugriffssignatur für das Quellspeicherkonto.

--source-share

Der Freigabename für das Quellspeicherkonto.

--source-snapshot

Die Blob-Momentaufnahme für das Quellspeicherkonto.

--source-tags-condition

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

--source-uri -u

Eine URL von bis zu 2 KB Länge, die eine Azure-Datei oder ein Blob angibt. Der Wert sollte so URL-codiert sein, wie er in einem Anforderungs-URI verwendet 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://otheraccount.blob.core.windows.net/mycontainer/myblob?sastokenhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>.

--tags

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

--tier

Der Ebenenwert, auf den das Blob festgelegt werden soll. Bei Seiten-Blob 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, P60, P60, P70, P80 und dies gilt nur für Seiten-Blobs auf Premiumspeicherkonten; Bei Block-Blob sind mögliche Werte Archiv, Cool und Hot. Dies gilt nur für die Blockierung von Blobs auf Standardspeicherkonten.

--timeout

Anfordern von Timeout in Sekunden. Gilt für jeden Aufruf des Diensts.

az storage blob copy start-batch

Kopieren Sie mehrere Blobs in einen Blobcontainer. Verwenden Sie az storage blob show zum Überprüfen des Status der Blobs.

az storage blob copy start-batch [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--blob-endpoint]
                                 [--connection-string]
                                 [--destination-container]
                                 [--destination-path]
                                 [--dryrun]
                                 [--pattern]
                                 [--sas-token]
                                 [--source-account-key]
                                 [--source-account-name]
                                 [--source-container]
                                 [--source-sas]
                                 [--source-share]
                                 [--source-uri]

Beispiele

Kopieren Sie mehrere Blobs in einen Blobcontainer. Verwenden Sie "az storage blob show", um den Status der Blobs zu überprüfen. (automatisch generiert)

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

--account-key

Speicherkontoschlüssel Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

--account-name

Name des Speicherkontos Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit dem 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 getroffen werden.

--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet ihre Anmeldeinformationen direkt für die Authentifizierung. Der ältere "Schlüssel"-Modus versucht, einen Kontoschlüssel zu abfragen, wenn keine Authentifizierungsparameter für das Konto bereitgestellt werden. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

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

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

--connection-string

Speicherkontoverbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--destination-container -c

Der Blobcontainer, in den die ausgewählten Quelldateien oder Blobs kopiert werden.

--destination-path

Der Zielpfad, der vor dem Blobnamen vorgestellt wird.

--dryrun

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

--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.7/library/fnmatch.html.

--sas-token

Eine Freigegebene Zugriffssignatur (SAS). Muss in Verbindung mit dem Speicherkontonamen oder Dienstendpunkt verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--source-account-key

Der Kontoschlüssel für das Quellspeicherkonto.

--source-account-name

Das Quellspeicherkonto, aus dem die Dateien oder Blobs in das Ziel kopiert werden. Wenn nicht angegeben, wird das Zielkonto verwendet.

--source-container

Der Quellcontainer, aus dem Blobs kopiert werden.

--source-sas

Die freigegebene Zugriffssignatur für das Quellspeicherkonto.

--source-share

Die Quellfreigabe, aus der Dateien kopiert werden.

--source-uri

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