BlobSASSignatureValues interface

DISPONÍVEL APENAS EM NODE.JS RUNTIME.

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

Propriedades

blobName

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

cacheControl

Opcional. O cabeçalho de controle de cache para a SAS.

containerName

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

contentDisposition

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

contentEncoding

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

contentLanguage

Opcional. O cabeçalho de linguagem de conteúdo para a SAS.

contentType

Opcional. O cabeçalho de tipo de conteúdo para a SAS.

correlationId

Opcional. 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

Opcional. A partir da versão 2025-07-05, esse valor especifica o ID Entra do usuário autorizado a usar a URL SAS resultante. A URL SAS resultante deve ser usada em conjunto com um token Entra ID que foi emitido ao usuário especificado nesse valor.

encryptionScope

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

expiresOn

Opcional somente quando o identificador for fornecido. O tempo após o qual a SAS não funcionará mais.

identifier

Opcional. O nome da política de acesso no contêiner que essa SAS faz referência se houver.

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

ipRange

Opcional. Intervalos de IP permitidos nesta SAS.

permissions

Opcional somente quando o identificador for fornecido. Consulte ContainerSASPermissions ou blobSASPermissions dependendo do recurso que está sendo acessado para ajudar a construir a cadeia de caracteres de permissões.

preauthorizedAgentObjectId

Opcional. A partir da versão 2020-02-10, especifica a ID do objeto do AAD autorizado no formato GUID. A 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 pela SAS. O serviço de Armazenamento do Azure garantirá que o proprietário da chave de delegação de 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

Opcional. Protocolos SAS, somente HTTPS ou HTTPSandHTTP

requestHeaders

Cabeçalhos de requisição usados na geração de um token SAS

requestQueryParameters

Parâmetros de consulta de requisição usados na geração de um token SAS

snapshotTime

Opcional. Cadeia de caracteres de carimbo de data/hora de instantâneo que o usuário sas pode acessar. Só há suporte da API versão 2018-11-09.

startsOn

Opcional. Quando a SAS entrar em vigor.

version

A versão do serviço que esta SAS terá como destino. Se não for especificado, ele usará como padrão a versão direcionada pela biblioteca.

versionId

Opcional. VersionId da versão de blob que o usuário SAS pode acessar. Só há suporte da API versão 2019-10-10.

Detalhes da propriedade

blobName

Opcional. 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

Opcional. O cabeçalho de controle de cache para a 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

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

contentDisposition?: string

Valor da propriedade

string

contentEncoding

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

contentEncoding?: string

Valor da propriedade

string

contentLanguage

Opcional. O cabeçalho de linguagem de conteúdo para a SAS.

contentLanguage?: string

Valor da propriedade

string

contentType

Opcional. O cabeçalho de tipo de conteúdo para a SAS.

contentType?: string

Valor da propriedade

string

correlationId

Opcional. 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

Opcional. A partir da versão 2025-07-05, esse valor especifica o ID Entra do usuário autorizado a usar a URL SAS resultante. A URL SAS resultante deve ser usada em conjunto com um token Entra ID que foi emitido ao usuário especificado nesse valor.

delegatedUserObjectId?: string

Valor da propriedade

string

encryptionScope

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

encryptionScope?: string

Valor da propriedade

string

expiresOn

Opcional somente quando o identificador for fornecido. O tempo após o qual a SAS não funcionará mais.

expiresOn?: Date

Valor da propriedade

Date

identifier

Opcional. O nome da política de acesso no contêiner que essa SAS faz referência se houver.

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

identifier?: string

Valor da propriedade

string

ipRange

Opcional. Intervalos de IP permitidos nesta SAS.

ipRange?: SasIPRange

Valor da propriedade

permissions

Opcional somente quando o identificador for fornecido. Consulte ContainerSASPermissions ou blobSASPermissions dependendo do recurso que está sendo acessado para ajudar a construir a cadeia de caracteres de permissões.

permissions?: BlobSASPermissions | ContainerSASPermissions

Valor da propriedade

preauthorizedAgentObjectId

Opcional. A partir da versão 2020-02-10, especifica a ID do objeto do AAD autorizado no formato GUID. A 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 pela SAS. O serviço de Armazenamento do Azure garantirá que o proprietário da chave de delegação de 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

Opcional. Protocolos SAS, somente HTTPS ou HTTPSandHTTP

protocol?: SASProtocol

Valor da propriedade

requestHeaders

Cabeçalhos de requisição usados na geração de um token SAS

requestHeaders?: RequestHeaders

Valor da propriedade

requestQueryParameters

Parâmetros de consulta de requisição usados na geração de um token SAS

requestQueryParameters?: RequestQueryParameters

Valor da propriedade

snapshotTime

Opcional. Cadeia de caracteres de carimbo de data/hora de instantâneo que o usuário sas pode acessar. Só há suporte da API versão 2018-11-09.

snapshotTime?: string

Valor da propriedade

string

startsOn

Opcional. Quando a SAS entrar em vigor.

startsOn?: Date

Valor da propriedade

Date

version

A versão do serviço que esta SAS terá como destino. Se não for especificado, ele usará como padrão a versão direcionada pela biblioteca.

version?: string

Valor da propriedade

string

versionId

Opcional. VersionId da versão de blob que o usuário SAS pode acessar. Só há suporte da API versão 2019-10-10.

versionId?: string

Valor da propriedade

string