az storage fs access

Zarządzanie dostępem do systemu plików i uprawnieniami dla konta Azure Data Lake Storage Gen2.

Polecenia

az storage fs access remove-recursive

Usuń Access Control na ścieżce i ścieżkach podrzędnych na koncie Azure Data Lake Storage Gen2.

az storage fs access set

Ustaw właściwości kontroli dostępu ścieżki (katalogu lub pliku) na koncie Azure Data Lake Storage Gen2.

az storage fs access set-recursive

Ustaw Access Control na ścieżce i ścieżkach podrzędnych na koncie Azure Data Lake Storage Gen2.

az storage fs access show

Pokaż właściwości kontroli dostępu ścieżki (katalogu lub pliku) na koncie Azure Data Lake Storage Gen2.

az storage fs access update-recursive

Zmodyfikuj Access Control na ścieżce i ścieżkach podrzędnych na koncie Azure Data Lake Storage Gen2.

az storage fs access remove-recursive

Usuń Access Control na ścieżce i ścieżkach podrzędnych na koncie Azure Data Lake Storage Gen2.

az storage fs access remove-recursive --acl
                                      --file-system
                                      --path
                                      [--account-key]
                                      [--account-name]
                                      [--auth-mode {key, login}]
                                      [--batch-size]
                                      [--blob-endpoint]
                                      [--connection-string]
                                      [--continuation]
                                      [--continue-on-failure {false, true}]
                                      [--max-batches]
                                      [--sas-token]
                                      [--timeout]

Przykłady

Usuń Access Control na ścieżce i ścieżkach podrzędnych na koncie Azure Data Lake Storage Gen2.

az storage fs access remove-recursive --acl "default:user:21cd756e-e290-4a26-9547-93e8cc1a8923" -p dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Parametry wymagane

--acl

Usuń prawa kontroli dostępu POSIX w plikach i katalogach. Wartość jest rozdzielaną przecinkami listą wpisów kontroli dostępu. Każdy wpis kontroli dostępu (ACE) składa się z zakresu, typu i identyfikatora użytkownika lub grupy w formacie "[scope:][type]:[id]".

--file-system -f

Nazwa systemu plików (tj. nazwa kontenera).

--path -p

Ścieżka do pliku lub katalogu w określonym systemie 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.

--auth-mode

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

akceptowane wartości: key, login
--batch-size

Opcjonalny. Jeśli rozmiar zestawu danych przekracza rozmiar partii, operacja zostanie podzielona na wiele żądań, aby można było śledzić postęp. Rozmiar partii powinien należeć do zakresu od 1 do 2000. Wartość domyślna, gdy nieokreślone jest 2000.

--blob-endpoint

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

--connection-string

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

--continuation

Opcjonalny token kontynuacji, którego można użyć do wznowienia wcześniej zatrzymanych operacji.

--continue-on-failure

W przypadku ustawienia wartości Fałsz operacja zakończy się szybko po napotkaniu błędów użytkownika (4XX). Jeśli wartość True, operacja zignoruje błędy użytkownika i przejdzie do operacji na innych podrzędnych jednostkach katalogu. Token kontynuacji zostanie zwrócony tylko wtedy, gdy wartość --continue-on-failure ma wartość True w przypadku błędów użytkownika. Jeśli nie zostanie ustawiona wartość domyślna to Fałsz.

akceptowane wartości: false, true
--max-batches

Opcjonalny. Zdefiniuj maksymalną liczbę partii, które mogą wykonywać pojedyncza zmiana Access Control operacji. Jeśli wartość maksymalna zostanie osiągnięta przed przetworzeniem wszystkich ścieżek podrzędnych, można użyć tokenu kontynuacji do wznowienia operacji. Pusta wartość wskazuje, że maksymalna liczba partii w niepowiązanych operacjach jest kontynuowana do końca.

--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 fs access set

Ustaw właściwości kontroli dostępu ścieżki (katalogu lub pliku) na koncie Azure Data Lake Storage Gen2.

az storage fs access set --file-system
                         --path
                         [--account-key]
                         [--account-name]
                         [--acl]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--connection-string]
                         [--group]
                         [--owner]
                         [--permissions]
                         [--sas-token]

Przykłady

Ustaw listę kontroli dostępu ścieżki.

az storage fs access set --acl "user::rwx,group::r--,other::---" -p dir -f myfilesystem --account-name mystorageaccount --account-key 0000-0000

