BlobSASSignatureValues interface

Pakiet:

@azure/storage-blob

DOSTĘPNE TYLKO W ŚRODOWISKU URUCHOMIENIOWYM NODE.JS.

Funkcja BlobSASSignatureValues ułatwia generowanie tokenów SAS usługi Blob service dla kontenerów lub obiektów blob.

Właściwości

blobName	Optional. Nazwa obiektu blob użytkownika sygnatury dostępu współdzielonego może uzyskać dostęp. Wymagane, jeśli podano parametr snapshotTime lub versionId.
cacheControl	Optional. Nagłówek kontrolki pamięci podręcznej dla sygnatury dostępu współdzielonego.
containerName	Nazwa kontenera, do których użytkownik sygnatury dostępu współdzielonego może uzyskać dostęp.
contentDisposition	Optional. Nagłówek zawartości dla sygnatury dostępu współdzielonego.
contentEncoding	Optional. Nagłówek kodowania zawartości dla sygnatury dostępu współdzielonego.
contentLanguage	Optional. Nagłówek języka zawartości dla sygnatury dostępu współdzielonego.
contentType	Optional. Nagłówek typu zawartości dla sygnatury dostępu współdzielonego.
correlationId	Optional. Począwszy od wersji 2020-02-10, jest to wartość identyfikatora GUID, która zostanie zarejestrowana w dziennikach diagnostycznych magazynu i może służyć do korelowania generowania sygnatury dostępu współdzielonego z dostępem do zasobów magazynu. Jest to używane tylko w przypadku sygnatury dostępu współdzielonego delegowania użytkowników.
delegatedUserObjectId	Optional. Począwszy od wersji 2025-07-05, ta wartość określa identyfikator Entra użytkownika, który jest autoryzowany do korzystania z powstałego adresu URL SAS. Powstały adres URL SAS musi być używany razem z tokenem Entra ID, który został przydzielony użytkownikowi wskazanemu w tej wartości.
encryptionScope	Optional. Zakres szyfrowania do użycia podczas wysyłania żądań autoryzowanych za pomocą tego identyfikatora URI sygnatury dostępu współdzielonego.
expiresOn	Opcjonalnie tylko w przypadku podania identyfikatora. Czas, po którym sygnatura dostępu współdzielonego nie będzie już działać.
identifier	Optional. Nazwa zasad dostępu w kontenerze, do którego odwołuje się ta sygnatura dostępu współdzielonego, jeśli istnieje. Zobacz https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy
ipRange	Optional. Zakresy adresów IP dozwolone w tej sygnaturze dostępu współdzielonego.
permissions	Opcjonalnie tylko w przypadku podania identyfikatora. Zapoznaj się z ContainerSASPermissions lub BlobSASPermissions w zależności od zasobu, do których uzyskuje się dostęp, aby uzyskać pomoc w konstruowaniu ciągu uprawnień.
preauthorizedAgentObjectId	Optional. Począwszy od wersji 2020-02-10, określa autoryzowany identyfikator obiektu usługi AAD w formacie GUID. Identyfikator obiektu usługi AAD użytkownika autoryzowanego przez właściciela klucza delegowania użytkownika w celu wykonania akcji przyznanej przez sygnaturę dostępu współdzielonego. Usługa Azure Storage zapewni, że właściciel klucza delegowania użytkownika ma wymagane uprawnienia przed udzieleniem dostępu, ale nie zostanie wykonane żadne dodatkowe sprawdzenie uprawnień dla użytkownika określonego w tej wartości. Jest to używane tylko w przypadku sygnatury dostępu współdzielonego delegowania użytkowników.
protocol	Optional. Protokoły SAS, tylko HTTPS lub HTTPSandHTTP
snapshotTime	Optional. Ciąg sygnatury czasowej migawki, do których użytkownik sygnatury dostępu współdzielonego może uzyskać dostęp. Obsługiwane tylko z interfejsu API w wersji 2018-11-09.
startsOn	Optional. Gdy sygnatura dostępu współdzielonego zacznie obowiązywać.
version	Wersja usługi, która będzie docelowa dla tej sygnatury dostępu współdzielonego. Jeśli nie zostanie określony, domyślnie będzie to wersja docelowa biblioteki.
versionId	Optional. VersionId wersji obiektu blob, do których użytkownik sygnatury dostępu współdzielonego może uzyskać dostęp. Obsługiwane tylko z interfejsu API w wersji 2019-10-10.

Szczegóły nieruchomości

blobName

Optional. Nazwa obiektu blob użytkownika sygnatury dostępu współdzielonego może uzyskać dostęp. Wymagane, jeśli podano parametr snapshotTime lub versionId.

blobName?: string

Wartość nieruchomości

string

cacheControl

Optional. Nagłówek kontrolki pamięci podręcznej dla sygnatury dostępu współdzielonego.

cacheControl?: string

Wartość nieruchomości

string

