SASQueryParameters class

Paquet:: @azure/storage-file-datalake

Représente les composants qui composent les paramètres de requête d’azure Storage SAS. Ce type n’est pas construit directement par l’utilisateur ; elle est générée uniquement par les types AccountSASSignatureValues et <xref:BlobSASSignatureValues>. Une fois généré, il peut être encodé dans un toString() et ajouté directement à une URL (bien que la prudence soit prise ici dans le cas où il existe des paramètres de requête existants, ce qui peut affecter les moyens appropriés d’ajouter ces paramètres de requête).

REMARQUE : les instances de cette classe sont immuables.

Constructeurs

SASQueryParameters(string, string, SASQueryParametersOptions)	Crée une instance de SASQueryParameters.
SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, number, string, string, string, string)	Crée une instance de SASQueryParameters.

Propriétés

agentObjectId	ID d’objet AAD non autorisé au format GUID. ID d’objet AAD d’un utilisateur supposé être non autorisé par le propriétaire de la clé de délégation d’utilisateur. Le service stockage Azure effectue une vérification ACL POSIX supplémentaire pour déterminer si l’utilisateur est autorisé à effectuer l’opération demandée. Cela ne peut pas être utilisé dans la conjuction avec <xref:signedAuthorizedUserObjectId>. Cela est utilisé uniquement pour la SAP de délégation d’utilisateur.
cacheControl	Valeur de l’en-tête de contrôle du cache dans la SAP Blob/File Service.
contentDisposition	Valeur de l’en-tête de disposition de contenu dans la SAP du service blob/fichier.
contentEncoding	Valeur de l’en-tête d’encodage de contenu dans la SAP du service blob/fichier.
contentLanguage	Valeur de l’en-tête de longueur de contenu dans la SAP du service d’objets blob/fichier.
contentType	Valeur de l’en-tête de type de contenu dans la SAP Blob/File Service.
correlationId	Valeur GUID qui sera journalisée dans les journaux de diagnostic de stockage et qui peut être utilisée pour mettre en corrélation la génération SAS avec l’accès aux ressources de stockage. Cela est utilisé uniquement pour la SAP de délégation d’utilisateur.
directoryDepth	Indiquez la profondeur du répertoire spécifié dans le champ canonicalizedresource de la chaîne à signer. La profondeur du répertoire est le nombre de répertoires situés sous le dossier racine.
encryptionScope	Optional. Étendue de chiffrement à utiliser lors de l’envoi de requêtes autorisées avec cet URI SAP.
expiresOn	Facultatif uniquement lorsque l’identificateur est fourni. Heure d’expiration de ce jeton SAP.
identifier	Optional. Identificateur signé (uniquement pour <xref:BlobSASSignatureValues>). Voir https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy
ipRange	Optional. Plage d’adresses IP autorisée pour cette SAP.
permissions	Facultatif uniquement lorsque l’identificateur est fourni. Pour plus d’informations, consultez AccountSASPermissions, <xref:BlobSASPermissions>ou <xref:ContainerSASPermissions>.
preauthorizedAgentObjectId	ID d’objet AAD autorisé au format GUID. ID d’objet AAD d’un utilisateur autorisé par le propriétaire de la clé de délégation d’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 d’utilisateur dispose des autorisations requises avant d’accorder l’accès, mais aucun contrôle d’autorisation supplémentaire pour l’utilisateur spécifié dans cette valeur sera effectué. Cela ne peut pas être utilisé dans la conjuction avec <xref:signedUnauthorizedUserObjectId>. Cela est utilisé uniquement pour la SAP de délégation d’utilisateur.
protocol	Optional. Protocole(s) HTTP autorisé(s).
resource	Optional. Spécifie les ressources accessibles via la SAP (uniquement pour <xref:BlobSASSignatureValues>). Voir https://learn.microsoft.com/rest/api/storageservices/create-service-sas#specifying-the-signed-resource-blob-service-only
resourceTypes	Optional. Types de ressources de stockage accessibles (uniquement pour la SAP de compte). Pour plus d’informations, consultez AccountSASResourceTypes.
services	Optional. Les services de stockage accessibles (uniquement pour la SAP de compte). Pour plus d’informations, consultez AccountSASServices.
signature	Signature du jeton SAP.
startsOn	Optional. Heure de début de ce jeton SAP.
version	Version de l’API de stockage.

Méthodes

toString()

Encode tous les paramètres de requête SAP dans une chaîne qui peut être ajoutée à une URL.