Ustawianie uprawnień ścieżki.

az storage fs access set --permissions "rwxrwx---" -p dir -f myfilesystem --account-name mystorageaccount --account-key 0000-0000

Ustaw właściciela ścieżki.

az storage fs access set --owner example@microsoft.com -p dir -f myfilesystem --account-name mystorageaccount --account-key 0000-0000

Ustaw grupę będącą właścicielem ścieżki.

az storage fs access set --group 68390a19-a897-236b-b453-488abf67b4dc -p dir -f myfilesystem --account-name mystorageaccount --account-key 0000-0000

Parametry wymagane

--file-system -f

Nazwa systemu plików (tj. nazwa kontenera).

--path -p

Ścieżka do pliku lub katalogu w określonym systemie 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.

--acl

Nieprawidłowy w połączeniu z listą ACL. Prawa kontroli dostępu POSIX do plików i katalogów w formacie "[scope:][type]:[id]::[permissions]". np. "user::rwx,group::r--,in::---,mask::rwx".

--auth-mode

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

akceptowane wartości: key, login
--blob-endpoint

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

--connection-string

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

--group

Grupa będąca właścicielem pliku lub katalogu. Grupa Identyfikator obiektu usługi Azure Active Directory lub główna nazwa użytkownika, która ma być ustawiona jako grupa będąca właścicielem. Aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/azure/storage/blobs/data-lake-storage-access-control#changing-the-owning-group.

--owner

Użytkownik będąc właścicielem pliku lub katalogu. Identyfikator obiektu usługi Azure Active Directory lub główna nazwa użytkownika, który ma być ustawiony jako właściciel. Aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/azure/storage/blobs/data-lake-storage-access-control#the-owning-user.

--permissions

Nieprawidłowy w połączeniu z listą ACL. Uprawnienia dostępu do pliku POSIX dla właściciela pliku, grupy właścicieli plików i innych. Każda klasa może mieć uprawnienie read(r), write(w) lub execute(x). Obsługiwane są notacje symboliczne (rwxrw-rw-) i 4-cyfrowe notacje ósemkowej (np. 0766).

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

az storage fs access set-recursive

Ustaw Access Control na ścieżce i ścieżkach podrzędnych na koncie Azure Data Lake Storage Gen2.

az storage fs access set-recursive --acl
                                   --file-system
                                   --path
                                   [--account-key]
                                   [--account-name]
                                   [--auth-mode {key, login}]
                                   [--batch-size]
                                   [--blob-endpoint]
                                   [--connection-string]
                                   [--continuation]
                                   [--continue-on-failure {false, true}]
                                   [--max-batches]
                                   [--sas-token]
                                   [--timeout]

Przykłady

Ustaw Access Control na ścieżce i ścieżkach podrzędnych na koncie Azure Data Lake Storage Gen2.

az storage fs access set-recursive --acl "default:user:21cd756e-e290-4a26-9547-93e8cc1a8923:rwx" -p dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Parametry wymagane

--acl

Wartość jest rozdzielaną przecinkami listą wpisów kontroli dostępu. Każdy wpis kontroli dostępu (ACE) składa się z zakresu, typu, identyfikatora użytkownika lub grupy i uprawnień w formacie "[scope:][type]:[id]:[permissions]". Aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/azure/storage/blobs/data-lake-storage-access-control.

--file-system -f

Nazwa systemu plików (tj. nazwa kontenera).

--path -p

Ścieżka do pliku lub katalogu w określonym systemie 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.

--auth-mode

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

akceptowane wartości: key, login
--batch-size

Opcjonalny. Jeśli rozmiar zestawu danych przekracza rozmiar partii, operacja zostanie podzielona na wiele żądań, aby można było śledzić postęp. Rozmiar partii powinien należeć do zakresu od 1 do 2000. Wartość domyślna, gdy nieokreślone jest 2000.

--blob-endpoint

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

--connection-string

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

--continuation

Opcjonalny token kontynuacji, którego można użyć do wznowienia wcześniej zatrzymanych operacji.

--continue-on-failure

