BlobSharedAccessSignature Classe
Fornece uma fábrica para criar tokens de assinatura de acesso a blobs e contentores com um nome de conta comum e uma chave de conta. Os utilizadores podem utilizar a fábrica ou construir o serviço adequado e utilizar o método generate_*_shared_access_signature diretamente.
- Herança
-
BlobSharedAccessSignature
Construtor
BlobSharedAccessSignature(account_name, account_key=None, user_delegation_key=None)
Parâmetros
- account_name
- str
O nome da conta de armazenamento utilizado para gerar as assinaturas de acesso partilhado.
- account_key
- str
A chave de acesso para gerar as assinaturas de acesso das partilhas.
- user_delegation_key
- UserDelegationKey
Em vez de uma chave de conta, o utilizador pode transmitir uma chave de delegação de utilizador. Uma chave de delegação de utilizador pode ser obtida a partir do serviço através da autenticação com uma identidade do AAD; isto pode ser feito ao chamar get_user_delegation_key em qualquer objeto de serviço blob.
Métodos
generate_account |
Gera uma assinatura de acesso partilhado para a conta. Utilize a assinatura devolvida com o parâmetro sas_token do serviço ou para criar um novo objeto de conta. |
generate_blob |
Gera uma assinatura de acesso partilhado para o blob ou um dos respetivos instantâneos. Utilize a assinatura devolvida com o parâmetro sas_token de qualquer BlobService. |
generate_container |
Gera uma assinatura de acesso partilhado para o contentor. Utilize a assinatura devolvida com o parâmetro sas_token de qualquer BlobService. |
generate_account
Gera uma assinatura de acesso partilhado para a conta. Utilize a assinatura devolvida 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>
Especifica os serviços acessíveis com a SAS da conta. Pode combinar valores para fornecer acesso a mais do que um serviço.
- resource_types
- <xref:ResourceTypes>
Especifica os tipos de recursos que estão acessíveis com a SAS da conta. Pode combinar valores para fornecer acesso a mais do que um tipo de recurso.
- permission
- <xref:AccountPermissions>
As permissões associadas à assinatura de acesso partilhado. O utilizador está restrito a operações permitidas pelas permissões. Obrigatório, a menos que seja fornecido um ID que referencie uma política de acesso armazenada que contenha este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada. Pode combinar valores para fornecer mais do que uma permissão.
O momento em que a assinatura de acesso partilhado se torna inválida. Obrigatório, a menos que seja fornecido um ID que referencie uma política de acesso armazenada que contenha este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada. O Azure irá sempre converter valores em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC.
O momento em que a assinatura de acesso partilhado se torna válida. Se for omitido, assume-se que a hora de início desta chamada é a hora em que o serviço de armazenamento recebe o pedido. O Azure irá sempre converter valores em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC.
- ip
- str
Especifica um endereço IP ou um intervalo de endereços IP a partir do qual aceitar pedidos. Se o endereço IP a partir do qual o pedido é originado não corresponder ao endereço IP ou intervalo de endereços especificado no token de SAS, o pedido não é autenticado. Por exemplo, especificar sip=168.1.5.65 ou sip=168.1.5.60-168.1.5.70 no SAS restringe o pedido a esses endereços IP.
generate_blob
Gera uma assinatura de acesso partilhado para o blob ou um dos respetivos instantâneos. Utilize a assinatura devolvida 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
- snapshot
- str
O parâmetro de instantâneo é um valor dateTime opaco que, quando presente, especifica o instantâneo de blob para conceder permissão.
- permission
- BlobPermissions
As permissões associadas à assinatura de acesso partilhado. O utilizador está restrito a operações permitidas pelas permissões. As permissões têm de ser ordenadas como leitura, escrita, eliminação, lista. Obrigatório, a menos que seja fornecido um ID que referencie uma política de acesso armazenada que contenha este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada.
O momento em que a assinatura de acesso partilhado se torna inválida. Obrigatório, a menos que seja fornecido um ID que referencie uma política de acesso armazenada que contenha este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada. O Azure irá sempre converter valores em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC.
O momento em que a assinatura de acesso partilhado se torna válida. Se for omitido, assume-se que a hora de início desta chamada é a hora em que o serviço de armazenamento recebe o pedido. O Azure irá sempre converter valores em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC.
- id
- str
Um valor exclusivo com até 64 carateres de comprimento que se correlaciona com uma política de acesso armazenada. Para criar uma política de acesso armazenada, utilize set_blob_service_properties.
- ip
- str
Especifica um endereço IP ou um intervalo de endereços IP a partir do qual aceitar pedidos. Se o endereço IP a partir do qual o pedido é originado não corresponder ao endereço IP ou intervalo de endereços especificado no token de SAS, o pedido não é autenticado. Por exemplo, especificar sip=168.1.5.65 ou sip=168.1.5.60-168.1.5.70 no SAS restringe o pedido a esses endereços IP.
- protocol
- str
Especifica o protocolo permitido para um pedido feito. O valor predefinido é https,http. Veja Protocol os valores possíveis.
- cache_control
- str
Valor do cabeçalho de resposta para Cache-Control quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_disposition
- str
Valor do cabeçalho de resposta para Content-Disposition quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_encoding
- str
Valor do cabeçalho de resposta para Content-Encoding quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_language
- str
Valor do cabeçalho de resposta para Content-Language quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_type
- str
Valor do cabeçalho de resposta para Content-Type quando o recurso é acedido com esta assinatura de acesso partilhado.
generate_container
Gera uma assinatura de acesso partilhado para o contentor. Utilize a assinatura devolvida 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
- permission
- ContainerPermissions
As permissões associadas à assinatura de acesso partilhado. O utilizador está restrito a operações permitidas pelas permissões. As permissões têm de ser ordenadas como leitura, escrita, eliminação, lista. Obrigatório, a menos que seja fornecido um ID que referencie uma política de acesso armazenada que contenha este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada.
O momento em que a assinatura de acesso partilhado se torna inválida. Obrigatório, a menos que seja fornecido um ID que referencie uma política de acesso armazenada que contenha este campo. Este campo tem de ser omitido se tiver sido especificado numa política de acesso armazenada associada. O Azure irá sempre converter valores em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC.
O momento em que a assinatura de acesso partilhado se torna válida. Se for omitido, assume-se que a hora de início desta chamada é a hora em que o serviço de armazenamento recebe o pedido. O Azure irá sempre converter valores em UTC. Se for transmitida uma data sem informações de fuso horário, assume-se que é UTC.
- id
- str
Um valor exclusivo com até 64 carateres de comprimento que se correlaciona com uma política de acesso armazenada. Para criar uma política de acesso armazenada, utilize set_blob_service_properties.
- ip
- str
Especifica um endereço IP ou um intervalo de endereços IP a partir do qual aceitar pedidos. Se o endereço IP a partir do qual o pedido é originado não corresponder ao endereço IP ou intervalo de endereços especificado no token de SAS, o pedido não é autenticado. Por exemplo, especificar sip=168.1.5.65 ou sip=168.1.5.60-168.1.5.70 no SAS restringe o pedido a esses endereços IP.
- protocol
- str
Especifica o protocolo permitido para um pedido feito. O valor predefinido é https,http. Veja Protocol os valores possíveis.
- cache_control
- str
Valor do cabeçalho de resposta para Cache-Control quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_disposition
- str
Valor do cabeçalho de resposta para Content-Disposition quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_encoding
- str
Valor do cabeçalho de resposta para Content-Encoding quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_language
- str
Valor do cabeçalho de resposta para Content-Language quando o recurso é acedido com esta assinatura de acesso partilhado.
- content_type
- str
Valor do cabeçalho de resposta para Content-Type quando o recurso é acedido com esta assinatura de acesso partilhado.
Azure SDK for Python
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários