Freigeben über

az storage blob incremental-copy

  • Referenz

Verwalten von inkrementellen Blobkopiervorgängen

Befehle

Name Beschreibung Typ Status
az storage blob incremental-copy cancel

Bricht einen ausstehenden copy_blob Vorgang ab und belässt ein Ziel-BLOB mit null Länge und vollständigen Metadaten.

 Kernspeicher Allgemein verfügbar
az storage blob incremental-copy start

Kopiert asynchron eine inkrementelle Kopie eines Blobs.

 Kernspeicher Allgemein verfügbar

az storage blob incremental-copy cancel

Bearbeiten

Bricht einen ausstehenden copy_blob Vorgang ab und belässt ein Ziel-BLOB mit null Länge und vollständigen Metadaten.

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

Erforderliche Parameter

--container-name -c

Der Containername

--copy-id

Kopierbezeichner, der im copy.id des ursprünglichen copy_blob-Vorgangs bereitgestellt wird.

--name -n

Der Blobname.

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss zusammen mit dem Namen des Speicherkontos 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 erreicht 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
--connection-string

Speicherkonto Verbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--lease-id

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

--sas-token

Eine Freigegebene Zugriffssignatur (SHARED Access Signature, SAS). Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--timeout

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az storage blob incremental-copy start

Bearbeiten

Kopiert asynchron eine inkrementelle Kopie eines Blobs.

Dieser Vorgang gibt ein Objekt für kopiervorgangseigenschaften zurück, einschließlich einer Kopier-ID, die Sie zum Überprüfen oder Abbrechen des Kopiervorgangs verwenden können. Der Blob-Dienst kopiert Blobs auf best-effort-Basis. Das Quell-BLOB für einen inkrementellen Kopiervorgang muss ein Seitenblob sein. Rufen Sie get_blob_properties für das Ziel-BLOB auf, um den Status des Kopiervorgangs zu überprüfen. Das endgültige Blob wird bei Abschluss des Kopiervorgangs committet.

az storage blob incremental-copy start --destination-blob
                                       --destination-container
                                       [--account-key]
                                       [--account-name]
                                       [--auth-mode {key, login}]
                                       [--connection-string]
                                       [--destination-if-match]
                                       [--destination-if-modified-since]
                                       [--destination-if-none-match]
                                       [--destination-if-unmodified-since]
                                       [--destination-lease-id]
                                       [--metadata]
                                       [--sas-token]
                                       [--source-account-key]
                                       [--source-account-name]
                                       [--source-blob]
                                       [--source-container]
                                       [--source-lease-id]
                                       [--source-sas]
                                       [--source-snapshot]
                                       [--source-uri]
                                       [--timeout]

Beispiele

Laden Sie alle Dateien hoch, die mit ".py" enden, es sei denn, blob vorhanden ist und seit dem angegebenen Datum geändert wurde.

az storage blob incremental-copy start --source-container MySourceContainer --source-blob MyBlob --source-account-name MySourceAccount --source-account-key MySourceKey --source-snapshot MySnapshot --destination-container MyDestinationContainer --destination-blob MyDestinationBlob

Kopiert asynchron eine inkrementelle Kopie eines Blobs. (automatisch generiert)

az storage blob incremental-copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-account-key MySourceKey --source-account-name MySourceAccount --source-blob MyBlob --source-container MySourceContainer --source-snapshot MySnapshot

Kopieren Sie eine inkrementelle Kopie eines Blobs asynchron. (automatisch generiert)

az storage blob incremental-copy start --connection-string myconnectionstring --destination-blob mydestinationblob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos

Erforderliche Parameter

--destination-blob -b

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

--destination-container -c

Der Containername

Optionale Parameter

--account-key

Speicherkontoschlüssel Muss zusammen mit dem Namen des Speicherkontos 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 erreicht 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
--connection-string

Speicherkonto Verbindungszeichenfolge. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

--destination-if-match

Ein ETag-Wert oder das Platzhalterzeichen (*)Karte. Geben Sie einen ETag-Wert für diesen bedingten Header an, um den Blob nur zu kopieren, wenn der angegebene ETag-Wert dem ETag-Wert für ein vorhandenes Ziel-BLOB entspricht. Wenn das ETag für das Ziel-BLOB nicht mit dem für If-Match angegebenen ETag übereinstimmt, gibt der Blob-Dienst den Statuscode 412 zurück (Vorbedingung fehlgeschlagen).

--destination-if-modified-since

Beginnt nur, wenn seit der Angegebenen UTC-Datumszeit geändert (Y-m-d'T'H:M'Z').

--destination-if-none-match

Ein ETag-Wert oder das Wild Karte Zeichen (). Geben Sie einen ETag-Wert für diesen bedingten Header an, um den Blob nur zu kopieren, wenn der angegebene ETag-Wert nicht mit dem ETag-Wert für das Ziel-BLOB übereinstimmt. Geben Sie das Wild Karte Zeichen () an, um den Vorgang nur auszuführen, wenn das Ziel-BLOB nicht vorhanden ist. Wenn die angegebene Bedingung nicht erfüllt ist, gibt der Blob-Dienst den Statuscode 412 zurück (Vorbedingung fehlgeschlagen).

--destination-if-unmodified-since

Beginnt nur, wenn seit der Bereitstellung von UTC-Datumsangabe (Y-m-d'T'H:M'Z') nicht geändert wurde.

--destination-lease-id

Die für diesen Header angegebene Lease-ID muss mit der Lease-ID des Ziel-BLOB ü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).

--metadata

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

--sas-token

Eine Freigegebene Zugriffssignatur (SHARED Access Signature, SAS). Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

--source-account-key

Der Speicherkontoschlüssel des Quell-BLOB.

--source-account-name

Der Name des Speicherkontos des Quell-BLOB.

--source-blob

Der Blobname für das Quellspeicherkonto.

--source-container

Der Containername für das Quellspeicherkonto.

--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.

--source-sas

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

--source-snapshot

Der BLOB-Momentaufnahme für das Quellspeicherkonto.

--source-uri -u

Eine URL von bis zu 2 KB Länge, die ein Azure-Seiten-BLOB angibt. Der Wert sollte URL-codiert sein, wie er in einem Anforderungs-URI angezeigt wird. Die Kopierquelle muss eine Momentaufnahme sein und ein gültiges SAS-Token enthalten oder öffentlich sein. Beispiel: https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>&sastoken.

--timeout

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.