DataLakeSasBuilder Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
DataLakeSasBuilder é usado para gerar uma SAS (Assinatura de Acesso Compartilhado) para um sistema de arquivos ou caminho do Data Lake
For more information, see
Construindo uma SAS de serviço.
public class DataLakeSasBuilder
type DataLakeSasBuilder = class
Public Class DataLakeSasBuilder
- Herança
-
DataLakeSasBuilder
Construtores
DataLakeSasBuilder(DataLakeFileSystemSasPermissions, DateTimeOffset) |
Inicializa uma nova instância da DataLakeSasBuilder classe para criar uma Sas do Serviço de Blob. |
DataLakeSasBuilder(DataLakeSasPermissions, DateTimeOffset) |
Inicializa uma nova instância da DataLakeSasBuilder classe para criar uma Sas do Serviço de Blob. |
Propriedades
AgentObjectId |
Opcional. A partir da versão 2020-02-10, esse valor será usado para a ID de Objeto do AAD de um usuário autorizado pelo proprietário da Chave de Delegação de 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. O Serviço de Armazenamento do Azure executará uma ACL POSIX adicional marcar para determinar se o usuário está autorizado a executar a operação solicitada. Isso não pode ser usado em conjúria com PreauthorizedAgentObjectId. Isso só é usado com a geração de SAS de Delegação de Usuário. |
CacheControl |
Substitua o valor retornado para Cache-Control cabeçalho de resposta. |
ContentDisposition |
Substitua o valor retornado para o cabeçalho de resposta Content-Disposition. |
ContentEncoding |
Substitua o valor retornado para Cache-Encoding cabeçalho de resposta. |
ContentLanguage |
Substitua o valor retornado para Cache-Language cabeçalho de resposta. |
ContentType |
Substitua o valor retornado para Cache-Type cabeçalho de resposta. |
CorrelationId |
Opcional. A partir da versão 2020-02-10, esse valor será usado para correlacionar os logs de auditoria de armazenamento com os logs de auditoria usados pela entidade de segurança que gera e distribui SAS. Isso só é usado para SAS de Delegação de Usuário. |
EncryptionScope |
Opcional. Escopo de criptografia a ser usado ao enviar solicitações autorizadas com esse URI sas. |
ExpiresOn |
O momento em que a assinatura de acesso compartilhado se torna inválida. Este campo deverá ser omitido se tiver sido especificado em uma política de acesso armazenada associada. |
FileSystemName |
O nome do sistema de arquivos que está sendo disponibilizado. |
Identifier |
Um valor exclusivo opcional de até 64 caracteres de comprimento que se correlaciona a uma política de acesso especificada para o sistema de arquivos. |
IPRange |
Especifica um endereço IP ou um intervalo de endereços IP dos quais aceitar solicitações. Se o endereço IP do qual a solicitação se origina não corresponder ao endereço IP ou intervalo de endereços especificado no token SAS, a solicitação não será autenticada. Ao especificar um intervalo de endereços IP, observe que o intervalo é inclusivo. |
IsDirectory |
A partir da versão 2020-02-10, esse valor define se o Path é 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 falso ou padrão, o Caminho será um caminho de arquivo para uma SAS de caminho de arquivo. |
Path |
O nome do caminho que está sendo disponibilizado ou Empty para uma SAS do sistema de arquivos. A partir da versão 2020-02-10, definir IsDirectory como true significa que aceitaremos o Caminho como um diretório para uma SAS de diretório. Se não for definido, esse valor será considerado um caminho de arquivo para uma SAS de caminho de arquivo. |
Permissions |
As permissões associadas à assinatura de acesso compartilhado. O usuário é restrito às operações permitidas pelas permissões. Este campo deverá ser omitido se tiver sido especificado em uma política de acesso armazenada associada. O DataLakeSasPermissionsou DataLakeFileSystemSasPermissionsDataLakeAccountSasPermissions pode ser usado para criar a cadeia de caracteres de permissões. |
PreauthorizedAgentObjectId |
Opcional. A partir da versão 2020-02-10, esse valor será usado para a ID de Objeto do AAD de um usuário autorizado pelo proprietário da Chave de Delegação de 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. Nenhuma permissão adicional marcar para o usuário especificado nesse valor será executada. Isso não pode ser usado em conjúria com AgentObjectId. Isso só é usado com a geração de SAS de Delegação de Usuário. |
Protocol |
O campo de protocolo assinado opcional especifica o protocolo permitido para uma solicitação feita com a SAS. Os valores possíveis são HttpsAndHttp, Https e None. |
Resource |
Especifica quais recursos podem ser acessados por meio da assinatura de acesso compartilhado. Especifique "b" se o recurso compartilhado for um blob. Isso concede acesso ao conteúdo e aos metadados do blob. Especifique "c" se o recurso compartilhado for um contêiner de blob. Isso concede acesso ao conteúdo e aos metadados de qualquer blob no contêiner, e a lista de blobs no contêiner. A partir da versão 2018-11-09, especifique "bs" se o recurso compartilhado for um blob instantâneo. Isso concede acesso ao conteúdo e aos metadados do instantâneo específico, mas não ao blob raiz correspondente. A partir da versão 2020-02-10, especifique "d" se o recurso compartilhado for um diretório DataLake. Isso concede acesso aos caminhos no diretório e lista os caminhos no diretório. Quando "d" é especificado, o parâmetro de consulta sdd também é necessário. |
StartsOn |
Opcionalmente, especifique a hora em que a assinatura de acesso compartilhado se torna válida. Se for omitido quando DateTimeOffset.MinValue for usado, a hora de início dessa chamada será considerada a hora em que o serviço de armazenamento recebe a solicitação. |
Métodos
SetPermissions(DataLakeAccountSasPermissions) |
Define as permissões para uma SAS de nível de conta de caminho. |
SetPermissions(DataLakeFileSystemSasPermissions) |
Define as permissões para uma SAS do sistema de arquivos. |
SetPermissions(DataLakeSasPermissions) |
Define as permissões para uma SAS de arquivo. |
SetPermissions(String) |
Define as permissões para a SAS usando uma cadeia de caracteres de permissões brutas. |
SetPermissions(String, Boolean) |
Define as permissões para a SAS usando uma cadeia de caracteres de permissões brutas. |
ToSasQueryParameters(StorageSharedKeyCredential) |
Use os de uma conta para assinar esses valores de StorageSharedKeyCredential assinatura de acesso compartilhado para produzir os parâmetros de consulta SAS adequados para autenticar solicitações. |
ToSasQueryParameters(UserDelegationKey, String) |
Use os de uma conta para assinar esses valores de UserDelegationKey assinatura de acesso compartilhado para produzir os parâmetros de consulta SAS adequados para autenticar solicitações. |
Aplica-se a
Azure SDK for .NET