az storage container

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 kontenerami magazynu 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 container create	Utwórz kontener na koncie magazynu.	Rdzeń	GA
az storage container delete	Oznacz określony kontener do usunięcia.	Rdzeń	GA
az storage container exists	Sprawdź istnienie kontenera magazynu.	Rdzeń	GA
az storage container generate-sas	Generowanie tokenu SAS dla kontenera magazynu.	Rdzeń	GA
az storage container generate-sas (storage-blob-preview rozszerzenie)	Generowanie tokenu SAS dla kontenera magazynu.	Rozszerzenie	GA
az storage container immutability-policy	Zarządzanie zasadami niezmienności kontenerów.	Rdzeń	GA
az storage container immutability-policy create	Utwórz lub zaktualizuj odblokowane zasady niezmienności.	Rdzeń	GA
az storage container immutability-policy delete	Przerywa odblokowane zasady niezmienności.	Rdzeń	GA
az storage container immutability-policy extend	Rozszerz niezmiennośćPeriodSinceCreationInDays zablokowanej niezmiennościPolicy.	Rdzeń	GA
az storage container immutability-policy lock	Ustawia stan ImmutabilityPolicy na Stan zablokowany.	Rdzeń	GA
az storage container immutability-policy show	Pobiera istniejące zasady niezmienności wraz z odpowiednim elementem ETag w nagłówkach odpowiedzi i treści.	Rdzeń	GA
az storage container lease	Zarządzanie dzierżawami kontenerów magazynu obiektów blob.	Rdzeń	GA
az storage container lease acquire	Zażądaj nowej dzierżawy.	Rdzeń	GA
az storage container lease break	Przerwij dzierżawę, jeśli kontener ma aktywną dzierżawę.	Rdzeń	GA
az storage container lease change	Zmień identyfikator dzierżawy aktywnej dzierżawy.	Rdzeń	GA
az storage container lease release	Zwolnij dzierżawę.	Rdzeń	GA
az storage container lease renew	Odnów dzierżawę.	Rdzeń	GA
az storage container legal-hold	Zarządzanie blokadami prawnymi kontenerów.	Rdzeń	GA
az storage container legal-hold clear	Wyczyść tagi archiwizacji ze względów prawnych.	Rdzeń	GA
az storage container legal-hold set	Ustaw tagi archiwizacji ze względów prawnych.	Rdzeń	GA
az storage container legal-hold show	Pobierz właściwości archiwizacji ze względów prawnych kontenera.	Rdzeń	GA
az storage container list	Wyświetlanie listy kontenerów na koncie magazynu.	Rdzeń	GA
az storage container metadata	Zarządzanie metadanymi kontenera.	Rdzeń	GA
az storage container metadata show	Zwróć wszystkie metadane zdefiniowane przez użytkownika dla określonego kontenera.	Rdzeń	GA
az storage container metadata update	Ustaw co najmniej jedną parę nazwa-wartość zdefiniowaną przez użytkownika dla określonego kontenera.	Rdzeń	GA
az storage container policy	Zarządzanie zasadami dostępu przechowywanymi w kontenerze.	Rdzeń	GA
az storage container policy create	Utwórz przechowywane zasady dostępu w obiekcie zawierającym.	Rdzeń	GA
az storage container policy delete	Usuń przechowywane zasady dostępu w obiekcie zawierającym.	Rdzeń	GA
az storage container policy list	Lista przechowywanych zasad dostępu w obiekcie zawierającym.	Rdzeń	GA
az storage container policy show	Pokaż przechowywane zasady dostępu w obiekcie zawierającym.	Rdzeń	GA
az storage container policy update	Ustaw przechowywane zasady dostępu dla obiektu zawierającego.	Rdzeń	GA
az storage container restore	Przywracanie kontenera usuniętego nietrwale.	Rdzeń	GA
az storage container set-permission	Ustaw uprawnienia dla określonego kontenera.	Rdzeń	GA
az storage container show	Zwróć wszystkie metadane zdefiniowane przez użytkownika i właściwości systemu dla określonego kontenera.	Rdzeń	GA
az storage container show-permission	Uzyskaj uprawnienia dla określonego kontenera.	Rdzeń	GA

az storage container create

Utwórz kontener na koncie magazynu.

Domyślnie dane kontenera są prywatne ("wyłączone") do właściciela konta. Użyj polecenia "blob", aby zezwolić na publiczny dostęp do odczytu dla obiektów blob. Użyj "kontenera", aby zezwolić na publiczny dostęp do odczytu i listy do całego kontenera. Możesz skonfigurować dostęp --public-access przy użyciu polecenia az storage container set-permission -n CONTAINER_NAME --public-access blob/container/off.

