az storage file

Zarządzanie udziałami plików korzystającymi z protokołu SMB 3.0.

Polecenia

az storage file copy

Zarządzanie operacjami kopiowania plików.

az storage file copy cancel

Przerywanie trwającej operacji kopiowania.

az storage file copy start

Skopiuj plik asynchronicznie.

az storage file copy start-batch

Skopiuj wiele plików lub obiektów blob do udziału plików.

az storage file delete

Oznacz określony plik do usunięcia.

az storage file delete-batch

Usuń pliki z udziału plików usługi Azure Storage.

az storage file download

Pobierz plik do ścieżki pliku z automatycznymi powiadomieniami o postępie i fragmentowaniu.

az storage file download-batch

Pobierz pliki z udziału plików usługi Azure Storage do katalogu lokalnego w operacji wsadowej.

az storage file exists

Sprawdź, czy plik istnieje.

az storage file generate-sas

Wygeneruj sygnaturę dostępu współdzielonego dla pliku.

az storage file list

Wyświetlanie listy plików i katalogów w udziale.

az storage file metadata

Zarządzanie metadanymi plików.

az storage file metadata show

Zwróć wszystkie metadane zdefiniowane przez użytkownika dla pliku.

az storage file metadata update

Aktualizowanie metadanych pliku.

az storage file resize

Zmień rozmiar pliku na określony rozmiar.

az storage file show

Zwróć wszystkie metadane zdefiniowane przez użytkownika, standardowe właściwości PROTOKOŁU HTTP i właściwości systemu dla pliku.

az storage file update

Ustaw właściwości systemowe w pliku.

az storage file upload

Przekaż plik do udziału korzystającego z protokołu SMB 3.0.

az storage file upload-batch

Przekazywanie plików z katalogu lokalnego do udziału plików usługi Azure Storage w operacji wsadowej.

az storage file url

Utwórz adres URL, aby uzyskać dostęp do pliku.

az storage file delete

Oznacz określony plik do usunięcia.

Plik zostanie później usunięty podczas odzyskiwania pamięci.

az storage file delete --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--connection-string]
                       [--sas-token]
                       [--timeout]

Parametry wymagane

--path -p

Ścieżka do pliku w udziale plików.

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Musi być używany w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

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

--connection-string

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

--sas-token

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

--timeout

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

az storage file delete-batch

Usuń pliki z udziału plików usługi Azure Storage.

az storage file delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--connection-string]
                             [--dryrun]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

Przykłady

Usuń pliki z udziału plików usługi Azure Storage. (generowane automatycznie)

az storage file delete-batch --account-key 00000000 --account-name MyAccount --source /path/to/file

Usuń pliki z udziału plików usługi Azure Storage. (generowane automatycznie)

az storage file delete-batch --account-key 00000000 --account-name MyAccount --pattern *.py --source /path/to/file

Parametry wymagane

--source -s

Źródło operacji usuwania pliku. Źródło może być adresem URL udziału plików lub nazwą udziału.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Musi być używany w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

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

--connection-string

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

--dryrun

Wyświetl listę plików i obiektów blob do usunięcia. Nie zostanie wykonane żadne rzeczywiste usunięcie danych.

--pattern

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

--sas-token

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

--timeout

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

az storage file download

Pobierz plik do ścieżki pliku z automatycznymi powiadomieniami o postępie i fragmentowaniu.

Zwróć wystąpienie pliku z właściwościami i metadanymi.

az storage file download --path
                         --share-name
                         [--account-key]
                         [--account-name]
                         [--connection-string]
                         [--dest]
                         [--end-range]
                         [--max-connections]
                         [--no-progress]
                         [--open-mode]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--timeout]
                         [--validate-content]

Parametry wymagane

--path -p

Ścieżka do pliku w udziale plików.

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Musi być używany w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

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

--connection-string

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

--dest

Ścieżka pliku do zapisu. Nazwa pliku źródłowego będzie używana, jeśli nie zostanie określona.

--end-range

Koniec zakresu bajtów do użycia do pobierania sekcji pliku. 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 pliku.

--max-connections