containerName

Nazwa kontenera, do których użytkownik sygnatury dostępu współdzielonego może uzyskać dostęp.

containerName: string

Wartość nieruchomości

string

contentDisposition

Optional. Nagłówek zawartości dla sygnatury dostępu współdzielonego.

contentDisposition?: string

Wartość nieruchomości

string

contentEncoding

Optional. Nagłówek kodowania zawartości dla sygnatury dostępu współdzielonego.

contentEncoding?: string

Wartość nieruchomości

string

contentLanguage

Optional. Nagłówek języka zawartości dla sygnatury dostępu współdzielonego.

contentLanguage?: string

Wartość nieruchomości

string

contentType

Optional. Nagłówek typu zawartości dla sygnatury dostępu współdzielonego.

contentType?: string

Wartość nieruchomości

string

correlationId

Optional. Począwszy od wersji 2020-02-10, jest to wartość identyfikatora GUID, która zostanie zarejestrowana w dziennikach diagnostycznych magazynu i może służyć do korelowania generowania sygnatury dostępu współdzielonego z dostępem do zasobów magazynu. Jest to używane tylko w przypadku sygnatury dostępu współdzielonego delegowania użytkowników.

correlationId?: string

Wartość nieruchomości

string

delegatedUserObjectId

Optional. Począwszy od wersji 2025-07-05, ta wartość określa identyfikator Entra użytkownika, który jest autoryzowany do korzystania z powstałego adresu URL SAS. Powstały adres URL SAS musi być używany razem z tokenem Entra ID, który został przydzielony użytkownikowi wskazanemu w tej wartości.

delegatedUserObjectId?: string

Wartość nieruchomości

string

encryptionScope

Optional. Zakres szyfrowania do użycia podczas wysyłania żądań autoryzowanych za pomocą tego identyfikatora URI sygnatury dostępu współdzielonego.

encryptionScope?: string

Wartość nieruchomości

string

expiresOn

Opcjonalnie tylko w przypadku podania identyfikatora. Czas, po którym sygnatura dostępu współdzielonego nie będzie już działać.

expiresOn?: Date

Wartość nieruchomości

Date

identifier

Optional. Nazwa zasad dostępu w kontenerze, do którego odwołuje się ta sygnatura dostępu współdzielonego, jeśli istnieje.

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

identifier?: string

Wartość nieruchomości

string

ipRange

Optional. Zakresy adresów IP dozwolone w tej sygnaturze dostępu współdzielonego.

ipRange?: SasIPRange

Wartość nieruchomości

SasIPRange

permissions

Opcjonalnie tylko w przypadku podania identyfikatora. Zapoznaj się z ContainerSASPermissions lub BlobSASPermissions w zależności od zasobu, do których uzyskuje się dostęp, aby uzyskać pomoc w konstruowaniu ciągu uprawnień.

permissions?: BlobSASPermissions | ContainerSASPermissions

Wartość nieruchomości

BlobSASPermissions | ContainerSASPermissions

preauthorizedAgentObjectId

Optional. Począwszy od wersji 2020-02-10, określa autoryzowany identyfikator obiektu usługi AAD w formacie GUID. Identyfikator obiektu usługi AAD użytkownika autoryzowanego przez właściciela klucza delegowania użytkownika w celu wykonania akcji przyznanej przez sygnaturę dostępu współdzielonego. Usługa Azure Storage zapewni, że właściciel klucza delegowania użytkownika ma wymagane uprawnienia przed udzieleniem dostępu, ale nie zostanie wykonane żadne dodatkowe sprawdzenie uprawnień dla użytkownika określonego w tej wartości. Jest to używane tylko w przypadku sygnatury dostępu współdzielonego delegowania użytkowników.

preauthorizedAgentObjectId?: string

Wartość nieruchomości

string

protocol

Optional. Protokoły SAS, tylko HTTPS lub HTTPSandHTTP

protocol?: SASProtocol

Wartość nieruchomości

SASProtocol

snapshotTime

Optional. Ciąg sygnatury czasowej migawki, do których użytkownik sygnatury dostępu współdzielonego może uzyskać dostęp. Obsługiwane tylko z interfejsu API w wersji 2018-11-09.

snapshotTime?: string

Wartość nieruchomości

string

startsOn

Optional. Gdy sygnatura dostępu współdzielonego zacznie obowiązywać.

startsOn?: Date

Wartość nieruchomości

Date

version

Wersja usługi, która będzie docelowa dla tej sygnatury dostępu współdzielonego. Jeśli nie zostanie określony, domyślnie będzie to wersja docelowa biblioteki.

version?: string

Wartość nieruchomości

string

versionId

Optional. VersionId wersji obiektu blob, do których użytkownik sygnatury dostępu współdzielonego może uzyskać dostęp. Obsługiwane tylko z interfejsu API w wersji 2019-10-10.

versionId?: string

Wartość nieruchomości

string