Partager via


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

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