Sdílet prostřednictvím

az storage blob copy

Note

Tato skupina příkazů obsahuje příkazy, které jsou definované v Azure CLI i alespoň v jednom rozšíření. Nainstalujte každé rozšíření, abyste mohli využívat své rozšířené funkce. Přečtěte si další informace o rozšířeních.

Správa operací kopírování objektů blob Slouží az storage blob show ke kontrole stavu objektů blob.

Příkazy

Name Description Typ Stav
az storage blob copy cancel

Přerušte probíhající operaci kopírování.

 Core GA
az storage blob copy start

Asynchronně zkopírujte objekt blob. Slouží az storage blob show ke kontrole stavu objektů blob.

 Core GA
az storage blob copy start (storage-blob-preview přípona)

Spusťte úlohu kopírování objektů blob.

 Extension GA
az storage blob copy start-batch

Zkopírujte více objektů blob do kontejneru objektů blob. Slouží az storage blob show ke kontrole stavu objektů blob.

 Core GA

az storage blob copy cancel

Upravit

Přerušte probíhající operaci kopírování.

Tím ponecháte cílový objekt blob s nulovou délkou a úplnými metadaty. Pokud už operace kopírování skončila, zobrazí se chyba.

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]

Povinné parametry

--copy-id

Operace kopírování, která se má přerušit. Může to být řetězec ID nebo instance BlobProperties.

--destination-blob -b

Název cílového objektu blob. Pokud existuje, přepíše se.

--destination-container -c

Název kontejneru.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--account-name

Název účtu úložiště Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

Vlastnost Hodnota
Přípustné hodnoty: key, login
--blob-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--connection-string

Řetězec připojení účtu úložiště Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--lease-id

Vyžaduje se, pokud má cílový objekt blob aktivní nekonečné zapůjčení.

--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--timeout

Doba vypršení platnosti požadavku v sekundách Platí pro každé volání služby.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az storage blob copy start

Upravit

Asynchronně zkopírujte objekt blob. Slouží az storage blob show ke kontrole stavu objektů blob.

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]

Příklady

Asynchronně zkopírujte objekt blob. Pomocí příkazu az storage blob show zkontrolujte stav objektů blob.

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

Asynchronně zkopírujte objekt blob. Pomocí příkazu az storage blob show zkontrolujte stav objektů blob.

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

Kopírování konkrétní verze objektu blob

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

Povinné parametry

--destination-blob -b

Název cílového objektu blob. Pokud existuje, přepíše se.

--destination-container -c

Název kontejneru.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--account-name

Název účtu úložiště Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

Vlastnost Hodnota
Přípustné hodnoty: key, login
--blob-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--connection-string

Řetězec připojení účtu úložiště Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--destination-blob-type

Definuje typ objektu blob v cíli. Hodnota "Detect" určuje typ na základě typu zdrojového objektu blob.

Vlastnost Hodnota
Přípustné hodnoty: AppendBlob, BlockBlob, Detect, PageBlob
--destination-if-match

Hodnota značky ETag nebo zástupný znak (*). Zadejte tuto hlavičku, aby se operace provedla pouze v případě, že ETag prostředku odpovídá určené hodnotě.

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--destination-if-modified-since

Hodnota DateTime. Azure očekává, že hodnota data předaná do standardu UTC. Pokud je časové pásmo zahrnuto, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že se jedná o utc. Tuto podmíněnou hlavičku zadejte pro zkopírování objektu blob pouze v případě, že se cílový objekt blob od zadaného data a času změnil. Pokud cílový objekt blob nebyl upraven, vrátí služba Blob Service stavový kód 412 (předběžná podmínka se nezdařila).

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--destination-if-none-match

Hodnota značky ETag nebo zástupný znak (). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku neodpovídají zadané hodnotě. Zadejte zástupný znak () k provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operace selže.

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--destination-if-unmodified-since

