az storage fs directory

управление каталогами в учетной записи Azure Data Lake Storage 2-го поколения.

Команды

az storage fs directory create

Создайте каталог в ADLS 2-го поколения файловой системе.

az storage fs directory delete

Удалите каталог в ADLS 2-го поколения файловой системе.

az storage fs directory download

Скачивать файлы из каталога в ADLS 2-го поколения файловой системе по локальному пути к файлу.

az storage fs directory exists

Проверьте наличие каталога в ADLS 2-го поколения файловой системе.

az storage fs directory list

Вывод списка каталогов в ADLS 2-го поколения файловой системе.

az storage fs directory metadata

Управление метаданными для каталога в файловой системе.

az storage fs directory metadata show

Возвращает все определяемые пользователем метаданные для указанного каталога.

az storage fs directory metadata update

Задает одну или несколько определяемых пользователем пар "имя-значение" для указанной файловой системы.

az storage fs directory move

Переместите каталог в ADLS 2-го поколения файловую систему.

az storage fs directory show

Отображение свойств каталога в ADLS 2-го поколения файловой системе.

az storage fs directory upload

Upload файлы или подкаталоги в каталог в ADLS 2-го поколения файловой системе.

az storage fs directory create

Создайте каталог в ADLS 2-го поколения файловой системе.

az storage fs directory create --file-system
                               --name
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--connection-string]
                               [--metadata]
                               [--permissions]
                               [--sas-token]
                               [--subscription]
                               [--timeout]
                               [--umask]

Примеры

Создайте каталог в ADLS 2-го поколения файловой системе.

az storage fs directory create -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Создайте каталог в ADLS 2-го поколения файловую систему с помощью строки подключения.

az storage fs directory create -n dir -f myfilesystem --connection-string myconnectionstring

Обязательные параметры

--file-system -f

Имя файловой системы.

--name -n

Имя каталога.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Должен использоваться в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранилища, может быть достигнута квота API.

--auth-mode

Режим, в котором выполняется команда. режим "вход" будет напрямую использовать учетные данные для входа для проверки подлинности. В устаревшем режиме "ключ" будет предпринята попытка запросить ключ учетной записи, если для учетной записи не указаны параметры проверки подлинности. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--metadata

Метаданные в парах "ключ = значение", разделенные пробелами. При этом все существующие метаданные перезаписываются.

--permissions

Права доступа POSIX для владельца файла, группы владельцев файла и других. Каждому классу может быть предоставлено разрешение на чтение, запись или выполнение. Также поддерживается бит крепления. Поддерживаются символьные (рвксрв-RW-) и 4-значные восьмеричные нотации (например, 0766). Дополнительные сведения см. в статье https://docs.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-access-control#levels-of-permission .

--sas-token

Подпись общего доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

--umask

При создании файла или каталога, если в родительской папке отсутствует ACL по умолчанию, umask ограничивают разрешения создаваемого файла или каталога. Полученное разрешение предоставляется p & ^ u, где p — это разрешение, а umask. Дополнительные сведения см. в статье https://docs.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-access-control#umask .

az storage fs directory delete

Удалите каталог в ADLS 2-го поколения файловой системе.

az storage fs directory delete --file-system
                               --name
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--connection-string]
                               [--sas-token]
                               [--subscription]
                               [--timeout]
                               [--yes]

Примеры

Удалите каталог в ADLS 2-го поколения файловой системе.

az storage fs directory delete -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Удалите каталог в ADLS 2-го поколения файловой системе. автоматически сформированный

az storage fs directory delete --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir --yes

Обязательные параметры

--file-system -f

Имя файловой системы.

--name -n

Имя каталога.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Должен использоваться в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранилища, может быть достигнута квота API.

--auth-mode

Режим, в котором выполняется команда. режим "вход" будет напрямую использовать учетные данные для входа для проверки подлинности. В устаревшем режиме "ключ" будет предпринята попытка запросить ключ учетной записи, если для учетной записи не указаны параметры проверки подлинности. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Подпись общего доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

--yes -y

Не запрашивать подтверждение.

az storage fs directory download

Скачивать файлы из каталога в ADLS 2-го поколения файловой системе по локальному пути к файлу.

az storage fs directory download --destination-path
                                 --file-system
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--connection-string]
                                 [--recursive]
                                 [--sas-token]
                                 [--source-path]
                                 [--subscription]

