blob Pacote

Pacotes

aio

Classes

AccessPolicy	Classe política de acesso usada pelo conjunto e obter métodos de política de acesso em cada serviço. Uma política de acesso armazenada pode especificar a hora de início, a hora de expiração e as permissões para as Assinaturas de Acesso Compartilhado às quais ela está associada. Dependendo de como você deseja controlar o acesso ao recurso, você pode especificar todos esses parâmetros dentro da política de acesso armazenada e omiti-los da URL para a Assinatura de Acesso Compartilhado. Fazer isso permite modificar o comportamento da assinatura associada a qualquer momento, bem como revogá-la. Ou você pode especificar um ou mais dos parâmetros de política de acesso na política de acesso armazenada e os outros na URL. Por fim, você pode especificar todos os parâmetros na URL. Nesse caso, é possível usar a política de acesso armazenada para revogar a assinatura, mas não para modificar seu comportamento. Juntas, a Assinatura de Acesso Compartilhado e a política de acesso armazenada devem incluir todos os campos necessários para autenticar a assinatura. Se qualquer campo obrigatório estiver ausente, a solicitação falhará. Da mesma forma, se um campo for especificado na URL da Assinatura de Acesso Compartilhado e na política de acesso armazenada, ocorrerá uma falha na solicitação com o código de status 400 (Solicitação Incorreta).
AccountSasPermissions	ResourceTypes classe a ser usada com generate_account_sas função e para o AccessPolicies usado com set_*_acl. Há dois tipos de SAS que podem ser usados para conceder acesso a recursos. Uma delas é conceder acesso a um recurso específico (específico do recurso). Outra é conceder acesso a todo o serviço para uma conta específica e permitir determinadas operações com base em perms encontrados aqui.
ArrowDialect	campo de um esquema de seta. Todos os parâmetros necessários devem ser preenchidos para enviar ao Azure.
BlobAnalyticsLogging	Configurações de log do Azure Analytics.
BlobBlock	Classe BlockBlob Block.
BlobClient	Um cliente para interagir com um blob específico, embora esse blob ainda não exista. Para obter mais configurações opcionais, clique aqui.
BlobLeaseClient	Cria um novo BlobLeaseClient. Esse cliente fornece operações de concessão em um BlobClient ou ContainerClient.
BlobPrefix	Uma iterável de propriedades de Blob. Retornado de walk_blobs quando um delimitador é usado. Pode ser considerado como um diretório de blob virtual.
BlobProperties	Propriedades do Blob.
BlobQueryError	O erro ocorreu durante a operação de consulta rápida.
BlobQueryReader	Um objeto de streaming para ler os resultados da consulta.
BlobSasPermissions	Classe BlobSasPermissions a ser usada com a generate_blob_sas função .
BlobServiceClient	Um cliente para interagir com o Serviço Blob no nível da conta. Esse cliente fornece operações para recuperar e configurar as propriedades da conta, bem como listar, criar e excluir contêineres dentro da conta. Para operações relacionadas a um contêiner ou blob específico, os clientes dessas entidades também podem ser recuperados usando as funções get_client . Para obter mais configurações opcionais, clique aqui.
ContainerClient	Um cliente para interagir com um contêiner específico, embora esse contêiner ainda não exista. Para operações relacionadas a um blob específico dentro desse contêiner, um cliente de blob pode ser recuperado usando a get_blob_client função . Para obter mais configurações opcionais, clique aqui.
ContainerEncryptionScope	A configuração de escopo de criptografia padrão para um contêiner. Esse escopo é usado implicitamente para todas as gravações futuras dentro do contêiner, mas pode ser substituído por operação de blob. Novo na versão 12.2.0.
ContainerProperties	Classe de propriedades do contêiner de blob. Instâncias retornadas ContainerProperties expõem esses valores por meio de uma interface de dicionário, por exemplo: container_props["last_modified"]. Além disso, o nome do contêiner está disponível como container_props["name"].
ContainerSasPermissions	Classe ContainerSasPermissions a ser usada com a generate_container_sas função e para o AccessPolicies usado com set_container_access_policy.
ContentSettings	As configurações de conteúdo de um blob.
CopyProperties	Propriedades de Cópia de Blob. Essas propriedades serão None se esse blob nunca tiver sido o destino em uma operação Copiar Blob ou se esse blob tiver sido modificado após uma operação de Copiar Blob concluída, por exemplo, usando Definir Propriedades do Blob, Carregar Blob ou Confirmar Lista de Blocos.
CorsRule	O CORS é um recurso HTTP que permite que um aplicativo web em execução em um domínio acesse recursos em outro domínio. Os navegadores da Web implementam uma restrição de segurança conhecida como política de mesma origem que evita que uma página da Web chame as APIs em um domínio diferente; o CORS fornece uma maneira segura de permitir que um domínio (o domínio de origem) chame APIs em outro domínio.
CustomerProvidedEncryptionKey	Todos os dados no Armazenamento do Azure são criptografados em repouso usando uma chave de criptografia no nível da conta. Nas versões 2018-06-17 e mais recentes, você pode gerenciar a chave usada para criptografar conteúdo de blob e metadados de aplicativo por blob fornecendo uma chave de criptografia AES-256 em solicitações para o serviço de armazenamento. Quando você usa uma chave fornecida pelo cliente, o Armazenamento do Azure não gerencia nem persiste sua chave. Ao gravar dados em um blob, a chave fornecida é usada para criptografar seus dados antes de criá-los em disco. Um hash SHA-256 da chave de criptografia é gravado junto com o conteúdo do blob e é usado para verificar se todas as operações subsequentes no blob usam a mesma chave de criptografia. Esse hash não pode ser usado para recuperar a chave de criptografia ou descriptografar o conteúdo do blob. Ao ler um blob, a chave fornecida é usada para descriptografar seus dados depois de lê-los do disco. Em ambos os casos, a chave de criptografia fornecida é descartada com segurança assim que o processo de criptografia ou descriptografia é concluído.
DelimitedJsonDialect	Define a serialização JSON de entrada ou saída para uma consulta de dados de blob. palavra-chave delimitador str: o caractere separador de linha, o valor padrão é ' '
DelimitedTextDialect	Define a serialização CSV (delimitada por entrada ou saída) para uma solicitação de consulta de blob.
ExponentialRetry	Repetição exponencial. Constrói um objeto de repetição exponencial. O initial_backoff é usado para a primeira repetição. As tentativas subsequentes são repetidas após initial_backoff + increment_power^retry_count segundos.
FilteredBlob	Informações de blob de uma chamada à API de Blobs de Filtros.
ImmutabilityPolicy	Parâmetros opcionais para definir a política de imutabilidade de uma versão de blob, blob instantâneo ou blob. Novo na versão 12.10.0: isso foi introduzido na versão de API '2020-10-02'.
LeaseProperties	Propriedades de Concessão de Blob.
LinearRetry	Repetição linear. Constrói um objeto de repetição Linear.
LocationMode	Especifica o local para o qual a solicitação deve ser enviada. Esse modo só se aplica a contas RA-GRS que permitem acesso de leitura secundário. Todos os outros tipos de conta devem usar PRIMARY.
Metrics	Um resumo das estatísticas de solicitação agrupadas pela API em agregações de hora ou minuto para blobs.
ObjectReplicationPolicy	ID da política e IDs de regra aplicadas a um blob.
ObjectReplicationRule	ID da política e IDs de regra aplicadas a um blob.
PageRange	Intervalo de páginas para blob de páginas.
PartialBatchErrorException	Há uma falha parcial nas operações em lote.
ResourceTypes	Especifica os tipos de recursos acessíveis com a SAS da conta.
RetentionPolicy	A política de retenção que determina por quanto tempo os dados associados devem persistir.
StaticWebsite	As propriedades que permitem que uma conta hospede um site estático.
StorageStreamDownloader	Um objeto de streaming a ser baixado do Armazenamento do Azure.
UserDelegationKey	Representa uma chave de delegação de usuário, fornecida ao usuário pelo Armazenamento do Azure com base no token de acesso do Azure Active Directory. Os campos são salvos como cadeias de caracteres simples, pois o usuário não precisa interagir com esse objeto; para gerar uma SAS de identificação, o usuário pode simplesmente passá-la para a API certa.

