BlobSasBuilder Classe

Définition

BlobSasBuilder est utilisé pour générer une signature d’accès partagé (SAP) pour un conteneur ou un objet blob stockage Azure. Pour plus d'informations, consultez la rubrique Créez une SAP de service.

public class BlobSasBuilder
type BlobSasBuilder = class
Public Class BlobSasBuilder
Héritage
BlobSasBuilder

Constructeurs

BlobSasBuilder(BlobContainerSasPermissions, DateTimeOffset)

Initialise une nouvelle instance de la BlobSasBuilder classe pour créer une sas de service de conteneur d’objets blob.

BlobSasBuilder(BlobSasPermissions, DateTimeOffset)

Initialise une nouvelle instance de la BlobSasBuilder classe pour créer une sap de service Blob.

Propriétés

BlobContainerName

Nom du conteneur d’objets blob rendu accessible.

BlobName

Nom de l’objet blob rendu accessible, ou Empty pour une SAP de conteneur.

BlobVersionId

Nom de la version de l’objet blob rendue accessible, ou Empty pour une SAP d’objet blob.

CacheControl

Remplacez la valeur retournée pour Cache-Control'en-tête de réponse.

ContentDisposition

Remplacez la valeur retournée pour l’en-tête de réponse Content-Disposition.

ContentEncoding

Remplacez la valeur retournée pour l’en-tête de réponse Content-Encoding.

ContentLanguage

Remplacez la valeur retournée pour l’en-tête de réponse Content-Language.

ContentType

Remplacez la valeur retournée pour l’en-tête de réponse Content-Type.

CorrelationId

facultatif. À compter de la version 2020-02-10, cette valeur sera utilisée pour 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 signature d’accès partagé. Il est utilisé uniquement pour la sape de délégation d’utilisateur.

EncryptionScope

facultatif. Étendue de chiffrement à utiliser lors de l’envoi de requêtes autorisées avec cet URI SAS.

ExpiresOn

Heure à laquelle la signature d’accès partagé ne devient plus valide. Ce champ doit être omis s'il a été spécifié dans une stratégie d'accès stockée associée.

Identifier

Valeur unique facultative d’une longueur maximale de 64 caractères qui correspond à une stratégie d’accès spécifiée pour le conteneur.

IPRange

Spécifie une adresse IP ou une plage d’adresses IP à partir de laquelle accepter les demandes. Si l’adresse IP à partir de laquelle la demande provient 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. Lorsque vous spécifiez une plage d’adresses IP, notez que la plage est inclusive.

Permissions

Autorisations associées à la signature d'accès partagé. L'utilisateur est limité aux opérations autorisées par les autorisations. Ce champ doit être omis s'il a été spécifié dans une stratégie d'accès stockée associée. Le BlobSasPermissions, BlobContainerSasPermissions, SnapshotSasPermissionsou BlobAccountSasPermissions peut être utilisé pour créer la chaîne d’autorisations.

PreauthorizedAgentObjectId

facultatif. À compter de la version 2020-02-10, cette valeur sera utilisée pour l’ID d’objet AAD d’un utilisateur autorisé par le propriétaire de la clé de délégation utilisateur à effectuer l’action accordée par la SAP. Le service Stockage Azure s’assure que le propriétaire de la clé de délégation utilisateur dispose des autorisations requises avant d’accorder l’accès. Aucune autorisation supplémentaire case activée pour l’utilisateur spécifié dans cette valeur n’est effectuée. Elle est utilisée uniquement avec la génération de SAP de délégation d’utilisateur.

Protocol

Le champ facultatif protocole signé spécifie le protocole autorisé pour une requête effectuée avec la signature d’accès partagé. Les valeurs possibles sont HttpsAndHttp, Https et None.

Resource

Spécifie les ressources accessibles via la signature d’accès partagé.

Spécifiez « b » si la ressource partagée est un objet blob. Ce paramètre accorde l'accès au contenu et aux métadonnées de l'objet blob.

Spécifiez « c » si la ressource partagée est un conteneur d’objets blob. Ce paramètre accorde l'accès au contenu et aux métadonnées des objets blob du conteneur, ainsi qu'à la liste des objets blob du conteneur.

À compter de la version 2018-11-09, spécifiez « bs » si la ressource partagée est un objet blob instantané. Cela accorde l’accès au contenu et aux métadonnées de l’instantané spécifique, mais pas à l’objet blob racine correspondant.

À compter de la version 2019-12-12, spécifiez « bv » si la ressource partagée est une version d’objet blob. Cela accorde l’accès au contenu et aux métadonnées de la version spécifique, mais pas à l’objet blob racine correspondant.

Snapshot

Nom du instantané rendu accessible, ou Empty pour une sape d’objet blob.

StartsOn

Spécifiez éventuellement l’heure à laquelle la signature d’accès partagé devient valide. S’il est omis lors de l’utilisation de DateTimeOffset.MinValue, l’heure de début de cet appel est supposée être l’heure à laquelle le service de stockage reçoit la demande.

Méthodes

SetPermissions(BlobAccountSasPermissions)

Définit les autorisations pour une SAP de niveau compte d’objet blob.

SetPermissions(BlobContainerSasPermissions)

Définit les autorisations pour une SAP de conteneur d’objets blob.

SetPermissions(BlobSasPermissions)

Définit les autorisations pour une SAP d’objet blob.

SetPermissions(BlobVersionSasPermissions)

Définit les autorisations pour une sape de version.

SetPermissions(SnapshotSasPermissions)

Définit les autorisations pour une SAP d’instantané.

SetPermissions(String)

Définit les autorisations pour la signature d’accès partagé à l’aide d’une chaîne d’autorisations brute.

SetPermissions(String, Boolean)

Définit les autorisations pour la signature d’accès partagé à l’aide d’une chaîne d’autorisations brute.

ToSasQueryParameters(StorageSharedKeyCredential)

Utilisez un compte pour signer ces valeurs de StorageSharedKeyCredential signature d’accès partagé afin de produire les paramètres de requête SAS appropriés pour l’authentification des demandes.

ToSasQueryParameters(UserDelegationKey, String)

Utilisez un compte pour signer ces valeurs de UserDelegationKey signature d’accès partagé afin de produire les paramètres de requête SAS appropriés pour l’authentification des demandes.

S’applique à