az storage blob copy

  • Odwołanie

Zarządzanie operacjami kopiowania obiektów blob. Służy az storage blob show do sprawdzania stanu obiektów blob.

Polecenia

az storage blob copy cancel

Przerywanie trwającej operacji kopiowania.
az storage blob copy start

Skopiuj obiekt blob asynchronicznie. Służy az storage blob show do sprawdzania stanu obiektów blob.
az storage blob copy start-batch

Skopiuj wiele obiektów blob do kontenera obiektów blob. Służy az storage blob show do sprawdzania stanu obiektów blob.

az storage blob copy cancel

Edytuj

Przerywanie 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 element istnieje, zostanie zastąpiony.

--destination-container -c

Nazwa kontenera.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Musi być używany 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 żadna z nich nie istnieje, polecenie spróbuje wykonać zapytanie o klucz 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

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

--sas-token

Sygnatura dostępu współdzielonego (SAS). Musi być używany 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.

az storage blob copy start

Edytuj

Skopiuj obiekt blob asynchronicznie. Służy az storage blob show do sprawdzania stanu 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-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. Służy `az storage blob show` do sprawdzania stanu 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. Służy `az storage blob show` do sprawdzania stanu 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 element istnieje, zostanie zastąpiony.

--destination-container -c

Nazwa kontenera.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Musi być używany 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 żadna z nich nie istnieje, polecenie spróbuje wykonać zapytanie o klucz 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-if-match

Wartość 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 będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na 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 (Warunek wstępny nie powiodło się).

--destination-if-none-match

Wartość 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 powiedzie się operacji, jeśli istnieje.

--destination-if-unmodified-since

Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na 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 (Warunek wstępny nie powiodło się).

--destination-lease-id

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

--destination-tags-condition

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

--metadata

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

--rehydrate-priority -r

Wskaż priorytet, za pomocą którego ma być ponownie wypełnianie zarchiwizowanego obiektu 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). Musi być używany 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ść 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 będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na 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ść 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 powiedzie się operacji, jeśli istnieje.

--source-if-unmodified-since

Wartość typu Data/godzina. Platforma Azure oczekuje, że wartość daty przekazana w formacie UTC będzie mieć wartość UTC. Jeśli strefa czasowa jest uwzględniona, wszystkie daty i godziny inne niż UTC zostaną przekonwertowane na 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 tę opcję, 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 w obiektach blob z pasującą wartością.

--source-uri -u

Adres URL o długości do 2 KB, który określa plik platformy Azure lub obiekt blob. Wartość powinna być zakodowana w adresie URL, ponieważ jest wyświetlana 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.

--tags

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

--tier

Wartość warstwy, na która ma zostać ustawiona wartość obiektu blob. 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 blokowego obiektu blob możliwe wartości to Archiwum, 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.

az storage blob copy start-batch

Edytuj

Skopiuj wiele obiektów blob do kontenera obiektów blob. Służy az storage blob show do sprawdzania stanu obiektów blob.

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

Przykłady

Skopiuj wiele obiektów blob do kontenera obiektów blob. Służy `az storage blob show` do sprawdzania stanu obiektów blob. (generowane automatycznie)

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. Musi być używany 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 żadna z nich nie istnieje, polecenie spróbuje wykonać zapytanie o klucz 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-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 zostanie prependowana do nazwy obiektu blob.

--dryrun

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

--pattern

Wzorzec używany do 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.

--sas-token

Sygnatura dostępu współdzielonego (SAS). Musi być używany 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.