blob Paquet

Paquets

aio

Classes

AccessPolicy	Classe de stratégie d’accès utilisée par les méthodes de stratégie d’accès set et get dans chaque service. Une stratégie d'accès stockée peut spécifier l'heure de début, l'heure d'expiration et les autorisations pour les signatures d'accès partagé auxquelles elle est associée. Selon la façon dont vous souhaitez contrôler l’accès à votre ressource, vous pouvez spécifier tous ces paramètres dans la stratégie d’accès stockée et les omettre de l’URL de la signature d’accès partagé. De cette façon, vous pouvez modifier le comportement de la signature associée à tout moment, de même que la révoquer. Vous pouvez aussi spécifier un ou plusieurs paramètres de stratégie d'accès dans la stratégie d'accès stockée et les autres dans l'URL. Enfin, vous pouvez spécifier tous les paramètres dans l'URL. Dans ce cas, vous pouvez utiliser la stratégie d'accès stockée pour révoquer la signature et non pour modifier son comportement. La signature d'accès partagé et la stratégie d'accès stockée doivent inclure tous les champs obligatoires pour authentifier la signature. Si les champs obligatoires sont manquants, la demande échoue. De même, si un champ est spécifié dans l'URL de signature d'accès partagé et dans la stratégie d'accès stockée, la demande échoue avec le code d'état 400 (Requête incorrecte).
AccountSasPermissions	ResourceTypes classe à utiliser avec generate_account_sas fonction et pour les AccessPolicies utilisées avec set_*_acl. Il existe deux types de SAP qui peuvent être utilisés pour accorder l’accès aux ressources. L’une consiste à accorder l’accès à une ressource spécifique (spécifique à une ressource). Une autre consiste à accorder l’accès à l’ensemble du service pour un compte spécifique et à autoriser certaines opérations en fonction des perms trouvés ici.
ArrowDialect	champ d’un schéma de flèche. Tous les paramètres requis doivent être renseignés pour pouvoir être envoyés à Azure.
BlobAnalyticsLogging	Paramètres de journalisation Azure Analytics.
BlobBlock	Classe BlockBlob Block.
BlobClient	Un client pour interagir avec un objet blob spécifique, bien que cet objet blob n’existe pas encore. Pour plus de configuration facultative, cliquez ici.
BlobLeaseClient	Crée un blobLeaseClient. Ce client fournit des opérations de bail sur un BlobClient ou un ContainerClient.
BlobPrefix	Itérable des propriétés d’objet blob. Retourné par walk_blobs lorsqu’un délimiteur est utilisé. Peut être considéré comme un répertoire d’objets blob virtuel.
BlobProperties	Propriétés d’objet blob.
BlobQueryError	L’erreur s’est produite pendant l’opération de requête rapide.
BlobQueryReader	Objet de diffusion en continu pour lire les résultats de la requête.
BlobSasPermissions	Classe BlobSasPermissions à utiliser avec la generate_blob_sas fonction .
BlobServiceClient	Client pour interagir avec le service Blob au niveau du compte. Ce client fournit des opérations pour récupérer et configurer les propriétés du compte, ainsi que répertorier, créer et supprimer des conteneurs dans le compte. Pour les opérations relatives à un conteneur ou à un objet blob spécifique, les clients de ces entités peuvent également être récupérés à l’aide des fonctions get_client . Pour plus de configuration facultative, cliquez ici.
ContainerClient	Un client pour interagir avec un conteneur spécifique, bien que ce conteneur n’existe pas encore. Pour les opérations relatives à un objet blob spécifique dans ce conteneur, un client blob peut être récupéré à l’aide de la get_blob_client fonction . Pour plus de configuration facultative, cliquez ici.
ContainerEncryptionScope	Configuration d’étendue de chiffrement par défaut pour un conteneur. Cette étendue est utilisée implicitement pour toutes les écritures futures dans le conteneur, mais peut être remplacée par opération d’objet blob. Nouveautés de la version 12.2.0.
ContainerProperties	Classe de propriétés du conteneur d’objets blob. Les instances retournées ContainerProperties exposent ces valeurs via une interface de dictionnaire, par exemple : container_props["last_modified"]. En outre, le nom du conteneur est disponible en tant que container_props["name"].
ContainerSasPermissions	Classe ContainerSasPermissions à utiliser avec la generate_container_sas fonction et pour accesspolicies utilisée avec set_container_access_policy.
ContentSettings	Paramètres de contenu d’un objet blob.
CopyProperties	Propriétés de copie d’objets blob. Ces propriétés seront Aucune si cet objet blob n’a jamais été la destination dans une opération de copie d’objet blob, ou si cet objet blob a été modifié après une opération de copie d’objet blob terminée, par exemple, à l’aide de Définir des propriétés d’objet blob, De charger un objet blob ou de valider une liste de blocs.
CorsRule	CORS est une fonctionnalité HTTP qui permet à une application web exécutée dans un domaine d'accéder aux ressources d'un autre domaine. Les navigateurs Web implémentent une restriction de sécurité appelée stratégie de même origine qui empêche une page Web d'appeler des API d'un autre domaine ; CORS constitue un moyen sûr pour autoriser un domaine (le domaine d'origine) à appeler des API d'un autre domaine.
CustomerProvidedEncryptionKey	Toutes les données du Stockage Azure sont chiffrées au repos à l’aide d’une clé de chiffrement au niveau du compte. Dans les versions 2018-06-2018-17 et ultérieures, vous pouvez gérer la clé utilisée pour chiffrer le contenu des objets blob et les métadonnées d’application par objet blob en fournissant une clé de chiffrement AES-256 dans les demandes adressées au service de stockage. Lorsque vous utilisez une clé fournie par le client, stockage Azure ne gère pas ou ne conserve pas votre clé. Lors de l’écriture de données dans un objet blob, la clé fournie est utilisée pour chiffrer vos données avant de les écrire sur le disque. Un hachage SHA-256 de la clé de chiffrement est écrit en même temps que le contenu de l’objet blob et est utilisé pour vérifier que toutes les opérations suivantes sur l’objet blob utilisent la même clé de chiffrement. Ce hachage ne peut pas être utilisé pour récupérer la clé de chiffrement ou déchiffrer le contenu de l’objet blob. Lors de la lecture d’un objet blob, la clé fournie est utilisée pour déchiffrer vos données après les avoir lues à partir du disque. Dans les deux cas, la clé de chiffrement fournie est ignorée en toute sécurité dès que le processus de chiffrement ou de déchiffrement est terminé.
DelimitedJsonDialect	Définit la sérialisation JSON d’entrée ou de sortie pour une requête de données blob. mot clé délimiteur de str : caractère de séparateur de ligne, valeur par défaut est ' '
DelimitedTextDialect	Définit la sérialisation délimitée en entrée ou en sortie (CSV) pour une requête de requête d’objet blob.
ExponentialRetry	Nouvelle tentative exponentielle. Construit un objet de nouvelle tentative exponentielle. Le initial_backoff est utilisé pour la première nouvelle tentative. Les nouvelles tentatives suivantes sont retentées après initial_backoff + increment_power^retry_count secondes.
FilteredBlob	Informations d’objet blob d’un appel d’API Filtrer les objets blob.
ImmutabilityPolicy	Paramètres facultatifs pour définir la stratégie d’immuabilité d’un objet blob, d’un instantané d’objet blob ou d’une version d’objet blob. Nouveautés de la version 12.10.0 : ceci a été introduit dans la version d’API « 2020-10-02 ».
LeaseProperties	Propriétés du bail d’objets blob.
LinearRetry	Nouvelle tentative linéaire. Construit un objet de nouvelle tentative linéaire.
LocationMode	Spécifie l’emplacement vers lequel la demande doit être envoyée. Ce mode s’applique uniquement aux comptes RA-GRS qui autorisent l’accès en lecture secondaire. Tous les autres types de comptes doivent utiliser PRIMARY.
Metrics	Résumé des statistiques de requête regroupées par API en agrégats d’heures ou de minutes pour les objets blob.
ObjectReplicationPolicy	ID de stratégie et ID de règle appliqués à un objet blob.
ObjectReplicationRule	ID de stratégie et ID de règle appliqués à un objet blob.
PageRange	Plage de pages pour l’objet blob de pages.
PartialBatchErrorException	Il y a un échec partiel dans les opérations par lots.
ResourceTypes	Spécifie les types de ressources accessibles avec la sap du compte.
RetentionPolicy	Stratégie de rétention qui détermine la durée pendant laquelle les données associées doivent persister.
StaticWebsite	Propriétés qui permettent à un compte d’héberger un site web statique.
StorageStreamDownloader	Objet de streaming à télécharger à partir du Stockage Azure.
UserDelegationKey	Représente une clé de délégation d’utilisateur, fournie à l’utilisateur par Stockage Azure en fonction de son jeton d’accès Azure Active Directory. Les champs sont enregistrés sous forme de chaînes simples, car l’utilisateur n’a pas à interagir avec cet objet ; pour générer une sap d’identification, l’utilisateur peut simplement la passer à l’API appropriée.

Énumérations

ArrowType
BlobImmutabilityPolicyMode	Spécifie le mode de stratégie d’immuabilité à définir sur l’objet blob. « Mutable » ne peut être retourné que par le service. Ne définissez pas sur « Mutable ».
BlobType
BlockState	Bloquer les types de blocs d’objets blob.
PremiumPageBlobTier	Spécifie le niveau d’objet blob de page sur lequel définir l’objet blob. Cela s’applique uniquement aux objets blob de pages sur les comptes de stockage Premium. Consultez : https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets pour obtenir des informations détaillées sur les IOPS et le débit correspondants par PageBlobTier.
PublicAccess	Spécifie si les données dans le conteneur sont accessibles publiquement et le niveau d'accès.
QuickQueryDialect	Spécifie le dialecte d’entrée/sortie de requête rapide.
RehydratePriority	Si un objet est à l’état en attente de réalimentation, cet en-tête est retourné avec la priorité de réhydrater. Les valeurs valides sont High et Standard.
SequenceNumberAction	Actions de numéro de séquence.
StandardBlobTier	Spécifie le niveau d’objet blob sur lequel définir l’objet blob. Cela s’applique uniquement aux objets blob de blocs sur des comptes de stockage standard.
StorageErrorCode

Fonctions

download_blob_from_url

Téléchargez le contenu d’un objet blob dans un fichier ou un flux local.

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

Paramètres

blob_url

str

Obligatoire

URI complet de l’objet blob. Cela peut également inclure un jeton SAS.

output

str ou <xref:<xref:writable stream.>>

Obligatoire

Où les données doivent être téléchargées. Il peut s’agir d’un chemin d’accès de fichier dans lequel écrire ou d’un handle d’E/S ouvert dans lequel écrire.

credential

valeur par défaut: None

Informations d’identification avec lesquelles s’authentifier. Cette option est facultative si l’URL de l’objet blob a déjà un jeton SAP ou si l’objet blob est public. La valeur peut être une chaîne de jeton SAS, une instance d’une classe AzureSasCredential ou AzureNamedKeyCredential à partir d’azure.core.credentials, une clé d’accès partagé de compte ou une instance d’une classe TokenCredentials d’azure.identity. Si l’URI de ressource contient déjà un jeton SAP, celui-ci est ignoré au profit d’informations d’identification explicites.

• sauf dans le cas d’AzureSasCredential, où les jetons SAP en conflit déclenchent une ValeurError. Si vous utilisez une instance d’AzureNamedKeyCredential, « name » doit être le nom du compte de stockage et « key » doit être la clé du compte de stockage.

overwrite

bool

Indique si le fichier local doit être remplacé s’il existe déjà. La valeur par défaut est False , auquel cas un objet ValueError est déclenché si le fichier existe déjà. Si la valeur est True, une tentative d’écriture dans le fichier existant est effectuée. Si un handle de flux est passé, cette valeur est ignorée.

max_concurrency

int

Nombre de connexions parallèles à télécharger.

offset

int

Début de la plage d’octets à utiliser pour télécharger une section de l’objet blob. Doit être défini si la longueur est fournie.

length

int

Nombre d’octets à lire à partir du flux. Cette option est facultative, mais doit être fournie pour des performances optimales.

validate_content

bool

Si la valeur est true, calcule un hachage MD5 pour chaque segment de l’objet blob. Le service de stockage vérifie le hachage du contenu qui est arrivé avec le hachage envoyé. Cela est principalement utile pour la détection de bitflips sur le câble si l’utilisation de http au lieu de https comme https (la valeur par défaut) est déjà validée. Notez que ce hachage MD5 n'est pas stocké avec l'objet blob. Notez également que s’il est activé, l’algorithme de chargement à mémoire efficace ne sera pas utilisé, car le calcul du hachage MD5 nécessite la mise en mémoire tampon de blocs entiers, ce qui va à l’échec de l’objectif de l’algorithme d’efficacité de la mémoire.

Type de retour

None

generate_account_sas

Génère une signature d’accès partagé pour le service blob.

Utilisez la signature retournée avec le paramètre d’informations d’identification de n’importe quel BlobServiceClient, ContainerClient ou 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

Paramètres

account_name

str

Obligatoire

Nom du compte de stockage utilisé pour générer la signature d’accès partagé.

account_key

str

Obligatoire

La clé de compte, également appelée clé partagée ou clé d’accès, pour générer la signature d’accès partagé.

resource_types

str ou ResourceTypes

Obligatoire

Spécifie les types de ressources accessibles avec la sap du compte.

permission

str ou AccountSasPermissions

Obligatoire

Autorisations associées à la signature d'accès partagé. L'utilisateur est limité aux opérations autorisées par les autorisations. Obligatoire, sauf si un ID fait référence à une stratégie d’accès stockée qui contient ce champ. Ce champ doit être omis s'il a été spécifié dans une stratégie d'accès stockée associée.

expiry

datetime ou str

Obligatoire

Heure à laquelle la signature d’accès partagé devient non valide. Obligatoire, sauf si un ID fait référence à une stratégie d’accès stockée qui contient ce champ. Ce champ doit être omis s'il a été spécifié dans une stratégie d'accès stockée associée. Azure convertit toujours les valeurs en UTC. Si une date est transmise sans informations de fuseau horaire, elle est supposée être UTC.

start

datetime ou str

valeur par défaut: None

Heure à laquelle la signature d’accès partagé devient valide. En cas d'omission, l'heure de début de cet appel est supposée être l'heure à laquelle le service de stockage reçoit la demande. Azure convertit toujours les valeurs en UTC. Si une date est transmise sans informations de fuseau horaire, elle est supposée être UTC.

ip

str

valeur par défaut: None

Spécifie une adresse IP ou une plage d’adresses IP à partir de laquelle accepter les demandes. Si l’adresse IP d’où provient la demande ne correspond pas à l’adresse IP ou à la plage d’adresses spécifiée sur le jeton SAP, la demande n’est pas authentifiée. Par exemple, la spécification d’ip=168.1.5.65 ou ip=168.1.5.60-168.1.5.70 sur la signature d’accès partagé limite la demande à ces adresses IP.

protocol

str

Spécifie le protocole autorisé pour une requête effectuée. La valeur par défaut est https.

encryption_scope

str

Spécifie l’étendue de chiffrement d’une requête effectuée afin que toutes les opérations d’écriture soient chiffrées par le service.

Retours

Jeton de signature d’accès partagé (sas).

Type de retour

str

generate_blob_sas

Génère une signature d’accès partagé pour un objet blob.

Utilisez la signature retournée avec le paramètre d’informations d’identification de n’importe quel BlobServiceClient, ContainerClient ou 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

Paramètres

account_name

str

Obligatoire

Nom du compte de stockage utilisé pour générer la signature d’accès partagé.

container_name

str

Obligatoire

nom du conteneur.

blob_name

str

Obligatoire

Nom de l'objet blob.

snapshot

str

valeur par défaut: None

ID de instantané d’objet blob facultatif.

account_key

str

valeur par défaut: None

La clé de compte, également appelée clé partagée ou clé d’accès, pour générer la signature d’accès partagé. Vous devez spécifier account_key ou user_delegation_key .

user_delegation_key

UserDelegationKey

valeur par défaut: None

Au lieu d’une clé partagée de compte, l’utilisateur peut passer une clé de délégation d’utilisateur. Une clé de délégation utilisateur peut être obtenue à partir du service en authentification avec une identité AAD ; Pour ce faire, appelez get_user_delegation_key. Lorsqu’elle est présente, la signature d’accès partagé est signée avec la clé de délégation utilisateur à la place.

permission

str ou BlobSasPermissions

valeur par défaut: None

Autorisations associées à la signature d'accès partagé. L'utilisateur est limité aux opérations autorisées par les autorisations. Les autorisations doivent être triées racwdxytmei. Obligatoire, sauf si un ID fait référence à une stratégie d’accès stockée qui contient ce champ. Ce champ doit être omis s'il a été spécifié dans une stratégie d'accès stockée associée.

expiry

datetime ou str

valeur par défaut: None

Heure à laquelle la signature d’accès partagé devient non valide. Obligatoire, sauf si un ID fait référence à une stratégie d’accès stockée qui contient ce champ. Ce champ doit être omis s'il a été spécifié dans une stratégie d'accès stockée associée. Azure convertit toujours les valeurs en UTC. Si une date est transmise sans informations de fuseau horaire, elle est supposée être UTC.

start

datetime ou str

valeur par défaut: None

Heure à laquelle la signature d’accès partagé devient valide. En cas d'omission, l'heure de début de cet appel est supposée être l'heure à laquelle le service de stockage reçoit la demande. Azure convertit toujours les valeurs en UTC. Si une date est transmise sans informations de fuseau horaire, elle est supposée être UTC.

policy_id

str

valeur par défaut: None

Valeur unique d’une longueur maximale de 64 caractères qui correspond à une stratégie d’accès stockée. Pour créer une stratégie d’accès stockée, utilisez set_container_access_policy.

ip

str

valeur par défaut: None

Spécifie une adresse IP ou une plage d’adresses IP à partir de laquelle accepter les demandes. Si l’adresse IP d’où provient la demande ne correspond pas à l’adresse IP ou à la plage d’adresses spécifiée sur le jeton SAP, la demande n’est pas authentifiée. Par exemple, la spécification d’ip=168.1.5.65 ou ip=168.1.5.60-168.1.5.70 sur la signature d’accès partagé limite la demande à ces adresses IP.

version_id

str

ID de version d’objet blob facultatif. Ce paramètre s’applique uniquement aux comptes de stockage avec contrôle de version. Notez que le paramètre de requête « versionid » n’est pas inclus dans la sap de sortie. Par conséquent, fournissez le paramètre « version_id » à toutes les API lors de l’utilisation de la sap de sortie pour fonctionner sur une version spécifique.

Nouveauté de la version 12.4.0 : cet argument mot clé a été introduit dans la version d’API « 2019-12-12 ».

protocol

str

Spécifie le protocole autorisé pour une requête effectuée. La valeur par défaut est https.

cache_control

str

Valeur d’en-tête de réponse pour Cache-Control lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

content_disposition

str

Valeur d’en-tête de réponse pour Content-Disposition lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

content_encoding

str

Valeur d’en-tête de réponse pour Content-Encoding lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

content_language

str

Valeur d’en-tête de réponse pour Content-Language lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

content_type

str

Valeur d’en-tête de réponse pour Content-Type lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

encryption_scope

str

Spécifie l’étendue de chiffrement d’une requête effectuée afin que toutes les opérations d’écriture soient chiffrées par le service.

correlation_id

str

ID de corrélation permettant de mettre en corrélation les journaux d’audit de stockage avec les journaux d’audit utilisés par le principal qui génère et distribue la sap. Cela ne peut être utilisé que lors de la génération d’une signature d’accès partagé avec une clé de délégation.

Retours

Jeton de signature d’accès partagé (sas).

Type de retour

str

generate_container_sas

Génère une signature d’accès partagé pour un conteneur.

Utilisez la signature retournée avec le paramètre d’informations d’identification de n’importe quel BlobServiceClient, ContainerClient ou 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

Paramètres

account_name

str

Obligatoire

Nom du compte de stockage utilisé pour générer la signature d’accès partagé.

container_name

str

Obligatoire

nom du conteneur.

account_key

str

valeur par défaut: None

La clé de compte, également appelée clé partagée ou clé d’accès, pour générer la signature d’accès partagé. Vous devez spécifier account_key ou user_delegation_key .

user_delegation_key

UserDelegationKey

valeur par défaut: None

Au lieu d’une clé partagée de compte, l’utilisateur peut passer une clé de délégation d’utilisateur. Une clé de délégation utilisateur peut être obtenue à partir du service en authentification avec une identité AAD ; Pour ce faire, appelez get_user_delegation_key. Lorsqu’elle est présente, la signature d’accès partagé est signée avec la clé de délégation utilisateur à la place.

permission

str ou ContainerSasPermissions

valeur par défaut: None

Autorisations associées à la signature d'accès partagé. L'utilisateur est limité aux opérations autorisées par les autorisations. Les autorisations doivent être ordonnées racwdxyltfmei. Obligatoire, sauf si un ID fait référence à une stratégie d’accès stockée qui contient ce champ. Ce champ doit être omis s'il a été spécifié dans une stratégie d'accès stockée associée.

expiry

datetime ou str

valeur par défaut: None

Heure à laquelle la signature d’accès partagé devient non valide. Obligatoire, sauf si un ID fait référence à une stratégie d’accès stockée qui contient ce champ. Ce champ doit être omis s'il a été spécifié dans une stratégie d'accès stockée associée. Azure convertit toujours les valeurs en UTC. Si une date est transmise sans informations de fuseau horaire, elle est supposée être UTC.

start

datetime ou str

valeur par défaut: None

Heure à laquelle la signature d’accès partagé devient valide. En cas d'omission, l'heure de début de cet appel est supposée être l'heure à laquelle le service de stockage reçoit la demande. Azure convertit toujours les valeurs en UTC. Si une date est transmise sans informations de fuseau horaire, elle est supposée être UTC.

policy_id

str

valeur par défaut: None

Valeur unique d’une longueur maximale de 64 caractères qui correspond à une stratégie d’accès stockée. Pour créer une stratégie d’accès stockée, utilisez set_container_access_policy.

ip

str

valeur par défaut: None

Spécifie une adresse IP ou une plage d’adresses IP à partir de laquelle accepter les demandes. Si l’adresse IP d’où provient la demande ne correspond pas à l’adresse IP ou à la plage d’adresses spécifiée sur le jeton SAP, la demande n’est pas authentifiée. Par exemple, la spécification d’ip=168.1.5.65 ou ip=168.1.5.60-168.1.5.70 sur la signature d’accès partagé limite la demande à ces adresses IP.

protocol

str

Spécifie le protocole autorisé pour une requête effectuée. La valeur par défaut est https.

cache_control

str

Valeur d’en-tête de réponse pour Cache-Control lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

content_disposition

str

Valeur d’en-tête de réponse pour Content-Disposition lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

content_encoding

str

Valeur d’en-tête de réponse pour Content-Encoding lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

content_language

str

Valeur d’en-tête de réponse pour Content-Language lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

content_type

str

Valeur d’en-tête de réponse pour Content-Type lorsque la ressource est accessible à l’aide de cette signature d’accès partagé.

encryption_scope

str

Spécifie l’étendue de chiffrement d’une requête effectuée afin que toutes les opérations d’écriture soient chiffrées par le service.

correlation_id

str

ID de corrélation permettant de mettre en corrélation les journaux d’audit de stockage avec les journaux d’audit utilisés par le principal qui génère et distribue la sap. Cela ne peut être utilisé que lors de la génération d’une signature d’accès partagé avec une clé de délégation.

Retours

Jeton de signature d’accès partagé (sas).

Type de retour

str

upload_blob_to_url

Charger des données vers une URL donnée

Les données seront chargées en tant qu’objet blob de blocs.

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]