Détails du constructeur

SASQueryParameters(string, string, SASQueryParametersOptions)

Crée une instance de SASQueryParameters.

new SASQueryParameters(version: string, signature: string, options?: SASQueryParametersOptions)

Paramètres

version: string

Représentation de la version de stockage

signature: string

Représentant la signature du jeton SAP

options: SASQueryParametersOptions

Optional. Options de construction de SASQueryParameters.

SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, number, string, string, string, string)

Crée une instance de SASQueryParameters.

new SASQueryParameters(version: string, signature: string, permissions?: string, services?: string, resourceTypes?: string, protocol?: SASProtocol, startsOn?: Date, expiresOn?: Date, ipRange?: SasIPRange, identifier?: string, resource?: string, cacheControl?: string, contentDisposition?: string, contentEncoding?: string, contentLanguage?: string, contentType?: string, userDelegationKey?: UserDelegationKey, directoryDepth?: number, preauthorizedAgentObjectId?: string, agentObjectId?: string, correlationId?: string, encryptionScope?: string)

Paramètres

version: string

Représentation de la version de stockage

signature: string

Représentant la signature du jeton SAP

permissions: string

Représentant les autorisations de stockage

services: string

Représentant les services de stockage accessibles (uniquement pour la SAP de compte)

resourceTypes: string

Représentant les types de ressources de stockage accessibles (uniquement pour la SAP de compte)

protocol: SASProtocol

Représentant les protocoles HTTP autorisés

startsOn: Date

Représentant l’heure de début de ce jeton SAP

expiresOn: Date

Représentant l’heure d’expiration de ce jeton SAP

ipRange: SasIPRange

Représentant la plage d’adresses IP valides pour ce jeton SAP

identifier: string

Représentant l’identificateur signé (uniquement pour la SAP de service)

resource: string

Représentant le conteneur de stockage ou l’objet blob (uniquement pour la SAP de service)

cacheControl: string

Représentant l’en-tête de cache-contrôle (uniquement pour la SAP du service d’objets blob/de fichiers)

contentDisposition: string

Représentant l’en-tête de disposition du contenu (uniquement pour la sape d’objet blob/service de fichiers)

contentEncoding: string

Représentant l’en-tête d’encodage de contenu (uniquement pour la SAP du service d’objets blob/de fichiers)

contentLanguage: string

Représentant l’en-tête de langage de contenu (uniquement pour la SAP du service d’objets blob/de fichiers)

contentType: string

Représentant l’en-tête de type de contenu (uniquement pour la SAP du service blob/fichier)

userDelegationKey: UserDelegationKey

Représentant les propriétés de clé de délégation d’utilisateur

directoryDepth: number

preauthorizedAgentObjectId: string

Représentant l’ID d’objet AAD autorisé (uniquement pour la SAP de délégation d’utilisateur)

agentObjectId: string

Représentant l’ID d’objet AAD non autorisé (uniquement pour la SAP de délégation d’utilisateur)

correlationId: string

Représentant l’ID de corrélation (uniquement pour la SAP de délégation d’utilisateur)

encryptionScope: string

Détails de la propriété

agentObjectId

ID d’objet AAD non autorisé au format GUID. ID d’objet AAD d’un utilisateur supposé être non autorisé par le propriétaire de la clé de délégation d’utilisateur. Le service stockage Azure effectue une vérification ACL POSIX supplémentaire pour déterminer si l’utilisateur est autorisé à effectuer l’opération demandée. Cela ne peut pas être utilisé dans la conjuction avec <xref:signedAuthorizedUserObjectId>. Cela est utilisé uniquement pour la SAP de délégation d’utilisateur.

agentObjectId?: string

Valeur de propriété

string

cacheControl

Valeur de l’en-tête de contrôle du cache dans la SAP Blob/File Service.

cacheControl?: string

Valeur de propriété

string

contentDisposition

Valeur de l’en-tête de disposition de contenu dans la SAP du service blob/fichier.

contentDisposition?: string

Valeur de propriété

string

contentEncoding

Valeur de l’en-tête d’encodage de contenu dans la SAP du service blob/fichier.

contentEncoding?: string

Valeur de propriété

string

contentLanguage

Valeur de l’en-tête de longueur de contenu dans la SAP du service d’objets blob/fichier.

contentLanguage?: string

Valeur de propriété

string

contentType

Valeur de l’en-tête de type de contenu dans la SAP Blob/File Service.