Jeśli ustawiono wartość 2 lub większą, początkowe pobranie zostanie wykonane dla pierwszego siebie. MAX_SINGLE_GET_SIZE bajty pliku. Jeśli jest to cały plik, metoda zwraca się w tym momencie. Jeśli tak nie jest, pobierze pozostałe dane równoległe przy użyciu liczby wątków równych max_connections. Każdy fragment będzie mieć rozmiar własny. MAX_CHUNK_GET_SIZE. Jeśli ustawiono wartość 1, zostanie wykonane jedno duże żądanie get. Nie jest to ogólnie zalecane, ale dostępne, jeśli należy używać bardzo kilku wątków, żądania sieciowe są bardzo kosztowne lub strumień niemożliwy do wyszukiwania uniemożliwia równoległe pobieranie. Może to być również cenne, jeśli plik jest współbieżnie modyfikowany w celu wymuszania niepodzielności lub jeśli wiele plików ma być pustych, ponieważ dodatkowe żądanie jest wymagane dla pustych plików, jeśli max_connections jest większa niż 1.

wartość domyślna: 2
--no-progress

Dołącz tę flagę, aby wyłączyć raportowanie postępu dla polecenia.

--open-mode

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.

wartość domyślna: wb
--sas-token

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

--snapshot

Ciąg reprezentujący wersję migawki, jeśli ma to zastosowanie.

--start-range

Początek zakresu bajtów do użycia do pobrania sekcji pliku. 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 pliku.

--timeout

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

--validate-content

Jeśli ustawiono wartość true, sprawdza wartość skrótu MD5 dla każdej pobranej części pliku. Jest to przede wszystkim przydatne do wykrywania bitflips w sieci, jeśli używasz protokołu HTTP zamiast https jako https (wartość domyślna) będzie już weryfikowane. Należy pamiętać, że usługa zwróci tylko transakcyjne md5 dla fragmentów 4 MB lub mniej, więc pierwsze żądanie pobierania będzie mieć rozmiar samodzielnie. MAX_CHUNK_GET_SIZE zamiast siebie. MAX_SINGLE_GET_SIZE. Jeśli samodzielnie. MAX_CHUNK_GET_SIZE ustawiono wartość większą niż 4 MB, zostanie zgłoszony błąd. Ponieważ przetwarzanie md5 zajmuje czas przetwarzania, a konieczne będzie wykonanie większej liczby żądań ze względu na zmniejszony rozmiar fragmentu, może wystąpić pewien wzrost opóźnienia.

az storage file download-batch

Pobierz pliki z udziału plików usługi Azure Storage do katalogu lokalnego w operacji wsadowej.

az storage file download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--connection-string]
                               [--dryrun]
                               [--max-connections]
                               [--no-progress]
                               [--pattern]
                               [--sas-token]
                               [--snapshot]
                               [--validate-content]

Przykłady

Pobierz pliki z udziału plików usługi Azure Storage do katalogu lokalnego w operacji wsadowej. (generowane automatycznie)

az storage file download-batch --account-key 00000000 --account-name MyAccount --destination . --no-progress --source /path/to/file

Parametry wymagane

--destination -d

Katalog lokalny, do którego są pobierane pliki. Ten katalog musi już istnieć.

--source -s

Źródło operacji pobierania pliku. Źródło może być adresem URL udziału plików lub nazwą udziału.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Musi być używany w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

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

--connection-string

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

--dryrun

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

--max-connections

Maksymalna liczba połączeń równoległych do użycia. Wartość domyślna to 1.

wartość domyślna: 1
--no-progress

Dołącz tę flagę, aby wyłączyć raportowanie postępu dla polecenia.

--pattern

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

--sas-token

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

--snapshot

Ciąg reprezentujący wersję migawki, jeśli ma to zastosowanie.

--validate-content

W przypadku ustawienia oblicza wartość skrótu MD5 dla każdego zakresu pliku na potrzeby walidacji.

az storage file exists

Sprawdź, czy plik istnieje.

az storage file exists --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--connection-string]
                       [--sas-token]
                       [--snapshot]
                       [--timeout]

Przykłady

Sprawdź, czy plik istnieje. (generowane automatycznie)

az storage file exists --account-key 00000000 --account-name MyAccount --path path/file.txt --share-name MyShare

Sprawdź, czy plik istnieje. (generowane automatycznie)

az storage file exists --connection-string $connectionString --path path/file.txt --share-name MyShare

Parametry wymagane

--path -p

Ścieżka do pliku w udziale plików.

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Musi być używany w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

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

