Compartilhar via

BlobSharedAccessSignature Classe

  • Referência

Fornece uma fábrica para criar tokens de assinatura de acesso de blob e contêiner com um nome de conta comum e uma chave de conta. Os usuários podem usar a fábrica ou podem construir o serviço apropriado e usar o método generate_*_shared_access_signature diretamente.

Herança
SharedAccessSignature
BlobSharedAccessSignature

Construtor

BlobSharedAccessSignature(account_name, account_key=None, user_delegation_key=None)

Parâmetros

account_name
str
Obrigatório

O nome da conta de armazenamento usado para gerar as assinaturas de acesso compartilhado.

account_key
str
valor padrão: None

A chave de acesso para gerar as assinaturas de acesso de compartilhamentos.

user_delegation_key
UserDelegationKey
valor padrão: None

Em vez de uma chave de conta, o usuário pode passar uma chave de delegação de usuário. Uma chave de delegação de usuário pode ser obtida do serviço autenticando-se com uma identidade do AAD; isso pode ser feito chamando get_user_delegation_key em qualquer objeto de serviço Blob.

Métodos

generate_account

Gera uma assinatura de acesso compartilhado para a conta. Use a assinatura retornada com o parâmetro sas_token do serviço ou para criar um novo objeto de conta.
generate_blob

Gera uma assinatura de acesso compartilhado para o blob ou um de seus instantâneos. Use a assinatura retornada com o parâmetro sas_token de qualquer BlobService.
generate_container

Gera uma assinatura de acesso compartilhado para o contêiner. Use a assinatura retornada com o parâmetro sas_token de qualquer BlobService.

generate_account

Gera uma assinatura de acesso compartilhado para a conta. Use a assinatura retornada com o parâmetro sas_token do serviço ou para criar um novo objeto de conta.

generate_account(services, resource_types, permission, expiry, start=None, ip=None, protocol=None)

Parâmetros

services
<xref:Services>
Obrigatório

Especifica os serviços acessíveis com a SAS da conta. Você pode combinar valores para fornecer acesso a mais de um serviço.

resource_types
<xref:ResourceTypes>
Obrigatório

Especifica os tipos de recursos acessíveis com a SAS da conta. Você pode combinar valores para fornecer acesso a mais de um tipo de recurso.

permission
<xref:AccountPermissions>
Obrigatório

As permissões associadas à assinatura de acesso compartilhado. O usuário é restrito às operações permitidas pelas permissões. Obrigatório, a menos que uma ID seja fornecida referenciando uma política de acesso armazenada que contém esse campo. Este campo deverá ser omitido se tiver sido especificado em uma política de acesso armazenada associada. Você pode combinar valores para fornecer mais de uma permissão.

expiry
datetime ou str
Obrigatório

A hora em que a assinatura de acesso compartilhado se torna inválida. Obrigatório, a menos que uma ID seja fornecida referenciando uma política de acesso armazenada que contém esse campo. Este campo deverá ser omitido se tiver sido especificado em uma política de acesso armazenada associada. O Azure sempre converterá valores em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC.

start
datetime ou str
valor padrão: None

A hora em que a assinatura de acesso compartilhado se torna válida. Se for omitido, a hora de início para essa chamada será presumida como a hora na qual o serviço de armazenamento recebe a solicitação. O Azure sempre converterá valores em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC.

ip
str
valor padrão: None

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 ao intervalo de endereços especificado no token SAS, a solicitação não será autenticada. Por exemplo, especificar sip=168.1.5.65 ou sip=168.1.5.60-168.1.5.70 na SAS restringe a solicitação a esses endereços IP.

protocol
str
valor padrão: None

Especifica o protocolo permitido para uma solicitação feita. O valor padrão é https,http. Consulte Protocol para saber os valores possíveis.

generate_blob

Gera uma assinatura de acesso compartilhado para o blob ou um de seus instantâneos. Use a assinatura retornada com o parâmetro sas_token de qualquer BlobService.

generate_blob(container_name, blob_name, snapshot=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None)

Parâmetros

container_name
str
Obrigatório

Nome do contêiner.

blob_name
str
Obrigatório

Nome do blob.

snapshot
str
valor padrão: None

O parâmetro instantâneo é um valor datetime opaco que, quando presente, especifica o instantâneo de blob para conceder permissão.

permission
BlobPermissions
valor padrão: None

As permissões associadas à assinatura de acesso compartilhado. O usuário é restrito às operações permitidas pelas permissões. As permissões devem ser ordenadas para leitura, gravação, exclusão, lista. Obrigatório, a menos que uma ID seja fornecida referenciando uma política de acesso armazenada que contém esse campo. Este campo deverá ser omitido se tiver sido especificado em uma política de acesso armazenada associada.

expiry
datetime ou str
valor padrão: None

