Поделиться через


blob Пакет

Пакеты

aio

Классы

AccessPolicy

Класс Access Policy, используемый методом set, и get политики доступа в каждой службе.

Хранимая политика доступа может задавать время начала, время окончания и разрешения для подписей коллективного доступа, с которыми она сопоставлена. В зависимости от того, как вы хотите управлять доступом к ресурсу, можно указать все эти параметры в хранимой политике доступа и опустить их в URL-адресе подписанного URL-адреса. Это позволяет изменить поведение связанной подписи в любое время, а также отменить ее. Или же вы можете указать один или несколько параметров в политике доступа, а остальные указать в URL-адресе. И наконец, вы можете указать все параметры в URL-адресе. В этом случае хранимую политику доступа можно использовать для отмены подписи, но не для изменения поведения подписи.

Подпись общего доступа и хранимая политика доступа должны включать все поля, необходимые для проверки подлинности подписи. Если какие-либо обязательные поля отсутствуют, то запрос завершится ошибкой. Аналогично, если поле указано и в подписанном URL-адресе, и в хранимой политике доступа, запрос завершится ошибкой с кодом состояния 400 (неправильный запрос).

AccountSasPermissions

ResourceTypes класс для использования с функцией generate_account_sas и для AccessPolicies, используемых с set_*_acl. Существует два типа SAS, которые можно использовать для предоставления доступа к ресурсам. Один из них заключается в предоставлении доступа к определенному ресурсу (конкретному ресурсу). Другой — предоставить доступ ко всей службе для определенной учетной записи и разрешить определенные операции на основе perms, найденных здесь.

ArrowDialect

поле схемы со стрелками.

Для отправки в Azure необходимо заполнить все необходимые параметры.

BlobAnalyticsLogging

Параметры ведения журнала Azure Analytics.

BlobBlock

Класс BlockBlob Block.

BlobClient

Клиент для взаимодействия с определенным BLOB-объектом, хотя этот BLOB-объект может еще не существовать.

Дополнительные сведения о настройке см. здесь.

BlobLeaseClient

Создает объект BlobLeaseClient.

Этот клиент предоставляет операции аренды blobClient или ContainerClient.

BlobPrefix

Итерируемый объект свойств BLOB-объекта.

Возвращается из walk_blobs при использовании разделителя. Можно рассматривать как виртуальный каталог BLOB-объектов.

BlobProperties

Свойства BLOB-объекта.

BlobQueryError

Ошибка произошла во время операции быстрого запроса.

BlobQueryReader

Объект потоковой передачи для чтения результатов запроса.

BlobSasPermissions

Класс BlobSasPermissions, используемый с функцией generate_blob_sas .

BlobServiceClient

Клиент для взаимодействия со Службой BLOB-объектов на уровне учетной записи.

Этот клиент предоставляет операции для получения и настройки свойств учетной записи, а также перечисления, создания и удаления контейнеров в учетной записи. Для операций, связанных с определенным контейнером или большим двоичным объектом, клиенты для этих сущностей также можно получить с помощью функций get_client .

Дополнительные сведения о настройке см. здесь.

ContainerClient

Клиент для взаимодействия с определенным контейнером, хотя этот контейнер может еще не существовать.

Для операций, связанных с определенным BLOB-объектом в этом контейнере, клиент BLOB-объекта можно получить с помощью get_blob_client функции .

Дополнительные сведения о настройке см. здесь.

ContainerEncryptionScope

Конфигурация шифрования по умолчанию область для контейнера.

Этот область используется неявно для всех будущих операций записи в контейнере, но может быть переопределен для каждой операции с большим двоичным объектом.

Новые возможности в версии 12.2.0.

ContainerProperties

Класс свойств контейнера BLOB-объектов.

Возвращаемые ContainerProperties экземпляры предоставляют эти значения через интерфейс словаря, например container_props["last_modified"]: . Кроме того, имя контейнера доступно как container_props["name"].

ContainerSasPermissions

Класс ContainerSasPermissions для использования с функцией generate_container_sas и для AccessPolicies, используемых с set_container_access_policy.

ContentSettings

Параметры содержимого большого двоичного объекта.

CopyProperties