--connection-string

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

--sas-token

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

--snapshot

Ciąg reprezentujący wersję migawki, jeśli ma to zastosowanie.

--timeout

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

az storage file generate-sas

Wygeneruj sygnaturę dostępu współdzielonego dla pliku.

az storage file generate-sas --path
                             --share-name
                             [--account-key]
                             [--account-name]
                             [--cache-control]
                             [--connection-string]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--expiry]
                             [--https-only]
                             [--ip]
                             [--permissions]
                             [--policy-name]
                             [--start]

Przykłady

Generowanie tokenu sygnatury dostępu współdzielonego dla pliku.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage file generate-sas -p path/file.txt -s MyShare --account-name MyStorageAccount --permissions rcdw --https-only --expiry $end

Wygeneruj sygnaturę dostępu współdzielonego dla pliku. (generowane automatycznie)

az storage file generate-sas --account-name MyStorageAccount --expiry 2037-12-31T23:59:00Z --path path/file.txt --permissions rcdw --share-name MyShare --start 2019-01-01T12:20Z

Wygeneruj sygnaturę dostępu współdzielonego dla pliku. (generowane automatycznie)

az storage file generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2037-12-31T23:59:00Z --https-only --path path/file.txt --permissions rcdw --share-name myshare

Parametry wymagane

--path -p

Ścieżka do pliku w udziale plików.

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Musi być używany w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

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

--cache-control

Wartość nagłówka odpowiedzi dla Cache-Control, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.

--connection-string

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

--content-disposition

Wartość nagłówka odpowiedzi dla usługi Content-Disposition, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.

--content-encoding

Wartość nagłówka odpowiedzi dla kodowania zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.

--content-language

Wartość nagłówka odpowiedzi dla języka zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.

--content-type

Wartość nagłówka odpowiedzi dla typu zawartości, gdy zasób jest uzyskiwany przy użyciu tego sygnatury dostępu współdzielonego.

--expiry

Określa datę/godzinę UTC (Y-m-d'T'H:M'Z'), w której sygnatura dostępu współdzielonego staje się nieprawidłowa. Nie należy używać, jeśli przechowywane zasady dostępu są przywołyne z nazwą --policy-, która określa tę wartość.

--https-only

Zezwalaj tylko na żądania wysyłane przy użyciu protokołu HTTPS. W przypadku pominięcia żądania zarówno protokołu HTTP, jak i HTTPS są dozwolone.

--ip

Określa adres IP lub zakres adresów IP, z których mają być akceptowane żądania. Obsługuje tylko adresy stylów IPv4.

--permissions

Uprawnienia udziela sygnatury dostępu współdzielonego. Dozwolone wartości: (c)reate (d)elete (r)ead (w)rite. Nie należy używać, jeśli przechowywane zasady dostępu są przywołyne z parametrem --id określającym tę wartość. Można połączyć.

--policy-name

Nazwa przechowywanych zasad dostępu w ramach listy ACL kontenera.

--start

Określa datę/godzinę UTC (Y-m-d'T'H:M'Z'), w której sygnatura dostępu współdzielonego staje się prawidłowa. Nie należy używać, jeśli przechowywane zasady dostępu są przywołyne z nazwą --policy-, która określa tę wartość. Domyślnie czas żądania.

az storage file list

Wyświetlanie listy plików i katalogów w udziale.

az storage file list --share-name
                     [--account-key]
                     [--account-name]
                     [--connection-string]
                     [--exclude-dir]
                     [--exclude-extended-info]
                     [--marker]
                     [--num-results]
                     [--path]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

Przykłady

Wyświetlanie listy plików i katalogów w udziale. (generowane automatycznie)

az storage file list --share-name MyShare

Parametry wymagane

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Musi być używany w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

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

--connection-string

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

--exclude-dir

Wyświetl listę tylko plików w danym udziale.

--exclude-extended-info

Określ, aby wykluczyć informacje "timestamps", "Etag", "Attributes", "PermissionKey" z odpowiedzi.

--marker

Wartość ciągu identyfikującą 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 z punktu, w którym poprzedni generator zatrzymał.

--num-results

Określ maksymalną liczbę do zwrócenia. Jeśli żądanie nie określa 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 wyświetlania listy przekroczy granicę partycji, usługa zwróci token kontynuacji w celu pobrania pozostałych wyników. Podaj wartość "*", aby zwrócić wszystko.