Hodnota DateTime. Azure očekává, že hodnota data předaná do standardu UTC. Pokud je časové pásmo zahrnuto, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že se jedná o utc. Tuto podmíněnou hlavičku zadejte pro zkopírování objektu blob pouze v případě, že cílový objekt blob nebyl od zadaného data a času změněn. Pokud byl cílový objekt blob změněn, vrátí služba Blob Service stavový kód 412 (předběžná podmínka se nezdařila).

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--destination-lease-id

ID zapůjčení zadané pro tuto hlavičku musí odpovídat ID zapůjčení cílového objektu blob. Pokud požadavek neobsahuje ID zapůjčení nebo není platné, operace selže se stavovým kódem 412 (předběžná podmínka se nezdařila).

--destination-tags-condition

Zadejte klauzuli SQL where pro značky objektů blob, která bude fungovat pouze s objekty blob s odpovídající hodnotou.

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--metadata

Metadata ve dvojicích key=value oddělených mezerami Tím se přepíše všechna existující metadata.

--rehydrate-priority -r

Uveďte prioritu, se kterou se má dosadit archivovaný objekt blob.

--requires-sync

Vynutit, aby služba nevrátil odpověď, dokud nebude kopie dokončena.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--source-account-key

Klíč účtu úložiště zdrojového objektu blob.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-account-name

Název účtu úložiště zdrojového objektu blob.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-blob

Název objektu blob zdrojového účtu úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-container

Název kontejneru pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-if-match

Hodnota značky ETag nebo zástupný znak (*). Zadejte tuto hlavičku, aby se operace provedla pouze v případě, že ETag prostředku odpovídá určené hodnotě.

Vlastnost Hodnota
Skupina parametrů: Pre-condition Arguments
--source-if-modified-since

Hodnota DateTime. Azure očekává, že hodnota data předaná do standardu UTC. Pokud je časové pásmo zahrnuto, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že se jedná o utc. Tuto podmíněnou hlavičku zadejte pro zkopírování objektu blob pouze v případě, že byl zdrojový objekt blob změněn od zadaného data a času.

Vlastnost Hodnota
Skupina parametrů: Pre-condition Arguments
--source-if-none-match

Hodnota značky ETag nebo zástupný znak (). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku neodpovídají zadané hodnotě. Zadejte zástupný znak () k provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operace selže.

Vlastnost Hodnota
Skupina parametrů: Pre-condition Arguments
--source-if-unmodified-since

Hodnota DateTime. Azure očekává, že hodnota data předaná do standardu UTC. Pokud je časové pásmo zahrnuto, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že se jedná o utc. Zadáním této podmíněné hlavičky zkopírujte objekt blob pouze v případě, že zdrojový objekt blob nebyl od zadaného data a času změněn.

Vlastnost Hodnota
Skupina parametrů: Pre-condition Arguments
--source-lease-id

Tuto možnost zadejte, pokud se má operace kopírování objektu blob provést pouze v případě, že ZADANÉ ID zapůjčení odpovídá aktivnímu ID zapůjčení zdrojového objektu blob.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-path

Cesta k souboru pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-sas

Sdílený přístupový podpis pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-share

Název sdílené složky pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-snapshot

Snímek objektu blob pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-tags-condition

Zadejte klauzuli SQL where pro značky objektů blob, která bude fungovat pouze s objekty blob s odpovídající hodnotou.

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--source-uri -u

Adresa URL o délce až 2 kB, která určuje soubor nebo objekt blob Azure. Hodnota by měla být zakódovaná jako adresa URL, jak by se zobrazovala v identifikátoru URI požadavku. Pokud je zdroj v jiném účtu, musí být zdroj buď veřejný, nebo musí být ověřený prostřednictvím sdíleného přístupového podpisu. Pokud je zdroj veřejný, nevyžaduje se žádné ověřování. Příklady: 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.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--tier

Hodnota vrstvy, na kterou se má objekt blob nastavit. U objektu blob stránky úroveň koreluje s velikostí objektu blob a počtem povolených vstupně-výstupních operací za sekundu. Možné hodnoty jsou P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80 a to platí jenom pro objekty blob stránky v účtech premium storage; Pro objekt blob bloku jsou možné hodnoty Archive, Cold, Cool a Hot. To platí jenom pro objekty blob bloku v účtech úložiště úrovně Standard.

