Partilhar via


BlobSasBuilder Classe

Definição

BlobSasBuilder é usado para gerar uma SAS (Assinatura de Acesso Compartilhado) para um contêiner ou blob do Armazenamento do Azure. Para obter mais informações, consulte Crie uma SAS de serviço.

public class BlobSasBuilder
type BlobSasBuilder = class
Public Class BlobSasBuilder
Herança
BlobSasBuilder

Construtores

BlobSasBuilder(BlobContainerSasPermissions, DateTimeOffset)

Inicializa uma nova instância da BlobSasBuilder classe para criar uma Sas do Serviço de Contêiner de Blob.

BlobSasBuilder(BlobSasPermissions, DateTimeOffset)

Inicializa uma nova instância da BlobSasBuilder classe para criar uma Sas do Serviço de Blob.

Propriedades

BlobContainerName

O nome do contêiner de blob que está sendo disponibilizado.

BlobName

O nome do blob que está sendo disponibilizado ou Empty para uma SAS de contêiner.

BlobVersionId

O nome da versão do blob que está sendo tornada acessível ou Empty para uma SAS de blob.

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 o cabeçalho de resposta Content-Encoding.

ContentLanguage

Substitua o valor retornado para o cabeçalho de resposta Content-Language.

ContentType

Substitua o valor retornado para o cabeçalho de resposta Tipo de Conteúdo.

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.

Identifier

Um valor exclusivo opcional de até 64 caracteres de comprimento que se correlaciona a uma política de acesso especificada para o contêiner.

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.

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 BlobSasPermissions, BlobContainerSasPermissions, SnapshotSasPermissionsou BlobAccountSasPermissions 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 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 2019-12-12, especifique "bv" se o recurso compartilhado for uma versão de blob. Isso concede acesso ao conteúdo e aos metadados da versão específica, mas não ao blob raiz correspondente.

Snapshot

O nome do instantâneo sendo disponibilizado ou Empty para uma SAS de blob.

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(BlobAccountSasPermissions)

Define as permissões para uma SAS de nível de conta de blob.

SetPermissions(BlobContainerSasPermissions)

Define as permissões para uma SAS de contêiner de blob.

SetPermissions(BlobSasPermissions)

Define as permissões para uma SAS de blob.

SetPermissions(BlobVersionSasPermissions)

Define as permissões para uma SAS de versão.

SetPermissions(SnapshotSasPermissions)

Define as permissões para uma SAS de instantâneo.

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