az storage blob copy

Uwaga

Ta grupa poleceń zawiera polecenia zdefiniowane zarówno w interfejsie wiersza polecenia platformy Azure, jak i w co najmniej jednym rozszerzeniu. Zainstaluj każde rozszerzenie, aby korzystać z rozszerzonych możliwości. Dowiedz się więcej o rozszerzeniach.

Zarządzanie operacjami kopiowania obiektów blob. Użyj az storage blob show polecenia , aby sprawdzić stan obiektów blob.

Polecenia

Nazwa	Opis	Typ	Stan
az storage blob copy cancel	Przerwanie trwającej operacji kopiowania.	Podstawowe funkcje	Ogólna dostępność
az storage blob copy start	Skopiuj obiekt blob asynchronicznie. Użyj az storage blob show polecenia , aby sprawdzić stan obiektów blob.	Podstawowe funkcje	Ogólna dostępność
az storage blob copy start (storage-blob-preview rozszerzenie)	Uruchom zadanie kopiowania obiektu blob.	Numer wewnętrzny	Ogólna dostępność
az storage blob copy start-batch	Skopiuj wiele obiektów blob do kontenera obiektów blob. Użyj az storage blob show polecenia , aby sprawdzić stan obiektów blob.	Podstawowe funkcje	Ogólna dostępność

az storage blob copy cancel

Przerwanie trwającej operacji kopiowania.

Spowoduje to pozostawienie docelowego obiektu blob o zerowej długości i pełnych metadanych. Spowoduje to wystąpienie błędu, jeśli operacja kopiowania została już zakończona.

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]

Parametry wymagane

--copy-id

Operacja kopiowania do przerwania. Może to być ciąg identyfikatora lub wystąpienie obiektu BlobProperties.

--destination-blob -b

Nazwa docelowego obiektu blob. Jeśli istnieje, zostanie zastąpiony.

--destination-container -c

Nazwa kontenera.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.

--auth-mode

Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.

akceptowane wartości: key, login

--blob-endpoint

Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

--lease-id

Wymagane, jeśli docelowy obiekt blob ma aktywną nieskończoną dzierżawę.

--sas-token

Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.

--timeout

Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc

wartość domyślna: json

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az storage blob copy start

Skopiuj obiekt blob asynchronicznie. Użyj az storage blob show polecenia , aby sprawdzić stan obiektów 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]

Przykłady

Skopiuj obiekt blob asynchronicznie. Użyj polecenia "az storage blob show", aby sprawdzić stan obiektów 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

Skopiuj obiekt blob asynchronicznie. Użyj polecenia "az storage blob show", aby sprawdzić stan obiektów 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

Kopiowanie określonej wersji obiektu 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

Parametry wymagane

--destination-blob -b

Nazwa docelowego obiektu blob. Jeśli istnieje, zostanie zastąpiony.

--destination-container -c

Nazwa kontenera.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.

--auth-mode

Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.

akceptowane wartości: key, login

--blob-endpoint

Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

--destination-blob-type

Definiuje typ obiektu blob w miejscu docelowym. Wartość "Detect" określa typ na podstawie typu źródłowego obiektu blob.

akceptowane wartości: AppendBlob, BlockBlob, Detect, PageBlob

--destination-if-match

Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.

--destination-if-modified-since

Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy docelowy obiekt blob został zmodyfikowany od określonej daty/godziny. Jeśli docelowy obiekt blob nie został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Niepowodzenie warunku wstępnego).

--destination-if-none-match

Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.

--destination-if-unmodified-since

Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy docelowy obiekt blob nie został zmodyfikowany od określonej daty/godziny. Jeśli docelowy obiekt blob został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Niepowodzenie warunku wstępnego).

--destination-lease-id

Identyfikator dzierżawy określony dla tego nagłówka musi być zgodny z identyfikatorem dzierżawy obiektu blob szacowania. Jeśli żądanie nie zawiera identyfikatora dzierżawy lub jest nieprawidłowe, operacja kończy się niepowodzeniem z kodem stanu 412 (Niepowodzenie warunku wstępnego).

--destination-tags-condition

Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.

--metadata