--timeout

Doba vypršení platnosti požadavku v sekundách Platí pro každé volání služby.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az storage blob copy start (storage-blob-preview přípona)

Spusťte úlohu kopírování objektů blob.

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]

Příklady

Asynchronně zkopírujte objekt blob. Pomocí příkazu az storage blob show zkontrolujte stav objektů blob.

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

Asynchronně zkopírujte objekt blob. Pomocí příkazu az storage blob show zkontrolujte stav objektů blob.

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

Povinné parametry

--destination-blob -b

Název cílového objektu blob. Pokud existuje, přepíše se.

--destination-container -c

Název kontejneru.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště. Proměnná prostředí: AZURE_STORAGE_KEY.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--account-name

Název účtu úložiště Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

Vlastnost Hodnota
Přípustné hodnoty: key, login
--blob-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--connection-string

Řetězec připojení účtu úložiště Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--destination-blob-type

Definuje typ objektu blob v cíli. Hodnota "Detect" určuje typ na základě typu zdrojového objektu blob.

Vlastnost Hodnota
Přípustné hodnoty: AppendBlob, BlockBlob, Detect, PageBlob
--destination-if-match

Hodnota značky ETag nebo zástupný znak (*). Zadejte tuto hlavičku, aby se operace provedla pouze v případě, že ETag prostředku odpovídá určené hodnotě.

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--destination-if-modified-since

Hodnota DateTime. Azure očekává, že hodnota data předaná do standardu UTC. Pokud je časové pásmo zahrnuto, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že se jedná o utc. Tuto podmíněnou hlavičku zadejte pro zkopírování objektu blob pouze v případě, že se cílový objekt blob od zadaného data a času změnil. Pokud cílový objekt blob nebyl upraven, vrátí služba Blob Service stavový kód 412 (předběžná podmínka se nezdařila).

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--destination-if-none-match

Hodnota značky ETag nebo zástupný znak (). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku neodpovídají zadané hodnotě. Zadejte zástupný znak () k provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operace selže.

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--destination-if-unmodified-since

Hodnota DateTime. Azure očekává, že hodnota data předaná do standardu UTC. Pokud je časové pásmo zahrnuto, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že se jedná o utc. Tuto podmíněnou hlavičku zadejte pro zkopírování objektu blob pouze v případě, že cílový objekt blob nebyl od zadaného data a času změněn. Pokud byl cílový objekt blob změněn, vrátí služba Blob Service stavový kód 412 (předběžná podmínka se nezdařila).

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--destination-lease-id

ID zapůjčení zadané pro tuto hlavičku musí odpovídat ID zapůjčení objektu blob estination. Pokud požadavek neobsahuje ID zapůjčení nebo není platné, operace selže se stavovým kódem 412 (předběžná podmínka se nezdařila).

--destination-tags-condition

Zadejte klauzuli SQL where pro značky objektů blob, která bude fungovat pouze s objekty blob s odpovídající hodnotou.

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--metadata

Metadata ve dvojicích key=value oddělených mezerami Tím se přepíše všechna existující metadata.

--rehydrate-priority -r

Uveďte prioritu, se kterou se má dosadit archivovaný objekt blob.

--requires-sync

Vynutit, aby služba nevrátil odpověď, dokud nebude kopie dokončena.

Vlastnost Hodnota
Přípustné hodnoty: false, true
--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--source-account-key

Klíč účtu úložiště zdrojového objektu blob.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-account-name

Název účtu úložiště zdrojového objektu blob.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-blob

Název objektu blob zdrojového účtu úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-container

Název kontejneru pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-if-match

Hodnota značky ETag nebo zástupný znak (*). Zadejte tuto hlavičku, aby se operace provedla pouze v případě, že ETag prostředku odpovídá určené hodnotě.