W przypadku ustawienia wartości Fałsz operacja zakończy się szybko po napotkaniu błędów użytkownika (4XX). Jeśli wartość True, operacja zignoruje błędy użytkownika i przejdzie do operacji na innych podrzędnych jednostkach katalogu. Token kontynuacji zostanie zwrócony tylko wtedy, gdy wartość --continue-on-failure ma wartość True w przypadku błędów użytkownika. Jeśli nie zostanie ustawiona wartość domyślna to Fałsz.

akceptowane wartości: false, true
--max-batches

Opcjonalny. Zdefiniuj maksymalną liczbę partii, które mogą wykonywać pojedyncza zmiana Access Control operacji. Jeśli wartość maksymalna zostanie osiągnięta przed przetworzeniem wszystkich ścieżek podrzędnych, można użyć tokenu kontynuacji do wznowienia operacji. Pusta wartość wskazuje, że maksymalna liczba partii w niepowiązanych operacjach jest kontynuowana do końca.

--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 fs access show

Pokaż właściwości kontroli dostępu ścieżki (katalogu lub pliku) na koncie Azure Data Lake Storage Gen2.

az storage fs access show --file-system
                          --path
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--sas-token]

Przykłady

Pokaż właściwości kontroli dostępu ścieżki.

az storage fs access show -p dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Parametry wymagane

--file-system -f

Nazwa systemu plików (tj. nazwa kontenera).

--path -p

Ścieżka do pliku lub katalogu w określonym systemie 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.

--auth-mode

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

akceptowane wartości: key, login
--blob-endpoint

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

--connection-string

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

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

az storage fs access update-recursive

Zmodyfikuj Access Control na ścieżce i ścieżkach podrzędnych na koncie Azure Data Lake Storage Gen2.

az storage fs access update-recursive --acl
                                      --file-system
                                      --path
                                      [--account-key]
                                      [--account-name]
                                      [--auth-mode {key, login}]
                                      [--batch-size]
                                      [--blob-endpoint]
                                      [--connection-string]
                                      [--continuation]
                                      [--continue-on-failure {false, true}]
                                      [--max-batches]
                                      [--sas-token]
                                      [--timeout]

Przykłady

Zmodyfikuj Access Control na ścieżce i ścieżkach podrzędnych na koncie Azure Data Lake Storage Gen2.

az storage fs access update-recursive --acl "user::r-x" -p dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Parametry wymagane

--acl

Wartość jest rozdzielaną przecinkami listą wpisów kontroli dostępu. Każdy wpis kontroli dostępu (ACE) składa się z zakresu, typu, identyfikatora użytkownika lub grupy i uprawnień w formacie "[scope:][type]:[id]:[permissions]". Aby uzyskać więcej informacji, zobacz https://docs.microsoft.com/azure/storage/blobs/data-lake-storage-access-control.

--file-system -f

Nazwa systemu plików (tj. nazwa kontenera).

--path -p

Ścieżka do pliku lub katalogu w określonym systemie 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.

--auth-mode

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

akceptowane wartości: key, login
--batch-size

Opcjonalny. Jeśli rozmiar zestawu danych przekracza rozmiar partii, operacja zostanie podzielona na wiele żądań, aby można było śledzić postęp. Rozmiar partii powinien należeć do zakresu od 1 do 2000. Wartość domyślna, gdy nieokreślone jest 2000.

--blob-endpoint

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

--connection-string

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

--continuation

Opcjonalny token kontynuacji, którego można użyć do wznowienia wcześniej zatrzymanych operacji.

--continue-on-failure

W przypadku ustawienia wartości Fałsz operacja zakończy się szybko po napotkaniu błędów użytkownika (4XX). Jeśli wartość True, operacja zignoruje błędy użytkownika i przejdzie do operacji na innych podrzędnych jednostkach katalogu. Token kontynuacji zostanie zwrócony tylko wtedy, gdy wartość --continue-on-failure ma wartość True w przypadku błędów użytkownika. Jeśli nie zostanie ustawiona wartość domyślna to Fałsz.

akceptowane wartości: false, true
--max-batches

Opcjonalny. Zdefiniuj maksymalną liczbę partii, które mogą wykonywać pojedyncza zmiana Access Control operacji. Jeśli wartość maksymalna zostanie osiągnięta przed przetworzeniem wszystkich ścieżek podrzędnych, można użyć tokenu kontynuacji do wznowienia operacji. Pusta wartość wskazuje, że maksymalna liczba partii w niepowiązanych operacjach jest kontynuowana do końca.

--sas-token

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

--timeout

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