contentType?: string

Valeur de propriété

string

correlationId

Valeur GUID qui sera journalisée dans les journaux de diagnostic de stockage et qui peut être utilisée pour mettre en corrélation la génération SAS avec l’accès aux ressources de stockage. Cela est utilisé uniquement pour la SAP de délégation d’utilisateur.

correlationId?: string

Valeur de propriété

string

directoryDepth

Indiquez la profondeur du répertoire spécifié dans le champ canonicalizedresource de la chaîne à signer. La profondeur du répertoire est le nombre de répertoires situés sous le dossier racine.

directoryDepth?: number

Valeur de propriété

number

encryptionScope

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

encryptionScope?: string

Valeur de propriété

string

expiresOn

Facultatif uniquement lorsque l’identificateur est fourni. Heure d’expiration de ce jeton SAP.

expiresOn?: Date

Valeur de propriété

Date

identifier

Optional. Identificateur signé (uniquement pour <xref:BlobSASSignatureValues>).

Voir https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy

identifier?: string

Valeur de propriété

string

ipRange

Optional. Plage d’adresses IP autorisée pour cette SAP.

undefined | SasIPRange ipRange

Valeur de propriété

undefined | SasIPRange

permissions

Facultatif uniquement lorsque l’identificateur est fourni. Pour plus d’informations, consultez AccountSASPermissions, <xref:BlobSASPermissions>ou <xref:ContainerSASPermissions>.

permissions?: string

Valeur de propriété

string

preauthorizedAgentObjectId

ID d’objet AAD autorisé au format GUID. ID d’objet AAD d’un utilisateur autorisé par le propriétaire de la clé de délégation d’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 d’utilisateur dispose des autorisations requises avant d’accorder l’accès, mais aucun contrôle d’autorisation supplémentaire pour l’utilisateur spécifié dans cette valeur sera effectué. Cela ne peut pas être utilisé dans la conjuction avec <xref:signedUnauthorizedUserObjectId>. Cela est utilisé uniquement pour la SAP de délégation d’utilisateur.

preauthorizedAgentObjectId?: string

Valeur de propriété

string

protocol

Optional. Protocole(s) HTTP autorisé(s).

protocol?: SASProtocol

Valeur de propriété

SASProtocol

resource

Optional. Spécifie les ressources accessibles via la SAP (uniquement pour <xref:BlobSASSignatureValues>).

Voir https://learn.microsoft.com/rest/api/storageservices/create-service-sas#specifying-the-signed-resource-blob-service-only

resource?: string

Valeur de propriété

string

resourceTypes

Optional. Types de ressources de stockage accessibles (uniquement pour la SAP de compte). Pour plus d’informations, consultez AccountSASResourceTypes.

resourceTypes?: string

Valeur de propriété

string

services

Optional. Les services de stockage accessibles (uniquement pour la SAP de compte). Pour plus d’informations, consultez AccountSASServices.

services?: string

Valeur de propriété

string

signature

Signature du jeton SAP.

signature: string

Valeur de propriété

string

startsOn

Optional. Heure de début de ce jeton SAP.

startsOn?: Date

Valeur de propriété

Date

version

Version de l’API de stockage.

version: string

Valeur de propriété

string

Détails de la méthode

toString()

Encode tous les paramètres de requête SAP dans une chaîne qui peut être ajoutée à une URL.

function toString(): string

Retours

string

Partager via

SASQueryParameters class

Constructeurs

Propriétés

Méthodes

Détails du constructeur

SASQueryParameters(string, string, SASQueryParametersOptions)

Paramètres

SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, number, string, string, string, string)

Paramètres

Détails de la propriété

agentObjectId

Valeur de propriété

cacheControl

Valeur de propriété

contentDisposition

Valeur de propriété

contentEncoding

Valeur de propriété

contentLanguage

Valeur de propriété

contentType

Valeur de propriété

correlationId

Valeur de propriété

directoryDepth

Valeur de propriété

encryptionScope

Valeur de propriété

expiresOn

Valeur de propriété

identifier

Valeur de propriété

ipRange

Valeur de propriété

permissions

Valeur de propriété

preauthorizedAgentObjectId

Valeur de propriété

protocol

Valeur de propriété

resource

Valeur de propriété

resourceTypes

Valeur de propriété

services

Valeur de propriété

signature

Valeur de propriété

startsOn

Valeur de propriété

version

Valeur de propriété

Détails de la méthode

toString()

Retours