Metadane w parach klucz=wartość rozdzielanych spacjami. Spowoduje to zastąpienie wszystkich istniejących metadanych.

--rehydrate-priority -r

Wskaż priorytet, z którym ma być przywracany zarchiwizowany obiekt blob.

--requires-sync

Wymuś, że usługa nie zwróci odpowiedzi, dopóki kopia nie zostanie ukończona.

akceptowane wartości: false, true

--sas-token

Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.

--source-account-key

Klucz konta magazynu źródłowego obiektu blob.

--source-account-name

Nazwa konta magazynu źródłowego obiektu blob.

--source-blob

Nazwa obiektu blob źródłowego konta magazynu.

--source-container

Nazwa kontenera źródłowego konta magazynu.

--source-if-match

Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.

--source-if-modified-since

Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy źródłowy obiekt blob został zmodyfikowany od określonej daty/godziny.

--source-if-none-match

Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.

--source-if-unmodified-since

Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy źródłowy obiekt blob nie został zmodyfikowany od określonej daty/godziny.

--source-lease-id

Określ to, aby wykonać operację kopiowania obiektu blob tylko wtedy, gdy podany identyfikator dzierżawy jest zgodny z aktywnym identyfikatorem dzierżawy źródłowego obiektu blob.

--source-path

Ścieżka pliku źródłowego konta magazynu.

--source-sas

Sygnatura dostępu współdzielonego dla źródłowego konta magazynu.

--source-share

Nazwa udziału źródłowego konta magazynu.

--source-snapshot

Migawka obiektu blob dla źródłowego konta magazynu.

--source-tags-condition

Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.

--source-uri -u

Adres URL o długości do 2 KB, który określa plik lub obiekt blob platformy Azure. Wartość powinna być zakodowana w adresie URL, tak jak w identyfikatorze URI żądania. Jeśli źródło znajduje się na innym koncie, źródło musi być publiczne lub musi być uwierzytelnione za pośrednictwem sygnatury dostępu współdzielonego. Jeśli źródło jest publiczne, nie jest wymagane uwierzytelnianie. Przykłady: 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

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--tier

Wartość warstwy do ustawienia obiektu blob na wartość . W przypadku stronicowego obiektu blob warstwa jest skorelowana z rozmiarem obiektu blob i liczbą dozwolonych operacji we/wy na sekundę. Możliwe wartości to P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80 i dotyczy to tylko stronicowych obiektów blob na kontach magazynu w warstwie Premium; W przypadku blokowych obiektów blob możliwe wartości to Archiwum, Zimno, Chłodna i Gorąca. Dotyczy to tylko blokowych obiektów blob na kontach magazynu w warstwie Standardowa.

--timeout

Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc

wartość domyślna: json

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

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

Uruchom zadanie kopiowania obiektu 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]

Przykłady

Skopiuj obiekt blob asynchronicznie. Użyj polecenia "az storage blob show", aby sprawdzić stan obiektów 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

Skopiuj obiekt blob asynchronicznie. Użyj polecenia "az storage blob show", aby sprawdzić stan obiektów 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

Parametry wymagane

--destination-blob -b

Nazwa docelowego obiektu blob. Jeśli istnieje, zostanie zastąpiony.

--destination-container -c

Nazwa kontenera.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.

--auth-mode

Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.

akceptowane wartości: key, login

--blob-endpoint

Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

--destination-blob-type

Definiuje typ obiektu blob w miejscu docelowym. Wartość "Detect" określa typ na podstawie typu źródłowego obiektu blob.

akceptowane wartości: AppendBlob, BlockBlob, Detect, PageBlob

--destination-if-match

Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.

--destination-if-modified-since

Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy docelowy obiekt blob został zmodyfikowany od określonej daty/godziny. Jeśli docelowy obiekt blob nie został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Niepowodzenie warunku wstępnego).

--destination-if-none-match

Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.

--destination-if-unmodified-since

Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy docelowy obiekt blob nie został zmodyfikowany od określonej daty/godziny. Jeśli docelowy obiekt blob został zmodyfikowany, usługa Blob zwraca kod stanu 412 (Niepowodzenie warunku wstępnego).

--destination-lease-id

