DataLakeSASSignatureValues interface

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

DataLakeSASSignatureValues é usado para ajudar a gerar tokens SAS de serviço Blob e DataLake para contêineres, blobs, sistema de arquivos, diretórios e arquivos.

Propriedades

agentObjectId

Optional. A partir da versão 2020-02-10, especifica a ID do objeto AAD não autorizado no formato GUID. A ID do objeto AAD de um usuário que é considerado não autorizado pelo proprietário da chave de delegação do usuário. O Serviço de Armazenamento do Azure executará uma verificação adicional da ACL POSIX para determinar se o usuário está autorizado a executar a operação solicitada. Isso não pode ser usado em conjunto com preauthorizedAgentObjectId . Isso só é usado para SAS de delegação de usuário.

cacheControl

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

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.

directoryDepth

Optional. A partir da versão 2020-02-10, indique a profundidade do diretório especificado no campo canonicalizedresource da string-to-sign. A profundidade do diretório é o número de diretórios abaixo da pasta raiz.

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.

fileSystemName

O nome do sistema de arquivos que o usuário SAS pode acessar.

identifier

Optional. O nome da política de acesso no sistema de arquivos 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.

isDirectory

Optional. A partir da versão 2020-02-10, esse valor define se o pathName é ou não um diretório. Se esse valor for definido como true, o caminho será um diretório para uma SAS de diretório. Se definido como false ou default, o caminho é um caminho de arquivo para uma SAS de caminho de arquivo.

pathName

Optional. O nome do caminho do diretório ou arquivo SAS usuário pode acessar. Necessário se snapshotTime for fornecido.

permissions

Opcional apenas quando o identificador é fornecido. Consulte FileSystemSASPermissions, DirectorySASPermissions ou DataLakeSASPermissions 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 a ID do objeto AAD autorizado 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 não pode ser usado em conjunto com agentObjectId. Isso só é usado para SAS de delegação de usuário.

protocol

Optional. Protocolos SAS, apenas HTTPS ou HTTPSandHTTP

requestHeaders

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

requestQueryParameters

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

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.

Detalhes de Propriedade

agentObjectId

Optional. A partir da versão 2020-02-10, especifica a ID do objeto AAD não autorizado no formato GUID. A ID do objeto AAD de um usuário que é considerado não autorizado pelo proprietário da chave de delegação do usuário. O Serviço de Armazenamento do Azure executará uma verificação adicional da ACL POSIX para determinar se o usuário está autorizado a executar a operação solicitada. Isso não pode ser usado em conjunto com preauthorizedAgentObjectId . Isso só é usado para SAS de delegação de usuário.

agentObjectId?: string

Valor de Propriedade

string

cacheControl

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

cacheControl?: string

Valor de Propriedade

string

contentDisposition

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

contentDisposition?: string

Valor de Propriedade

string

contentEncoding

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

contentEncoding?: string

Valor de Propriedade

string

contentLanguage

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

contentLanguage?: string

Valor de Propriedade

string

contentType

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

contentType?: string

Valor de 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 de 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 de Propriedade

string

directoryDepth

Optional. A partir da versão 2020-02-10, indique a profundidade do diretório especificado no campo canonicalizedresource da string-to-sign. A profundidade do diretório é o número de diretórios abaixo da pasta raiz.

directoryDepth?: number

Valor de Propriedade

number

encryptionScope

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

encryptionScope?: string

Valor de Propriedade

string

expiresOn

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

expiresOn?: Date

Valor de Propriedade

Date

fileSystemName

O nome do sistema de arquivos que o usuário SAS pode acessar.

fileSystemName: string

Valor de Propriedade

string

identifier

Optional. O nome da política de acesso no sistema de arquivos 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 de Propriedade

string

ipRange

Optional. Intervalos de IP permitidos nesta SAS.

ipRange?: SasIPRange

Valor de Propriedade

isDirectory

Optional. A partir da versão 2020-02-10, esse valor define se o pathName é ou não um diretório. Se esse valor for definido como true, o caminho será um diretório para uma SAS de diretório. Se definido como false ou default, o caminho é um caminho de arquivo para uma SAS de caminho de arquivo.

isDirectory?: boolean

Valor de Propriedade

boolean

pathName

Optional. O nome do caminho do diretório ou arquivo SAS usuário pode acessar. Necessário se snapshotTime for fornecido.

pathName?: string

Valor de Propriedade

string

permissions

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

permissions?: DataLakeSASPermissions | DirectorySASPermissions | FileSystemSASPermissions

Valor de Propriedade

preauthorizedAgentObjectId

Optional. A partir da versão 2020-02-10, especifica a ID do objeto AAD autorizado 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 não pode ser usado em conjunto com agentObjectId. Isso só é usado para SAS de delegação de usuário.

preauthorizedAgentObjectId?: string

Valor de Propriedade

string

protocol

Optional. Protocolos SAS, apenas HTTPS ou HTTPSandHTTP

protocol?: SASProtocol

Valor de Propriedade

requestHeaders

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

requestHeaders?: RequestHeaders

Valor de Propriedade

requestQueryParameters

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

requestQueryParameters?: RequestQueryParameters

Valor de Propriedade

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 de Propriedade

string

startsOn

Optional. Quando o SAS entrará em vigor.

startsOn?: Date

Valor de 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 de Propriedade

string