Paramètres

blob_url

str

Obligatoire

URI complet de l’objet blob. Cela peut également inclure un jeton SAS.

data

bytes ou str ou Iterable

Obligatoire

Données à charger. Il peut s’agir d’octets, de texte, d’un objet itérable ou d’un fichier.

credential

valeur par défaut: None

Informations d’identification avec lesquelles s’authentifier. Cette option est facultative si l’URL d’objet blob a déjà un jeton SAP. La valeur peut être une chaîne de jeton SAS, une instance d’une classe AzureSasCredential ou AzureNamedKeyCredential à partir d’azure.core.credentials, une clé d’accès partagé de compte ou une instance d’une classe TokenCredentials d’azure.identity. Si l’URI de ressource contient déjà un jeton SAP, celui-ci est ignoré au profit d’informations d’identification explicites.

• sauf dans le cas d’AzureSasCredential, où les jetons SAP en conflit déclenchent une ValeurError. Si vous utilisez une instance d’AzureNamedKeyCredential, « name » doit être le nom du compte de stockage et « key » doit être la clé du compte de stockage.

overwrite

bool

Indique si l’objet blob à charger doit remplacer les données actuelles. Si la valeur est True, upload_blob_to_url remplacera toutes les données existantes. Si la valeur est False, l’opération échoue avec un ResourceExistsError.

max_concurrency

int

Nombre de connexions parallèles à télécharger.

length

int

Nombre d’octets à lire à partir du flux. Cette option est facultative, mais doit être fournie pour des performances optimales.

metadata

dict(str,str)

Paires nom-valeur associées à l'objet blob en tant que métadonnées.

validate_content

bool

Si la valeur est true, calcule un hachage MD5 pour chaque segment de l’objet blob. Le service de stockage vérifie le hachage du contenu qui est arrivé avec le hachage envoyé. Cela est principalement utile pour la détection de bitflips sur le câble si l’utilisation de http au lieu de https comme https (la valeur par défaut) est déjà validée. Notez que ce hachage MD5 n'est pas stocké avec l'objet blob. Notez également que s’il est activé, l’algorithme de chargement à mémoire efficace ne sera pas utilisé, car le calcul du hachage MD5 nécessite la mise en mémoire tampon de blocs entiers, ce qui va à l’échec de l’objectif de l’algorithme d’efficacité de la mémoire.

encoding

str

Encodage à utiliser si le texte est fourni en tant qu’entrée. La valeur par défaut est UTF-8.

Retours

Dict de propriété mise à jour d’objet blob (Etag et dernière modification)

Type de retour

dict(str, Any)