BlobSASSignatureValues interface

Pacote:

@azure/storage-blob

DISPONÍVEL APENAS EM TEMPO DE EXECUÇÃO NODE.JS.

BlobSASSignatureValues é usado para ajudar a gerar tokens SAS de serviço de Blob para contêineres ou blobs.

Propriedades

blobName	Optional. O nome do blob do usuário SAS pode acessar. Necessário se snapshotTime ou versionId for fornecido.
cacheControl	Optional. O cabeçalho cache-control para o SAS.
containerName	O nome do contêiner que o usuário SAS pode acessar.
contentDisposition	Optional. O cabeçalho de disposição de conteúdo para o SAS.
contentEncoding	Optional. O cabeçalho de codificação de conteúdo para o SAS.
contentLanguage	Optional. O cabeçalho de linguagem de conteúdo para o SAS.
contentType	Optional. O cabeçalho de tipo de conteúdo para o SAS.
correlationId	Optional. A partir da versão 2020-02-10, esse é um valor GUID que será registrado nos logs de diagnóstico de armazenamento e pode ser usado para correlacionar a geração de SAS com o acesso a recursos de armazenamento. Isso só é usado para SAS de delegação de usuário.
delegatedUserObjectId	Optional. A partir da versão 2025-07-05, este valor especifica que o ID Entra do utilizador está autorizado a usar a URL SAS resultante. A URL SAS resultante deve ser usada em conjunto com um token Entra ID que tenha sido emitido ao utilizador especificado neste valor.
encryptionScope	Optional. Escopo de criptografia a ser usado ao enviar solicitações autorizadas com este URI SAS.
expiresOn	Opcional apenas quando o identificador é fornecido. O tempo após o qual o SAS deixará de funcionar.
identifier	Optional. O nome da política de acesso no contêiner ao qual esta SAS faz referência, se houver. Visualizar https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy
ipRange	Optional. Intervalos de IP permitidos nesta SAS.
permissions	Opcional apenas quando o identificador é fornecido. Consulte ContainerSASPermissions ou BlobSASPermissions dependendo do recurso que está sendo acessado para obter ajuda na construção da cadeia de permissões.
preauthorizedAgentObjectId	Optional. A partir da versão 2020-02-10, especifica o ID de objeto autorizado do AAD no formato GUID. O ID de objeto do AAD de um usuário autorizado pelo proprietário da chave de delegação do usuário para executar a ação concedida pelo SAS. O serviço de Armazenamento do Azure garantirá que o proprietário da chave de delegação do usuário tenha as permissões necessárias antes de conceder acesso, mas nenhuma verificação de permissão adicional para o usuário especificado nesse valor será executada. Isso só é usado para SAS de delegação de usuário.
protocol	Optional. Protocolos SAS, apenas HTTPS ou HTTPSandHTTP
snapshotTime	Optional. Cadeia de caracteres de carimbo de data/hora do instantâneo que o usuário SAS pode acessar. Apenas suportado a partir da versão API 2018-11-09.
startsOn	Optional. Quando o SAS entrará em vigor.
version	A versão do serviço a que este SAS se destinará. Se não for especificado, o padrão será a versão direcionada pela biblioteca.
versionId	Optional. VersionId da versão de blob que o usuário SAS pode acessar. Apenas suportado a partir da versão API 2019-10-10.

Detalhes da Propriedade

blobName

Optional. O nome do blob do usuário SAS pode acessar. Necessário se snapshotTime ou versionId for fornecido.

blobName?: string

Valor da Propriedade

string

cacheControl

Optional. O cabeçalho cache-control para o SAS.

cacheControl?: string

Valor da Propriedade

string

containerName

O nome do contêiner que o usuário SAS pode acessar.

containerName: string

Valor da Propriedade

string

contentDisposition

Optional. O cabeçalho de disposição de conteúdo para o SAS.

contentDisposition?: string

Valor da Propriedade

string

contentEncoding

Optional. O cabeçalho de codificação de conteúdo para o SAS.

contentEncoding?: string

Valor da Propriedade

string

contentLanguage

Optional. O cabeçalho de linguagem de conteúdo para o SAS.

contentLanguage?: string

Valor da Propriedade

string

contentType

Optional. O cabeçalho de tipo de conteúdo para o SAS.

contentType?: string

Valor da Propriedade

string

correlationId

Optional. A partir da versão 2020-02-10, esse é um valor GUID que será registrado nos logs de diagnóstico de armazenamento e pode ser usado para correlacionar a geração de SAS com o acesso a recursos de armazenamento. Isso só é usado para SAS de delegação de usuário.

correlationId?: string

Valor da Propriedade

string

delegatedUserObjectId

Optional. A partir da versão 2025-07-05, este valor especifica que o ID Entra do utilizador está autorizado a usar a URL SAS resultante. A URL SAS resultante deve ser usada em conjunto com um token Entra ID que tenha sido emitido ao utilizador especificado neste valor.

delegatedUserObjectId?: string

Valor da Propriedade

string

encryptionScope

Optional. Escopo de criptografia a ser usado ao enviar solicitações autorizadas com este URI SAS.

encryptionScope?: string

Valor da Propriedade

string

expiresOn

Opcional apenas quando o identificador é fornecido. O tempo após o qual o SAS deixará de funcionar.

expiresOn?: Date

Valor da Propriedade

Date

identifier

Optional. O nome da política de acesso no contêiner ao qual esta SAS faz referência, se houver.

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

identifier?: string

Valor da Propriedade

string

ipRange

Optional. Intervalos de IP permitidos nesta SAS.

ipRange?: SasIPRange

Valor da Propriedade

SasIPRange

permissions

Opcional apenas quando o identificador é fornecido. Consulte ContainerSASPermissions ou BlobSASPermissions dependendo do recurso que está sendo acessado para obter ajuda na construção da cadeia de permissões.

permissions?: BlobSASPermissions | ContainerSASPermissions

Valor da Propriedade

BlobSASPermissions | ContainerSASPermissions

preauthorizedAgentObjectId

Optional. A partir da versão 2020-02-10, especifica o ID de objeto autorizado do AAD no formato GUID. O ID de objeto do AAD de um usuário autorizado pelo proprietário da chave de delegação do usuário para executar a ação concedida pelo SAS. O serviço de Armazenamento do Azure garantirá que o proprietário da chave de delegação do usuário tenha as permissões necessárias antes de conceder acesso, mas nenhuma verificação de permissão adicional para o usuário especificado nesse valor será executada. Isso só é usado para SAS de delegação de usuário.

preauthorizedAgentObjectId?: string

Valor da Propriedade

string

protocol

Optional. Protocolos SAS, apenas HTTPS ou HTTPSandHTTP

protocol?: SASProtocol

Valor da Propriedade

SASProtocol

snapshotTime

Optional. Cadeia de caracteres de carimbo de data/hora do instantâneo que o usuário SAS pode acessar. Apenas suportado a partir da versão API 2018-11-09.

snapshotTime?: string

Valor da Propriedade

string

startsOn

Optional. Quando o SAS entrará em vigor.

startsOn?: Date

Valor da Propriedade

Date

version

A versão do serviço a que este SAS se destinará. Se não for especificado, o padrão será a versão direcionada pela biblioteca.

version?: string

Valor da Propriedade

string

versionId

Optional. VersionId da versão de blob que o usuário SAS pode acessar. Apenas suportado a partir da versão API 2019-10-10.

versionId?: string

Valor da Propriedade

string