Свойства копирования BLOB-объектов.

Эти свойства будут иметь значение None , если этот BLOB-объект никогда не был назначением в операции копирования BLOB-объекта или если этот BLOB-объект был изменен после завершения операции копирования BLOB-объекта, например с помощью команды Задать свойства BLOB-объекта, Отправить BLOB-объект или Зафиксировать список блокировок.

CorsRule

CORS является функцией HTTP, которая позволяет веб-приложению, работающему в одном домене, обращаться к ресурсам из другого домена. Веб-браузеры имеют ограничение безопасности под названием политика одного источника, которое не позволяет веб-странице вызывать API из других доменов. CORS обеспечивают безопасный способ, с помощью которого один домен (исходный домен) может вызывать API из другого домена.

CustomerProvidedEncryptionKey

Все данные в службе хранилища Azure шифруются при хранении с помощью ключа шифрования на уровне учетной записи. В версиях 2018-06-17 и более поздних можно управлять ключом, используемым для шифрования содержимого BLOB-объектов и метаданных приложения для каждого BLOB-объекта, предоставляя ключ шифрования AES-256 в запросах к службе хранилища.

При использовании ключа, предоставленного клиентом, служба хранилища Azure не управляет ключом и не сохраняет его. При записи данных в большой двоичный объект указанный ключ используется для шифрования данных перед их записью на диск. Хэш SHA-256 ключа шифрования записывается вместе с содержимым большого двоичного объекта и используется для проверки того, что все последующие операции с большим двоичным объектом используют один и тот же ключ шифрования. Этот хэш нельзя использовать для извлечения ключа шифрования или расшифровки содержимого большого двоичного объекта. При чтении большого двоичного объекта указанный ключ используется для расшифровки данных после их чтения с диска. В обоих случаях указанный ключ шифрования безопасно отбрасывается сразу после завершения процесса шифрования или расшифровки.

DelimitedJsonDialect

Определяет сериализацию входных или выходных данных JSON для запроса данных BLOB-объекта.

ключевое слово разделитель str: символ разделителя строк, значение по умолчанию — '

'

DelimitedTextDialect

Определяет сериализацию входных или выходных данных с разделителями (CSV) для запроса к BLOB-объекту.

ExponentialRetry

Экспоненциальная повторная попытка.

Создает объект экспоненциальной попытки. Для первой попытки используется initial_backoff. Последующие повторные попытки повторяются через initial_backoff + increment_power^retry_count секунд.

FilteredBlob

Сведения о большом двоичном объекте из вызова API фильтрации BLOB-объектов.

ImmutabilityPolicy

Необязательные параметры для настройки политики неизменяемости большого двоичного объекта, snapshot blob-объекта или версии BLOB-объекта.

Новые возможности в версии 12.10.0: эта версия появилась в API версии 2020-10-02.

LeaseProperties

Свойства аренды BLOB-объектов.

LinearRetry

Линейная повторная попытка.

Создает объект linear retry.

LocationMode

Указывает расположение, в которое должен быть отправлен запрос. Этот режим применяется только к учетным записям RA-GRS, которые разрешают вторичный доступ на чтение. Все остальные типы учетных записей должны использовать PRIMARY.

Metrics

Сводка статистики запросов, сгруппированных по API в статистических выражениях по часам или минутам для больших двоичных объектов.

ObjectReplicationPolicy

Идентификаторы политики и правила, применяемые к большому двоичному объекту.

ObjectReplicationRule

Идентификаторы политики и правила, применяемые к большому двоичному объекту.

PageRange

Диапазон страниц для страничного BLOB-объекта.

PartialBatchErrorException

В пакетных операциях произошел частичный сбой.

ResourceTypes

Указывает типы ресурсов, доступные с помощью SAS учетной записи.

RetentionPolicy

Политика хранения, которая определяет, как долго должны храниться связанные данные.

StaticWebsite

Свойства, позволяющие учетной записи размещать статический веб-сайт.

StorageStreamDownloader

Объект потоковой передачи для скачивания из службы хранилища Azure.

UserDelegationKey

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

Поля сохраняются в виде простых строк, так как пользователю не нужно взаимодействовать с этим объектом; Чтобы создать SAS для идентификации, пользователь может просто передать его в нужный API.