az storage container create --name
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--default-encryption-scope]
                            [--fail-on-exist]
                            [--metadata]
                            [--prevent-encryption-scope-override {false, true}]
                            [--public-access {blob, container, off}]
                            [--resource-group]
                            [--sas-token]
                            [--timeout]

Przykłady

Utwórz kontener magazynu na koncie magazynu.

az storage container create -n mystoragecontainer

Utwórz kontener magazynu na koncie magazynu i zwróć błąd, jeśli kontener już istnieje.

az storage container create -n mystoragecontainer --fail-on-exist

Utwórz kontener magazynu na koncie magazynu i zezwól na publiczny dostęp do odczytu dla obiektów blob.

az storage container create -n mystoragecontainer --public-access blob

Parametry wymagane

--name -n

Nazwa kontenera.

Parametry opcjonalne

--account-key

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

--account-name

Nazwa konta magazynu. Powiązana zmienna środowiskowa: AZURE_STORAGE_ACCOUNT.

--auth-mode

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

Dopuszczalne wartości: key, login

--blob-endpoint

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

--connection-string

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

--default-encryption-scope -d

Wersja zapoznawcza

Domyślnie kontener używa określonego zakresu szyfrowania dla wszystkich zapisów.

--fail-on-exist

Zgłaszanie wyjątku, jeśli kontener już istnieje.

Domyślna wartość: False

--metadata

Metadane w formacie klucz=wartość, rozdzielone spacjami. Spowoduje to zastąpienie wszystkich istniejących metadanych.

--prevent-encryption-scope-override -p

Wersja zapoznawcza

Blokuj zastępowanie zakresu szyfrowania z domyślnego kontenera.

Dopuszczalne wartości: false, true

--public-access

Określa, czy dane w kontenerze mogą być dostępne publicznie.

Dopuszczalne wartości: blob, container, off

--resource-group -g

Przestarzałe

Argument "resource_group_name" został wycofany i zostanie usunięty w przyszłej wersji.

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--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 oczekiwania na żądanie w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

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

Domyślna wartość: json

--query

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

--subscription

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

--verbose

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

az storage container delete

Oznacz określony kontener do usunięcia.

Kontener i wszystkie zawarte w nim obiekty blob zostaną później usunięte podczas czyszczenia pamięci.

az storage container delete --name
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--bypass-immutability-policy]
                            [--connection-string]
                            [--fail-not-exist]
                            [--if-modified-since]
                            [--if-unmodified-since]
                            [--lease-id]
                            [--sas-token]
                            [--timeout]

Przykłady

Oznacza określony kontener do usunięcia. (automatycznie wygenerowane)

az storage container delete --account-key 00000000 --account-name MyAccount --name mycontainer

Parametry wymagane

--name -n

Nazwa kontenera.

Parametry opcjonalne

--account-key

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

--account-name

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

--auth-mode

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

Dopuszczalne wartości: key, login

--blob-endpoint

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

--bypass-immutability-policy

Pomija nadchodzące zachowanie usługi, które zablokuje usunięcie kontenera, jeśli ma zasady niezmienności. Określenie tego parametru spowoduje zignorowanie argumentów oprócz argumentów używanych do identyfikowania kontenera ("--name", "--account-name").

Domyślna wartość: False

--connection-string

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

--fail-not-exist

Zgłaszanie wyjątku, jeśli kontener nie istnieje.

Domyślna wartość: False

--if-modified-since

Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').

--if-unmodified-since

Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').

--lease-id

Jeśli zostanie określony, delete_container powiedzie się tylko wtedy, gdy dzierżawa kontenera jest aktywna i pasuje do tego identyfikatora. Wymagane, jeśli kontener ma aktywną dzierżawę.

--sas-token

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

--timeout

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

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

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

Domyślna wartość: json

--query

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

--subscription

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

--verbose

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

az storage container exists

Sprawdź istnienie kontenera magazynu.

az storage container exists --name
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--sas-token]
                            [--timeout]

Przykłady

Sprawdź istnienie kontenera magazynu. (automatycznie wygenerowane)

az storage container exists --account-name mystorageccount --account-key 00000000 --name mycontainer

Parametry wymagane

--name -n

Nazwa kontenera.

Parametry opcjonalne

--account-key

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

--account-name

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

--auth-mode

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

Dopuszczalne wartości: key, login

--blob-endpoint

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

--connection-string

Parametry połączenia konta przechowywania. 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 lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.

--timeout

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

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

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

Domyślna wartość: json

--query

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

--subscription

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

--verbose

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

az storage container generate-sas

Generowanie tokenu SAS dla kontenera magazynu.

az storage container generate-sas --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]
                                  [--encryption-scope]
                                  [--expiry]
                                  [--https-only]
                                  [--ip]
                                  [--permissions]
                                  [--policy-name]
                                  [--start]

