StorageClient Classe

Questa è la classe di base per gli oggetti servizio. Gli oggetti servizio vengono usati per eseguire tutte le richieste all'archiviazione. Non è possibile creare direttamente un'istanza di questa classe.

Ereditarietà

builtins.object

StorageClient

Costruttore

StorageClient(connection_params)

Parametri

connection_params

Variabili

account_name

str

nome dell'account di archiviazione. Viene usato per autenticare le richieste firmate con una chiave dell'account e per costruire l'endpoint di archiviazione. È obbligatorio, a meno che non venga specificata una stringa di connessione o se un dominio personalizzato viene usato con l'autenticazione anonima.

account_key

str

Chiave dell'account di archiviazione. Viene usato per l'autenticazione con chiave condivisa. Se non viene specificata alcuna chiave dell'account o token di firma di accesso condiviso, verrà usato l'accesso anonimo.

sas_token

str

Token di firma di accesso condiviso da usare per autenticare le richieste anziché la chiave dell'account. Se la chiave dell'account e il token di firma di accesso condiviso sono entrambi specificati, la chiave dell'account verrà usata per firmare. Se nessuno dei due viene specificato, verrà usato l'accesso anonimo.

primary_endpoint

str

Endpoint a cui inviare richieste di archiviazione.

secondary_endpoint

str

Endpoint secondario da cui leggere i dati di archiviazione. Si tratta di un endpoint valido solo se l'account di archiviazione usato è ra-grs e quindi consente la lettura dal database secondario.

retry

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

Funzione che determina se riprovare. Accetta come parametro un RetryContext oggetto . Restituisce il numero di secondi di attesa prima di ritentare la richiesta oppure Nessuno per indicare di non riprovare.

location_mode

LocationMode

Posizione host da usare per effettuare richieste. Il valore predefinito è LocationMode.PRIMARY. Si noti che questa impostazione si applica solo agli account RA-GRS perché altri tipi di account non consentono la lettura da secondario. Se il location_mode è impostato su LocationMode.SECONDARY, le richieste di lettura verranno inviate all'endpoint secondario. Le richieste di scrittura continueranno a essere inviate al database primario.

protocol

str

Protocollo da usare per le richieste. Il valore predefinito è https.

request_session

<xref:requests.Session>

Oggetto sessione da utilizzare per le richieste HTTP.

request_callback

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

Funzione chiamata immediatamente prima dell'invio di ogni richiesta. Questa funzione accetta come parametro l'oggetto richiesta e non restituisce nulla. Può essere usato per aggiungere intestazioni personalizzate o dati di richiesta di log.

response_callback

<xref:function>()

Funzione chiamata immediatamente dopo la ricezione di ogni risposta. Questa funzione accetta come parametro l'oggetto risposta e non restituisce nulla. Può essere usato per registrare i dati di risposta.

retry_callback

<xref:function>()

Funzione chiamata immediatamente dopo l'esecuzione della valutazione dei tentativi. Questa funzione accetta come parametro l'oggetto contesto di ripetizione dei tentativi e non restituisce nulla. Può essere usato per rilevare i tentativi e le informazioni sul contesto del log.

Metodi

extract_date_and_request_id
set_proxy	Imposta l'host del server proxy e la porta per il tunneling HTTP CONNECT.

extract_date_and_request_id

static extract_date_and_request_id(retry_context)

Parametri

retry_context

Necessario

set_proxy

Imposta l'host del server proxy e la porta per il tunneling HTTP CONNECT.

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

Parametri

host

str

Necessario

Indirizzo del proxy. Ad esempio: '192.168.0.100'

port

int

Necessario

Porta del proxy. Ad esempio: 6000

user

str

valore predefinito: None

Utente per l'autorizzazione proxy.

password

str

valore predefinito: None

Password per l'autorizzazione del proxy.

Attributi

protocol

request_session

socket_timeout