Share via


StorageClient Klasse

Dies ist die Basisklasse für Dienstobjekte. Dienstobjekte werden verwendet, um alle Anforderungen an Storage zu erledigen. Diese Klasse kann nicht direkt instanziiert werden.

Vererbung
builtins.object
StorageClient

Konstruktor

StorageClient(connection_params)

Parameter

connection_params

Variablen

account_name
str

Der Name des Speicherkontos. Dies wird verwendet, um mit einem Kontoschlüssel signierte Anforderungen zu authentifizieren und den Speicherendpunkt zu erstellen. Dies ist erforderlich, es sei denn, es wird eine Verbindungszeichenfolge angegeben oder eine benutzerdefinierte Domäne mit anonymer Authentifizierung verwendet.

account_key
str

Der Speicherkontoschlüssel. Dies wird für die Authentifizierung mit gemeinsam genutzten Schlüsseln verwendet. Wenn weder Kontoschlüssel noch SAS-Token angegeben sind, wird anonymer Zugriff verwendet.

sas_token
str

Ein Shared Access Signature-Token, das anstelle des Kontoschlüssels zum Authentifizieren von Anforderungen verwendet werden soll. Wenn Kontoschlüssel und SAS-Token angegeben sind, wird der Kontoschlüssel zum Signieren verwendet. Wenn keines angegeben ist, wird anonymer Zugriff verwendet.

primary_endpoint
str

Der Endpunkt, an den Speicheranforderungen gesendet werden sollen.

secondary_endpoint
str

Der sekundäre Endpunkt, aus dem Speicherdaten gelesen werden sollen. Dies ist nur dann ein gültiger Endpunkt, wenn das verwendete Speicherkonto RA-GRS ist und somit das Lesen aus einer sekundären Instanz ermöglicht.

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

Eine Funktion, die bestimmt, ob ein Wiederholungsversuch durchgeführt werden soll. Verwendet als Parameter ein RetryContext -Objekt. Gibt die Anzahl der Sekunden zurück, die gewartet werden soll, bevor die Anforderung wiederholt wird, oder Keine, um anzugeben, dass kein Wiederholungsversuch ausgeführt wird.

location_mode
LocationMode

Der Hostspeicherort, der zum Senden von Anforderungen verwendet werden soll. Der Standardwert ist "LocationMode.PRIMARY". Beachten Sie, dass diese Einstellung nur für RA-GRS-Konten gilt, da andere Kontotypen das Lesen aus sekundären Konten nicht zulassen. Wenn die location_mode auf LocationMode.SECONDARY festgelegt ist, werden Leseanforderungen an den sekundären Endpunkt gesendet. Schreibanforderungen werden weiterhin an das primäre Element gesendet.

protocol
str

Das Protokoll, das für Anforderungen verwendet werden soll. Der Standardwert ist https.

request_session
<xref:requests.Session>

Das Sitzungsobjekt, das für HTTP-Anforderungen verwendet werden soll.

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

Eine Funktion, die unmittelbar vor dem Senden jeder Anforderung aufgerufen wird. Diese Funktion akzeptiert als Parameter das Anforderungsobjekt und gibt nichts zurück. Es kann verwendet werden, um benutzerdefinierte Header oder Protokollanforderungsdaten hinzuzufügen.

response_callback
<xref:function>()

Eine Funktion, die unmittelbar nach dem Empfang jeder Antwort aufgerufen wird. Diese Funktion akzeptiert als Parameter das Antwortobjekt und gibt nichts zurück. Es kann verwendet werden, um Antwortdaten zu protokollieren.

retry_callback
<xref:function>()

Eine Funktion, die unmittelbar nach der Wiederholungsauswertung aufgerufen wird. Diese Funktion verwendet als Parameter das Wiederholungskontextobjekt und gibt nichts zurück. Es kann verwendet werden, um Wiederholungen zu erkennen und Kontextinformationen zu protokollieren.

Methoden

extract_date_and_request_id
set_proxy

Legt den Host und Port des Proxyservers für http CONNECT Tunnelling fest.

extract_date_and_request_id

static extract_date_and_request_id(retry_context)

Parameter

retry_context
Erforderlich

set_proxy

Legt den Host und Port des Proxyservers für http CONNECT Tunnelling fest.

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

Parameter

host
str
Erforderlich

Adresse des Proxys. Beispiel: '192.168.0.100'

port
int
Erforderlich

Port des Proxys. Beispiel: 6000

user
str
Standardwert: None

Benutzer für Proxyautorisierung.

password
str
Standardwert: None

Kennwort für die Proxyautorisierung.

Attribute

protocol

request_session

socket_timeout