Перечисления

ArrowType
BlobImmutabilityPolicyMode

Указывает режим политики неизменяемости для большого двоичного объекта. "Mutable" может быть возвращен только службой, не устанавливайте значение "Mutable".

BlobType
BlockState

Типы блоков блочных BLOB-объектов.

PremiumPageBlobTier

Указывает уровень страничного BLOB-объекта, на который следует задать большой двоичный объект. Это применимо только к страничные BLOB-объекты в учетных записях хранения класса Premium. Ознакомьтесь с подробными сведениями о соответствующих операций https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets ввода-вывода в секунду и пропускной способности для PageBlobTier.

PublicAccess

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

QuickQueryDialect

Указывает диалект быстрого запроса для ввода-вывода.

RehydratePriority

Если объект находится в состоянии ожидания восстановления, этот заголовок возвращается с приоритетом rehydrate. Допустимые значения: High и Standard.

SequenceNumberAction

Действия с порядкового номера.

StandardBlobTier

Указывает уровень BLOB-объекта, на который следует задать большой двоичный объект. Это применимо только для блочных BLOB-объектов в учетных записях хранения уровня "Стандартный".

StorageErrorCode

Функции

download_blob_from_url

Скачайте содержимое большого двоичного объекта в локальный файл или поток.

download_blob_from_url(blob_url: str, output: str, credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> None

Параметры

blob_url
str
Обязательно

Полный универсальный код ресурса (URI) большого двоичного объекта. Сюда также может входить маркер SAS.

output
str или <xref:<xref:writable stream.>>
Обязательно

Куда следует скачать данные. Это может быть либо путь к файлу для записи, либо открытый дескриптор ввода-вывода для записи.

credential
значение по умолчанию: None

Учетные данные для проверки подлинности. Это необязательно, если URL-адрес большого двоичного объекта уже содержит маркер SAS или большой двоичный объект является общедоступным. Это может быть строка маркера SAS, экземпляр AzureSasCredential или AzureNamedKeyCredential из azure.core.credentials, общий ключ доступа учетной записи или экземпляр класса TokenCredentials из azure.identity. Если URI ресурса уже содержит маркер SAS, он будет игнорироваться в пользу явных учетных данных.

  • за исключением случаев AzureSasCredential, где конфликтующие маркеры SAS вызовут ValueError. При использовании экземпляра AzureNamedKeyCredential "name" должно быть именем учетной записи хранения, а "key" — ключом учетной записи хранения.
overwrite
bool

Следует ли перезаписывать локальный файл, если он уже существует. Значение по умолчанию — False . В этом случае будет создано значение ValueError, если файл уже существует. Если задано значение True, будет предпринята попытка записи в существующий файл. Если передается дескриптор потока, это значение игнорируется.

max_concurrency
int

Количество параллельных подключений, с помощью которых требуется скачать.

offset
int

Начало диапазона байтов, используемого для скачивания раздела большого двоичного объекта. Должен быть задан, если указана длина.

length
int

Число байтов, считываемых из потока. Это необязательный параметр, но его необходимо предоставить для оптимальной производительности.

validate_content
bool

Если значение равно true, вычисляет хэш MD5 для каждого блока большого двоичного объекта. Служба хранилища проверяет хэш содержимого, которое поступило вместе с отправленным хэшом. Это в первую очередь полезно для обнаружения битовых фрагментов в сети, если использование http вместо https, так как https (по умолчанию) уже проверяется. Учтите, что этот хэш MD5 не сохраняется в большом двоичном объекте. Кроме того, обратите внимание, что если этот параметр включен, алгоритм отправки с эффективным использованием памяти не будет использоваться, так как для вычисления хэша MD5 требуется буферизация целых блоков, и это приведет к поражению цели алгоритма, эффективного в памяти.

Возвращаемый тип

generate_account_sas

Создает подписанный URL-адрес для службы BLOB-объектов.

Используйте возвращенную подпись с параметром учетных данных любого BlobServiceClient, ContainerClient или BlobClient.

generate_account_sas(account_name: str, account_key: str, resource_types: ResourceTypes | str, permission: AccountSasPermissions | str, expiry: datetime | str | None, start: datetime | str | None = None, ip: str | None = None, **kwargs: Any) -> str

Параметры

account_name
str
Обязательно

Имя учетной записи хранения, используемое для создания подписанного URL-адреса.

account_key
str
Обязательно

Ключ учетной записи, также называемый общим ключом или ключом доступа, для создания подписанного URL-адреса.

resource_types
str или ResourceTypes
Обязательно

Указывает типы ресурсов, доступные с помощью SAS учетной записи.

permission
str или AccountSasPermissions
Обязательно

Разрешения, связанные с подписанным URL-адресом. Пользователь может выполнять только операции, допускаемые этими разрешениями. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа.

expiry
datetime или str
Обязательно

Время, когда подписанный URL-адрес становится недействительным. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC.

start
datetime или str
значение по умолчанию: None

Время, когда подписанный URL-адрес становится действительным. Если не указано, то время начала для данного вызова считается временем, когда служба хранилища получает запрос. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC.

ip
str
значение по умолчанию: None

Указывает IP-адрес или диапазон IP-адресов, с которых будут приниматься запросы. Если IP-адрес, с которого исходит запрос, не соответствует IP-адресу или диапазону адресов, указанным в маркере SAS, запрос не проходит проверку подлинности. Например, если указать ip=168.1.5.65 или ip=168.1.5.60-168.1.5.70 в SAS, запрос будет ограничен этими IP-адресами.

protocol
str

Указывает протокол, разрешенный для выполненного запроса. Значение по умолчанию — https.

encryption_scope
str

Указывает область шифрования для запроса, выполненного таким образом, чтобы все операции записи были зашифрованы службой.

Возвращаемое значение

Маркер подписанного URL-адреса (SAS).

Возвращаемый тип

str

generate_blob_sas

Создает подписанный URL-адрес для большого двоичного объекта.

Используйте возвращенную подпись с параметром учетных данных любого BlobServiceClient, ContainerClient или BlobClient.

generate_blob_sas(account_name: str, container_name: str, blob_name: str, snapshot: str | None = None, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: BlobSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Параметры

account_name
str
Обязательно

Имя учетной записи хранения, используемое для создания подписанного URL-адреса.

container_name
str
Обязательно

Имя контейнера.

blob_name
str
Обязательно

Имя большого двоичного объекта.

snapshot
str
значение по умолчанию: None

Необязательный идентификатор snapshot BLOB-объекта.

account_key
str
значение по умолчанию: None

Ключ учетной записи, также называемый общим ключом или ключом доступа, для создания подписанного URL-адреса. Необходимо указать account_key или user_delegation_key .

user_delegation_key
UserDelegationKey
значение по умолчанию: None

Вместо общего ключа учетной записи пользователь может передать ключ делегирования пользователя. Ключ делегирования пользователя можно получить из службы путем проверки подлинности с помощью удостоверения AAD; Для этого можно вызвать метод get_user_delegation_key. При наличии SAS подписывается с помощью ключа делегирования пользователя.

permission
str или BlobSasPermissions
значение по умолчанию: None

Разрешения, связанные с подписанным URL-адресом. Пользователь может выполнять только операции, допускаемые этими разрешениями. Разрешения должны быть упорядочены racwdxytmei. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа.

expiry
datetime или str
значение по умолчанию: None

Время, когда подписанный URL-адрес становится недействительным. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC.

start
datetime или str
значение по умолчанию: None

Время, когда подписанный URL-адрес становится действительным. Если не указано, то время начала для данного вызова считается временем, когда служба хранилища получает запрос. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC.

policy_id
str
значение по умолчанию: None

Уникальное значение длиной до 64 символов, которое соответствует хранимой политике доступа. Чтобы создать хранимую политику доступа, используйте .set_container_access_policy

ip
str
значение по умолчанию: None

Указывает IP-адрес или диапазон IP-адресов, с которых будут приниматься запросы. Если IP-адрес, с которого исходит запрос, не соответствует IP-адресу или диапазону адресов, указанным в маркере SAS, запрос не проходит проверку подлинности. Например, если указать ip=168.1.5.65 или ip=168.1.5.60-168.1.5.70 в SAS, запрос будет ограничен этими IP-адресами.

version_id
str

Необязательный идентификатор версии BLOB-объекта. Этот параметр применим только для учетных записей хранения с поддержкой управления версиями. Обратите внимание, что параметр запроса versionid не включен в выходной SAS. Поэтому при использовании выходного SAS для работы с определенной версией укажите параметр "version_id" для всех API.

Новые возможности в версии 12.4.0: этот аргумент ключевое слово появился в API версии 2019-12-12.

protocol
str

Указывает протокол, разрешенный для выполненного запроса. Значение по умолчанию — https.

cache_control
str

Значение заголовка ответа для Cache-Control при обращении к ресурсу с помощью этой подписанной URL-адреса.

content_disposition
str

Значение заголовка ответа для Content-Disposition при доступе к ресурсу с помощью этой подписанной URL-адреса.

content_encoding
str

Значение заголовка ответа для Content-Encoding при доступе к ресурсу с помощью этой подписанной URL-адреса.

content_language
str

Значение заголовка ответа для Content-Language при доступе к ресурсу с помощью этой подписанной URL-адреса.

content_type
str

Значение заголовка ответа для Content-Type при доступе к ресурсу с помощью этой подписанной URL-адреса.

encryption_scope
str

Указывает область шифрования для запроса, выполненного таким образом, чтобы все операции записи были зашифрованы службой.

correlation_id
str

Идентификатор корреляции для корреляции журналов аудита хранилища с журналами аудита, используемыми субъектом, создающим и распространяющим SAS. Это можно использовать только при создании SAS с ключом делегирования.

Возвращаемое значение

Маркер подписанного URL-адреса (SAS).

Возвращаемый тип

str

generate_container_sas

Создает подписанный URL-адрес для контейнера.

Используйте возвращенную подпись с параметром учетных данных любого BlobServiceClient, ContainerClient или BlobClient.

generate_container_sas(account_name: str, container_name: str, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: ContainerSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Параметры

account_name
str
Обязательно

Имя учетной записи хранения, используемое для создания подписанного URL-адреса.

container_name
str
Обязательно

Имя контейнера.

account_key
str
значение по умолчанию: None

Ключ учетной записи, также называемый общим ключом или ключом доступа, для создания подписанного URL-адреса. Необходимо указать account_key или user_delegation_key .

user_delegation_key
UserDelegationKey
значение по умолчанию: None

Вместо общего ключа учетной записи пользователь может передать ключ делегирования пользователя. Ключ делегирования пользователя можно получить из службы путем проверки подлинности с помощью удостоверения AAD; Для этого можно вызвать метод get_user_delegation_key. При наличии SAS подписывается с помощью ключа делегирования пользователя.

permission
str или ContainerSasPermissions
значение по умолчанию: None

Разрешения, связанные с подписанным URL-адресом. Пользователь может выполнять только операции, допускаемые этими разрешениями. Разрешения должны быть упорядочены racwdxyltfmei. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа.

expiry
datetime или str
значение по умолчанию: None

Время, когда подписанный URL-адрес становится недействительным. Требуется, если не предоставлен идентификатор, ссылающийся на хранимую политику доступа, содержащую это поле. Это поле необходимо пропустить, если оно указано в связанной хранимой политике доступа. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC.

start
datetime или str
значение по умолчанию: None

Время, когда подписанный URL-адрес становится действительным. Если не указано, то время начала для данного вызова считается временем, когда служба хранилища получает запрос. Azure всегда будет преобразовывать значения в формат UTC. Если дата передается без сведений о часовом поясе, предполагается, что она имеет значение UTC.

policy_id
str
значение по умолчанию: None

Уникальное значение длиной до 64 символов, которое соответствует хранимой политике доступа. Чтобы создать хранимую политику доступа, используйте .set_container_access_policy

ip
str
значение по умолчанию: None

Указывает IP-адрес или диапазон IP-адресов, с которых будут приниматься запросы. Если IP-адрес, с которого исходит запрос, не соответствует IP-адресу или диапазону адресов, указанным в маркере SAS, запрос не проходит проверку подлинности. Например, если указать ip=168.1.5.65 или ip=168.1.5.60-168.1.5.70 в SAS, запрос будет ограничен этими IP-адресами.

protocol
str

Указывает протокол, разрешенный для выполненного запроса. Значение по умолчанию — https.

cache_control
str

Значение заголовка ответа для Cache-Control при обращении к ресурсу с помощью этой подписанной URL-адреса.

content_disposition
str

Значение заголовка ответа для Content-Disposition при доступе к ресурсу с помощью этой подписанной URL-адреса.

content_encoding
str

Значение заголовка ответа для Content-Encoding при доступе к ресурсу с помощью этой подписанной URL-адреса.

content_language
str

Значение заголовка ответа для Content-Language при доступе к ресурсу с помощью этой подписанной URL-адреса.

content_type
str

Значение заголовка ответа для Content-Type при доступе к ресурсу с помощью этой подписанной URL-адреса.

encryption_scope
str

Указывает область шифрования для запроса, выполненного таким образом, чтобы все операции записи были зашифрованы службой.

correlation_id
str

Идентификатор корреляции для корреляции журналов аудита хранилища с журналами аудита, используемыми субъектом, создающим и распространяющим SAS. Это можно использовать только при создании SAS с ключом делегирования.

Возвращаемое значение

Маркер подписанного URL-адреса (SAS).

Возвращаемый тип

str

upload_blob_to_url

Отправка данных по заданному URL-адресу

Данные будут переданы в виде блочного BLOB-объекта.

upload_blob_to_url(blob_url: str, data: Union[Iterable[AnyStr], IO[AnyStr]], credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> Dict[str, Any]

Параметры

blob_url
str
Обязательно

Полный универсальный код ресурса (URI) большого двоичного объекта. Сюда также может входить маркер SAS.

data
bytes или str или Iterable
Обязательно

Данные для отправки. Это могут быть байты, текст, итерируемый или файловый объект.

credential
значение по умолчанию: None

Учетные данные для проверки подлинности. Это необязательно, если URL-адрес большого двоичного объекта уже содержит маркер SAS. Это может быть строка маркера SAS, экземпляр AzureSasCredential или AzureNamedKeyCredential из azure.core.credentials, общий ключ доступа учетной записи или экземпляр класса TokenCredentials из azure.identity. Если URI ресурса уже содержит маркер SAS, он будет игнорироваться в пользу явных учетных данных.

  • за исключением случаев AzureSasCredential, где конфликтующие маркеры SAS вызовут ValueError. При использовании экземпляра AzureNamedKeyCredential "name" должно быть именем учетной записи хранения, а "key" — ключом учетной записи хранения.
overwrite
bool

Указывает, должен ли отправляемый BLOB-объект перезаписывать текущие данные. Если значение равно True, upload_blob_to_url перезапишет все существующие данные. Если задано значение False, операция завершится ошибкой ResourceExistsError.

max_concurrency
int

Количество параллельных подключений, с помощью которых требуется скачать.

length
int

Число байтов, считываемых из потока. Это необязательный параметр, но его необходимо предоставить для оптимальной производительности.

metadata
dict(str,str)

Пары «имя-значение», связанные с большим двоичным объектом как метаданные.

validate_content
bool

Если значение равно true, вычисляет хэш MD5 для каждого блока большого двоичного объекта. Служба хранилища проверяет хэш содержимого, которое поступило вместе с отправленным хэшом. Это в первую очередь полезно для обнаружения битовых фрагментов в сети, если использование http вместо https, так как https (по умолчанию) уже проверяется. Учтите, что этот хэш MD5 не сохраняется в большом двоичном объекте. Кроме того, обратите внимание, что если этот параметр включен, алгоритм отправки с эффективным использованием памяти не будет использоваться, так как для вычисления хэша MD5 требуется буферизация целых блоков, и это приведет к поражению цели алгоритма, эффективного в памяти.

encoding
str

Кодировка, используемая, если текст предоставляется в качестве входных данных. По умолчанию — UTF-8.

Возвращаемое значение

Словарь свойств, обновленных blob-объектов (Etag и последнее изменение)

Возвращаемый тип