FileService Класс
Протокол Server Message Block (SMB) — предпочитаемый протокол общего доступа к файлам, используемый локально в настоящее время. Служба файлов Microsoft Azure позволяет клиентам использовать доступность и масштабируемость облачной инфраструктуры как услуги Azure (IaaS) SMB без необходимости перезаписывать клиентские приложения SMB.
Файловая служба Azure также предлагает привлекательную альтернативу традиционным решениям непосредственно присоединенного хранилища (DAS) и сети хранения данных (SAN), которые часто оказываются слишком сложными и затратными в установке, настройке и работе.
- Наследование
-
FileService
Конструктор
FileService(account_name=None, account_key=None, sas_token=None, protocol='https', endpoint_suffix='core.windows.net', request_session=None, connection_string=None, socket_timeout=None)Параметры
| Имя | Описание |
|---|---|
|
account_name
|
имя учетной записи хранения. Он используется для проверки подлинности запросов, подписанных с помощью ключа учетной записи, и для создания конечной точки хранилища. Он является обязательным, если не указана строка подключения. значение по умолчанию: None
|
|
account_key
|
Ключ учетной записи хранения. Используется для проверки подлинности с общим ключом. значение по умолчанию: None
|
|
sas_token
|
Маркер подписанного URL-адреса, используемый для проверки подлинности запросов вместо ключа учетной записи. Если указаны ключ учетной записи и маркер SAS, для подписывания будет использоваться ключ учетной записи. значение по умолчанию: None
|
|
protocol
|
Протокол, используемый для запросов. Значение по умолчанию — https. значение по умолчанию: https
|
|
endpoint_suffix
|
Базовый компонент узла URL-адреса за вычетом имени учетной записи. По умолчанию используется Azure (core.windows.net). Переопределите его, чтобы использовать облако для Китая (core.chinacloudapi.cn). значение по умолчанию: core.windows.net
|
|
request_session
|
<xref:requests.Session>
Объект сеанса, который используется для HTTP-запросов. значение по умолчанию: None
|
|
connection_string
|
Если этот параметр указан, будут переопределяться все остальные параметры, кроме сеанса запроса. См http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/ . сведения о формате строки подключения. значение по умолчанию: None
|
|
socket_timeout
|
Если этот параметр указан, время ожидания сокета по умолчанию переопределяется. Указанное время ожидания — в секундах. Значение по умолчанию см. в разделе DEFAULT_SOCKET_TIMEOUT в _constants.py. значение по умолчанию: None
|
Переменные
| Имя | Описание |
|---|---|
|
MAX_SINGLE_GET_SIZE
|
Размер первого диапазона выполняется методами get_file_to_*, если max_connections больше 1. Если размер файла меньше, чем этот, будет возвращено меньше данных. |
|
MAX_CHUNK_GET_SIZE
|
Размер последующего диапазона выполняется методами get_file_to_*, если max_connections больше 1, а файл больше MAX_SINGLE_GET_SIZE. Если оставшаяся часть файла меньше, чем это, будет возвращено меньше данных. Если для параметра задано значение больше 4 МБ, content_validation вызовет ошибку, если он включен. Однако, если content_validation не требуется, оптимальным может быть размер, превышающий 4 МБ. Не рекомендуется устанавливать значение ниже 4 МБ. |
|
MAX_RANGE_SIZE
|
Размер диапазонов, помещаемых методами create_file_from_*. При меньшем значении данных можно указать меньшие диапазоны. Максимальный размер диапазона, поддерживаемый службой, составляет 4 МБ. |
Методы
| abort_copy_file |
Прерывает ожидающие операции copy_file и оставляет целевой файл нулевой длины и полные метаданные. |
| clear_range |
Очищает указанный диапазон и освобождает пространство, используемое в хранилище для этого диапазона. |
| close_handles |
Возвращает генератор для закрытия открытых дескрипторов в каталоге или файле в указанной общей папке. Генератор будет отложенно следовать маркерам продолжения, возвращенным службой, и останавливаться, когда все дескрипторы будут закрыты. Возвращаемые значения представляют количество дескрипторов, которые были закрыты в каждой транзакции. |
| copy_file |
Асинхронно копирует файл. Эта операция возвращает объект свойств операции копирования, включая идентификатор копирования, который можно использовать для проверка или прерывания операции копирования. Файловая служба копирует файлы на основе наилучших усилий. Если целевой файл существует, он будет перезаписан. Файл назначения нельзя изменить во время выполнения операции копирования. |
| create_directory |
Создает новый каталог в указанном общем или родительском каталоге. Если каталог с тем же именем уже существует, операция в службе завершается ошибкой. По умолчанию исключение поглощается клиентом. Чтобы предоставить исключение, укажите значение True для fail_on_exists. |
| create_file |
Создает новый файл. В разделе create_file_from_* описаны высокоуровневые функции, которые обрабатывают создание и отправку больших файлов с автоматическим фрагментированием и уведомлениями о ходе выполнения. |
| create_file_from_bytes |
Создает новый файл из массива байтов или обновляет содержимое существующего файла с помощью автоматического фрагментирования и уведомлений о ходе выполнения. |
| create_file_from_path |
Создает новый файл Azure из локального пути к файлу или обновляет содержимое существующего файла с помощью автоматического фрагментирования и уведомлений о ходе выполнения. |
| create_file_from_stream |
Создает новый файл из файла или потока или обновляет содержимое существующего файла с помощью автоматического фрагментирования и уведомлений о ходе выполнения. |
| create_file_from_text |
Создает новый файл из str/Unicode или обновляет содержимое существующего файла с помощью автоматического фрагментирования и уведомлений о ходе выполнения. |
| create_permission_for_share |
Создайте разрешение (дескриптор безопасности) на уровне общей папки. Это разрешение можно использовать для файлов и каталогов в общей папке. Если "разрешение" уже существует, оно должно вернуть его ключ, в противном случае создает новое разрешение на уровне общей папки и возвращает свой ключ. :возвращает ключ разрешения файла :rtype str |
| create_share |
Создает новую общую папку в указанной учетной записи. Если общая папка с тем же именем уже существует, операция в службе завершается сбоем. По умолчанию исключение поглощается клиентом. Чтобы предоставить исключение, укажите значение True для fail_on_exists. |
| delete_directory |
Удаляет указанный пустой каталог. Обратите внимание, что каталог должен быть пустым, перед тем как его можно будет удалить. Попытка удалить каталоги, которые не являются пустыми, завершится ошибкой. Если каталог не существует, операция в службе завершается сбоем. По умолчанию исключение поглощается клиентом. Чтобы предоставить исключение, укажите значение True для fail_not_exist. |
| delete_file |
Помечает указанный файл для удаления. Позже файл удаляется во время сборки мусора. |
| delete_share |
Помечает указанный общий ресурс для удаления. Если общая папка не существует, операция в службе завершается сбоем. По умолчанию исключение поглощается клиентом. Чтобы предоставить исключение, укажите значение True для fail_not_exist. |
| exists |
Возвращает логическое значение, указывающее, существует ли общая папка, если задано только имя общей папки. Если directory_name задано, возвращается логическое значение, указывающее, существует ли каталог. Если также указан file_name, возвращается логическое значение, указывающее, существует ли файл. |
| generate_account_shared_access_signature |
Создает подписанный URL-адрес для файловой службы. Используйте возвращенную подпись с параметром sas_token FileService. |
| generate_file_shared_access_signature |
Создает подписанный URL-адрес для файла. Используйте возвращенную сигнатуру с параметром sas_token FileService. |
| generate_share_shared_access_signature |
Создает подписанный URL-адрес для общей папки. Используйте возвращенную сигнатуру с параметром sas_token FileService. |
| get_directory_metadata |
Возвращает все определяемые пользователем метаданные для указанного каталога. |
| get_directory_properties |
Возвращает все определяемые пользователем метаданные и системные свойства для указанного каталога. Возвращаемые данные не включают список файлов каталога. |
| get_file_metadata |
Возвращает все определяемые пользователем метаданные для указанного файла. |
| get_file_properties |
Возвращает все определяемые пользователем метаданные, стандартные свойства HTTP и системные свойства для файла. Возвращает экземпляр с FileFileProperties и словарем метаданных. |
| get_file_service_properties |
Возвращает свойства файловой службы учетной записи хранения, включая Аналитика Службы хранилища Azure. |
| get_file_to_bytes |
Скачивает файл в виде массива байтов с автоматическим фрагментированием и уведомлениями о ходе выполнения. Возвращает экземпляр со File свойствами, метаданными и содержимым. |
| get_file_to_path |
Загружает файл в путь к файлу с автоматическим фрагментированием и уведомлениями о ходе выполнения. Возвращает экземпляр файла со свойствами и метаданными. |
| get_file_to_stream |
Загружает файл в поток с автоматическим фрагментированием и уведомлениями о ходе выполнения. Возвращает экземпляр со File свойствами и метаданными. |
| get_file_to_text |
Загружает файл в виде текста Юникода с автоматическим фрагментированием и уведомлениями о ходе выполнения. Возвращает экземпляр со File свойствами, метаданными и содержимым. |
| get_permission_for_share |
Создайте разрешение (дескриптор безопасности) на уровне общего ресурса. Это разрешение можно использовать для файлов и каталогов в общей папке. Если "разрешение" уже существует, оно возвращает его ключ, в противном случае создает новое разрешение на уровне общей папки и возвращает его ключ. :возвращает разрешение файла (переносимый SDDL) :rtype str |
| get_share_acl |
Возвращает разрешения для указанной общей папки. |
| get_share_metadata |
Возвращает все определяемые пользователем метаданные для указанной общей папки. |
| get_share_properties |
Возвращает все определяемые пользователем метаданные и системные свойства для указанной общей папки. Возвращаемые данные не включают список файлов или каталогов общих папок. |
| get_share_stats |
Возвращает приблизительный размер данных, хранящихся в общей папке, округленный до ближайшего гигабайта. Обратите внимание, что это значение может включать не все недавно созданные или недавно измененные файлы. |
| get_share_stats_in_bytes |
Возвращает приблизительный размер данных, хранящихся в общей папке, в байтах. Обратите внимание, что это значение может включать не все недавно созданные или недавно измененные файлы. |
| list_directories_and_files |
Возвращает генератор для вывода списка каталогов и файлов в указанной общей папке. Генератор будет отложенно следовать маркерам продолжения, возвращенным службой, и останавливаться, когда все каталоги и файлы будут возвращены или num_results достигнут. Если указано num_results и общая папка содержит больше указанного числа файлов и каталогов, генератор будет иметь заполненное поле next_marker после завершения. Этот маркер можно использовать для создания нового генератора, если нужны дополнительные результаты. |
| list_handles |
Возвращает генератор для вывода списка открытых дескрипторов в каталоге или файле в указанной общей папке. Генератор будет отложенно следовать маркерам продолжения, возвращенным службой, и останавливаться при возвращении всех дескрипторов или достижении num_results. Если указано num_results и общая папка содержит больше указанного числа файлов и каталогов, генератор будет иметь заполненное поле next_marker после завершения. Этот маркер можно использовать для создания нового генератора, если нужны дополнительные результаты. |
| list_ranges |
Извлекает допустимые диапазоны для файла. |
| list_shares |
Возвращает генератор для перечисления общих папок в указанной учетной записи. Генератор будет отложенно следовать маркерам продолжения, возвращенным службой, и останавливаться при возврате всех общих папок или достижении num_results. Если указано num_results и в учетной записи больше, чем это количество общих папок, генератор будет иметь заполненное поле next_marker после завершения. Этот маркер можно использовать для создания нового генератора, если нужны дополнительные результаты. |
| make_file_url |
Создает URL-адрес для доступа к файлу. |
| resize_file |
Изменяет размер файла на указанный. Если указанное байтовое значение меньше текущего размера файла, то все диапазоны свыше указанного байтового значения очищаются. |
| set_directory_metadata |
Задает одну или несколько определяемых пользователем пар "имя-значение" для указанного каталога. Каждый вызов этой операции приводит к замене всех существующих метаданных, присоединенных к каталогу. Чтобы удалить все метаданные из каталога, вызовите эту операцию без дикта метаданных. |
| set_directory_properties | |
| set_file_metadata |
Задает определяемые пользователем метаданные для указанного файла в виде одной или нескольких пар "имя-значение". |
| set_file_properties |
Задает системные свойства файла. Если для content_settings задано одно свойство, все свойства будут переопределены. |
| set_file_service_properties |
Задает свойства файловой службы учетной записи хранения, включая Аналитика Службы хранилища Azure. Если элемент (например, HourMetrics) остается как None, существующие параметры службы для этой функции сохраняются. |
| set_share_acl |
Задает разрешения для указанной общей папки или хранимых политик доступа, которые могут использоваться с подписанными URL-адресами. |
| set_share_metadata |
Задает одну или несколько определяемых пользователем пар "имя-значение" для указанной общей папки. Каждый вызов этой операции приводит к замене всех существующих метаданных, присоединенных к общему ресурсу. Чтобы удалить все метаданные из общей папки, вызовите эту операцию без диктовки метаданных. |
| set_share_properties |
Задает определяемые службой свойства для указанной общей папки. |
| snapshot_share |
Создает snapshot существующей общей папки в указанной учетной записи. |
| update_range |
Записывает байты, указанные текстом запроса, в указанный диапазон. |
| update_range_from_file_url |
Записывает байты из одной конечной точки файла Azure в указанный диапазон другой конечной точки файла Azure. |
abort_copy_file
Прерывает ожидающие операции copy_file и оставляет целевой файл нулевой длины и полные метаданные.
abort_copy_file(share_name, directory_name, file_name, copy_id, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя целевой общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя целевого файла. |
|
copy_id
Обязательно
|
Скопируйте идентификатор, указанный в copy.id исходной операции copy_file. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
clear_range
Очищает указанный диапазон и освобождает пространство, используемое в хранилище для этого диапазона.
clear_range(share_name, directory_name, file_name, start_range, end_range, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
start_range
Обязательно
|
Начало диапазона байтов, используемого для очистки раздела файла. Размер диапазона может составлять до 4 МБ. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. |
|
end_range
Обязательно
|
Конец диапазона байтов, используемый для очистки раздела файла. Размер диапазона может составлять до 4 МБ. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
close_handles
Возвращает генератор для закрытия открытых дескрипторов в каталоге или файле в указанной общей папке. Генератор будет отложенно следовать маркерам продолжения, возвращенным службой, и останавливаться, когда все дескрипторы будут закрыты. Возвращаемые значения представляют количество дескрипторов, которые были закрыты в каждой транзакции.
close_handles(share_name, directory_name=None, file_name=None, recursive=None, handle_id=None, marker=None, snapshot=None, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
|
Путь к каталогу. значение по умолчанию: None
|
|
file_name
|
Имя существующего файла. значение по умолчанию: None
|
|
recursive
|
Логическое значение, указывающее, должна ли операция применяться к каталогу, указанному в URI, его файлам, подкаталогам и файлам. значение по умолчанию: None
|
|
handle_id
|
Обязательный. Указывает идентификатор дескриптора, открытого в закрытом файле или каталоге. Astrix ('*') — это подстановочный знак, указывающий все дескрипторы. значение по умолчанию: None
|
|
marker
|
Непрозрачный маркер продолжения. Это значение можно получить из поля next_marker предыдущего объекта генератора, если он не завершил закрывающие дескрипторы. Если этот генератор указан, этот генератор начнет закрывать дескрипторы с точки, где остановлен предыдущий генератор. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
copy_file
Асинхронно копирует файл. Эта операция возвращает объект свойств операции копирования, включая идентификатор копирования, который можно использовать для проверка или прерывания операции копирования. Файловая служба копирует файлы на основе наилучших усилий.
Если целевой файл существует, он будет перезаписан. Файл назначения нельзя изменить во время выполнения операции копирования.
copy_file(share_name, directory_name, file_name, copy_source, metadata=None, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя целевой общей папки. Общая папка должна существовать. |
|
directory_name
Обязательно
|
Имя целевого каталога. Этот каталог должен существовать. |
|
file_name
Обязательно
|
Имя целевого файла. Если целевой файл существует, он будет перезаписан. В противном случае он будет создан. |
|
copy_source
Обязательно
|
URL-адрес длиной до 2 КБ, указывающий файл или большой двоичный объект Azure. Значение должно быть закодировано в URL-адресе в том виде, в каком оно указано в запросе URI. Если источник находится в другой учетной записи, источник должен быть общедоступным или пройти проверку подлинности с помощью подписанного URL-адреса. Если источник является общедоступным, проверка подлинности не требуется. Примеры: https://myaccount.file.core.windows.net/myshare/mydir/myfilehttps://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken |
|
metadata
|
Пары «имя-значение», связанные с файлом как метаданные. Если пары "имя-значение" не указаны, операция скопирует метаданные из исходного большого двоичного объекта или файла в целевой файл. Если указана одна или несколько пар "имя-значение", целевой файл создается с указанными метаданными, а метаданные не копируются из исходного BLOB-объекта или файла. значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Свойства операции копирования, такие как состояние, источник и идентификатор. |
create_directory
Создает новый каталог в указанном общем или родительском каталоге. Если каталог с тем же именем уже существует, операция в службе завершается ошибкой. По умолчанию исключение поглощается клиентом. Чтобы предоставить исключение, укажите значение True для fail_on_exists.
create_directory(share_name, directory_name, metadata=None, fail_on_exist=False, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Имя создаваемого каталога, включая путь к родительскому каталогу. |
|
metadata
|
Дикт с name_value парами для связывания с общим ресурсом в качестве метаданных. Пример:{'Category':'test'} значение по умолчанию: None
|
|
fail_on_exist
|
укажите, следует ли создавать исключение при наличии каталога. Значение по умолчанию: false. значение по умолчанию: False
|
|
file_permission
|
Разрешение файла, переносимый SDDL значение по умолчанию: None
|
|
smb_properties
|
Задает свойства файла, связанного с SMB |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Значение True, если каталог создан, false, если каталог уже существует. |
create_file
Создает новый файл.
В разделе create_file_from_* описаны высокоуровневые функции, которые обрабатывают создание и отправку больших файлов с автоматическим фрагментированием и уведомлениями о ходе выполнения.
create_file(share_name, directory_name, file_name, content_length, content_settings=None, metadata=None, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя создаваемого или обновляемого файла. |
|
content_length
Обязательно
|
Длина файла в байтах. |
|
content_settings
|
Объект ContentSettings, используемый для задания свойств файла. значение по умолчанию: None
|
|
metadata
|
Пары «имя-значение», связанные с файлом как метаданные. значение по умолчанию: None
|
|
file_permission
|
Разрешение файла, переносимый SDDL значение по умолчанию: None
|
|
smb_properties
|
Задает свойства файла, связанного с SMB |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
create_file_from_bytes
Создает новый файл из массива байтов или обновляет содержимое существующего файла с помощью автоматического фрагментирования и уведомлений о ходе выполнения.
create_file_from_bytes(share_name, directory_name, file_name, file, index=0, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя создаваемого или обновляемого файла. |
|
file
Обязательно
|
Содержимое файла в виде массива байтов. |
|
index
|
Начальный индекс в массиве байтов. значение по умолчанию: 0
|
|
count
|
Количество байтов для отправки. Задайте значение Нет или отрицательное значение, чтобы передать все байты, начиная с индекса. значение по умолчанию: None
|
|
content_settings
|
Объект ContentSettings, используемый для задания свойств файла. значение по умолчанию: None
|
|
metadata
|
Пары «имя-значение», связанные с файлом как метаданные. значение по умолчанию: None
|
|
validate_content
|
Если значение равно true, вычисляет хэш MD5 для каждого диапазона файла. Служба хранилища проверяет хэш содержимого, которое поступило вместе с отправленным хэшом. Это в первую очередь полезно для обнаружения битовых фрагментов в сети, если использование http вместо https, так как https (по умолчанию) уже проверяется. Обратите внимание, что этот хэш MD5 не хранится вместе с файлом. значение по умолчанию: False
|
|
progress_callback
|
<xref:func>(<xref:current>, <xref:total>)
Обратный вызов для выполнения с функцией сигнатуры (current, total), где current — это количество переданных байтов, а total — это размер файла, или None, если общий размер неизвестен. значение по умолчанию: None
|
|
max_connections
|
Максимальное число параллельных подключений для использования. значение по умолчанию: 2
|
|
file_permission
|
Разрешение файла, переносимый SDDL значение по умолчанию: None
|
|
smb_properties
|
Задает свойства файла, связанного с SMB |
|
timeout
|
Параметр времени ожидания указывается в секундах. Этот метод может выполнять несколько вызовов к службе Azure, и время ожидания будет применяться к каждому вызову по отдельности. значение по умолчанию: None
|
create_file_from_path
Создает новый файл Azure из локального пути к файлу или обновляет содержимое существующего файла с помощью автоматического фрагментирования и уведомлений о ходе выполнения.
create_file_from_path(share_name, directory_name, file_name, local_file_path, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя создаваемого или обновляемого файла. |
|
local_file_path
Обязательно
|
Путь к локальному файлу для отправки в качестве содержимого файла. |
|
content_settings
|
Объект ContentSettings, используемый для задания свойств файла. значение по умолчанию: None
|
|
metadata
|
Пары «имя-значение», связанные с файлом как метаданные. значение по умолчанию: None
|
|
validate_content
|
Если значение равно true, вычисляет хэш MD5 для каждого диапазона файла. Служба хранилища проверяет хэш содержимого, которое поступило вместе с отправленным хэшом. Это в первую очередь полезно для обнаружения битовых фрагментов в сети, если использование http вместо https, так как https (по умолчанию) уже проверяется. Обратите внимание, что этот хэш MD5 не хранится вместе с файлом. значение по умолчанию: False
|
|
progress_callback
|
<xref:func>(<xref:current>, <xref:total>)
Обратный вызов для выполнения с функцией сигнатуры (current, total), где current — это количество переданных байтов, а total — это размер файла, или None, если общий размер неизвестен. значение по умолчанию: None
|
|
max_connections
|
Максимальное число параллельных подключений для использования. значение по умолчанию: 2
|
|
file_permission
|
Разрешение файла, переносимый SDDL значение по умолчанию: None
|
|
smb_properties
|
Задает свойства файла, связанного с SMB |
|
timeout
|
Параметр времени ожидания указывается в секундах. Этот метод может выполнять несколько вызовов к службе Azure, и время ожидания будет применяться к каждому вызову по отдельности. значение по умолчанию: None
|
create_file_from_stream
Создает новый файл из файла или потока или обновляет содержимое существующего файла с помощью автоматического фрагментирования и уведомлений о ходе выполнения.
create_file_from_stream(share_name, directory_name, file_name, stream, count, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя создаваемого или обновляемого файла. |
|
stream
Обязательно
|
Открыт файл или поток для отправки в качестве содержимого файла. |
|
count
Обязательно
|
Число байтов, считываемых из потока. Это необходимо, файл не может быть создан, если счетчик неизвестен. |
|
content_settings
|
Объект ContentSettings, используемый для задания свойств файла. значение по умолчанию: None
|
|
metadata
|
Пары «имя-значение», связанные с файлом как метаданные. значение по умолчанию: None
|
|
validate_content
|
Если значение равно true, вычисляет хэш MD5 для каждого диапазона файла. Служба хранилища проверяет хэш содержимого, которое поступило вместе с отправленным хэшом. Это в первую очередь полезно для обнаружения битовых фрагментов в сети, если использование http вместо https, так как https (по умолчанию) уже проверяется. Обратите внимание, что этот хэш MD5 не хранится вместе с файлом. значение по умолчанию: False
|
|
progress_callback
|
<xref:func>(<xref:current>, <xref:total>)
Обратный вызов для выполнения с функцией сигнатуры (current, total), где current — это количество переданных байтов, а total — это размер файла, или None, если общий размер неизвестен. значение по умолчанию: None
|
|
max_connections
|
Максимальное число параллельных подключений для использования. Обратите внимание, что для параллельной отправки требуется, чтобы поток был искать. значение по умолчанию: 2
|
|
file_permission
|
Разрешение файла, переносимый SDDL значение по умолчанию: None
|
|
smb_properties
|
Задает свойства файла, связанного с SMB |
|
timeout
|
Параметр времени ожидания указывается в секундах. Этот метод может выполнять несколько вызовов к службе Azure, и время ожидания будет применяться к каждому вызову по отдельности. значение по умолчанию: None
|
create_file_from_text
Создает новый файл из str/Unicode или обновляет содержимое существующего файла с помощью автоматического фрагментирования и уведомлений о ходе выполнения.
create_file_from_text(share_name, directory_name, file_name, text, encoding='utf-8', content_settings=None, metadata=None, validate_content=False, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя создаваемого или обновляемого файла. |
|
text
Обязательно
|
Текст для отправки в файл. |
|
encoding
|
Кодировка Python, используемая для преобразования текста в байты. значение по умолчанию: utf-8
|
|
content_settings
|
Объект ContentSettings, используемый для задания свойств файла. значение по умолчанию: None
|
|
metadata
|
Пары «имя-значение», связанные с файлом как метаданные. значение по умолчанию: None
|
|
validate_content
|
Если значение равно true, вычисляет хэш MD5 для каждого диапазона файла. Служба хранилища проверяет хэш содержимого, которое поступило вместе с отправленным хэшом. Это в первую очередь полезно для обнаружения битовых фрагментов в сети, если использование http вместо https, так как https (по умолчанию) уже проверяется. Обратите внимание, что этот хэш MD5 не хранится вместе с файлом. значение по умолчанию: False
|
|
file_permission
|
Разрешение файла, переносимый SDDL значение по умолчанию: None
|
|
smb_properties
|
Задает свойства файла, связанного с SMB |
|
timeout
|
Параметр времени ожидания указывается в секундах. Этот метод может выполнять несколько вызовов к службе Azure, и время ожидания будет применяться к каждому вызову по отдельности. значение по умолчанию: None
|
create_permission_for_share
Создайте разрешение (дескриптор безопасности) на уровне общей папки. Это разрешение можно использовать для файлов и каталогов в общей папке. Если "разрешение" уже существует, оно должно вернуть его ключ, в противном случае создает новое разрешение на уровне общей папки и возвращает свой ключ.
:возвращает ключ разрешения файла :rtype str
create_permission_for_share(share_name, file_permission, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя общей папки. |
|
file_permission
Обязательно
|
Разрешение на файл, переносимый SDDL |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
create_share
Создает новую общую папку в указанной учетной записи. Если общая папка с тем же именем уже существует, операция в службе завершается сбоем. По умолчанию исключение поглощается клиентом. Чтобы предоставить исключение, укажите значение True для fail_on_exists.
create_share(share_name, metadata=None, quota=None, fail_on_exist=False, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя создаваемой общей папки. |
|
metadata
|
Дикт с name_value парами для связывания с общим ресурсом в качестве метаданных. Пример:{'Category':'test'} значение по умолчанию: None
|
|
quota
|
Задает максимальный размер общего ресурса в ГБ. Значение должно быть больше 0 и меньше или равно 5 ТБ (5120). значение по умолчанию: None
|
|
fail_on_exist
|
Укажите, следует ли создавать исключение при наличии общего ресурса. Значение по умолчанию: false. значение по умолчанию: False
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
True, если общий ресурс создан, false, если общий ресурс уже существует. |
delete_directory
Удаляет указанный пустой каталог. Обратите внимание, что каталог должен быть пустым, перед тем как его можно будет удалить. Попытка удалить каталоги, которые не являются пустыми, завершится ошибкой.
Если каталог не существует, операция в службе завершается сбоем. По умолчанию исключение поглощается клиентом. Чтобы предоставить исключение, укажите значение True для fail_not_exist.
delete_directory(share_name, directory_name, fail_not_exist=False, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Имя удаляемого каталога, включая путь к родительскому каталогу. |
|
fail_not_exist
|
Укажите, следует ли создавать исключение, если каталог не существует. значение по умолчанию: False
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Значение true, если каталог удален, в противном случае — false. |
delete_file
Помечает указанный файл для удаления. Позже файл удаляется во время сборки мусора.
delete_file(share_name, directory_name, file_name, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
delete_share
Помечает указанный общий ресурс для удаления. Если общая папка не существует, операция в службе завершается сбоем. По умолчанию исключение поглощается клиентом. Чтобы предоставить исключение, укажите значение True для fail_not_exist.
delete_share(share_name, fail_not_exist=False, timeout=None, snapshot=None, delete_snapshots=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя удаляемого общего ресурса. |
|
fail_not_exist
|
Укажите, следует ли создавать исключение, если общая папка не существует. Значение по умолчанию: false. значение по умолчанию: False
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. Укажите этот аргумент, чтобы удалить только определенный snapshot. delete_snapshots должно иметь значение None, если он указан. значение по умолчанию: None
|
|
delete_snapshots
|
Чтобы удалить общую папку с моментальными снимками, ее необходимо указать как DeleteSnapshot.Include. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Значение true, если общий ресурс удален, общая папка false не существует. |
exists
Возвращает логическое значение, указывающее, существует ли общая папка, если задано только имя общей папки. Если directory_name задано, возвращается логическое значение, указывающее, существует ли каталог. Если также указан file_name, возвращается логическое значение, указывающее, существует ли файл.
exists(share_name, directory_name=None, file_name=None, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя общей папки. |
|
directory_name
|
Путь к каталогу. значение по умолчанию: None
|
|
file_name
|
Имя файла. значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Логическое значение, указывающее, существует ли ресурс. |
generate_account_shared_access_signature
Создает подписанный URL-адрес для файловой службы. Используйте возвращенную подпись с параметром sas_token FileService.
generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)Параметры
| Имя | Описание |
|---|---|
|
resource_types
Обязательно
|
<xref:ResourceTypes>
Указывает типы ресурсов, доступные с помощью SAS учетной записи. |
|
permission
Обязательно
|
<xref:AccountPermissions>
Разрешения, связанные с подписанным URL-адресом. Пользователь может выполнять только операции, допускаемые этими разрешениями. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа. |
|
expiry
Обязательно
|
Время, когда подписанный URL-адрес становится недействительным. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC. |
|
start
|
Время, когда подписанный URL-адрес становится действительным. Если не указано, то время начала для данного вызова считается временем, когда служба хранилища получает запрос. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC. значение по умолчанию: None
|
|
ip
|
Указывает IP-адрес или диапазон IP-адресов, с которых будут приниматься запросы. Если IP-адрес, с которого исходит запрос, не соответствует IP-адресу или диапазону адресов, указанным в маркере SAS, запрос не проходит проверку подлинности. Например, указание sip=168.1.5.65 или sip=168.1.5.60-168.1.5.70 в SAS ограничивает запрос этими IP-адресами. значение по умолчанию: None
|
|
protocol
|
Указывает протокол, разрешенный для выполненного запроса. Возможные значения: HTTPS и HTTP (https,http) или ТОЛЬКО HTTPS (https). Значение по умолчанию — https,http. Обратите внимание, что использовать только протокол HTTP нельзя. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Маркер подписанного URL-адреса (SAS). |
generate_file_shared_access_signature
Создает подписанный URL-адрес для файла. Используйте возвращенную сигнатуру с параметром sas_token FileService.
generate_file_shared_access_signature(share_name, directory_name=None, file_name=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя общей папки. |
|
directory_name
|
Имя каталога. Маркеры SAS невозможно создать для каталогов, поэтому этот параметр должен присутствовать только в том случае, если указан file_name. значение по умолчанию: None
|
|
file_name
|
Имя файла. значение по умолчанию: None
|
|
permission
|
Разрешения, связанные с подписанным URL-адресом. Пользователь может выполнять только операции, допускаемые этими разрешениями. Разрешения должны быть упорядочены для чтения, создания, записи, удаления, списка. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа. значение по умолчанию: None
|
|
expiry
|
Время, когда подписанный URL-адрес становится недействительным. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC. значение по умолчанию: None
|
|
start
|
Время, когда подписанный URL-адрес становится действительным. Если не указано, то время начала для данного вызова считается временем, когда служба хранилища получает запрос. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC. значение по умолчанию: None
|
|
id
|
Уникальное значение длиной до 64 символов, которое соответствует хранимой политике доступа. Чтобы создать хранимую политику доступа, используйте set_file_service_properties. значение по умолчанию: None
|
|
ip
|
Указывает IP-адрес или диапазон IP-адресов, с которых будут приниматься запросы. Если IP-адрес, с которого исходит запрос, не соответствует IP-адресу или диапазону адресов, указанным в маркере SAS, запрос не проходит проверку подлинности. Например, указание sip=168.1.5.65 или sip=168.1.5.60-168.1.5.70 в SAS ограничивает запрос этими IP-адресами. значение по умолчанию: None
|
|
protocol
|
Указывает протокол, разрешенный для выполненного запроса. Возможные значения: HTTPS и HTTP (https,http) или ТОЛЬКО HTTPS (https). Значение по умолчанию — https,http. Обратите внимание, что использовать только протокол HTTP нельзя. значение по умолчанию: None
|
|
cache_control
|
Значение заголовка ответа для Cache-Control при обращении к ресурсу с помощью этой подписанной URL-адреса. значение по умолчанию: None
|
|
content_disposition
|
Значение заголовка ответа для Content-Disposition при доступе к ресурсу с помощью этой подписанной URL-адреса. значение по умолчанию: None
|
|
content_encoding
|
Значение заголовка ответа для Content-Encoding при доступе к ресурсу с помощью этой подписанной URL-адреса. значение по умолчанию: None
|
|
content_language
|
Значение заголовка ответа для Content-Language при доступе к ресурсу с помощью этой подписанной URL-адреса. значение по умолчанию: None
|
|
content_type
|
Значение заголовка ответа для Content-Type при доступе к ресурсу с помощью этой подписанной URL-адреса. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Маркер подписанного URL-адреса (SAS). |
generate_share_shared_access_signature
Создает подписанный URL-адрес для общей папки. Используйте возвращенную сигнатуру с параметром sas_token FileService.
generate_share_shared_access_signature(share_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя общей папки. |
|
permission
|
Разрешения, связанные с подписанным URL-адресом. Пользователь может выполнять только операции, допускаемые этими разрешениями. Разрешения должны быть упорядочены для чтения, создания, записи, удаления, списка. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа. значение по умолчанию: None
|
|
expiry
|
Время, когда подписанный URL-адрес становится недействительным. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC. значение по умолчанию: None
|
|
start
|
Время, когда подписанный URL-адрес становится действительным. Если не указано, то время начала для данного вызова считается временем, когда служба хранилища получает запрос. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC. значение по умолчанию: None
|
|
id
|
Уникальное значение длиной до 64 символов, которое соответствует хранимой политике доступа. Чтобы создать хранимую политику доступа, используйте .set_share_acl значение по умолчанию: None
|
|
ip
|
Указывает IP-адрес или диапазон IP-адресов, с которых будут приниматься запросы. Если IP-адрес, с которого исходит запрос, не соответствует IP-адресу или диапазону адресов, указанным в маркере SAS, запрос не проходит проверку подлинности. Например, указание sip=168.1.5.65 или sip=168.1.5.60-168.1.5.70 в SAS ограничивает запрос этими IP-адресами. значение по умолчанию: None
|
|
protocol
|
Указывает протокол, разрешенный для выполненного запроса. Возможные значения: HTTPS и HTTP (https,http) или ТОЛЬКО HTTPS (https). Значение по умолчанию — https,http. Обратите внимание, что использовать только протокол HTTP нельзя. значение по умолчанию: None
|
|
cache_control
|
Значение заголовка ответа для Cache-Control при обращении к ресурсу с помощью этой подписанной URL-адреса. значение по умолчанию: None
|
|
content_disposition
|
Значение заголовка ответа для Content-Disposition при доступе к ресурсу с помощью этой подписанной URL-адреса. значение по умолчанию: None
|
|
content_encoding
|
Значение заголовка ответа для Content-Encoding при доступе к ресурсу с помощью этой подписанной URL-адреса. значение по умолчанию: None
|
|
content_language
|
Значение заголовка ответа для Content-Language при доступе к ресурсу с помощью этой подписанной URL-адреса. значение по умолчанию: None
|
|
content_type
|
Значение заголовка ответа для Content-Type при доступе к ресурсу с помощью этой подписанной URL-адреса. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Маркер подписанного URL-адреса (SAS). |
get_directory_metadata
Возвращает все определяемые пользователем метаданные для указанного каталога.
get_directory_metadata(share_name, directory_name, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Словарь, представляющий имя метаданных каталога и пары значений. |
get_directory_properties
Возвращает все определяемые пользователем метаданные и системные свойства для указанного каталога. Возвращаемые данные не включают список файлов каталога.
get_directory_properties(share_name, directory_name, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к существующему каталогу. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
свойства для указанного каталога в объекте каталога. |
get_file_metadata
Возвращает все определяемые пользователем метаданные для указанного файла.
get_file_metadata(share_name, directory_name, file_name, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Словарь, представляющий имя метаданных файла и пары значений. |
get_file_properties
Возвращает все определяемые пользователем метаданные, стандартные свойства HTTP и системные свойства для файла. Возвращает экземпляр с FileFileProperties и словарем метаданных.
get_file_properties(share_name, directory_name, file_name, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
объект файла, включающий свойства и метаданные. |
get_file_service_properties
Возвращает свойства файловой службы учетной записи хранения, включая Аналитика Службы хранилища Azure.
get_file_service_properties(timeout=None)Параметры
| Имя | Описание |
|---|---|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Свойства файловой службы. |
get_file_to_bytes
Скачивает файл в виде массива байтов с автоматическим фрагментированием и уведомлениями о ходе выполнения. Возвращает экземпляр со File свойствами, метаданными и содержимым.
get_file_to_bytes(share_name, directory_name, file_name, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
start_range
|
Начало диапазона байтов, используемого для скачивания раздела файла. Если end_range не задано, будут загружены все байты после start_range. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. значение по умолчанию: None
|
|
end_range
|
Конец диапазона байтов, используемый для скачивания раздела файла. Если задано end_range, необходимо указать start_range. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. значение по умолчанию: None
|
|
validate_content
|
Если задано значение true, проверяет хэш MD5 для каждой извлеченной части файла. Это в первую очередь полезно для обнаружения битовых фрагментов в сети, если использование http вместо https, так как https (по умолчанию) уже проверяется. Обратите внимание, что служба будет возвращать транзакционные md5s только для блоков размером 4 МБ или меньше, поэтому первый запрос на получение будет иметь собственный размер. MAX_CHUNK_GET_SIZE вместо себя. MAX_SINGLE_GET_SIZE. Если self. MAX_CHUNK_GET_SIZE задано значение больше 4 МБ, будет выдана ошибка. Так как вычисление MD5 занимает время обработки и потребуется выполнить больше запросов из-за уменьшения размера блока, задержка может быть увеличена. значение по умолчанию: False
|
|
progress_callback
|
<xref:func>(<xref:current>, <xref:total>)
Обратный вызов для выполнения с функцией сигнатуры (current, total), где current — это количество переданных байтов, а total — это размер файла, если он известен. значение по умолчанию: None
|
|
max_connections
|
Если задано значение 2 или больше, для первого экземпляра будет выполнено начальное получение. MAX_SINGLE_GET_SIZE байтов файла. Если это весь файл, метод возвращает на этом этапе. Если это не так, он скачивает оставшиеся данные параллельно, используя количество потоков, равное max_connections. Каждый блок будет иметь размер self. MAX_CHUNK_GET_SIZE. Если задано значение 1, будет выполнен один большой запрос на получение. Как правило, это не рекомендуется, но доступно, если необходимо использовать очень мало потоков, сетевые запросы являются очень дорогими или поток без поиска предотвращает параллельную загрузку. Это также может быть полезно, если файл одновременно изменяется для обеспечения атомарности или если ожидается, что многие файлы будут пустыми, так как для пустых файлов требуется дополнительный запрос, если max_connections больше 1. значение по умолчанию: 2
|
|
timeout
|
Параметр времени ожидания указывается в секундах. Этот метод может выполнять несколько вызовов к службе Azure, и время ожидания будет применяться к каждому вызову по отдельности. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Файл со свойствами, содержимым и метаданными. |
get_file_to_path
Загружает файл в путь к файлу с автоматическим фрагментированием и уведомлениями о ходе выполнения. Возвращает экземпляр файла со свойствами и метаданными.
get_file_to_path(share_name, directory_name, file_name, file_path, open_mode='wb', start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
file_path
Обязательно
|
Путь к файлу для записи. |
|
open_mode
|
Режим, используемый при открытии файла. Обратите внимание, что указание только добавления open_mode предотвращает параллельную загрузку. Таким образом, max_connections необходимо задать значение 1, если используется этот open_mode. значение по умолчанию: wb
|
|
start_range
|
Начало диапазона байтов, используемого для скачивания раздела файла. Если end_range не задано, скачиваются все байты после start_range. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. значение по умолчанию: None
|
|
end_range
|
Конец диапазона байтов, используемый для скачивания раздела файла. Если задано end_range, необходимо указать start_range. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. значение по умолчанию: None
|
|
validate_content
|
Если задано значение true, проверяет хэш MD5 для каждой извлеченной части файла. Это в первую очередь полезно для обнаружения битовых слипов в проводе, если использование http вместо https, так как https (по умолчанию) уже проверяется. Обратите внимание, что служба будет возвращать транзакционные MD5 только для блоков размером 4 МБ или меньше, поэтому первый запрос на получение будет иметь размер самостоятельно. MAX_CHUNK_GET_SIZE вместо себя. MAX_SINGLE_GET_SIZE. Если самостоятельно. MAX_CHUNK_GET_SIZE задано значение больше 4 МБ, возникает ошибка. Поскольку вычисление MD5 занимает время обработки и потребуется выполнить больше запросов из-за уменьшения размера блока, задержка может увеличиться. значение по умолчанию: False
|
|
progress_callback
|
<xref:func>(<xref:current>, <xref:total>)
Обратный вызов для выполнения с функцией сигнатуры (current, total), где current — это количество переданных байтов, а total — это размер файла, если он известен. значение по умолчанию: None
|
|
max_connections
|
Если задано значение 2 или больше, для первого экземпляра будет выполнено начальное получение. MAX_SINGLE_GET_SIZE байтов файла. Если это весь файл, метод возвращает на этом этапе. Если это не так, он будет скачивать оставшиеся данные параллельно, используя количество потоков, равное max_connections. Каждый кусок будет иметь размер самостоятельно. MAX_CHUNK_GET_SIZE. Если задано значение 1, будет выполнен один большой запрос на получение. Как правило, это не рекомендуется, но доступно, если следует использовать очень мало потоков, сетевые запросы являются очень дорогими или поток без поиска предотвращает параллельную загрузку. Это также может быть полезно, если файл одновременно изменяется для обеспечения атомарности или если ожидается, что многие файлы будут пустыми, так как для пустых файлов требуется дополнительный запрос, если max_connections больше 1. значение по умолчанию: 2
|
|
timeout
|
Параметр времени ожидания указывается в секундах. Этот метод может выполнять несколько вызовов службы Azure, и время ожидания будет применяться к каждому вызову по отдельности. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Файл со свойствами и метаданными. |
get_file_to_stream
Загружает файл в поток с автоматическим фрагментированием и уведомлениями о ходе выполнения. Возвращает экземпляр со File свойствами и метаданными.
get_file_to_stream(share_name, directory_name, file_name, stream, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
stream
Обязательно
|
Открыт файл или поток для записи. |
|
start_range
|
Начало диапазона байтов, используемого для скачивания раздела файла. Если end_range не задано, скачиваются все байты после start_range. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. значение по умолчанию: None
|
|
end_range
|
Конец диапазона байтов, используемый для скачивания раздела файла. Если задано end_range, необходимо указать start_range. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. значение по умолчанию: None
|
|
validate_content
|
Если задано значение true, проверяет хэш MD5 для каждой извлеченной части файла. Это в первую очередь полезно для обнаружения битовых слипов в проводе, если использование http вместо https, так как https (по умолчанию) уже проверяется. Обратите внимание, что служба будет возвращать транзакционные MD5 только для блоков размером 4 МБ или меньше, поэтому первый запрос на получение будет иметь размер самостоятельно. MAX_CHUNK_GET_SIZE вместо себя. MAX_SINGLE_GET_SIZE. Если самостоятельно. MAX_CHUNK_GET_SIZE задано значение больше 4 МБ, возникает ошибка. Поскольку вычисление MD5 занимает время обработки и потребуется выполнить больше запросов из-за уменьшения размера блока, задержка может увеличиться. значение по умолчанию: False
|
|
progress_callback
|
<xref:func>(<xref:current>, <xref:total>)
Обратный вызов для выполнения с функцией сигнатуры (current, total), где current — это количество переданных байтов, а total — это размер файла, если он известен. значение по умолчанию: None
|
|
max_connections
|
Если задано значение 2 или больше, для первого экземпляра будет выполнено начальное получение. MAX_SINGLE_GET_SIZE байтов файла. Если это весь файл, метод возвращает на этом этапе. Если это не так, он будет скачивать оставшиеся данные параллельно, используя количество потоков, равное max_connections. Каждый кусок будет иметь размер самостоятельно. MAX_CHUNK_GET_SIZE. Если задано значение 1, будет выполнен один большой запрос на получение. Как правило, это не рекомендуется, но доступно, если следует использовать очень мало потоков, сетевые запросы являются очень дорогими или поток без поиска предотвращает параллельную загрузку. Это также может быть полезно, если файл одновременно изменяется для обеспечения атомарности или если ожидается, что многие файлы будут пустыми, так как для пустых файлов требуется дополнительный запрос, если max_connections больше 1. значение по умолчанию: 2
|
|
timeout
|
Параметр времени ожидания указывается в секундах. Этот метод может выполнять несколько вызовов службы Azure, и время ожидания будет применяться к каждому вызову по отдельности. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Файл со свойствами и метаданными. |
get_file_to_text
Загружает файл в виде текста Юникода с автоматическим фрагментированием и уведомлениями о ходе выполнения. Возвращает экземпляр со File свойствами, метаданными и содержимым.
get_file_to_text(share_name, directory_name, file_name, encoding='utf-8', start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
encoding
|
Кодировка Python, используемая при декодировании данных файла. значение по умолчанию: utf-8
|
|
start_range
|
Начало диапазона байтов, используемого для скачивания раздела файла. Если end_range не задано, скачиваются все байты после start_range. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. значение по умолчанию: None
|
|
end_range
|
Конец диапазона байтов, используемый для скачивания раздела файла. Если задано end_range, необходимо указать start_range. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. значение по умолчанию: None
|
|
validate_content
|
Если задано значение true, проверяет хэш MD5 для каждой извлеченной части файла. Это в первую очередь полезно для обнаружения битовых слипов в проводе, если использование http вместо https, так как https (по умолчанию) уже проверяется. Обратите внимание, что служба будет возвращать транзакционные MD5 только для блоков размером 4 МБ или меньше, поэтому первый запрос на получение будет иметь размер самостоятельно. MAX_CHUNK_GET_SIZE вместо себя. MAX_SINGLE_GET_SIZE. Если самостоятельно. MAX_CHUNK_GET_SIZE задано значение больше 4 МБ, возникает ошибка. Поскольку вычисление MD5 занимает время обработки и потребуется выполнить больше запросов из-за уменьшения размера блока, задержка может увеличиться. значение по умолчанию: False
|
|
progress_callback
|
<xref:func>(<xref:current>, <xref:total>)
Обратный вызов для выполнения с функцией сигнатуры (current, total), где current — это количество переданных байтов, а total — это размер файла, если он известен. значение по умолчанию: None
|
|
max_connections
|
Если задано значение 2 или больше, для первого экземпляра будет выполнено начальное получение. MAX_SINGLE_GET_SIZE байтов файла. Если это весь файл, метод возвращает на этом этапе. Если это не так, он будет скачивать оставшиеся данные параллельно, используя количество потоков, равное max_connections. Каждый кусок будет иметь размер самостоятельно. MAX_CHUNK_GET_SIZE. Если задано значение 1, будет выполнен один большой запрос на получение. Как правило, это не рекомендуется, но доступно, если следует использовать очень мало потоков, сетевые запросы являются очень дорогими или поток без поиска предотвращает параллельную загрузку. Это также может быть полезно, если файл одновременно изменяется для обеспечения атомарности или если ожидается, что многие файлы будут пустыми, так как для пустых файлов требуется дополнительный запрос, если max_connections больше 1. значение по умолчанию: 2
|
|
timeout
|
Параметр времени ожидания указывается в секундах. Этот метод может выполнять несколько вызовов службы Azure, и время ожидания будет применяться к каждому вызову по отдельности. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Файл со свойствами, содержимым и метаданными. |
get_permission_for_share
Создайте разрешение (дескриптор безопасности) на уровне общего ресурса. Это разрешение можно использовать для файлов и каталогов в общей папке. Если "разрешение" уже существует, оно возвращает его ключ, в противном случае создает новое разрешение на уровне общей папки и возвращает его ключ.
:возвращает разрешение файла (переносимый SDDL) :rtype str
get_permission_for_share(share_name, file_permission_key, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя общей папки. |
|
file_permission_key
Обязательно
|
Ключ разрешения на получение файла |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
get_share_acl
Возвращает разрешения для указанной общей папки.
get_share_acl(share_name, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Словарь политик доступа, связанных с общей папкой. |
get_share_metadata
Возвращает все определяемые пользователем метаданные для указанной общей папки.
get_share_metadata(share_name, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Словарь, представляющий пары "Имя метаданных общего ресурса" и "Значение". |
get_share_properties
Возвращает все определяемые пользователем метаданные и системные свойства для указанной общей папки. Возвращаемые данные не включают список файлов или каталогов общих папок.
get_share_properties(share_name, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
Общий ресурс, предоставляющий свойства и метаданные. |
get_share_stats
Возвращает приблизительный размер данных, хранящихся в общей папке, округленный до ближайшего гигабайта.
Обратите внимание, что это значение может включать не все недавно созданные или недавно измененные файлы.
get_share_stats(share_name, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
приблизительный размер данных, хранящихся в общей папке. |
get_share_stats_in_bytes
Возвращает приблизительный размер данных, хранящихся в общей папке, в байтах.
Обратите внимание, что это значение может включать не все недавно созданные или недавно измененные файлы.
get_share_stats_in_bytes(share_name, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
приблизительный размер данных, хранящихся в общей папке. |
list_directories_and_files
Возвращает генератор для вывода списка каталогов и файлов в указанной общей папке. Генератор будет отложенно следовать маркерам продолжения, возвращенным службой, и останавливаться, когда все каталоги и файлы будут возвращены или num_results достигнут.
Если указано num_results и общая папка содержит больше указанного числа файлов и каталогов, генератор будет иметь заполненное поле next_marker после завершения. Этот маркер можно использовать для создания нового генератора, если нужны дополнительные результаты.
list_directories_and_files(share_name, directory_name=None, num_results=None, marker=None, timeout=None, prefix=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
|
Путь к каталогу. значение по умолчанию: None
|
|
num_results
|
Указывает максимальное количество возвращаемых файлов, включая все элементы каталога. Если в запросе не указано num_results или указано значение больше 5000, сервер вернет до 5000 элементов. Установка num_results значения меньше или равного нулю приводит к ошибке с кодом ответа 400 (недопустимый запрос). значение по умолчанию: None
|
|
marker
|
Непрозрачный маркер продолжения. Это значение можно получить из поля next_marker предыдущего объекта генератора, если был указан num_results и этот генератор завершил перечисление результатов. Если этот генератор указан, этот генератор начнет возвращать результаты с точки, где остановился предыдущий генератор. значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
|
prefix
|
Вывод списка только файлов и (или) каталогов с заданным префиксом. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
list_handles
Возвращает генератор для вывода списка открытых дескрипторов в каталоге или файле в указанной общей папке. Генератор будет отложенно следовать маркерам продолжения, возвращенным службой, и останавливаться при возвращении всех дескрипторов или достижении num_results.
Если указано num_results и общая папка содержит больше указанного числа файлов и каталогов, генератор будет иметь заполненное поле next_marker после завершения. Этот маркер можно использовать для создания нового генератора, если нужны дополнительные результаты.
list_handles(share_name, directory_name=None, file_name=None, recursive=None, max_results=None, marker=None, snapshot=None, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
|
Путь к каталогу. значение по умолчанию: None
|
|
file_name
|
Имя существующего файла. значение по умолчанию: None
|
|
recursive
|
Логическое значение, указывающее, должна ли операция применяться к каталогу, указанному в URI, его файлам, подкаталогам и файлам. значение по умолчанию: None
|
|
max_results
|
Указывает максимальное количество дескрипторов, принятых для возвращаемых файлов и (или) каталогов. Если в запросе не указано max_results или указано значение больше 5000, сервер вернет до 5000 элементов. Установка max_results значения меньше или равному нулю приводит к ошибке с кодом ответа 400 (недопустимый запрос). значение по умолчанию: None
|
|
marker
|
Непрозрачный маркер продолжения. Это значение можно получить из поля next_marker предыдущего объекта генератора, если было указано max_results и этот генератор завершил перечисление результатов. Если этот генератор указан, этот генератор начнет возвращать результаты с точки, где остановился предыдущий генератор. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
list_ranges
Извлекает допустимые диапазоны для файла.
list_ranges(share_name, directory_name, file_name, start_range=None, end_range=None, timeout=None, snapshot=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
start_range
|
Задает начальную смещение байтов, по которым выводится список диапазонов. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. значение по умолчанию: None
|
|
end_range
|
Указывает конечное смещение байтов, по которым перечисляются диапазоны. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
|
snapshot
|
Строка, представляющая версию snapshot, если применимо. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
список допустимых диапазонов; |
list_shares
Возвращает генератор для перечисления общих папок в указанной учетной записи. Генератор будет отложенно следовать маркерам продолжения, возвращенным службой, и останавливаться при возврате всех общих папок или достижении num_results.
Если указано num_results и в учетной записи больше, чем это количество общих папок, генератор будет иметь заполненное поле next_marker после завершения. Этот маркер можно использовать для создания нового генератора, если нужны дополнительные результаты.
list_shares(prefix=None, marker=None, num_results=None, include_metadata=False, timeout=None, include_snapshots=False)Параметры
| Имя | Описание |
|---|---|
|
prefix
|
Фильтрует результаты для возврата только общих папок, имена которых начинаются с указанного префикса. значение по умолчанию: None
|
|
num_results
|
Указывает максимальное количество возвращаемых общих ресурсов. значение по умолчанию: None
|
|
include_metadata
|
Указывает, что в ответе возвращаются метаданные общего ресурса. значение по умолчанию: False
|
|
marker
|
Непрозрачный маркер продолжения. Это значение можно получить из поля next_marker предыдущего объекта генератора, если был указан num_results и этот генератор завершил перечисление результатов. Если этот генератор указан, этот генератор начнет возвращать результаты с точки, где остановился предыдущий генератор. значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
|
include_snapshots
|
Указывает, что моментальные снимки общих ресурсов возвращаются в ответе. значение по умолчанию: False
|
make_file_url
Создает URL-адрес для доступа к файлу.
make_file_url(share_name, directory_name, file_name, protocol=None, sas_token=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя файла. |
|
protocol
|
Используемый протокол: "http" или "https". Если значение не указано, использует протокол, указанный при инициализации FileService. значение по умолчанию: None
|
|
sas_token
|
Маркер подписанного URL-адреса, созданный с помощью generate_shared_access_signature. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
URL-адрес доступа к файлу. |
resize_file
Изменяет размер файла на указанный. Если указанное байтовое значение меньше текущего размера файла, то все диапазоны свыше указанного байтового значения очищаются.
resize_file(share_name, directory_name, file_name, content_length, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
content_length
Обязательно
|
Длина, на который нужно изменить размер файла. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
set_directory_metadata
Задает одну или несколько определяемых пользователем пар "имя-значение" для указанного каталога. Каждый вызов этой операции приводит к замене всех существующих метаданных, присоединенных к каталогу. Чтобы удалить все метаданные из каталога, вызовите эту операцию без дикта метаданных.
set_directory_metadata(share_name, directory_name, metadata=None, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
metadata
|
Словарь, содержащий пары "имя-значение", которые необходимо связать с каталогом в качестве метаданных. Пример: {'category':'test'} значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
set_directory_properties
set_directory_properties(share_name, directory_name, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя общей папки |
|
directory_name
Обязательно
|
Имя каталога |
|
file_permission
|
Разрешение на файл, переносимый SDDL значение по умолчанию: None
|
|
smb_properties
|
Задает свойства файла, связанного с SMB |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
set_file_metadata
Задает определяемые пользователем метаданные для указанного файла в виде одной или нескольких пар "имя-значение".
set_file_metadata(share_name, directory_name, file_name, metadata=None, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
metadata
|
Дикт, содержащий пары имен и значений. Каждый вызов этой операции приводит к замене всех существующих метаданных, присоединенных к файлу. Чтобы удалить все метаданные из файла, вызовите эту операцию без заголовков метаданных. значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
set_file_properties
Задает системные свойства файла. Если для content_settings задано одно свойство, все свойства будут переопределены.
set_file_properties(share_name, directory_name, file_name, content_settings, timeout=None, file_permission=None, smb_properties=<azure.storage.file.models.SMBProperties object>)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
content_settings
Обязательно
|
Объект ContentSettings, используемый для задания свойств файла. |
|
file_permission
|
Разрешение на файл, переносимый SDDL значение по умолчанию: None
|
|
smb_properties
|
Задает свойства файла, связанного с SMB |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
set_file_service_properties
Задает свойства файловой службы учетной записи хранения, включая Аналитика Службы хранилища Azure. Если элемент (например, HourMetrics) остается как None, существующие параметры службы для этой функции сохраняются.
set_file_service_properties(hour_metrics=None, minute_metrics=None, cors=None, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
hour_metrics
|
<xref:Metrics>
Параметры часовых метрик предоставляют сводку статистики запросов, сгруппированных по API, в почасовых статистических выражениях для файлов. значение по умолчанию: None
|
|
minute_metrics
|
<xref:Metrics>
Параметры метрик минут предоставляют статистику запросов за каждую минуту для файлов. значение по умолчанию: None
|
|
cors
|
list(CorsRule)
В список можно включить до пяти элементов CorsRule. Если указан пустой список, все правила CORS будут удалены, а CORS будет отключен для службы. значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
set_share_acl
Задает разрешения для указанной общей папки или хранимых политик доступа, которые могут использоваться с подписанными URL-адресами.
set_share_acl(share_name, signed_identifiers=None, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
signed_identifiers
|
dict(str, AccessPolicy)
Словарь политик доступа, которые необходимо связать с общей папкой. Словарь может содержать до 5 элементов. Пустой словарь очистит политики доступа, заданные в службе. значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
set_share_metadata
Задает одну или несколько определяемых пользователем пар "имя-значение" для указанной общей папки. Каждый вызов этой операции приводит к замене всех существующих метаданных, присоединенных к общему ресурсу. Чтобы удалить все метаданные из общей папки, вызовите эту операцию без диктовки метаданных.
set_share_metadata(share_name, metadata=None, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
metadata
|
Дикт, содержащий пары "имя-значение", которые необходимо связать с общей папкой в качестве метаданных. Пример: {'category':'test'} значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
set_share_properties
Задает определяемые службой свойства для указанной общей папки.
set_share_properties(share_name, quota, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
quota
Обязательно
|
Задает максимальный размер общего ресурса в ГБ. Значение должно быть больше 0 и меньше или равно 5 ТБ (5120 ГБ). |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
snapshot_share
Создает snapshot существующей общей папки в указанной учетной записи.
snapshot_share(share_name, metadata=None, quota=None, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя общей папки для создания snapshot. |
|
metadata
|
<xref:<xref:a dict> of <xref:str to str:>>
Диктовка с name_value парами для связывания с общей папкой в качестве метаданных. Пример:{'Category':'test'} значение по умолчанию: None
|
|
quota
|
Задает максимальный размер общего ресурса в ГБ. Значение должно быть больше 0 и меньше или равно 5 ТБ (5120). значение по умолчанию: None
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
Возвращаемое значение
| Тип | Описание |
|---|---|
|
свойства snapshot |
update_range
Записывает байты, указанные текстом запроса, в указанный диапазон.
update_range(share_name, directory_name, file_name, data, start_range, end_range, validate_content=False, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
data
Обязательно
|
Содержимое диапазона. |
|
start_range
Обязательно
|
Начало диапазона байтов, используемого для обновления раздела файла. Размер диапазона может составлять до 4 МБ. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. |
|
end_range
Обязательно
|
Конец диапазона байтов, используемый для обновления раздела файла. Размер диапазона может составлять до 4 МБ. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. |
|
validate_content
|
Если значение равно true, вычисляет md5-хэш содержимого страницы. Служба хранилища проверяет хэш отправленного содержимого. Это в первую очередь полезно для обнаружения битовых слипов в проводе, если использование http вместо https, так как https (по умолчанию) уже проверяется. Обратите внимание, что этот хэш MD5 не хранится вместе с файлом. значение по умолчанию: False
|
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
update_range_from_file_url
Записывает байты из одной конечной точки файла Azure в указанный диапазон другой конечной точки файла Azure.
update_range_from_file_url(share_name, directory_name, file_name, start_range, end_range, source, source_start_range, timeout=None)Параметры
| Имя | Описание |
|---|---|
|
share_name
Обязательно
|
Имя существующей общей папки. |
|
directory_name
Обязательно
|
Путь к каталогу. |
|
file_name
Обязательно
|
Имя существующего файла. |
|
start_range
Обязательно
|
Начало диапазона байтов, используемого для обновления раздела файла. Размер диапазона может составлять до 4 МБ. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. |
|
end_range
Обязательно
|
Конец диапазона байтов, используемый для обновления раздела файла. Размер диапазона может составлять до 4 МБ. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. |
|
source
Обязательно
|
URL-адрес длиной до 2 КБ, указывающий файл или большой двоичный объект Azure. Значение должно быть закодировано в URL-адресе в том виде, в каком оно указано в запросе URI. Если источник находится в другой учетной записи, источник должен быть общедоступным или пройти проверку подлинности с помощью подписанного URL-адреса. Если источник является общедоступным, проверка подлинности не требуется. Примеры: https://myaccount.file.core.windows.net/myshare/mydir/myfilehttps://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken |
|
source_start_range
Обязательно
|
Начало диапазона байтов, используемого для обновления раздела файла. Размер диапазона может составлять до 4 МБ. Параметры start_range и end_range являются инклюзивными. Например, start_range=0, end_range=511 скачает первые 512 байт файла. |
|
timeout
|
Параметр времени ожидания указывается в секундах. значение по умолчанию: None
|
Атрибуты
MAX_CHUNK_GET_SIZE
MAX_CHUNK_GET_SIZE = 8388608MAX_RANGE_SIZE
MAX_RANGE_SIZE = 4194304MAX_SINGLE_GET_SIZE
MAX_SINGLE_GET_SIZE = 33554432
Azure SDK for Python
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по