Vlastnost Hodnota
Skupina parametrů: Pre-condition Arguments
--source-if-modified-since

Hodnota DateTime. Azure očekává, že hodnota data předaná do standardu UTC. Pokud je časové pásmo zahrnuto, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že se jedná o utc. Tuto podmíněnou hlavičku zadejte pro zkopírování objektu blob pouze v případě, že byl zdrojový objekt blob změněn od zadaného data a času.

Vlastnost Hodnota
Skupina parametrů: Pre-condition Arguments
--source-if-none-match

Hodnota značky ETag nebo zástupný znak (). Tuto hlavičku zadejte, aby se operace prováděla pouze v případě, že značky ETag prostředku neodpovídají zadané hodnotě. Zadejte zástupný znak () k provedení operace pouze v případě, že prostředek neexistuje, a pokud existuje, operace selže.

Vlastnost Hodnota
Skupina parametrů: Pre-condition Arguments
--source-if-unmodified-since

Hodnota DateTime. Azure očekává, že hodnota data předaná do standardu UTC. Pokud je časové pásmo zahrnuto, všechny hodnoty datetime mimo UTC se převedou na UTC. Pokud je datum předáno bez informací o časovém pásmu, předpokládá se, že se jedná o utc. Zadáním této podmíněné hlavičky zkopírujte objekt blob pouze v případě, že zdrojový objekt blob nebyl od zadaného data a času změněn.

Vlastnost Hodnota
Skupina parametrů: Pre-condition Arguments
--source-lease-id

Tuto možnost zadejte, pokud se má operace kopírování objektu blob provést pouze v případě, že ZADANÉ ID zapůjčení odpovídá aktivnímu ID zapůjčení zdrojového objektu blob.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-path

Cesta k souboru pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-sas

Sdílený přístupový podpis pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-share

Název sdílené složky pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-snapshot

Snímek objektu blob pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-tags-condition

Zadejte klauzuli SQL where pro značky objektů blob, která bude fungovat pouze s objekty blob s odpovídající hodnotou.

Vlastnost Hodnota
Skupina parametrů: Precondition Arguments
--source-uri -u

Adresa URL o délce až 2 kB, která určuje soubor nebo objekt blob Azure. Hodnota by měla být zakódovaná jako adresa URL, jak by se zobrazovala v identifikátoru URI požadavku. Pokud je zdroj v jiném účtu, musí být zdroj buď veřejný, nebo musí být ověřený prostřednictvím sdíleného přístupového podpisu. Pokud je zdroj veřejný, nevyžaduje se žádné ověřování. Příklady: 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.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. Značky rozlišují malá a velká písmena. Sada značek může obsahovat maximálně 10 značek. Klíče značek musí mít délku 1 až 128 znaků a hodnoty značek musí být 0 až 256 znaků. Platné znaky klíče a hodnoty značky: malá a velká písmena, číslice (0–9), mezera ( ), plus (+), minus (-), tečka (.), solidus (/), dvojtečka (:), rovná se (=), podtržítko (_).

--tier

Hodnota vrstvy, na kterou se má objekt blob nastavit. U objektu blob stránky úroveň koreluje s velikostí objektu blob a počtem povolených vstupně-výstupních operací za sekundu. Možné hodnoty jsou P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80 a to platí jenom pro objekty blob stránky v účtech premium storage; Pro objekt blob bloku jsou možné hodnoty Archive, Cold, Cool a Hot. To platí jenom pro objekty blob bloku v účtech úložiště úrovně Standard.

--timeout

Doba vypršení platnosti požadavku v sekundách Platí pro každé volání služby.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az storage blob copy start-batch

Upravit

Zkopírujte více objektů blob do kontejneru objektů blob. Slouží az storage blob show ke kontrole stavu objektů blob.

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]

Příklady