wartość domyślna: 5000
--path -p

Ścieżka katalogu w udziale plików.

--sas-token

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

--snapshot

Ciąg reprezentujący wersję migawki, jeśli ma zastosowanie.

--timeout

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

az storage file resize

Zmień rozmiar pliku na określony rozmiar.

Jeśli określona wartość bajtu jest mniejsza niż bieżący rozmiar pliku, wszystkie zakresy powyżej określonej wartości bajtu zostaną wyczyszczone.

az storage file resize --path
                       --share-name
                       --size
                       [--account-key]
                       [--account-name]
                       [--connection-string]
                       [--sas-token]
                       [--timeout]

Parametry wymagane

--path -p

Ścieżka do pliku w udziale plików.

--share-name -s

Nazwa udziału plików.

--size

Rozmiar do zmiany rozmiaru pliku na (w bajtach).

Parametry opcjonalne

--account-key

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

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żadna 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.

--connection-string

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

--sas-token

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

--timeout

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

az storage file show

Zwróć wszystkie metadane zdefiniowane przez użytkownika, standardowe właściwości PROTOKOŁU HTTP i właściwości systemu dla pliku.

az storage file show --path
                     --share-name
                     [--account-key]
                     [--account-name]
                     [--connection-string]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

Przykłady

Pokaż właściwości pliku w udziale plików.

az storage file show -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000

Parametry wymagane

--path -p

Ścieżka do pliku w udziale plików.

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

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

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żadna 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.

--connection-string

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

--sas-token

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

--snapshot

Ciąg reprezentujący wersję migawki, jeśli ma zastosowanie.

--timeout

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

az storage file update

Ustaw właściwości systemowe w pliku.

Jeśli dla content_settings ustawiono jedną właściwość, wszystkie właściwości zostaną zastąpione.

az storage file update --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--file-endpoint]
                       [--sas-token]
                       [--timeout]

Przykłady

Ustaw właściwości systemowe w pliku.

az storage file update -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000 --content-type test/type

Parametry wymagane

--path -p

Ścieżka do pliku w udziale plików.

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

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

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT. Musi być używany w połączeniu z kluczem konta magazynu lub tokenem SAS. Jeśli żadna 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.

--clear-content-settings

Jeśli ta flaga jest ustawiona, to 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ą ustawiane razem. Jeśli dla danej właściwości nie podano wartości, gdy ustawiono co najmniej jedną z właściwości wymienionych poniżej, ta właściwość zostanie wyczyszczone.

akceptowane wartości: false, true
--connection-string

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

--content-cache --content-cache-control

Ciąg kontrolki pamięci podręcznej.

--content-disposition

Przekazuje dodatkowe informacje o sposobie przetwarzania ładunku odpowiedzi, a także może służyć do dołączania dodatkowych metadanych.

--content-encoding

Typ kodowania zawartości.

--content-language

Język zawartości.

--content-md5

Skrót MD5 zawartości.

--content-type

Typ MIME zawartości.

--file-endpoint

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

--sas-token

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

--timeout

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

az storage file upload

Przekaż plik do udziału korzystającego z protokołu SMB 3.0.

Tworzy lub aktualizuje plik platformy Azure na podstawie ścieżki źródłowej z automatycznymi powiadomieniami o fragmentowaniu i postępie.

az storage file upload --share-name
                       --source
                       [--account-key]
                       [--account-name]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--max-connections]
                       [--metadata]
                       [--no-progress]
                       [--path]
                       [--sas-token]
                       [--timeout]
                       [--validate-content]

Przykłady

Przekazywanie do pliku lokalnego do udziału.

az storage file upload -s MyShare --source /path/to/file

Przekaż plik do udziału korzystającego z protokołu SMB 3.0. (automatycznie wygenerowane)

az storage file upload --account-key 00000000 --account-name MyStorageAccount --path path/file.txt --share-name MyShare --source /path/to/file

Parametry wymagane

--share-name -s

Nazwa udziału plików.

--source

Ścieżka pliku lokalnego do przekazania jako zawartości pliku.

Parametry opcjonalne

--account-key

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

--account-name

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

--connection-string

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

--content-cache --content-cache-control

Ciąg kontrolki pamięci podręcznej.