Przykłady

Wygeneruj token sas dla kontenera obiektów blob i użyj go do przekazania obiektu blob.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
sas=`az storage container generate-sas -n mycontainer --https-only --permissions dlrw --expiry $end -o tsv`
az storage blob upload -n MyBlob -c mycontainer -f file.txt --sas-token $sas

Generowanie sygnatury dostępu współdzielonego dla kontenera (generowane automatycznie)

az storage container generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2020-01-01 --name mycontainer --permissions dlrw

Generowanie tokenu SAS dla kontenera magazynu. (automatycznie wygenerowane)

az storage container generate-sas --account-name mystorageaccount --as-user --auth-mode login --expiry 2020-01-01 --name container1 --permissions dlrw

Parametry wymagane

--name -n

Nazwa kontenera.

Parametry opcjonalne

--account-key

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

--account-name

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

--as-user

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.

Domyślna wartość: False

--auth-mode

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

Dopuszczalne wartości: key, login

--blob-endpoint

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

--cache-control

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

--connection-string

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

--content-disposition

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.

--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 Content-Language, 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.

--encryption-scope

Wstępnie zdefiniowany zakres szyfrowania używany do szyfrowania danych w usłudze.

--expiry

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ść.

--https-only

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.

--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: (a)dd (c)reate (d)elete (e)xecute (f)ilter_by_tags (i)set_immutability_policy (l)ist (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ć.

--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'), 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.

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

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

Domyślna wartość: json

--query

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

--subscription

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

--verbose

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

az storage container generate-sas (storage-blob-preview rozszerzenie)

Generowanie tokenu SAS dla kontenera magazynu.

az storage container generate-sas --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]
                                  [--start]

Przykłady

Wygeneruj token sas dla kontenera obiektów blob i użyj go do przekazania obiektu blob.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
sas=`az storage container generate-sas -n mycontainer --https-only --permissions dlrw --expiry $end -o tsv`
az storage blob upload -n MyBlob -c mycontainer -f file.txt --sas-token $sas

Generowanie sygnatury dostępu współdzielonego dla kontenera (generowane automatycznie)

az storage container generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2020-01-01 --name mycontainer --permissions dlrw

Generowanie tokenu SAS dla kontenera magazynu. (automatycznie wygenerowane)

az storage container generate-sas --account-name mystorageaccount --as-user --auth-mode login --expiry 2020-01-01 --name container1 --permissions dlrw

Parametry wymagane

--name -n

Nazwa kontenera.

Parametry opcjonalne

--account-key

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

--account-name

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

--as-user

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.

Domyślna wartość: False

--auth-mode

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

Dopuszczalne wartości: key, login

--blob-endpoint

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

--cache-control

Wartość nagłówka odpowiedzi dla Cache-Control, gdy zasób uzyskuje dostęp do tego sygnatury dostępu współdzielonego.

--connection-string

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

--content-disposition

Wartość nagłówka odpowiedzi dla właściwości Content-Disposition, gdy zasób uzyskuje dostęp do tego sygnatury dostępu współdzielonego.

--content-encoding

Wartość nagłówka odpowiedzi dla kodowania zawartości, gdy zasób uzyskuje dostęp do tego sygnatury dostępu współdzielonego.

--content-language

Wartość nagłówka odpowiedzi dla języka Content-Language, 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 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ść.

--full-uri

Wersja zapoznawcza

Wskaż, że to polecenie zwraca pełny identyfikator URI obiektu blob i token sygnatury dostępu współdzielonego.

Domyślna wartość: False

--https-only

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.

--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: (a)dd (c)reate (d)elete (x)delete_previous_version (e)xecute (f)ilter_by_tags (l)ist (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ć.

--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'), 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.

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

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

Domyślna wartość: json

--query

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

--subscription

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

--verbose

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

az storage container list

Wyświetlanie listy kontenerów na koncie magazynu.

az storage container list [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--include-deleted {false, true}]
                          [--include-metadata {false, true}]
                          [--marker]
                          [--num-results]
                          [--prefix]
                          [--sas-token]
                          [--show-next-marker]
                          [--timeout]

Przykłady

Wyświetlanie listy kontenerów na koncie magazynu.

az storage container list

Wyświetlanie listy nietrwałych usuniętych kontenerów na koncie magazynu.

az storage container list --include-deleted

Parametry opcjonalne

--account-key

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

--account-name

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

--auth-mode

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

Dopuszczalne wartości: key, login

--blob-endpoint

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

--connection-string

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

--include-deleted

Określ, że usunięte kontenery mają być zwracane w odpowiedzi. Dotyczy to konta z włączoną obsługą przywracania kontenera. Wartość domyślna to False.

Dopuszczalne wartości: false, true

Domyślna wartość: False

--include-metadata

Określ, że metadane kontenera mają być zwracane w odpowiedzi.

Dopuszczalne wartości: false, true

Domyślna wartość: False

--marker

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.

--num-results

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.

Domyślna wartość: 5000

--prefix

Przefiltruj wyniki, aby zwracać tylko obiekty blob, których nazwa zaczyna się od określonego prefiksu.

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

--show-next-marker

Wersja zapoznawcza

Pokaż następny znacznik w wyniku po określeniu.

--timeout

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

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

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

Domyślna wartość: json

--query

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

--subscription

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

--verbose

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

az storage container restore

Przywracanie kontenera usuniętego nietrwale.

Operacja zakończy się pomyślnie tylko wtedy, gdy zostanie użyta w określonej liczbie dni ustawionych w zasadach przechowywania usuwania.

az storage container restore --deleted-version
                             --name
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--sas-token]
                             [--timeout]