Identyfikator dzierżawy określony dla tego nagłówka musi być zgodny z identyfikatorem dzierżawy obiektu blob szacowania. Jeśli żądanie nie zawiera identyfikatora dzierżawy lub jest nieprawidłowe, operacja kończy się niepowodzeniem z kodem stanu 412 (Niepowodzenie warunku wstępnego).

--destination-tags-condition

Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.

--metadata

Metadane w parach klucz=wartość rozdzielanych spacjami. Spowoduje to zastąpienie wszystkich istniejących metadanych.

--rehydrate-priority -r

Wskaż priorytet, z którym ma być przywracany zarchiwizowany obiekt blob.

--requires-sync

Wymuś, że usługa nie zwróci odpowiedzi, dopóki kopia nie zostanie ukończona.

akceptowane wartości: false, true

--sas-token

Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.

--source-account-key

Klucz konta magazynu źródłowego obiektu blob.

--source-account-name

Nazwa konta magazynu źródłowego obiektu blob.

--source-blob

Nazwa obiektu blob źródłowego konta magazynu.

--source-container

Nazwa kontenera źródłowego konta magazynu.

--source-if-match

Wartość elementu ETag lub symbol wieloznaczny (*). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu jest zgodny z określoną wartością.

--source-if-modified-since

Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy źródłowy obiekt blob został zmodyfikowany od określonej daty/godziny.

--source-if-none-match

Wartość elementu ETag lub symbol wieloznaczny (). Określ ten nagłówek, aby wykonać operację tylko wtedy, gdy element ETag zasobu nie jest zgodny z określoną wartością. Określ symbol wieloznaczny (), aby wykonać operację tylko wtedy, gdy zasób nie istnieje, a operacja zakończy się niepowodzeniem, jeśli istnieje.

--source-if-unmodified-since

Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na czas UTC. Jeśli data jest przekazywana bez informacji o strefie czasowej, przyjmuje się, że jest to utc. Określ ten nagłówek warunkowy, aby skopiować obiekt blob tylko wtedy, gdy źródłowy obiekt blob nie został zmodyfikowany od określonej daty/godziny.

--source-lease-id

Określ to, aby wykonać operację kopiowania obiektu blob tylko wtedy, gdy podany identyfikator dzierżawy jest zgodny z aktywnym identyfikatorem dzierżawy źródłowego obiektu blob.

--source-path

Ścieżka pliku źródłowego konta magazynu.

--source-sas

Sygnatura dostępu współdzielonego dla źródłowego konta magazynu.

--source-share

Nazwa udziału źródłowego konta magazynu.

--source-snapshot

Migawka obiektu blob dla źródłowego konta magazynu.

--source-tags-condition

Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.

--source-uri -u

Adres URL o długości do 2 KB, który określa plik lub obiekt blob platformy Azure. Wartość powinna być zakodowana w adresie URL, tak jak w identyfikatorze URI żądania. Jeśli źródło znajduje się na innym koncie, źródło musi być publiczne lub musi być uwierzytelnione za pośrednictwem sygnatury dostępu współdzielonego. Jeśli źródło jest publiczne, nie jest wymagane uwierzytelnianie. Przykłady: 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

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. W tagach jest rozróżniana wielkość liter. Zestaw tagów może zawierać co najwyżej 10 tagów. Klucze tagów muszą zawierać od 1 do 128 znaków, a wartości tagów muszą mieć od 0 do 256 znaków. Prawidłowe znaki klucza tagu i wartości to: małe i wielkie litery, cyfry (0–9), spacja ( ), plus (+), minus (-), kropka (.), kropka (/), dwukropek (:), równa (=), podkreślenie (_).

--tier

Wartość warstwy do ustawienia obiektu blob na wartość . W przypadku stronicowego obiektu blob warstwa jest skorelowana z rozmiarem obiektu blob i liczbą dozwolonych operacji we/wy na sekundę. Możliwe wartości to P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80 i dotyczy to tylko stronicowych obiektów blob na kontach magazynu w warstwie Premium; W przypadku blokowych obiektów blob możliwe wartości to Archiwum, Zimno, Chłodna i Gorąca. Dotyczy to tylko blokowych obiektów blob na kontach magazynu w warstwie Standardowa.

