StorageClient Classe

Il s’agit de la classe de base pour les objets de service. Les objets de service sont utilisés pour effectuer toutes les demandes adressées au stockage. Cette classe ne peut pas être instanciée directement.

Héritage

builtins.object

StorageClient

Constructeur

StorageClient(connection_params)

Paramètres

connection_params

Variables

account_name

str

nom du compte de stockage. Il permet d’authentifier les demandes signées avec une clé de compte et de construire le point de terminaison de stockage. Elle est obligatoire, sauf si une chaîne de connexion est donnée ou si un domaine personnalisé est utilisé avec l’authentification anonyme.

account_key

str

La clé du compte de stockage. Il est utilisé pour l’authentification par clé partagée. Si aucune clé de compte ou jeton SAs n’est spécifié, l’accès anonyme est utilisé.

sas_token

str

Jeton de signature d’accès partagé à utiliser pour authentifier les demandes au lieu de la clé de compte. Si la clé de compte et le jeton sas sont tous deux spécifiés, la clé de compte est utilisée pour la signature. Si aucun des deux n’est spécifié, l’accès anonyme est utilisé.

primary_endpoint

str

Point de terminaison à laquelle envoyer des demandes de stockage.

secondary_endpoint

str

Point de terminaison secondaire à partir duquel lire les données de stockage. Il ne s’agit d’un point de terminaison valide que si le compte de stockage utilisé est RA-GRS et autorise donc la lecture à partir du serveur secondaire.

retry

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

Fonction qui détermine s’il faut réessayer. Prend comme paramètre un RetryContext objet . Retourne le nombre de secondes à attendre avant de réessayer la demande, ou Aucun pour indiquer de ne pas réessayer.

location_mode

LocationMode

Emplacement de l’hôte à utiliser pour effectuer des demandes. La valeur par défaut est LocationMode.PRIMARY. Notez que ce paramètre s’applique uniquement aux comptes RA-GRS, car les autres types de comptes n’autorisent pas la lecture à partir de la base de données secondaire. Si le location_mode est défini sur LocationMode.SECONDARY, les demandes de lecture sont envoyées au point de terminaison secondaire. Les demandes d’écriture continueront d’être envoyées au serveur principal.

protocol

str

Protocole à utiliser pour les requêtes. La valeur par défaut est https.

request_session

<xref:requests.Session>

Objet de session à utiliser pour les requêtes http.

request_callback

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

Fonction appelée immédiatement avant l’envoi de chaque requête. Cette fonction prend comme paramètre l’objet de requête et ne retourne rien. Il peut être utilisé pour ajouter des en-têtes personnalisés ou des données de demande de journal.

response_callback

<xref:function>()

Fonction appelée immédiatement après la réception de chaque réponse. Cette fonction prend comme paramètre l’objet response et ne retourne rien. Il peut être utilisé pour journaliser les données de réponse.

retry_callback

<xref:function>()

Fonction appelée immédiatement après l’exécution de l’évaluation des nouvelles tentatives. Cette fonction prend comme paramètre l’objet de contexte de nouvelle tentative et ne retourne rien. Il peut être utilisé pour détecter les nouvelles tentatives et journaliser les informations de contexte.

Méthodes

extract_date_and_request_id
set_proxy	Définit l’hôte et le port du serveur proxy pour le tunnelling HTTP CONNECT.

extract_date_and_request_id

static extract_date_and_request_id(retry_context)

Paramètres

retry_context

Obligatoire

set_proxy

Définit l’hôte et le port du serveur proxy pour le tunnelling HTTP CONNECT.

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

Paramètres

host

str

Obligatoire

Adresse du proxy. Ex : '192.168.0.100'

port

int

Obligatoire

Port du proxy. Ex : 6000

user

str

valeur par défaut: None

Utilisateur pour l’autorisation de proxy.

password

str

valeur par défaut: None

Mot de passe pour l’autorisation de proxy.

Attributs

protocol

request_session

socket_timeout