Compartilhar via


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

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