Zkopírujte více objektů blob do kontejneru objektů blob. Pomocí příkazu az storage blob show zkontrolujte stav objektů blob. (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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--account-key

Klíč účtu úložiště. Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_KEY.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--account-name

Název účtu úložiště Související proměnná prostředí: AZURE_STORAGE_ACCOUNT. Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Pokud žádný z nich neexistuje, pokusí se příkaz dotazovat klíč účtu úložiště pomocí ověřeného účtu Azure. Pokud se spustí velký počet příkazů úložiště, může dojít k dosažení kvóty rozhraní API.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--auth-mode

Režim, ve kterém se má příkaz spustit. Režim přihlášení použije pro ověření přímo vaše přihlašovací údaje. Starší režim "klíč" se pokusí dotazovat na klíč účtu, pokud nejsou k dispozici žádné parametry ověřování pro účet. Proměnná prostředí: AZURE_STORAGE_AUTH_MODE.

Vlastnost Hodnota
Přípustné hodnoty: key, login
--blob-endpoint

Koncový bod datové služby úložiště Musí být použit ve spojení s klíčem účtu úložiště nebo tokenem SAS. Ke každému primárnímu koncovému bodu az storage account showslužby můžete použít . Proměnná prostředí: AZURE_STORAGE_SERVICE_ENDPOINT.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--connection-string

Řetězec připojení účtu úložiště Proměnná prostředí: AZURE_STORAGE_CONNECTION_STRING.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--destination-blob-type

Definuje typ objektu blob v cíli. Hodnota "Detect" určuje typ na základě typu zdrojového objektu blob.

Vlastnost Hodnota
Přípustné hodnoty: AppendBlob, BlockBlob, Detect, PageBlob
--destination-container -c

Kontejner objektů blob, do kterého se zkopírují vybrané zdrojové soubory nebo objekty blob.

--destination-path

Cílová cesta, která bude před názvem objektu blob.

--dryrun

Vypíše soubory nebo objekty blob, které se mají nahrát. Nedojde k žádnému skutečnému přenosu dat.

Vlastnost Hodnota
Default value: False
--pattern

Vzor používaný pro soubory nebo objekty blob ve zdroji. Podporované vzory jsou *, ?, [seq] a [!seq]. Další informace naleznete v https://docs.python.org/3/library/fnmatch.htmltématu .

Při použití znaku *ve vzoru bude odpovídat libovolnému znaku včetně oddělovače adresáře /.

--rehydrate-priority -r

Uveďte prioritu, se kterou se má dosadit archivovaný objekt blob.

--sas-token

Sdílený přístupový podpis (SAS). Musí být použit ve spojení s názvem účtu úložiště nebo koncovým bodem služby. Proměnná prostředí: AZURE_STORAGE_SAS_TOKEN.

Vlastnost Hodnota
Skupina parametrů: Storage Account Arguments
--source-account-key

Klíč účtu pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-account-name

Zdrojový účet úložiště, ze kterého se soubory nebo objekty blob zkopírují do cíle. Pokud tento parametr vynecháte, použije se cílový účet.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-container

Zdrojový kontejner, ze kterého se objekty blob kopírují.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-sas

Sdílený přístupový podpis pro zdrojový účet úložiště.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-share

Zdrojová sdílená složka, ze které se soubory kopírují.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--source-uri

Identifikátor URI určující sdílenou složku nebo kontejner objektů blob, ze kterého se kopírují soubory nebo objekty blob.

Pokud je zdroj v jiném účtu, musí být zdroj buď veřejný, nebo musí být ověřený pomocí sdíleného přístupového podpisu.

Vlastnost Hodnota
Skupina parametrů: Copy Source Arguments
--tier

Hodnota vrstvy, na kterou se má objekt blob nastavit. U objektu blob stránky úroveň koreluje s velikostí objektu blob a počtem povolených vstupně-výstupních operací za sekundu. Možné hodnoty jsou P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80 a to platí jenom pro objekty blob stránky v účtech premium storage; Pro objekt blob bloku jsou možné hodnoty Archive, Cold, Cool a Hot. To platí jenom pro objekty blob bloku v účtech úložiště úrovně Standard.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False