Примеры

Загрузите один файл в каталог в ADLS 2-го поколения файловой системе.

az storage fs directory download -f myfilesystem --account-name mystorageaccount -s "path/to/file" -d "<local-path>"

Скачивание всей ADLS 2-го поколения файловой системы.

az storage fs directory download -f myfilesystem --account-name mystorageaccount  -d "<local-path>" --recursive

Скачайте весь каталог в ADLS 2-го поколения файловой системе.

az storage fs directory download -f myfilesystem --account-name mystorageaccount -s SourceDirectoryPath -d "<local-path>" --recursive

Скачайте весь подкаталог в ADLS 2-го поколения файловой системе.

az storage fs directory download -f myfilesystem --account-name mystorageaccount -s "path/to/subdirectory" -d "<local-path>" --recursive

Обязательные параметры

--destination-path -d

Путь к локальному целевому каталогу для скачивания.

--file-system -f

Исходная файловая система для скачивания.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Должен использоваться в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранилища, может быть достигнута квота API.

--auth-mode

Режим, в котором выполняется команда. режим "вход" будет напрямую использовать учетные данные для входа для проверки подлинности. В устаревшем режиме "ключ" будет предпринята попытка запросить ключ учетной записи, если для учетной записи не указаны параметры проверки подлинности. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--recursive -r

Рекурсивно скачивать файлы. Если параметр включен, будут скачаны все файлы, включая файлы из подкаталогов.

--sas-token

Подпись общего доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--source-path -s

Путь к исходному каталогу загрузки. Он должен быть абсолютным путем к файловой системе.

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

az storage fs directory exists

Проверьте наличие каталога в ADLS 2-го поколения файловой системе.

az storage fs directory exists --file-system
                               --name
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--connection-string]
                               [--sas-token]
                               [--subscription]
                               [--timeout]

Примеры

Проверьте наличие каталога в ADLS 2-го поколения файловой системе.

az storage fs directory exists -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Проверьте наличие каталога в ADLS 2-го поколения файловой системе. автоматически сформированный

az storage fs directory exists --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir

Обязательные параметры

--file-system -f

Имя файловой системы.

--name -n

Имя каталога.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Должен использоваться в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранилища, может быть достигнута квота API.

--auth-mode

Режим, в котором выполняется команда. режим "вход" будет напрямую использовать учетные данные для входа для проверки подлинности. В устаревшем режиме "ключ" будет предпринята попытка запросить ключ учетной записи, если для учетной записи не указаны параметры проверки подлинности. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Подпись общего доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

az storage fs directory list

Вывод списка каталогов в ADLS 2-го поколения файловой системе.

az storage fs directory list --file-system
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--connection-string]
                             [--num-results]
                             [--path]
                             [--query-examples]
                             [--recursive {false, true}]
                             [--sas-token]
                             [--subscription]
                             [--timeout]

Примеры

Вывод списка каталогов в ADLS 2-го поколения файловой системе.

az storage fs directory list -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Вывод списка каталогов в папке "Dir/" для ADLS 2-го поколения файловой системы.

az storage fs directory list --path dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Обязательные параметры

--file-system -f

Имя файловой системы.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Должен использоваться в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранилища, может быть достигнута квота API.

--auth-mode

Режим, в котором выполняется команда. режим "вход" будет напрямую использовать учетные данные для входа для проверки подлинности. В устаревшем режиме "ключ" будет предпринята попытка запросить ключ учетной записи, если для учетной записи не указаны параметры проверки подлинности. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--num-results

Укажите максимальное число возвращаемых результатов.

--path

Отфильтруйте результаты, чтобы возвращались только пути по указанному пути.

--query-examples

Рекомендуемая строка JMESPath. Можно скопировать один из запросов и вставить его после параметра--query в двойных кавычках, чтобы увидеть результаты. Можно добавить одно или несколько позиций ключевых слов, чтобы мы могли предоставлять предложения на основе этих ключевых слов.

--recursive

Рекурсивно искать подкаталоги, если задано значение true.

допустимые значения: false, true
значение по умолчанию: 1
--sas-token

Подпись общего доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

az storage fs directory move

Переместите каталог в ADLS 2-го поколения файловую систему.

az storage fs directory move --file-system
                             --name
                             --new-directory
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--connection-string]
                             [--sas-token]
                             [--subscription]
                             [--timeout]