Przykłady

Wyświetlanie listy i przywracanie kontenera usuniętego nietrwale.

az storage container list --include-deleted
az storage container restore -n deletedcontainer --deleted-version deletedversion

Parametry wymagane

--deleted-version

Określ wersję usuniętego kontenera do przywrócenia.

--name -n

Określ nazwę usuniętego kontenera do przywrócenia.

Parametry opcjonalne

--account-key

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

--account-name

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

--auth-mode

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

Dopuszczalne wartości: key, login

--blob-endpoint

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

--connection-string

Parametry połączenia konta przechowywania. 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 lub punktem końcowym usługi. Zmienna środowiskowa: AZURE_STORAGE_SAS_TOKEN.

--timeout

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

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

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

Domyślna wartość: json

--query

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

--subscription

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

--verbose

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

az storage container set-permission

Ustaw uprawnienia dla określonego kontenera.

az storage container set-permission --name
                                    [--account-key]
                                    [--account-name]
                                    [--auth-mode {key}]
                                    [--blob-endpoint]
                                    [--connection-string]
                                    [--if-modified-since]
                                    [--if-unmodified-since]
                                    [--lease-id]
                                    [--public-access {blob, container, off}]
                                    [--timeout]

Parametry wymagane

--name -n

Nazwa kontenera.

Parametry opcjonalne

--account-key

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

--account-name

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

--auth-mode

Tryb uruchamiania polecenia. 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.

Dopuszczalne wartości: key

--blob-endpoint

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

--connection-string

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

--if-modified-since

Zacznij tylko w przypadku modyfikacji od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').

--if-unmodified-since

Zacznij tylko wtedy, gdy niezmodyfikowane od podanej daty/godziny UTC (Y-m-d'T'H:M'Z').

--lease-id

Jeśli zostanie określony, powiedzie się tylko wtedy, gdy dzierżawa kontenera jest aktywna i pasuje do tego identyfikatora.

--public-access

Określa, czy dane w kontenerze mogą być dostępne publicznie.

Dopuszczalne wartości: blob, container, off

--timeout

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

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

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

Domyślna wartość: json

--query

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

--subscription

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

--verbose

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

az storage container show

Zwróć wszystkie metadane zdefiniowane przez użytkownika i właściwości systemu dla określonego kontenera.

az storage container show --name
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--lease-id]
                          [--sas-token]
                          [--timeout]

Parametry wymagane

--name -n

Nazwa kontenera.

Parametry opcjonalne

--account-key

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

--account-name

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

--auth-mode

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

Dopuszczalne wartości: key, login

--blob-endpoint

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

--connection-string

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

--lease-id

Jeśli zostanie określony, powiedzie się tylko wtedy, gdy dzierżawa kontenera jest aktywna i pasuje do tego identyfikatora.

--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 oczekiwania na żądanie w sekundach. Dotyczy każdego wywołania usługi.

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

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

Domyślna wartość: json

--query

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

--subscription

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

--verbose

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

az storage container show-permission

Uzyskaj uprawnienia dla określonego kontenera.

az storage container show-permission --name
                                     [--account-key]
                                     [--account-name]
                                     [--auth-mode {key}]
                                     [--blob-endpoint]
                                     [--connection-string]
                                     [--lease-id]
                                     [--timeout]

Parametry wymagane

--name -n

Nazwa kontenera.

Parametry opcjonalne

--account-key

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

--account-name

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

--auth-mode

Tryb uruchamiania polecenia. 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.

Dopuszczalne wartości: key

--blob-endpoint

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

--connection-string

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

--lease-id

Jeśli zostanie określony, powiedzie się tylko wtedy, gdy dzierżawa kontenera jest aktywna i pasuje do tego identyfikatora.

--timeout

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

Parametry globalne

--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

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

Domyślna wartość: json

--query

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

--subscription

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

--verbose

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