az storage blob
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 magazynem obiektów dla danych bez struktury (obiektów blob).
Określ jeden z następujących parametrów uwierzytelniania dla poleceń: --auth-mode, --account-key, --connection-string, --sas-token. Możesz również użyć odpowiednich zmiennych środowiskowych do przechowywania poświadczeń uwierzytelniania, np. AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING i AZURE_STORAGE_SAS_TOKEN.
Polecenia
Nazwa | Opis | Typ | Stan |
---|---|---|---|
az storage blob access |
Zarządzaj właściwościami kontroli dostępu obiektu blob, gdy włączono hierarchiczną przestrzeń nazw. |
Numer wewnętrzny | Przestarzałe |
az storage blob access set |
Ustaw właściwości kontroli dostępu obiektu blob. |
Numer wewnętrzny | Przestarzałe |
az storage blob access show |
Pokaż właściwości kontroli dostępu obiektu blob. |
Numer wewnętrzny | Przestarzałe |
az storage blob access update |
Zaktualizuj właściwości kontroli dostępu obiektu blob. |
Numer wewnętrzny | Przestarzałe |
az storage blob copy |
Zarządzanie operacjami kopiowania obiektów blob. Użyj |
Core i Extension | Ogólna dostępność |
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 |
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 |
Podstawowe funkcje | Ogólna dostępność |
az storage blob delete |
Oznacz obiekt blob lub migawkę do usunięcia. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob delete (storage-blob-preview rozszerzenie) |
Oznacz obiekt blob lub migawkę do usunięcia. |
Numer wewnętrzny | Ogólna dostępność |
az storage blob delete-batch |
Rekursywnie usuwaj obiekty blob z kontenera obiektów blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob directory |
Zarządzanie katalogami obiektów blob w kontenerze konta magazynu. |
Numer wewnętrzny | Przestarzałe |
az storage blob directory access |
Zarządzaj właściwościami kontroli dostępu katalogu, gdy włączono hierarchiczną przestrzeń nazw. |
Numer wewnętrzny | Podgląd i przestarzałe |
az storage blob directory access set |
Ustaw właściwości kontroli dostępu katalogu. |
Numer wewnętrzny | Podgląd i przestarzałe |
az storage blob directory access show |
Pokaż właściwości kontroli dostępu katalogu. |
Numer wewnętrzny | Podgląd i przestarzałe |
az storage blob directory access update |
Zaktualizuj właściwości kontroli dostępu katalogu. |
Numer wewnętrzny | Podgląd i przestarzałe |
az storage blob directory create |
Utwórz katalog obiektów blob magazynu w kontenerze magazynu. |
Numer wewnętrzny | Przestarzałe |
az storage blob directory delete |
Usuń katalog obiektów blob magazynu w kontenerze magazynu. |
Numer wewnętrzny | Przestarzałe |
az storage blob directory download |
Pobierz obiekty blob do lokalnej ścieżki pliku. |
Numer wewnętrzny | Przestarzałe |
az storage blob directory exists |
Sprawdź istnienie katalogu obiektów blob w kontenerze magazynu. |
Numer wewnętrzny | Przestarzałe |
az storage blob directory list |
Wyświetlanie listy obiektów blob i podkatalogów obiektów blob w katalogu magazynu. |
Numer wewnętrzny | Przestarzałe |
az storage blob directory metadata |
Zarządzanie metadanymi katalogu. |
Numer wewnętrzny | Przestarzałe |
az storage blob directory metadata show |
Pokaż wszystkie metadane zdefiniowane przez użytkownika dla określonego katalogu obiektów blob. |
Numer wewnętrzny | Przestarzałe |
az storage blob directory metadata update |
Ustaw metadane zdefiniowane przez użytkownika dla określonego katalogu obiektów blob jako co najmniej jedną parę nazwa-wartość. |
Numer wewnętrzny | Przestarzałe |
az storage blob directory move |
Przenieś katalog magazynu do innego katalogu obiektów blob magazynu w kontenerze magazynu. |
Numer wewnętrzny | Przestarzałe |
az storage blob directory show |
Pokaż właściwości katalogu obiektów blob magazynu w kontenerze magazynu. |
Numer wewnętrzny | Przestarzałe |
az storage blob directory upload |
Przekazywanie obiektów blob lub podkatalogów do katalogu obiektów blob magazynu. |
Numer wewnętrzny | Przestarzałe |
az storage blob download |
Pobierz obiekt blob do ścieżki pliku. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob download-batch |
Pobieranie obiektów blob z kontenera obiektów blob rekursywnie. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob exists |
Sprawdź istnienie obiektu blob w kontenerze. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob filter |
Wyświetl listę obiektów blob we wszystkich kontenerach, których tagi pasują do danego wyrażenia wyszukiwania. |
Numer wewnętrzny | Wersja Preview |
az storage blob generate-sas |
Wygeneruj sygnaturę dostępu współdzielonego dla obiektu blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob generate-sas (storage-blob-preview rozszerzenie) |
Wygeneruj sygnaturę dostępu współdzielonego dla obiektu blob. |
Numer wewnętrzny | Ogólna dostępność |
az storage blob immutability-policy |
Zarządzanie zasadami niezmienności obiektów blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob immutability-policy delete |
Usuń zasady niezmienności obiektu blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob immutability-policy set |
Ustaw zasady niezmienności obiektu blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob incremental-copy |
Zarządzanie operacjami kopiowania przyrostowego obiektów blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob incremental-copy cancel |
Przerywa oczekującą operację copy_blob i pozostawia docelowy obiekt blob o zerowej długości i pełnych metadanych. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob incremental-copy start |
Kopiuje przyrostową kopię obiektu blob asynchronicznie. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob lease |
Zarządzanie dzierżawami obiektów blob magazynu. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob lease acquire |
Zażądaj nowej dzierżawy. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob lease break |
Przerwij dzierżawę, jeśli kontener lub obiekt blob ma aktywną dzierżawę. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob lease change |
Zmień identyfikator dzierżawy aktywnej dzierżawy. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob lease release |
Zwolnij dzierżawę. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob lease renew |
Odnów dzierżawę. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob list |
Wyświetlanie listy obiektów blob w danym kontenerze. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob metadata |
Zarządzanie metadanymi obiektów blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob metadata show |
Zwróć wszystkie metadane zdefiniowane przez użytkownika dla określonego obiektu blob lub migawki. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob metadata update |
Ustawia metadane zdefiniowane przez użytkownika dla obiektu blob jako co najmniej jedną parę nazwa-wartość. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob move |
Przenoszenie obiektu blob w kontenerze magazynu. |
Numer wewnętrzny | Podgląd i przestarzałe |
az storage blob query |
Umożliwia użytkownikom wybieranie/projekt danych migawek obiektów blob lub obiektów blob przez udostępnianie prostych wyrażeń zapytań. |
Podstawowe funkcje | Wersja Preview |
az storage blob restore |
Przywracanie obiektów blob w określonych zakresach obiektów blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob rewrite |
Utwórz nowy blokowy obiekt blob, w którym zawartość obiektu blob jest odczytywana z danego adresu URL. |
Podstawowe funkcje | Wersja Preview |
az storage blob service-properties |
Zarządzanie właściwościami usługi blob magazynu. |
Core i Extension | Ogólna dostępność |
az storage blob service-properties delete-policy |
Zarządzanie właściwościami usługi usuwania obiektów blob magazynu. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob service-properties delete-policy show |
Pokaż zasady usuwania obiektów blob magazynu. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob service-properties delete-policy update |
Zaktualizuj zasady usuwania obiektów blob magazynu. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob service-properties show |
Pobiera właściwości usługi Blob service konta magazynu, w tym usługi Azure analityka magazynu. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob service-properties update |
Aktualizowanie właściwości usługi blob magazynu. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob service-properties update (storage-blob-preview rozszerzenie) |
Aktualizowanie właściwości usługi blob magazynu. |
Numer wewnętrzny | Ogólna dostępność |
az storage blob set-legal-hold |
Ustaw blokadę prawną obiektu blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob set-tier |
Ustaw warstwy bloku lub strony w obiekcie blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob set-tier (storage-blob-preview rozszerzenie) |
Ustaw warstwy bloku lub strony w obiekcie blob. |
Numer wewnętrzny | Ogólna dostępność |
az storage blob show |
Uzyskaj szczegóły obiektu blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob show (storage-blob-preview rozszerzenie) |
Uzyskaj szczegóły obiektu blob. |
Numer wewnętrzny | Ogólna dostępność |
az storage blob snapshot |
Tworzy migawkę obiektu blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob sync |
Synchronizuj obiekty blob cyklicznie z kontenerem obiektów blob magazynu. |
Podstawowe funkcje | Wersja Preview |
az storage blob tag |
Zarządzanie tagami obiektów blob. |
Numer wewnętrzny | Wersja Preview |
az storage blob tag list |
Pobieranie tagów dla obiektu blob lub określonej wersji obiektu blob lub migawki. |
Numer wewnętrzny | Wersja Preview |
az storage blob tag set |
Ustaw tagi dla obiektu blob lub określonej wersji obiektu blob, ale nie migawki. |
Numer wewnętrzny | Wersja Preview |
az storage blob undelete |
Przywracanie nietrwałego usuniętego obiektu blob lub migawki. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob update |
Ustawia właściwości systemowe obiektu blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob upload |
Przekaż plik do obiektu blob magazynu. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob upload-batch |
Przekazywanie plików z katalogu lokalnego do kontenera obiektów blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob url |
Utwórz adres URL, aby uzyskać dostęp do obiektu blob. |
Podstawowe funkcje | Ogólna dostępność |
az storage blob delete
Oznacz obiekt blob lub migawkę do usunięcia.
Obiekt blob jest oznaczony do późniejszego usunięcia podczas odzyskiwania pamięci. Aby można było usunąć obiekt blob, należy również usunąć wszystkie jego migawki. Oba można usunąć w tym samym czasie.
az storage blob delete [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--delete-snapshots {include, only}]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--name]
[--sas-token]
[--snapshot]
[--tags-condition]
[--timeout]
Przykłady
Usuwanie obiektu blob.
az storage blob delete -c mycontainer -n MyBlob
Usuń obiekt blob przy użyciu poświadczeń logowania.
az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login
Parametry opcjonalne
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.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
Wymagane, jeśli obiekt blob ma skojarzone migawki. Wartości obejmują: "only": Usuwa tylko migawki obiektów blob. "include": Usuwa obiekt blob wraz ze wszystkimi migawkami.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Wymagane, jeśli obiekt blob ma aktywną dzierżawę.
Nazwa obiektu blob.
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.
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do usunięcia.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob delete (storage-blob-preview rozszerzenie)
Oznacz obiekt blob lub migawkę do usunięcia.
Obiekt blob jest oznaczony do późniejszego usunięcia podczas odzyskiwania pamięci. Aby można było usunąć obiekt blob, należy również usunąć wszystkie jego migawki. Oba można usunąć w tym samym czasie.
az storage blob delete [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--delete-snapshots {include, only}]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--name]
[--sas-token]
[--snapshot]
[--tags-condition]
[--timeout]
[--version-id]
Przykłady
Usuwanie obiektu blob.
az storage blob delete -c mycontainer -n MyBlob
Usuń obiekt blob przy użyciu poświadczeń logowania.
az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
Wymagane, jeśli obiekt blob ma skojarzone migawki. "only": usuwa tylko migawki obiektów blob. "include": Usuwa obiekt blob wraz ze wszystkimi migawkami.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Wymagane, jeśli obiekt blob ma aktywną dzierżawę.
Nazwa obiektu blob.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Opcjonalny identyfikator wersji obiektu blob. Ten parametr jest przeznaczony tylko dla konta z włączoną obsługą wersji.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob delete-batch
Rekursywnie usuwaj obiekty blob z kontenera obiektów blob.
az storage blob delete-batch --source
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--delete-snapshots {include, only}]
[--dryrun]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--pattern]
[--sas-token]
[--timeout]
Przykłady
Usuń wszystkie obiekty blob kończące się ciągiem ".py" w kontenerze, który nie został zmodyfikowany przez 10 dni.
date=`date -d "10 days ago" '+%Y-%m-%dT%H:%MZ'`
az storage blob delete-batch -s mycontainer --account-name mystorageaccount --pattern "*.py" --if-unmodified-since $date --auth-mode login
Usuń wszystkie obiekty blob w katalogu o nazwie "dir" w kontenerze o nazwie "mycontainer".
az storage blob delete-batch -s mycontainer --pattern "dir/*"
Usuń obiekty blob z formatem "cli-2018-xx-xx.txt" lub "cli-2019-xx-xx.txt" w kontenerze.
az storage blob delete-batch -s mycontainer --pattern "cli-201[89]-??-??.txt"
Usuń wszystkie obiekty blob w formacie "cli-201x-xx-xx.txt", z wyjątkiem cli-2018-xx-xx.txt" i "cli-2019-xx-xx.txt" w kontenerze.
az storage blob delete-batch -s mycontainer --pattern "cli-201[!89]-??-??.txt"
Parametry wymagane
Kontener obiektów blob, z którego zostaną usunięte pliki.
Źródłem może być adres URL kontenera lub nazwa kontenera. Gdy źródło jest adresem URL kontenera, nazwa konta magazynu zostanie przeanalizowana z adresu URL.
Parametry opcjonalne
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.
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.
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.
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.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Wymagane, jeśli obiekt blob ma skojarzone migawki.
Pokaż podsumowanie operacji do wykonania zamiast faktycznego usuwania plików.
Jeśli zostanie to określone, zignoruje wszystkie argumenty warunków wstępnych, które obejmują --if-modified-since i --if-unmodified-since. Dlatego pliki zostaną usunięte za pomocą polecenia bez --dryrun może różnić się od listy wyników z flagą --dryrun na.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Identyfikator aktywnej dzierżawy obiektu blob.
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 "/". Możesz również spróbować użyć polecenia "az storage remove" za pomocą polecenia --include i --exclude z interfejsem wiersza polecenia >platformy Azure = 2.0.70, aby dopasować wiele wzorców.
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.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob download
Pobierz obiekt blob do ścieżki pliku.
az storage blob download [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--end-range]
[--file]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--max-connections]
[--name]
[--no-progress]
[--open-mode]
[--overwrite {false, true}]
[--sas-token]
[--snapshot]
[--start-range]
[--tags-condition]
[--timeout]
[--validate-content]
[--version-id]
Przykłady
Pobierz obiekt blob.
az storage blob download -f /path/to/file -c mycontainer -n MyBlob
Pobierz zawartość obiektu blob do elementu stdout(obsługa potoku).
az storage blob download -c mycontainer -n myblob --account-name mystorageaccount --account-key myaccountkey
Parametry opcjonalne
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.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
Koniec zakresu bajtów do użycia do pobrania sekcji obiektu blob. W przypadku podania end_range należy podać start_range. Parametry start_range i end_range są inkluzywne. Na przykład: start_range=0, end_range=511 pobierze pierwsze 512 bajtów obiektu blob.
Ścieżka pliku do zapisu. Jeśli nie zostanie określony, zostanie użyta funkcja stdout, a max_connections zostanie ustawiona na 1.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Wymagane, jeśli obiekt blob ma aktywną dzierżawę.
Liczba połączeń równoległych, z którymi należy pobrać.
Nazwa obiektu blob.
Dołącz tę flagę, aby wyłączyć raportowanie postępu dla polecenia.
Tryb do użycia podczas otwierania pliku. Należy pamiętać, że określanie dołączania tylko open_mode uniemożliwia pobieranie równoległe. Dlatego max_connections musi być ustawiona na 1, jeśli jest używana ta open_mode.
Zastąp istniejący plik po określeniu. Domyślna wartość to true.
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.
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
Początek zakresu bajtów do użycia do pobrania sekcji obiektu blob. Jeśli nie zostanie podana żadna end_range, wszystkie bajty po start_range zostaną pobrane. Parametry start_range i end_range są inkluzywne. Na przykład: start_range=0, end_range=511 pobierze pierwsze 512 bajtów obiektu blob.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Jeśli wartość true, oblicza skrót MD5 dla każdego fragmentu obiektu blob. Usługa magazynu sprawdza skrót zawartości, która dotarła do wysłanego skrótu. Jest to przede wszystkim przydatne w przypadku wykrywania bitflipów w sieci, jeśli używasz protokołu HTTP zamiast https, ponieważ protokół https (wartość domyślna) zostanie już zweryfikowany. Należy pamiętać, że ten skrót MD5 nie jest przechowywany w obiekcie blob. Należy również pamiętać, że jeśli jest włączona, algorytm wydajny w pamięci nie zostanie użyty, ponieważ przetwarzanie skrótu MD5 wymaga buforowania całych bloków i w ten sposób pokonuje cel algorytmu wydajnego w pamięci.
Opcjonalny identyfikator wersji obiektu blob. Ten parametr jest przeznaczony tylko dla konta z włączoną obsługą wersji.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob download-batch
Pobieranie obiektów blob z kontenera obiektów blob rekursywnie.
az storage blob download-batch --destination
--source
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--dryrun]
[--max-connections]
[--no-progress]
[--overwrite {false, true}]
[--pattern]
[--sas-token]
Przykłady
Pobierz wszystkie obiekty blob kończące się .py
az storage blob download-batch -d . --pattern "*.py" -s mycontainer --account-name mystorageaccount --account-key 00000000
Pobierz wszystkie obiekty blob w katalogu o nazwie "dir" z kontenera o nazwie "mycontainer".
az storage blob download-batch -d . -s mycontainer --pattern "dir/*"
Pobierz wszystkie obiekty blob w formacie "cli-2018-xx-xx.txt" lub "cli-2019-xx-xx.txt" w kontenerze do bieżącej ścieżki.
az storage blob download-batch -d . -s mycontainer --pattern "cli-201[89]-??-??.txt"
Pobierz wszystkie obiekty blob w formacie "cli-201x-xx-xx.txt", z wyjątkiem cli-2018-xx-xx.txt i "cli-2019-xx-xx.txt" w kontenerze do bieżącej ścieżki.
az storage blob download-batch -d . -s mycontainer --pattern "cli-201[!89]-??-??.txt"
Parametry wymagane
Istniejący folder docelowy dla tej operacji pobierania.
Kontener obiektów blob, z którego zostaną pobrane pliki.
Źródłem może być adres URL kontenera lub nazwa kontenera. Gdy źródło jest adresem URL kontenera, nazwa konta magazynu zostanie przeanalizowana z adresu URL.
Parametry opcjonalne
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.
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.
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.
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.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Pokaż podsumowanie operacji do wykonania zamiast faktycznie pobierać pliki.
Liczba połączeń równoległych, z którymi należy pobrać.
Dołącz tę flagę, aby wyłączyć raportowanie postępu dla polecenia.
Zastąp istniejący plik po określeniu. Wartość domyślna to false.
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 "/".
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.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob exists
Sprawdź istnienie obiektu blob w kontenerze.
az storage blob exists [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--name]
[--sas-token]
[--snapshot]
[--timeout]
Przykłady
Sprawdź istnienie obiektu blob w kontenerze. (automatycznie wygenerowane)
az storage blob exists --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob
Parametry opcjonalne
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.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
Nazwa obiektu blob.
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.
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob filter
To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Wyświetl listę obiektów blob we wszystkich kontenerach, których tagi pasują do danego wyrażenia wyszukiwania.
az storage blob filter --tag-filter
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--container-name]
[--sas-token]
Parametry wymagane
Wyrażenie do znajdowania obiektów blob, których tagi pasują do określonego warunku. np. "yourtagname"='firsttag' i "yourtagname2"='secondtag'".
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.
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.
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.
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.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Służy do wyświetlania listy obiektów blob w określonym kontenerze.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob generate-sas
Wygeneruj sygnaturę dostępu współdzielonego dla obiektu blob.
az storage blob generate-sas [--account-key]
[--account-name]
[--as-user]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--cache-control]
[--connection-string]
[--container-name]
[--content-disposition]
[--content-encoding]
[--content-language]
[--content-type]
[--encryption-scope]
[--expiry]
[--full-uri]
[--https-only]
[--ip]
[--name]
[--permissions]
[--policy-name]
[--snapshot]
[--start]
[--timeout]
Przykłady
Generowanie tokenu sas dla obiektu blob z uprawnieniami tylko do odczytu.
end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only
Wygeneruj token sas dla obiektu blob z określonym zakresem adresów IP.
end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only
Wygeneruj sygnaturę dostępu współdzielonego dla obiektu blob. (automatycznie wygenerowane)
az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r
Parametry opcjonalne
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.
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.
Wskazuje, że to polecenie zwraca sygnaturę dostępu współdzielonego podpisanego przy użyciu klucza delegowania użytkownika. W przypadku określenia tego argumentu wymagany jest parametr wygaśnięcia i identyfikator logowania w trybie uwierzytelniania.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Wartość nagłówka odpowiedzi dla kontroli pamięci podręcznej, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
Wartość nagłówka odpowiedzi dla właściwości Content-Disposition, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
Wartość nagłówka odpowiedzi dla kodowania zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
Wartość nagłówka odpowiedzi dla języka Content-Language, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
Wartość nagłówka odpowiedzi dla typu zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
Wstępnie zdefiniowany zakres szyfrowania używany do szyfrowania danych w usłudze.
Określa datę/godzinę UTC (Y-m-d'T'H:M'Z'), w której sygnatura dostępu współdzielonego stanie się nieprawidłowa. Nie należy używać, jeśli do przechowywanych zasad dostępu odwołuje się --policy-name, która określa tę wartość.
Wskazuje, że to polecenie zwraca pełny identyfikator URI obiektu blob i token sygnatury dostępu współdzielonego.
Zezwalaj tylko na żądania wysyłane przy użyciu protokołu HTTPS. W przypadku pominięcia żądania zarówno z protokołu HTTP, jak i HTTPS są dozwolone.
Określa adres IP lub zakres adresów IP, z których mają być akceptowane żądania. Obsługuje tylko adresy stylów IPv4.
Nazwa obiektu blob.
Uprawnienia udziela sygnatury dostępu współdzielonego. Dozwolone wartości: (a)dd (c)reate (d)elete (e)xecute (i)set_immutability_policy (m)ove (r)ead (t)ag (w)rite (x)delete_previous_version (y)permanent_delete. Nie należy używać, jeśli do przechowywanych zasad dostępu odwołuje się parametr --id określający tę wartość. Można połączyć.
Nazwa przechowywanych zasad dostępu w ramach listy ACL kontenera.
Opcjonalny identyfikator migawki obiektu blob. Nieprzezroczysta wartość datetime określająca migawkę obiektu blob w celu udzielenia uprawnień.
Określa datę/godzinę UTC (Y-m-d'T'H:M'Z'), o której sygnatura dostępu współdzielonego stanie się prawidłowa. Nie należy używać, jeśli do przechowywanych zasad dostępu odwołuje się --policy-name, która określa tę wartość. Domyślnie jest to czas żądania.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob generate-sas (storage-blob-preview rozszerzenie)
Wygeneruj sygnaturę dostępu współdzielonego dla obiektu blob.
az storage blob generate-sas --container-name
--name
[--account-key]
[--account-name]
[--as-user]
[--auth-mode {key, login}]
[--blob-endpoint]
[--cache-control]
[--connection-string]
[--content-disposition]
[--content-encoding]
[--content-language]
[--content-type]
[--expiry]
[--full-uri]
[--https-only]
[--ip]
[--permissions]
[--policy-name]
[--snapshot]
[--start]
[--version-id]
Przykłady
Generowanie tokenu sas dla obiektu blob z uprawnieniami tylko do odczytu.
end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only
Wygeneruj token sas dla obiektu blob z określonym zakresem adresów IP.
end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only
Wygeneruj sygnaturę dostępu współdzielonego dla obiektu blob. (automatycznie wygenerowane)
az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r
Parametry wymagane
Nazwa kontenera.
Nazwa obiektu blob.
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.
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.
Wskazuje, że to polecenie zwraca sygnaturę dostępu współdzielonego podpisanego przy użyciu klucza delegowania użytkownika. W przypadku określenia tego argumentu wymagany jest parametr wygaśnięcia i identyfikator logowania w trybie uwierzytelniania.
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.
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.
Wartość nagłówka odpowiedzi dla kontroli pamięci podręcznej, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Wartość nagłówka odpowiedzi dla właściwości Content-Disposition, gdy zasób uzyskuje dostęp do tego sygnatury dostępu współdzielonego.
Wartość nagłówka odpowiedzi dla kodowania zawartości, gdy zasób uzyskuje dostęp do tego sygnatury dostępu współdzielonego.
Wartość nagłówka odpowiedzi dla języka Content-Language, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
Wartość nagłówka odpowiedzi dla typu zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.
Określa datę/godzinę UTC (Y-m-d'T'H:M'Z'), w której sygnatura dostępu współdzielonego stanie się nieprawidłowa. Nie należy używać, jeśli do przechowywanych zasad dostępu odwołuje się parametr --id określający tę wartość.
Wskaż, że to polecenie zwraca pełny identyfikator URI obiektu blob i token sygnatury dostępu współdzielonego.
Zezwalaj tylko na żądania wysyłane przy użyciu protokołu HTTPS. W przypadku pominięcia żądania zarówno z protokołu HTTP, jak i HTTPS są dozwolone.
Określ adres IP lub zakres adresów IP, z których mają być akceptowane żądania. Jeśli adres IP, z którego pochodzi żądanie, nie jest zgodny z adresem IP lub zakresem adresów określonym w tokenie SAS, żądanie nie jest uwierzytelniane. Na przykład określenie adresu IP=168.1.5.65 lub ip=168.1.5.60-168.1.5.70 w sygnaturze dostępu współdzielonego ogranicza żądanie do tych adresów IP.
Uprawnienia udziela sygnatury dostępu współdzielonego. Dozwolone wartości: (a)dd (c)reate (d)elete (x)delete_previous_version (e)xecute (m)ove (p)ermanent_delete (r)ead (s)et_immutability_policy (t)ag (w)rite. Nie należy używać, jeśli do przechowywanych zasad dostępu odwołuje się --policy-name, która określa tę wartość. Można połączyć.
Nazwa przechowywanych zasad dostępu w ramach listy ACL kontenera.
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
Określa datę/godzinę UTC (Y-m-d'T'H:M'Z'), o której sygnatura dostępu współdzielonego stanie się prawidłowa. Nie należy używać, jeśli do przechowywanych zasad dostępu odwołuje się parametr --id określający tę wartość. Domyślnie jest to czas żądania.
Opcjonalny identyfikator wersji obiektu blob. Ten parametr jest przeznaczony tylko dla konta z włączoną obsługą wersji.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob list
Wyświetlanie listy obiektów blob w danym kontenerze.
az storage blob list --container-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--delimiter]
[--include]
[--marker]
[--num-results]
[--prefix]
[--sas-token]
[--show-next-marker]
[--timeout]
Przykłady
Wyświetl listę wszystkich obiektów blob magazynu w kontenerze, których nazwy zaczynają się od "foo"; będzie pasuje do nazw, takich jak "foo", "foobar" i "foo/bar"
az storage blob list -c mycontainer --prefix foo
Parametry wymagane
Nazwa kontenera.
Parametry opcjonalne
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.
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.
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.
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.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Gdy żądanie zawiera ten parametr, operacja zwraca element BlobPrefix na liście wyników, który działa jako symbol zastępczy dla wszystkich obiektów blob, których nazwy zaczynają się od tego samego podciągu do wyglądu znaku ogranicznika. Ogranicznik może być pojedynczym znakiem lub ciągiem.
Określ co najmniej jeden dodatkowy zestaw danych do uwzględnienia w odpowiedzi. Opcje obejmują: (c)opy, (d)eleted, (m)etadata, (s)napshots, (v)ersions, (t)ags, (i)mmutabilitypolicy, (l)egalhold, (d)eletedwithversions. Można połączyć.
Wartość ciągu, która identyfikuje część listy kontenerów, które mają zostać zwrócone przy użyciu następnej operacji wyświetlania listy. Operacja zwraca wartość NextMarker w treści odpowiedzi, jeśli operacja wyświetlania listy nie zwróciła wszystkich kontenerów pozostałych do wyświetlenia na bieżącej stronie. Jeśli zostanie określony, ten generator rozpocznie zwracanie wyników od momentu zatrzymania poprzedniego generatora.
Określ maksymalną liczbę do zwrócenia. Jeśli żądanie nie określi num_results lub określa wartość większą niż 5000, serwer zwróci do 5000 elementów. Należy pamiętać, że jeśli operacja listy przekroczy granicę partycji, usługa zwróci token kontynuacji w celu pobrania pozostałych wyników. Podaj wartość "*", aby zwrócić wszystkie.
Przefiltruj wyniki, aby zwracać tylko obiekty blob, których nazwa zaczyna się od określonego prefiksu.
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.
Pokaż następny znacznik w wyniku po określeniu.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob move
To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
To polecenie zostało wycofane i zostanie usunięte w przyszłej wersji. Zamiast tego użyj polecenia "az storage fs file move". Aby uzyskać więcej informacji, przejdź na stronę https://github.com/Azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/storage/docs/ADLS%20Gen2.md
Przenoszenie obiektu blob w kontenerze magazynu.
az storage blob move --container-name
--destination-blob
--source-blob
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--lease-id]
[--sas-token]
[--source-if-match]
[--source-if-modified-since]
[--source-if-none-match]
[--source-if-unmodified-since]
[--source-lease-id]
[--timeout]
Przykłady
Przenoszenie obiektu blob w kontenerze magazynu.
az storage blob move -c MyContainer -d DestinationBlobPath -s SourceBlobPath --account-name MyStorageAccount
Parametry wymagane
Nazwa kontenera.
Nazwa docelowego obiektu blob. Powinna to być ścieżka bezwzględna pod kontenerem. np. "topdir1/dirbar".
Nazwa źródłowego obiektu blob. Powinna to być ścieżka bezwzględna pod kontenerem. np. "topdir1/dirsubfoo".
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.
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.
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.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Opcjonalny. Identyfikator dzierżawy dla new_path. New_path musi mieć aktywną dzierżawę, a identyfikator dzierżawy musi być zgodny.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Opcjonalny. Wartość elementu ETag. Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy element ETag źródła jest zgodny z określoną wartością.
Opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy źródło zostało zmodyfikowane od określonej daty i godziny.
Opcjonalny. Wartość elementu ETag lub specjalna wartość wieloznaczny ("*"). Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy element ETag źródła nie jest zgodny z określoną wartością.
Opcjonalny. Wartość daty i godziny. Określ ten nagłówek, aby wykonać operację zmiany nazwy tylko wtedy, gdy źródło nie zostało zmodyfikowane od określonej daty i godziny.
Opcjonalny. Identyfikator dzierżawy dla source_path. Source_path musi mieć aktywną dzierżawę, a identyfikator dzierżawy musi być zgodny.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob query
To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Umożliwia użytkownikom wybieranie/projekt danych migawek obiektów blob lub obiektów blob przez udostępnianie prostych wyrażeń zapytań.
az storage blob query --query-expression
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--in-column-separator]
[--in-escape-char]
[--in-has-header]
[--in-line-separator]
[--in-quote-char]
[--in-record-separator]
[--input-format {csv, json}]
[--lease-id]
[--name]
[--out-column-separator]
[--out-escape-char]
[--out-has-header]
[--out-line-separator]
[--out-quote-char]
[--out-record-separator]
[--output-format {csv, json}]
[--result-file]
[--sas-token]
[--tags-condition]
[--timeout]
Przykłady
Umożliwianie użytkownikom wybierania/projektu w obiekcie blob przez udostępnianie prostych wyrażeń zapytań.
az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage"
Umożliwianie użytkownikom wybierania/projektu w obiekcie blob przez udostępnianie prostych wyrażeń zapytań i zapisywanie w pliku docelowym.
az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage" --result-file result.csv
Parametry wymagane
Wyrażenie zapytania w języku SQL. Maksymalny rozmiar wyrażenia zapytania to 256KiB. Aby uzyskać więcej informacji na temat składni wyrażeń, zobacz https://docs.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.
Parametry opcjonalne
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.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Ciąg używany do oddzielania kolumn.
Ciąg używany jako znak ucieczki. Wartość domyślna to puste.
Określa, czy dane obiektu blob zawierają nagłówki w pierwszym wierszu. Wartość domyślna to False, co oznacza, że dane zostaną zwrócone włącznie z pierwszym wierszem. W przypadku ustawienia wartości True dane będą zwracane wyłącznie z pierwszego wiersza.
Ciąg używany do oddzielania rekordów.
Ciąg używany do cudzysłowu określonego pola.
Ciąg używany do oddzielania rekordów.
Typ serializacji danych przechowywanych obecnie w obiekcie blob. Wartością domyślną jest traktowanie danych obiektu blob jako danych CSV sformatowanych w domyślnym dialektze. Dane obiektu blob zostaną sformatowane zgodnie z tym profilem po określeniu formatu obiektu blob. Jeśli wybierzesz opcję json
, określ Output Json Text Configuration Arguments
odpowiednio; Jeśli wybierzesz pozycję csv
, określ wartość Output Delimited Text Configuration Arguments
.
Wymagane, jeśli obiekt blob ma aktywną dzierżawę.
Nazwa obiektu blob.
Ciąg używany do oddzielania kolumn.
Ciąg używany jako znak ucieczki. Wartość domyślna to puste.
Określa, czy dane obiektu blob zawierają nagłówki w pierwszym wierszu. Wartość domyślna to False, co oznacza, że dane zostaną zwrócone włącznie z pierwszym wierszem. W przypadku ustawienia wartości True dane będą zwracane wyłącznie z pierwszego wiersza.
Ciąg używany do oddzielania rekordów.
Ciąg używany do cudzysłowu określonego pola.
Ciąg używany do oddzielania rekordów.
Typ serializacji danych wyjściowych dla strumienia danych. Domyślnie dane będą zwracane, ponieważ są reprezentowane w obiekcie blob. Po podaniu formatu wyjściowego dane obiektu blob zostaną sformatowane zgodnie z tym profilem. Jeśli wybierzesz opcję json
, określ Output Json Text Configuration Arguments
odpowiednio; Jeśli wybierzesz pozycję csv
, określ wartość Output Delimited Text Configuration Arguments
.
Określ ścieżkę pliku, aby zapisać wynik.
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.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob restore
Przywracanie obiektów blob w określonych zakresach obiektów blob.
az storage blob restore --account-name
--time-to-restore
[--blob-range]
[--no-wait]
[--resource-group]
Przykłady
Przywracanie obiektów blob w dwóch określonych zakresach obiektów blob. Na przykład (container1/blob1, container2/blob2) i (container2/blob3.). container2/blob4).
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r container1/blob1 container2/blob2 -r container2/blob3 container2/blob4
Przywracanie obiektów blob w określonych zakresach obiektów blob od początku konta do końca konta.
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r "" ""
Przywracanie obiektów blob w określonym zakresie obiektów blob.
time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2
Przywracanie obiektów blob w określonym zakresie obiektów blob bez oczekiwania i wykonywanie zapytań o stan przywracania obiektów blob za pomocą polecenia "az storage account show".
time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2 --no-wait
Parametry wymagane
Nazwa konta magazynu.
Przywróć obiekt blob do określonej godziny, w której powinna znajdować się data/godzina UTC (Y-m-d'T'H:M:S'Z').
Parametry opcjonalne
Zakresy obiektów blob do przywrócenia. Musisz określić dwie wartości, aby określić start_range i end_range dla każdego zakresu obiektów blob, np. -r blob1 blob2. Uwaga: Wartość pusta oznacza, że konto jest uruchamiane jako wartość zakresu początkowego i oznacza koniec konta dla zakresu końcowego.
Nie czekaj na zakończenie długotrwałej operacji.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob rewrite
To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Utwórz nowy blokowy obiekt blob, w którym zawartość obiektu blob jest odczytywana z danego adresu URL.
Zawartość istniejącego obiektu blob jest zastępowana nowym obiektem blob.
az storage blob rewrite --container-name
--name
--source-uri
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--encryption-scope]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--sas-token]
[--tags-condition]
[--tier {Archive, Cold, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80}]
[--timeout]
Przykłady
Aktualizowanie zakresu szyfrowania dla istniejącego obiektu blob.
az storage blob rewrite --source-uri https://srcaccount.blob.core.windows.net/mycontainer/myblob?<sastoken> --encryption-scope newscope -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000
Parametry wymagane
Nazwa kontenera.
Nazwa obiektu blob.
Adres URL o długości do 2 KB, który określa plik lub obiekt blob. 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.
Parametry opcjonalne
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.
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.
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.
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.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Wstępnie zdefiniowany zakres szyfrowania używany do szyfrowania danych w usłudze. Zakres szyfrowania można utworzyć przy użyciu interfejsu API zarządzania i przywoływał tutaj według nazwy. Jeśli domyślny zakres szyfrowania został zdefiniowany w kontenerze, ta wartość zastąpi go, jeśli zakres na poziomie kontenera jest skonfigurowany do zezwalania na przesłonięcia. W przeciwnym razie zostanie zgłoszony błąd.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Wymagane, jeśli obiekt blob ma aktywną dzierżawę. Wartość może być obiektem BlobLeaseClient lub identyfikatorem dzierżawy jako ciągiem.
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.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
Standardowa wartość warstwy obiektów blob do ustawienia obiektu blob. W przypadku tej wersji biblioteki ma to zastosowanie tylko do blokowych obiektów blob na kontach magazynu w warstwie Standardowa.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob set-legal-hold
Ustaw blokadę prawną obiektu blob.
az storage blob set-legal-hold --container-name
--legal-hold {false, true}
--name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--sas-token]
[--timeout]
Przykłady
Konfigurowanie archiwizacji ze względów prawnych obiektów blob.
az storage blob set-legal-hold --legal-hold -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000
Wyczyść blokadę prawną obiektu blob.
az storage blob set-legal-hold --legal-hold false -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000
Parametry wymagane
Nazwa kontenera.
Określono, czy dla obiektu blob należy ustawić archiwizację prawną.
Nazwa obiektu blob.
Parametry opcjonalne
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.
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.
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.
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.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
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.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob set-tier
Ustaw warstwy bloku lub strony w obiekcie blob.
W przypadku blokowych obiektów blob to polecenie obsługuje tylko blokowy obiekt blob na kontach magazynu w warstwie Standardowa. W przypadku stronicowego obiektu blob to polecenie obsługuje tylko stronicowe obiekty blob na kontach Premium.
az storage blob set-tier --tier
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--name]
[--rehydrate-priority {High, Standard}]
[--sas-token]
[--timeout]
[--type {block, page}]
Przykłady
Ustaw warstwy bloku lub strony w obiekcie blob. (automatycznie wygenerowane)
az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10
Parametry wymagane
Wartość warstwy do ustawienia obiektu blob na wartość .
Parametry opcjonalne
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.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
Nazwa obiektu blob.
Wskaż priorytet, z którym ma być przywracany zarchiwizowany obiekt blob. Priorytet można ustawić tylko raz dla obiektu blob, a wartość domyślna to Standardowa.
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.
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania osobno.
Typ obiektu blob.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob set-tier (storage-blob-preview rozszerzenie)
Ustaw warstwy bloku lub strony w obiekcie blob.
W przypadku blokowych obiektów blob to polecenie obsługuje tylko blokowy obiekt blob na kontach magazynu w warstwie Standardowa. W przypadku stronicowego obiektu blob to polecenie obsługuje tylko stronicowe obiekty blob na kontach Premium.
az storage blob set-tier --tier
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--name]
[--rehydrate-priority {High, Standard}]
[--sas-token]
[--tags-condition]
[--timeout]
[--type {block, page}]
[--version-id]
Przykłady
Ustaw warstwy bloku lub strony w obiekcie blob. (automatycznie wygenerowane)
az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10
Parametry wymagane
Wartość warstwy do ustawienia obiektu blob na wartość .
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
Nazwa obiektu blob.
Wskaż priorytet, z którym ma być przywracany zarchiwizowany obiekt blob.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
Parametr limitu czasu jest wyrażony w sekundach. Ta metoda może wykonywać wiele wywołań do usługi platformy Azure, a limit czasu będzie stosowany do każdego wywołania osobno.
Typ obiektu blob.
Opcjonalny identyfikator wersji obiektu blob. Ten parametr jest przeznaczony tylko dla konta z włączoną obsługą wersji.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob show
Uzyskaj szczegóły obiektu blob.
az storage blob show [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--name]
[--sas-token]
[--snapshot]
[--tags-condition]
[--timeout]
Przykłady
Pokaż wszystkie właściwości obiektu blob.
az storage blob show -c mycontainer -n MyBlob
Pobieranie szczegółów obiektu blob (generowanego automatycznie)
az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob
Parametry opcjonalne
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.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Wymagane, jeśli obiekt blob ma aktywną dzierżawę.
Nazwa obiektu blob.
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.
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob show (storage-blob-preview rozszerzenie)
Uzyskaj szczegóły obiektu blob.
az storage blob show [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--name]
[--sas-token]
[--snapshot]
[--tags-condition]
[--timeout]
[--version-id]
Przykłady
Pokaż wszystkie właściwości obiektu blob.
az storage blob show -c mycontainer -n MyBlob
Pobieranie szczegółów obiektu blob (generowanego automatycznie)
az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Wymagane, jeśli obiekt blob ma aktywną dzierżawę.
Nazwa obiektu blob.
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Parametr migawki jest nieprzezroczystą wartością DateTime, która w chwili obecnej określa migawkę obiektu blob do pobrania.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Opcjonalny identyfikator wersji obiektu blob. Ten parametr jest przeznaczony tylko dla konta z włączoną obsługą wersji.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob snapshot
Tworzy migawkę obiektu blob.
Migawka to wersja obiektu blob tylko do odczytu wykonywana w danym momencie. Można go odczytywać, kopiować lub usuwać, ale nie modyfikować. Migawki zapewniają sposób tworzenia kopii zapasowej obiektu blob, który jest wyświetlany w danym momencie. Migawka obiektu blob ma taką samą nazwę jak podstawowy obiekt blob, z którego jest wykonywana migawka, z wartością DateTime dołączona w celu wskazania czasu, w którym utworzono migawkę.
az storage blob snapshot [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--metadata]
[--name]
[--sas-token]
[--tags-condition]
[--timeout]
Parametry opcjonalne
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.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Wymagane, jeśli obiekt blob ma aktywną dzierżawę.
Metadane w parach klucz=wartość rozdzielanych spacjami. Spowoduje to zastąpienie wszystkich istniejących metadanych.
Nazwa obiektu blob.
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.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob sync
To polecenie jest w wersji zapoznawczej i jest opracowywane. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Synchronizuj obiekty blob cyklicznie z kontenerem obiektów blob magazynu.
az storage blob sync --container
--source
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--delete-destination {false, prompt, true}]
[--destination]
[--exclude-path]
[--exclude-pattern]
[--include-pattern]
[--sas-token]
[<EXTRA_OPTIONS>]
Przykłady
Synchronizowanie pojedynczego obiektu blob z kontenerem.
az storage blob sync -c mycontainer -s "path/to/file" -d NewBlob
Synchronizowanie katalogu z kontenerem.
az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory"
Zsynchronizuj katalog z kontenerem z przekazywaniem opcji azcopy (w tym przypadku ograniczenie przedziału przekazywania do 20 Mb/s).
az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory" -- --cap-mbps=20
Parametry wymagane
Kontener docelowy synchronizacji.
Ścieżka pliku źródłowego do synchronizacji.
Parametry opcjonalne
Klucz konta magazynu. Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.
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.
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.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Określa, czy usunąć dodatkowe pliki z miejsca docelowego, które nie są obecne w źródle. Można ustawić wartość true, false lub monit. Jeśli zostanie ustawiony monit, użytkownik zostanie poproszony o pytanie przed zaplanowaniem plików i obiektów blob w celu usunięcia.
Ścieżka docelowa, która będzie poprzedzana nazwą obiektu blob.
Wyklucz te ścieżki. Ta opcja nie obsługuje symboli wieloznacznych (*). Sprawdza prefiks ścieżki względnej. Na przykład: myFolder; myFolder/subDirName/file.pdf.
Wyklucz te pliki, w których nazwa jest zgodna z listą wzorców. Na przykład: .jpg;. Pdf; exactName. Ta opcja obsługuje symbole wieloznaczne (*).
Uwzględnij tylko te pliki, w których nazwa jest zgodna z listą wzorców. Na przykład: .jpg;. Pdf; exactName. Ta opcja obsługuje symbole wieloznaczne (*).
Sygnatura dostępu współdzielonego (SAS). Należy używać w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.
Inne opcje, które zostaną przekazane do azcopy, tak jak to jest. Umieść wszystkie dodatkowe opcje po .--
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob undelete
Przywracanie nietrwałego usuniętego obiektu blob lub migawki.
Operacja zakończy się pomyślnie tylko wtedy, gdy zostanie użyta w określonej liczbie dni ustawionych w zasadach przechowywania usuwania. Próba cofnięcia usunięcia obiektu blob lub migawki, która nie zostanie usunięta nietrwale, powiedzie się bez żadnych zmian.
az storage blob undelete [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--name]
[--sas-token]
[--timeout]
Przykłady
Cofanie usunięcia obiektu blob.
az storage blob undelete -c mycontainer -n MyBlob
Cofanie usunięcia obiektu blob przy użyciu poświadczeń logowania.
az storage blob undelete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login
Parametry opcjonalne
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.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
Nazwa obiektu blob.
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.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob update
Ustawia właściwości systemowe obiektu blob.
Jeśli dla content_settings ustawiono jedną właściwość, wszystkie właściwości zostaną zastąpione.
az storage blob update --container-name
--name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--clear-content-settings {false, true}]
[--connection-string]
[--content-cache]
[--content-disposition]
[--content-encoding]
[--content-language]
[--content-md5]
[--content-type]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--sas-token]
[--tags-condition]
[--timeout]
Parametry wymagane
Nazwa kontenera.
Nazwa obiektu blob.
Parametry opcjonalne
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.
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.
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.
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.
Jeśli ta flaga jest ustawiona, jeśli ustawiono co najmniej jedną z następujących właściwości (--content-cache-control, --content-disposition, --content-encoding, --content-language, --content-md5, --content-type), wszystkie te właściwości są ustawione razem. Jeśli dla danej właściwości nie podano wartości, jeśli ustawiono co najmniej jedną z właściwości wymienionych poniżej, ta właściwość zostanie wyczyszczone.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Ciąg sterujący pamięci podręcznej.
Przekazuje dodatkowe informacje o sposobie przetwarzania ładunku odpowiedzi, a także może służyć do dołączania dodatkowych metadanych.
Typ kodowania zawartości.
Język zawartości.
Skrót MD5 zawartości.
Typ MIME zawartości.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Wymagane, jeśli obiekt blob ma aktywną dzierżawę.
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.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob upload
Przekaż plik do obiektu blob magazynu.
Utwórz nowy obiekt blob na podstawie ścieżki pliku lub zaktualizuj zawartość istniejącego obiektu blob z automatycznymi powiadomieniami o fragmentowaniu i postępie.
az storage blob upload [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--blob-url]
[--connection-string]
[--container-name]
[--content-cache]
[--content-disposition]
[--content-encoding]
[--content-language]
[--content-md5]
[--content-type]
[--data]
[--encryption-scope]
[--file]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--length]
[--max-connections]
[--maxsize-condition]
[--metadata]
[--name]
[--no-progress]
[--overwrite {false, true}]
[--sas-token]
[--socket-timeout]
[--tags]
[--tags-condition]
[--tier]
[--timeout]
[--type {append, block, page}]
[--validate-content]
Przykłady
Przekaż do obiektu blob.
az storage blob upload -f /path/to/file -c mycontainer -n MyBlob
Przekaż do obiektu blob przy użyciu adresu URL sygnatury dostępu współdzielonego obiektu blob.
az storage blob upload -f /path/to/file --blob-url https://mystorageaccount.blob.core.windows.net/mycontainer/myblob?sv=2019-02-02&st=2020-12-22T07%3A07%3A29Z&se=2020-12-23T07%3A07%3A29Z&sr=b&sp=racw&sig=redacted
Przekaż plik do obiektu blob magazynu. (automatycznie wygenerowane)
az storage blob upload --account-name mystorageaccount --account-key 0000-0000 --container-name mycontainer --file /path/to/file --name myblob
Przekaż ciąg do obiektu blob.
az storage blob upload --data "teststring" -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000
Przekaż do potoku.
echo $data | az storage blob upload --data @- -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000
Parametry opcjonalne
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.
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.
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.
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.
Pełny adres URL punktu końcowego do obiektu blob, w tym token SAS i migawka, jeśli jest używana. Może to być podstawowy punkt końcowy lub pomocniczy punkt końcowy w zależności od bieżącego location_mode
.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Nazwa kontenera.
Ciąg sterujący pamięci podręcznej.
Przekazuje dodatkowe informacje o sposobie przetwarzania ładunku odpowiedzi, a także może służyć do dołączania dodatkowych metadanych.
Typ kodowania zawartości.
Język zawartości.
Skrót MD5 zawartości.
Typ MIME zawartości.
Dane obiektu blob do przekazania.
Wstępnie zdefiniowany zakres szyfrowania używany do szyfrowania danych w usłudze.
Ścieżka pliku do przekazania jako zawartość obiektu blob.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Wymagane, jeśli obiekt blob ma aktywną dzierżawę.
Liczba bajtów do odczytu ze strumienia. Jest to opcjonalne, ale należy podać w celu uzyskania optymalnej wydajności. Współpraca z --data.
Maksymalna liczba połączeń równoległych do użycia, gdy rozmiar obiektu blob przekracza 64 MB.
Maksymalna długość bajtów dozwolona dla uzupełnialnych obiektów blob.
Metadane w parach klucz=wartość rozdzielanych spacjami. Spowoduje to zastąpienie wszystkich istniejących metadanych.
Nazwa obiektu blob.
Dołącz tę flagę, aby wyłączyć raportowanie postępu dla polecenia.
Czy obiekt blob, który ma zostać przekazany, powinien zastąpić bieżące dane. Jeśli wartość True, operacja przekazywania obiektów blob zastąpi istniejące dane. W przypadku ustawienia wartości False operacja zakończy się niepowodzeniem z błędem ResourceExistsError. Wyjątkiem od powyższych są typy uzupełnialnych obiektów blob: jeśli ustawiono wartość False i dane już istnieją, błąd nie zostanie zgłoszony, a dane zostaną dołączone do istniejącego obiektu blob. Jeśli ustawisz wartość overwrite=True, istniejący obiekt blob dołączania zostanie usunięty i zostanie utworzony nowy. Wartość domyślna to False.
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.
Limit czasu gniazda (s) używany przez usługę do regulowania przepływu danych.
Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
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.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
Domyślnie wartość "page" dla plików *.vhd lub "block" w przeciwnym razie.
Określ, że skrót MD5 jest obliczany dla każdego fragmentu obiektu blob i zweryfikowany przez usługę po dodaniu fragmentu.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob upload-batch
Przekazywanie plików z katalogu lokalnego do kontenera obiektów blob.
az storage blob upload-batch --destination
--source
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--content-cache]
[--content-disposition]
[--content-encoding]
[--content-language]
[--content-md5]
[--content-type]
[--destination-path]
[--dryrun]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--lease-id]
[--max-connections]
[--maxsize-condition]
[--metadata]
[--no-progress]
[--overwrite {false, true}]
[--pattern]
[--sas-token]
[--tags]
[--tags-condition]
[--tier]
[--timeout]
[--type {append, block, page}]
[--validate-content]
Przykłady
Przekaż wszystkie pliki kończące się .py, chyba że obiekt blob istnieje i został zmodyfikowany od danej daty.
az storage blob upload-batch -d mycontainer --account-name mystorageaccount --account-key 00000000 -s <path-to-directory> --pattern "*.py" --if-unmodified-since 2018-08-27T20:51Z
Przekaż wszystkie pliki z katalogu ścieżki lokalnej do kontenera o nazwie "mycontainer".
az storage blob upload-batch -d mycontainer -s <path-to-directory>
Przekaż wszystkie pliki w formacie "cli-2018-xx-xx.txt" lub "cli-2019-xx-xx.txt" w katalogu ścieżki lokalnej.
az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern "cli-201[89]-??-??.txt"
Przekaż wszystkie pliki w formacie "cli-201x-xx-xx.txt", z wyjątkiem cli-2018-xx-xx.txt" i "cli-2019-xx-xx.txt" w kontenerze.
az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern "cli-201[!89]-??-??.txt"
Parametry wymagane
Kontener obiektów blob, w którym zostaną przekazane pliki.
Miejscem docelowym może być adres URL kontenera lub nazwa kontenera. Gdy miejsce docelowe jest adresem URL kontenera, nazwa konta magazynu zostanie przeanalizowana z adresu URL.
Katalog, w którym znajdują się pliki do przekazania.
Parametry opcjonalne
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.
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.
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.
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.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Ciąg sterujący pamięci podręcznej.
Przekazuje dodatkowe informacje o sposobie przetwarzania ładunku odpowiedzi, a także może służyć do dołączania dodatkowych metadanych.
Typ kodowania zawartości.
Język zawartości.
Skrót MD5 zawartości.
Typ MIME zawartości.
Ścieżka docelowa, która będzie poprzedzana nazwą obiektu blob.
Pokaż podsumowanie operacji do wykonania zamiast faktycznie przekazywać pliki.
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ą.
Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
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.
Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').
Identyfikator aktywnej dzierżawy obiektu blob.
Maksymalna liczba połączeń równoległych do użycia, gdy rozmiar obiektu blob przekracza 64 MB.
Maksymalna długość bajtów dozwolona dla uzupełnialnych obiektów blob.
Metadane w parach klucz=wartość rozdzielanych spacjami. Spowoduje to zastąpienie wszystkich istniejących metadanych.
Dołącz tę flagę, aby wyłączyć raportowanie postępu dla polecenia.
Czy obiekt blob, który ma zostać przekazany, powinien zastąpić bieżące dane. Jeśli wartość True, operacja przekazywania obiektów blob zastąpi istniejące dane. W przypadku ustawienia wartości False operacja zakończy się niepowodzeniem z błędem ResourceExistsError. Wyjątkiem od powyższych są typy uzupełnialnych obiektów blob: jeśli ustawiono wartość False i dane już istnieją, błąd nie zostanie zgłoszony, a dane zostaną dołączone do istniejącego obiektu blob. Jeśli ustawisz wartość overwrite=True, istniejący obiekt blob dołączania zostanie usunięty i zostanie utworzony nowy. Wartość domyślna to False.
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 "/".
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.
Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.
Określ klauzulę SQL where dla tagów obiektów blob do działania tylko na obiektach blob z dopasowaną wartością.
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.
Limit czasu żądania w sekundach. Dotyczy każdego wywołania usługi.
W przeciwnym razie wartość domyślna to "page" dla plików *.vhd lub "block". Ustawienie zastąpi typy obiektów blob dla każdego pliku.
Określa, że skrót MD5 jest obliczany dla każdego fragmentu obiektu blob i zweryfikowany przez usługę po przybyciu fragmentu.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az storage blob url
Utwórz adres URL, aby uzyskać dostęp do obiektu blob.
az storage blob url --container-name
--name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--protocol {http, https}]
[--sas-token]
[--snapshot]
Przykłady
Tworzenie adresu URL w celu uzyskania dostępu do obiektu blob (generowanego automatycznie)
az storage blob url --connection-string $connectionString --container-name container1 --name blob1
Tworzenie adresu URL w celu uzyskania dostępu do obiektu blob (generowanego automatycznie)
az storage blob url --account-name storageacct --account-key 00000000 --container-name container1 --name blob1
Parametry wymagane
Nazwa kontenera.
Nazwa obiektu blob.
Parametry opcjonalne
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.
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.
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.
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.
Parametry połączenia konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_CONNECTION_STRING.
Protokół do użycia.
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.
Wartość ciągu, która jednoznacznie identyfikuje migawkę. Wartość tego parametru zapytania wskazuje wersję migawki.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.