Примеры

Переместите каталог в каталог в ADLS 2-го поколения файловой системе.

az storage fs directory move --new-directory newfs/dir -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Переместите каталог в ADLS 2-го поколения файловую систему. автоматически сформированный

az storage fs directory move --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir --new-directory newfs/dir

Обязательные параметры

--file-system -f

Имя файловой системы.

--name -n

Имя каталога.

--new-directory -d

Имя нового каталога, в который нужно переместить пользователей. Значение должно иметь следующий формат: "{FileSystem}/{директори}/{субдиректори}".

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Должен использоваться в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранилища, может быть достигнута квота API.

--auth-mode

Режим, в котором выполняется команда. режим "вход" будет напрямую использовать учетные данные для входа для проверки подлинности. В устаревшем режиме "ключ" будет предпринята попытка запросить ключ учетной записи, если для учетной записи не указаны параметры проверки подлинности. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--sas-token

Подпись общего доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

az storage fs directory show

Отображение свойств каталога в ADLS 2-го поколения файловой системе.

az storage fs directory show --file-system
                             --name
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--connection-string]
                             [--query-examples]
                             [--sas-token]
                             [--subscription]
                             [--timeout]

Примеры

Отображение свойств каталога в ADLS 2-го поколения файловой системе.

az storage fs directory show -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Отображение свойств подкаталога в ADLS 2-го поколения файловой системе.

az storage fs directory show -n dir/subdir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Отображение свойств каталога в ADLS 2-го поколения файловой системе. автоматически сформированный

az storage fs directory show --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir

Обязательные параметры

--file-system -f

Имя файловой системы.

--name -n

Имя каталога.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Должен использоваться в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранилища, может быть достигнута квота API.

--auth-mode

Режим, в котором выполняется команда. режим "вход" будет напрямую использовать учетные данные для входа для проверки подлинности. В устаревшем режиме "ключ" будет предпринята попытка запросить ключ учетной записи, если для учетной записи не указаны параметры проверки подлинности. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--query-examples

Рекомендуемая строка JMESPath. Можно скопировать один из запросов и вставить его после параметра--query в двойных кавычках, чтобы увидеть результаты. Можно добавить одно или несколько позиций ключевых слов, чтобы мы могли предоставлять предложения на основе этих ключевых слов.

--sas-token

Подпись общего доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

az storage fs directory upload

Upload файлы или подкаталоги в каталог в ADLS 2-го поколения файловой системе.

az storage fs directory upload --file-system
                               --source
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--connection-string]
                               [--destination-path]
                               [--recursive]
                               [--sas-token]
                               [--subscription]

Примеры

Upload один файл в каталог blob-объектов хранилища.

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/file" -d directory

Upload локальный каталог в корневой каталог в ADLS 2-го поколения файловой системе.

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/directory" --recursive

Upload локальный каталог в каталог в ADLS 2-го поколения файловой системе.

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/directory" -d directory --recursive

Upload набор файлов в локальном каталоге в каталог в ADLS 2-го поколения файловой системе.

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/file*" -d directory --recursive

Обязательные параметры

--file-system -f

Целевая файловая система для отправки.

--source -s

Путь к исходному файлу для отправки.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_KEY.

--account-name

имя учетной записи хранения; Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Должен использоваться в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранилища, может быть достигнута квота API.

--auth-mode

Режим, в котором выполняется команда. режим "вход" будет напрямую использовать учетные данные для входа для проверки подлинности. В устаревшем режиме "ключ" будет предпринята попытка запросить ключ учетной записи, если для учетной записи не указаны параметры проверки подлинности. Переменная среды: AZURE_STORAGE_AUTH_MODE.

допустимые значения: key, login
--connection-string

строка подключения учетной записи служба хранилища. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--destination-path -d

Путь к каталогу назначения для отправки. Он должен быть абсолютным путем к файловой системе. Если указанный конечный путь не существует, будет создан новый путь к каталогу.

--recursive -r

Рекурсивно отправлять файлы. Если параметр включен, будут отправлены все файлы, включая файлы из подкаталогов.

--sas-token

Подпись общего доступа (SAS). Необходимо использовать в сочетании с именем учетной записи хранения. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--subscription

Имя или идентификатор подписки Вы можете настроить подписку по умолчанию с помощью az account set -s NAME_OR_ID .