A hora em que a assinatura de acesso compartilhado se torna inválida. Obrigatório, a menos que uma ID seja fornecida referenciando uma política de acesso armazenada que contém esse campo. Este campo deverá ser omitido se tiver sido especificado em uma política de acesso armazenada associada. O Azure sempre converterá valores em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC.

start
datetime ou str
valor padrão: None

A hora em que a assinatura de acesso compartilhado se torna válida. Se for omitido, a hora de início para essa chamada será presumida como a hora na qual o serviço de armazenamento recebe a solicitação. O Azure sempre converterá valores em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC.

id
str
valor padrão: None

Um valor exclusivo de até 64 caracteres que se correlaciona a uma política de acesso armazenada. Para criar uma política de acesso armazenada, use set_blob_service_properties.

ip
str
valor padrão: None

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 ao intervalo de endereços especificado no token SAS, a solicitação não será autenticada. Por exemplo, especificar sip=168.1.5.65 ou sip=168.1.5.60-168.1.5.70 na SAS restringe a solicitação a esses endereços IP.

protocol
str
valor padrão: None

Especifica o protocolo permitido para uma solicitação feita. O valor padrão é https,http. Consulte Protocol para saber os valores possíveis.

cache_control
str
valor padrão: None

Valor do cabeçalho de resposta para Cache-Control quando o recurso é acessado usando essa assinatura de acesso compartilhado.

content_disposition
str
valor padrão: None

Valor do cabeçalho de resposta para Content-Disposition quando o recurso é acessado usando essa assinatura de acesso compartilhado.

content_encoding
str
valor padrão: None

Valor do cabeçalho de resposta para Codificação de Conteúdo quando o recurso é acessado usando essa assinatura de acesso compartilhado.

content_language
str
valor padrão: None

Valor do cabeçalho de resposta para Content-Language quando o recurso é acessado usando essa assinatura de acesso compartilhado.

content_type
str
valor padrão: None

Valor do cabeçalho de resposta para Content-Type quando o recurso é acessado usando essa assinatura de acesso compartilhado.

generate_container

Gera uma assinatura de acesso compartilhado para o contêiner. Use a assinatura retornada com o parâmetro sas_token de qualquer BlobService.

generate_container(container_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None)

Parâmetros

container_name
str
Obrigatório

Nome do contêiner.

permission
ContainerPermissions
valor padrão: None

As permissões associadas à assinatura de acesso compartilhado. O usuário é restrito às operações permitidas pelas permissões. As permissões devem ser ordenadas para leitura, gravação, exclusão, lista. Obrigatório, a menos que uma ID seja fornecida referenciando uma política de acesso armazenada que contém esse campo. Este campo deverá ser omitido se tiver sido especificado em uma política de acesso armazenada associada.

expiry
datetime ou str
valor padrão: None

A hora em que a assinatura de acesso compartilhado se torna inválida. Obrigatório, a menos que uma ID seja fornecida referenciando uma política de acesso armazenada que contém esse campo. Este campo deverá ser omitido se tiver sido especificado em uma política de acesso armazenada associada. O Azure sempre converterá valores em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC.

start
datetime ou str
valor padrão: None

A hora em que a assinatura de acesso compartilhado se torna válida. Se for omitido, a hora de início para essa chamada será presumida como a hora na qual o serviço de armazenamento recebe a solicitação. O Azure sempre converterá valores em UTC. Se uma data for passada sem informações de fuso horário, será considerado UTC.

id
str
valor padrão: None

Um valor exclusivo de até 64 caracteres que se correlaciona a uma política de acesso armazenada. Para criar uma política de acesso armazenada, use set_blob_service_properties.

ip
str
valor padrão: None

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 ao intervalo de endereços especificado no token SAS, a solicitação não será autenticada. Por exemplo, especificar sip=168.1.5.65 ou sip=168.1.5.60-168.1.5.70 na SAS restringe a solicitação a esses endereços IP.

protocol
str
valor padrão: None

Especifica o protocolo permitido para uma solicitação feita. O valor padrão é https,http. Consulte Protocol para saber os valores possíveis.

cache_control
str
valor padrão: None

Valor do cabeçalho de resposta para Cache-Control quando o recurso é acessado usando essa assinatura de acesso compartilhado.

content_disposition
str
valor padrão: None

Valor do cabeçalho de resposta para Content-Disposition quando o recurso é acessado usando essa assinatura de acesso compartilhado.

content_encoding
str
valor padrão: None

Valor do cabeçalho de resposta para Codificação de Conteúdo quando o recurso é acessado usando essa assinatura de acesso compartilhado.

content_language
str
valor padrão: None

Valor do cabeçalho de resposta para Content-Language quando o recurso é acessado usando essa assinatura de acesso compartilhado.

content_type
str
valor padrão: None

Valor do cabeçalho de resposta para Content-Type quando o recurso é acessado usando essa assinatura de acesso compartilhado.