Udostępnij za pomocą

az storage blob copy

Note

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.

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

 Core ogólna dostępność
az storage blob copy start (storage-blob-preview rozszerzenie)

Uruchom zadanie kopiowania obiektu blob.

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

 Core ogólna dostępność

az storage blob copy cancel

Edytuj

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--account-key

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

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--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 komend magazynowania, limit API może zostać osiągnięty.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--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.

Właściwość Wartość
Dopuszczalne 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.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--connection-string

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

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--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.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--timeout

Limit czasu oczekiwania na żądanie w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False

az storage blob copy start

Edytuj

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--account-key

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

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--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 komend magazynowania, limit API może zostać osiągnięty.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--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.

Właściwość Wartość
Dopuszczalne 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.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--connection-string

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

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--destination-blob-type

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

Właściwość Wartość
Dopuszczalne 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ą.

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--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).

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--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, i nie można wykonać operacji, jeśli istnieje.

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--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).

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--destination-lease-id

Identyfikator dzierżawy określony dla tego nagłówka musi być zgodny z identyfikatorem dzierżawy docelowego obiektu blob. 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ą.

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--metadata

Metadane w formacie klucz=wartość, rozdzielone 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.

Właściwość Wartość
Dopuszczalne 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.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--source-account-key

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-account-name

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-blob

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-container

Nazwa kontenera źródłowego konta magazynu.

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--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ą.

Właściwość Wartość
Grupa parametrów: Pre-condition Arguments
--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.

Właściwość Wartość
Grupa parametrów: Pre-condition Arguments
--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, i nie można wykonać operacji, jeśli istnieje.

Właściwość Wartość
Grupa parametrów: Pre-condition Arguments
--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.

Właściwość Wartość
Grupa parametrów: Pre-condition Arguments
--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.

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-path

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-sas

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-share

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-snapshot

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--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ą.

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--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://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>, https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken.

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--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 oczekiwania na żądanie w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--account-key

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

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--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 komend magazynowania, limit API może zostać osiągnięty.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--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.

Właściwość Wartość
Dopuszczalne 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.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--connection-string

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

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--destination-blob-type

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

Właściwość Wartość
Dopuszczalne 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ą.

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--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).

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--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, i nie można wykonać operacji, jeśli istnieje.

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--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).

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--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ą.

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--metadata

Metadane w formacie klucz=wartość, rozdzielone 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.

Właściwość Wartość
Dopuszczalne wartości: false, true
--sas-token

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

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--source-account-key

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-account-name

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-blob

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-container

Nazwa kontenera źródłowego konta magazynu.

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--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ą.

Właściwość Wartość
Grupa parametrów: Pre-condition Arguments
--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.

Właściwość Wartość
Grupa parametrów: Pre-condition Arguments
--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, i nie można wykonać operacji, jeśli istnieje.

Właściwość Wartość
Grupa parametrów: Pre-condition Arguments
--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.

Właściwość Wartość
Grupa parametrów: Pre-condition Arguments
--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.

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-path

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-sas

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-share

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-snapshot

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--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ą.

Właściwość Wartość
Grupa parametrów: Precondition Arguments
--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://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>, https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken.

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--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 oczekiwania na żądanie w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False

az storage blob copy start-batch

Edytuj

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--account-key

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

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--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 komend magazynowania, limit API może zostać osiągnięty.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--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.

Właściwość Wartość
Dopuszczalne 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.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--connection-string

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

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--destination-blob-type

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

Właściwość Wartość
Dopuszczalne 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.

Właściwość Wartość
Domyślna wartość: 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/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.

Właściwość Wartość
Grupa parametrów: Storage Account Arguments
--source-account-key

Klucz konta źródłowego konta magazynu.

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--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.

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-container

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-sas

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--source-share

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

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--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.

Właściwość Wartość
Grupa parametrów: Copy Source Arguments
--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.

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False