Partager via


DataLakeSasBuilder Classe

Définition

DataLakeSasBuilder est utilisé pour générer une signature d’accès partagé (SAP) pour un système de fichiers ou un chemin d’accès Data Lake

   For more information, see
Construction d’une SAP de service.
public class DataLakeSasBuilder
type DataLakeSasBuilder = class
Public Class DataLakeSasBuilder
Héritage
DataLakeSasBuilder

Constructeurs

DataLakeSasBuilder(DataLakeFileSystemSasPermissions, DateTimeOffset)

Initialise une nouvelle instance de la DataLakeSasBuilder classe pour créer un sas de service Blob.

DataLakeSasBuilder(DataLakeSasPermissions, DateTimeOffset)

Initialise une nouvelle instance de la DataLakeSasBuilder classe pour créer un sas de service Blob.

Propriétés

AgentObjectId

Optionnel. À 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 garantit que le propriétaire de la clé de délégation utilisateur dispose des autorisations requises avant d’accorder l’accès. le service stockage Azure effectue une liste de contrôle d’accès POSIX supplémentaire case activée pour déterminer si l’utilisateur est autorisé à effectuer l’opération demandée. Il ne peut pas être utilisé en conjuction avec PreauthorizedAgentObjectId. Il est utilisé uniquement avec la génération de sas de délégation d’utilisateur.

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 Cache-Encoding'en-tête de réponse.

ContentLanguage

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

ContentType

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

CorrelationId

Optionnel. À 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 sap. Il est utilisé uniquement pour la signature SAP de délégation d’utilisateur.

EncryptionScope

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

ExpiresOn

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

FileSystemName

Nom du système de fichiers rendu accessible.

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 système de fichiers.

IPRange

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. Lorsque vous spécifiez une plage d’adresses IP, notez que la plage est inclusive.

IsDirectory

À compter de la version 2020-02-10, cette valeur définit si le Path est ou non un répertoire. Si cette valeur est définie sur true, le chemin d’accès est un répertoire pour une sap d’annuaire. S’il est défini sur false ou par défaut, le chemin d’accès est un chemin d’accès au fichier pour une sap de chemin de fichier.

Path

Nom du chemin d’accès rendu accessible, ou Empty pour une sap de système de fichiers. À compter de la version 2020-02-10, la définition de la valeur IsDirectory true signifie que nous allons accepter le chemin d’accès en tant que répertoire pour une sap d’annuaire. Si elle n’est pas définie, cette valeur est supposée être un chemin d’accès au fichier pour une sap de chemin de fichier.

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. DataLakeFileSystemSasPermissionsDataLakeAccountSasPermissions ou DataLakeSasPermissionspeut être utilisé pour créer la chaîne d’autorisations.

PreauthorizedAgentObjectId

Optionnel. À 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 garantit 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. Il ne peut pas être utilisé en conjuction avec AgentObjectId. Il est utilisé uniquement avec la génération de sas de délégation d’utilisateur.

Protocol

Le champ protocole signé facultatif 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 instantané blob. Cela accorde l’accès au contenu et aux métadonnées du instantané spécifique, mais pas à l’objet blob racine correspondant.

À compter de la version 2020-02-10, spécifiez « d » si la ressource partagée est un répertoire DataLake. Cela accorde l’accès aux chemins d’accès dans le répertoire et à la liste des chemins d’accès dans le répertoire. Lorsque « d » est spécifié, le paramètre de requête sdd est également requis.

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(DataLakeAccountSasPermissions)

Définit les autorisations pour une sap de niveau compte de chemin d’accès.

SetPermissions(DataLakeFileSystemSasPermissions)

Définit les autorisations pour une sap de système de fichiers.

SetPermissions(DataLakeSasPermissions)

Définit les autorisations pour une SAP de fichier.

SetPermissions(String)

Définit les autorisations pour la sap à l’aide d’une chaîne d’autorisations brute.

SetPermissions(String, Boolean)

Définit les autorisations pour la sap à 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 à