Enumerações

ArrowType
BlobImmutabilityPolicyMode	Especifica o modo de política de imutabilidade a ser definido no blob. "Mutável" só pode ser retornado pelo serviço, não defina como "Mutável".
BlobType
BlockState	Tipos de bloco de blob de blocos.
PremiumPageBlobTier	Especifica a camada de blob de páginas para a qual definir o blob. Isso só é aplicável a blobs de páginas em contas de armazenamento Premium. Dê uma olhada em: https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets para obter informações detalhadas sobre o IOPS e a taxa de transferência correspondentes por PageBlobTier.
PublicAccess	Especifica se os dados no contêiner podem ser acessados publicamente e o nível de acesso.
QuickQueryDialect	Especifica o dialeto de entrada/saída de consulta rápida.
RehydratePriority	Se um objeto estiver no estado pendente de reidração, esse cabeçalho será retornado com prioridade de reidratar. Os valores válidos são High e Standard.
SequenceNumberAction	Ações de número de sequência.
StandardBlobTier	Especifica a camada de blob para a qual definir o blob. Isso só é aplicável a blobs de blocos em contas de armazenamento padrão.
StorageErrorCode

Funções

download_blob_from_url

Baixe o conteúdo de um blob em um arquivo ou fluxo local.

download_blob_from_url(blob_url: str, output: str, credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> None

Parâmetros

blob_url

str

Obrigatório

O URI completo para o blob. Isso também pode incluir um token SAS.

output

str ou <xref:<xref:writable stream.>>

Obrigatório

Para onde os dados devem ser baixados. Pode ser um caminho de arquivo para gravar ou um identificador de E/S aberto para gravar.

credential

valor padrão: None

As credenciais com as quais autenticar. Isso é opcional se a URL do blob já tiver um token SAS ou se o blob for público. O valor pode ser uma cadeia de caracteres de token SAS, uma instância de um AzureSasCredential ou AzureNamedKeyCredential de azure.core.credentials, uma chave de acesso compartilhado de conta ou uma instância de uma classe TokenCredentials de azure.identity. Se o URI do recurso já contiver um token SAS, isso será ignorado em favor de uma credencial explícita

• exceto no caso de AzureSasCredential, em que os tokens SAS conflitantes gerarão um ValueError. Se estiver usando uma instância de AzureNamedKeyCredential, "name" deverá ser o nome da conta de armazenamento e "key" deverá ser a chave da conta de armazenamento.

overwrite

bool

Se o arquivo local deve ser substituído se ele já existir. O valor padrão é False – nesse caso, um ValueError será gerado se o arquivo já existir. Se definido como True, será feita uma tentativa de gravar no arquivo existente. Se um identificador de fluxo for passado, esse valor será ignorado.

max_concurrency

int

O número de conexões paralelas com as quais baixar.

offset

int

Início do intervalo de bytes a ser usado para baixar uma seção do blob. Deve ser definido se o comprimento for fornecido.

length

int

Número de bytes a serem lidos do fluxo. Isso é opcional, mas deve ser fornecido para um desempenho ideal.

validate_content

bool

Se for true, calculará um hash MD5 para cada parte do blob. O serviço de armazenamento verifica o hash do conteúdo que chegou com o hash que foi enviado. Isso é importante principalmente para detectar bitflips na transmissão se usar http em vez de https como https (o padrão) já será validado. Observe que esse hash MD5 não é armazenado com o blob. Observe também que, se habilitado, o algoritmo de upload com eficiência de memória não será usado, pois a computação do hash MD5 requer buffer de blocos inteiros e isso derrota a finalidade do algoritmo com eficiência de memória.

Tipo de retorno

None

generate_account_sas

Gera uma assinatura de acesso compartilhado para o serviço blob.

Use a assinatura retornada com o parâmetro de credencial de qualquer BlobServiceClient, ContainerClient ou BlobClient.

generate_account_sas(account_name: str, account_key: str, resource_types: ResourceTypes | str, permission: AccountSasPermissions | str, expiry: datetime | str | None, start: datetime | str | None = None, ip: str | None = None, **kwargs: Any) -> str

Parâmetros

account_name

str

Obrigatório

O nome da conta de armazenamento usado para gerar a assinatura de acesso compartilhado.

account_key

str

Obrigatório

A chave de conta, também chamada de chave compartilhada ou chave de acesso, para gerar a assinatura de acesso compartilhado.

resource_types

str ou ResourceTypes

Obrigatório

Especifica os tipos de recursos acessíveis com a SAS da conta.

permission

str ou AccountSasPermissions

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.

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 ip=168.1.5.65 ou ip=168.1.5.60-168.1.5.70 na SAS restringe a solicitação a esses endereços IP.

protocol

str

Especifica o protocolo permitido para uma solicitação feita. O valor padrão é https.

encryption_scope

str

Especifica o escopo de criptografia de uma solicitação feita para que todas as operações de gravação sejam criptografadas pelo serviço.

Retornos

Um token sas (Assinatura de Acesso Compartilhado).

Tipo de retorno

str

generate_blob_sas

Gera uma assinatura de acesso compartilhado para um blob.

Use a assinatura retornada com o parâmetro de credencial de qualquer BlobServiceClient, ContainerClient ou BlobClient.

generate_blob_sas(account_name: str, container_name: str, blob_name: str, snapshot: str | None = None, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: BlobSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parâmetros

account_name

str

Obrigatório

O nome da conta de armazenamento usado para gerar a assinatura de acesso compartilhado.

container_name

str

Obrigatório

É o nome do contêiner.

blob_name

str

Obrigatório

O nome do blob.

snapshot

str

valor padrão: None

Uma ID de instantâneo de blob opcional.

account_key

str

valor padrão: None

A chave de conta, também chamada de chave compartilhada ou chave de acesso, para gerar a assinatura de acesso compartilhado. É necessário especificar account_key ou user_delegation_key .

user_delegation_key

UserDelegationKey

valor padrão: None

Em vez de uma chave compartilhada 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. Quando presente, a SAS é assinada com a chave de delegação do usuário.

permission

str ou BlobSasPermissions

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 racwdxytmei. 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.

policy_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_container_access_policy.

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 ip=168.1.5.65 ou ip=168.1.5.60-168.1.5.70 na SAS restringe a solicitação a esses endereços IP.

version_id

str

Uma ID de versão de blob opcional. Esse parâmetro só é aplicável para contas de armazenamento habilitadas para controle de versão. Observe que o parâmetro de consulta 'versionid' não está incluído na SAS de saída. Portanto, forneça o parâmetro 'version_id' para qualquer APIs ao usar a SAS de saída para operar em uma versão específica.

Novo na versão 12.4.0: este argumento palavra-chave foi introduzido na versão de API '2019-12-12'.

protocol

str

Especifica o protocolo permitido para uma solicitação feita. O valor padrão é https.

cache_control

str

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

content_disposition

str

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

content_encoding

str

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 do cabeçalho de resposta para Content-Language quando o recurso é acessado usando essa assinatura de acesso compartilhado.

content_type

str

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

encryption_scope

str

Especifica o escopo de criptografia de uma solicitação feita para que todas as operações de gravação sejam criptografadas pelo serviço.

correlation_id

str

A ID de correlação para correlacionar os logs de auditoria de armazenamento com os logs de auditoria usados pela entidade de segurança que gera e distribui a SAS. Isso só pode ser usado ao gerar uma SAS com chave de delegação.

Retornos

Um token sas (Assinatura de Acesso Compartilhado).

Tipo de retorno

str

generate_container_sas

Gera uma assinatura de acesso compartilhado para um contêiner.

Use a assinatura retornada com o parâmetro de credencial de qualquer BlobServiceClient, ContainerClient ou BlobClient.

generate_container_sas(account_name: str, container_name: str, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: ContainerSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parâmetros

account_name

str

Obrigatório

O nome da conta de armazenamento usado para gerar a assinatura de acesso compartilhado.

container_name

str

Obrigatório

É o nome do contêiner.

account_key

str

valor padrão: None

A chave de conta, também chamada de chave compartilhada ou chave de acesso, para gerar a assinatura de acesso compartilhado. É necessário especificar account_key ou user_delegation_key .

user_delegation_key

UserDelegationKey

valor padrão: None

Em vez de uma chave compartilhada 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. Quando presente, a SAS é assinada com a chave de delegação do usuário.

permission

str ou ContainerSasPermissions

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 racwdxyltfmei. Obrigatório, a menos que uma ID seja fornecida fazendo referência a uma política de acesso armazenada que contenha 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

O momento em que a assinatura de acesso compartilhado se torna inválida. Obrigatório, a menos que uma ID seja fornecida fazendo referência a uma política de acesso armazenada que contenha 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, supõe-se que seja UTC.

start

datetime ou str

valor padrão: None

O momento 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, supõe-se que seja UTC.

policy_id

str

valor padrão: None

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

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

protocol

str

Especifica o protocolo permitido para uma solicitação feita. O valor padrão é https.

cache_control

str

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

content_disposition

str

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

content_encoding

str

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 do cabeçalho de resposta para Content-Language quando o recurso é acessado usando essa assinatura de acesso compartilhado.

content_type

str

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

encryption_scope

str

Especifica o escopo de criptografia de uma solicitação feita para que todas as operações de gravação sejam criptografadas pelo serviço.

correlation_id

str

A ID de correlação dos logs de auditoria de armazenamento com os logs de auditoria usados pela entidade de segurança que gera e distribui a SAS. Isso só pode ser usado ao gerar uma SAS com chave de delegação.

Retornos

Um token sas (Assinatura de Acesso Compartilhado).

Tipo de retorno

str

upload_blob_to_url

Carregar dados em uma determinada URL

Os dados serão carregados como um blob de blocos.

upload_blob_to_url(blob_url: str, data: Union[Iterable[AnyStr], IO[AnyStr]], credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> Dict[str, Any]

Parâmetros

blob_url

str

Obrigatório

O URI completo para o blob. Isso também pode incluir um token SAS.

data

bytes ou str ou Iterable

Obrigatório

Os dados a serem carregados. Isso pode ser bytes, texto, um objeto iterável ou semelhante a um arquivo.

credential

valor padrão: None

As credenciais com as quais autenticar. Isso será opcional se a URL do blob já tiver um token SAS. O valor pode ser uma cadeia de caracteres de token SAS, uma instância de um AzureSasCredential ou AzureNamedKeyCredential de azure.core.credentials, uma chave de acesso compartilhado de conta ou uma instância de uma classe TokenCredentials do azure.identity. Se o URI do recurso já contiver um token SAS, isso será ignorado em favor de uma credencial explícita

• exceto no caso do AzureSasCredential, em que os tokens SAS conflitantes gerarão um ValueError. Se estiver usando uma instância do AzureNamedKeyCredential, "name" deverá ser o nome da conta de armazenamento e "key" deverá ser a chave da conta de armazenamento.

overwrite

bool

Se o blob a ser carregado deve substituir os dados atuais. Se True, upload_blob_to_url substituirá todos os dados existentes. Se definido como False, a operação falhará com um ResourceExistsError.

max_concurrency

int

O número de conexões paralelas com as quais baixar.

length

int

Número de bytes a serem lidos do fluxo. Isso é opcional, mas deve ser fornecido para o desempenho ideal.

metadata

dict(str,str)

Pares de nome-valor associados ao blob como metadados.

validate_content

bool

Se for true, calculará um hash MD5 para cada parte do blob. O serviço de armazenamento verifica o hash do conteúdo que chegou com o hash que foi enviado. Isso é importante principalmente para detectar bitflips no fio se o uso de http em vez de https como https (o padrão) já validará. Observe que esse hash MD5 não é armazenado com o blob. Observe também que, se habilitado, o algoritmo de carregamento com eficiência de memória não será usado, pois a computação do hash MD5 requer buffer de blocos inteiros e isso derrota a finalidade do algoritmo com eficiência de memória.

encoding

str

Codificação a ser usada se o texto for fornecido como entrada. O padrão é UTF-8.

Retornos

Dict de propriedade atualizado por blob (Etag e última modificação)

Tipo de retorno

dict(str, Any)