--timeout

Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc

wartość domyślna: json

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az storage blob copy start-batch

Skopiuj wiele obiektów blob do kontenera obiektów blob. Użyj az storage blob show polecenia , aby sprawdzić stan obiektów 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]

Przykłady

Skopiuj wiele obiektów blob do kontenera obiektów blob. Użyj polecenia "az storage blob show", aby sprawdzić stan obiektów blob. (automatycznie wygenerowane)

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

Parametry opcjonalne

--account-key

Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żaden z nich nie istnieje, polecenie spróbuje wykonać zapytanie dotyczące klucza konta magazynu przy użyciu uwierzytelnioowanego konta platformy Azure. Jeśli zostanie wykonana duża liczba poleceń magazynu, limit przydziału interfejsu API może zostać osiągnięty.

--auth-mode

Tryb uruchamiania polecenia. Tryb "logowania" będzie bezpośrednio używać poświadczeń logowania do uwierzytelniania. Starszy tryb "klucz" spróbuje wysłać zapytanie o klucz konta, jeśli nie podano parametrów uwierzytelniania dla konta. Zmienna środowiskowa: AZURE_STORAGE_AUTH_MODE.

akceptowane wartości: key, login

--blob-endpoint

Punkt końcowy usługi danych magazynu. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Każdy podstawowy punkt końcowy usługi można znaleźć za pomocą polecenia az storage account show. Zmienna środowiskowa: AZURE_STORAGE_SERVICE_ENDPOINT.

--connection-string

Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.

--destination-blob-type

Definiuje typ obiektu blob w miejscu docelowym. Wartość "Detect" określa typ na podstawie typu źródłowego obiektu blob.

akceptowane wartości: AppendBlob, BlockBlob, Detect, PageBlob

--destination-container -c

Kontener obiektów blob, do którego zostaną skopiowane wybrane pliki źródłowe lub obiekty blob.

--destination-path

Ścieżka docelowa, która będzie poprzedzana nazwą obiektu blob.

--dryrun

Wyświetl listę plików lub obiektów blob do przekazania. Nie nastąpi rzeczywisty transfer danych.

wartość domyślna: False

--pattern

Wzorzec używany do tworzenia globbingu plików lub obiektów blob w źródle. Obsługiwane wzorce to "*", "?", "[seq]" i "[!seq]". Aby uzyskać więcej informacji, zobacz https://docs.python.org/3.7/library/fnmatch.html.

Jeśli używasz znaku "*" w elemecie --pattern, będzie on zgodny z dowolnym znakiem, w tym separatorem katalogu "/".

--rehydrate-priority -r

Wskaż priorytet, z którym ma być przywracany zarchiwizowany obiekt blob.

--sas-token

Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.

--source-account-key

Klucz konta źródłowego konta magazynu.

--source-account-name

Źródłowe konto magazynu, z którego pliki lub obiekty blob są kopiowane do miejsca docelowego. W przypadku pominięcia zostanie użyte konto docelowe.

--source-container

Kontener źródłowy, z którego są kopiowane obiekty blob.

--source-sas

Sygnatura dostępu współdzielonego dla źródłowego konta magazynu.

--source-share

Udział źródłowy, z którego są kopiowane pliki.

--source-uri

Identyfikator URI określający udział plików lub kontener obiektów blob, z którego są kopiowane pliki lub obiekty blob.

Jeśli źródło znajduje się na innym koncie, źródło musi być publiczne lub uwierzytelnione przy użyciu sygnatury dostępu współdzielonego.

--tier

Wartość warstwy do ustawienia obiektu blob na wartość . W przypadku stronicowego obiektu blob warstwa jest skorelowana z rozmiarem obiektu blob i liczbą dozwolonych operacji we/wy na sekundę. Możliwe wartości to P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80 i dotyczy to tylko stronicowych obiektów blob na kontach magazynu w warstwie Premium; W przypadku blokowych obiektów blob możliwe wartości to Archiwum, Zimno, Chłodna i Gorąca. Dotyczy to tylko blokowych obiektów blob na kontach magazynu w warstwie Standardowa.

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc

wartość domyślna: json

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.