StorageClient Класс

  • Ссылка

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

Наследование
builtins.object
StorageClient

Конструктор

StorageClient(connection_params)

Параметры

connection_params
<xref:obj>
Обязательно

Параметры, используемые для создания клиента.

Переменные

account_name
str

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

account_key
str

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

sas_token
str

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

primary_endpoint
str

Конечная точка для отправки запросов хранилища.

secondary_endpoint
str

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

retry
<xref:function>(<xref:context>)

Функция, которая определяет, следует ли повторить попытку. Принимает в качестве параметра RetryContext объект . Возвращает время ожидания в секундах перед повторным выполнением запроса или значение None, чтобы указать, что повторные попытки не повторялись.

location_mode
LocationMode

Расположение узла, используемое для выполнения запросов. Значение по умолчанию — LocationMode.PRIMARY. Обратите внимание, что этот параметр применяется только к учетным записям RA-GRS, так как другие типы учетных записей не разрешают чтение из дополнительных учетных записей. Если location_mode имеет значение LocationMode.SECONDARY, запросы на чтение будут отправляться во вторичную конечную точку. Запросы на запись будут по-прежнему отправляться в основной источник.

protocol
str

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

request_session
<xref:requests.Session>

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

request_callback
<xref:function>(<xref:request>)

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

response_callback
<xref:function>()

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

retry_callback
<xref:function>()

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

Методы

extract_date_and_request_id
set_proxy

Задает узел прокси-сервера и порт для туннелирования HTTP CONNECT.

extract_date_and_request_id 

static extract_date_and_request_id(retry_context)

Параметры

retry_context
Обязательно

set_proxy

Задает узел прокси-сервера и порт для туннелирования HTTP CONNECT.

set_proxy(host, port, user=None, password=None)

Параметры

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

Адрес прокси-сервера. Например: '192.168.0.100'

port
int
Обязательно

Порт прокси-сервера. Например: 6000

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

Пользователь для авторизации прокси-сервера.

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

Пароль для авторизации прокси-сервера.

Атрибуты

protocol

request_session

socket_timeout