BlobSasBuilder Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 à
Azure SDK for .NET