--content-disposition

Przekazuje dodatkowe informacje na temat przetwarzania ładunku odpowiedzi, a także może służyć do dołączania dodatkowych metadanych.

--content-encoding

Typ kodowania zawartości.

--content-language

Język zawartości.

--content-md5

Skrót MD5 zawartości.

--content-type

Typ MIME zawartości.

--max-connections

Maksymalna liczba połączeń równoległych do użycia.

wartość domyślna: 2
--metadata

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

--no-progress

Dołącz tę flagę, aby wyłączyć raportowanie postępu dla polecenia.

--path -p

Ścieżka do pliku w udziale plików. Jeśli nazwa pliku zostanie pominięta, zostanie użyta nazwa pliku źródłowego.

--sas-token

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

--timeout

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

--validate-content

Jeśli wartość true, oblicza skrót MD5 dla każdego zakresu pliku. Usługa magazynu sprawdza skrót zawartości, która dotarła do wysłanego skrótu. Jest to przede wszystkim przydatne do wykrywania bitflips w sieci, jeśli używasz protokołu HTTP zamiast https jako https (wartość domyślna) będzie już weryfikowane. Należy pamiętać, że ten skrót MD5 nie jest przechowywany w pliku.

az storage file upload-batch

Przekazywanie plików z katalogu lokalnego do udziału plików usługi Azure Storage w operacji wsadowej.

az storage file upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--connection-string]
                             [--content-cache]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-md5]
                             [--content-type]
                             [--destination-path]
                             [--dryrun]
                             [--max-connections]
                             [--metadata]
                             [--no-progress]
                             [--pattern]
                             [--sas-token]
                             [--validate-content]

Przykłady

Przekazywanie plików z katalogu lokalnego do udziału plików usługi Azure Storage w operacji wsadowej.

az storage file upload-batch --destination myshare --source . --account-name myaccount --account-key 00000000

Przekazywanie plików z katalogu lokalnego do udziału plików usługi Azure Storage przy użyciu adresu URL w operacji wsadowej.

az storage file upload-batch --destination https://myaccount.file.core.windows.net/myshare --source . --account-key 00000000

Parametry wymagane

--destination -d

Miejsce docelowe operacji przekazywania.

--source -s

Katalog do przekazywania plików.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Musi być używany w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

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

--connection-string

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

--content-cache --content-cache-control

Ciąg kontrolki pamięci podręcznej.

--content-disposition

Przekazuje dodatkowe informacje na temat przetwarzania ładunku odpowiedzi, a także może służyć do dołączania dodatkowych metadanych.

--content-encoding

Typ kodowania zawartości.

--content-language

Język zawartości.

--content-md5

Skrót MD5 zawartości.

--content-type

Typ MIME zawartości.

--destination-path

Katalog, do którego są kopiowane dane źródłowe. Jeśli pominięto, dane są kopiowane do katalogu głównego.

--dryrun

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

--max-connections

Maksymalna liczba połączeń równoległych do użycia. Wartość domyślna to 1.

wartość domyślna: 1
--metadata

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

--no-progress

Dołącz tę flagę, aby wyłączyć raportowanie postępu dla polecenia.

--pattern

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

--sas-token

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

--validate-content

W przypadku ustawienia oblicza wartość skrótu MD5 dla każdego zakresu pliku na potrzeby walidacji.

az storage file url

Utwórz adres URL, aby uzyskać dostęp do pliku.

az storage file url --path
                    --share-name
                    [--account-key]
                    [--account-name]
                    [--connection-string]
                    [--protocol {http, https}]
                    [--sas-token]

Przykłady

Utwórz adres URL, aby uzyskać dostęp do pliku. (generowane automatycznie)

az storage file url --account-key 00000000 --account-name mystorageaccount --path path/file.txt --share-name myshare

Parametry wymagane

--path -p

Ścieżka do pliku/katalogu w udziale plików.

--share-name -s

Nazwa udziału plików.

Parametry opcjonalne

--account-key

Klucz konta magazynu. Musi być używany w połączeniu z nazwą konta magazynu. Zmienna środowiskowa: AZURE_STORAGE_KEY.

--account-name

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

--connection-string

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

--protocol

Protokół do użycia.

akceptowane wartości: http, https
wartość domyślna: https
--sas-token

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