Partilhar via


blob Pacote

Pacote

aio

Classes

AccessPolicy

Classe política de acesso utilizada 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 das Assinaturas de Acesso Partilhado com as quais está associada. Consoante a forma como pretende controlar o acesso ao recurso, pode especificar todos estes parâmetros na política de acesso armazenada e omiti-los a partir do URL da Assinatura de Acesso Partilhado. Ao fazê-lo, pode modificar o comportamento da assinatura associada em qualquer altura, bem como revogá-lo. Em alternativa, pode especificar um ou mais dos parâmetros da política de acesso na política de acesso armazenada e os outros no URL. Por fim, pode especificar todos os parâmetros no URL. Neste caso, pode utilizar a política de acesso armazenada para revogar a assinatura, mas não para modificar o respetivo comportamento.

Em conjunto, a Assinatura de Acesso Partilhado e a política de acesso armazenado têm de incluir todos os campos necessários para autenticar a assinatura. Se existirem campos necessários em falta, o pedido falhará. Da mesma forma, se for especificado um campo no URL da Assinatura de Acesso Partilhado e na política de acesso armazenada, o pedido falhará com o código de estado 400 (Pedido Incorreto).

AccountSasPermissions

ResourceTypes classe a utilizar com a função generate_account_sas e para as AccessPolicies utilizadas com set_*_acl. Existem dois tipos de SAS que podem ser utilizados 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

de um esquema de seta.

Todos os parâmetros necessários têm de ser preenchidos para enviar para o Azure.

BlobAnalyticsLogging

Definições do Registo do Azure Analytics.

BlobBlock

BlockBlob Block class (Classe BlockBlob Block).

BlobClient

Um cliente para interagir com um blob específico, embora esse blob possa ainda não existir.

Para obter mais configuração opcional, clique aqui.

BlobLeaseClient

Cria um novo BlobLeaseClient.

Este cliente fornece operações de concessão num BlobClient ou ContainerClient.

BlobPrefix

Iterável das propriedades do Blob.

Devolvido de walk_blobs quando é utilizado um delimitador. Pode ser considerado um diretório de blobs virtual.

BlobProperties

Propriedades do Blob.

BlobQueryError

O erro ocorreu durante a operação de consulta rápida.

BlobQueryReader

Um objeto de transmissão em fluxo para ler os resultados da consulta.

BlobSasPermissions

Classe BlobSasPermissions a utilizar com a generate_blob_sas função .

BlobServiceClient

Um cliente para interagir com o Serviço Blob ao nível da conta.

Este cliente fornece operações para obter e configurar as propriedades da conta, bem como listar, criar e eliminar contentores na conta. Para operações relacionadas com um contentor ou blob específico, os clientes dessas entidades também podem ser obtidos com as funções de get_client .

Para obter mais configuração opcional, clique aqui.

ContainerClient

Um cliente para interagir com um contentor específico, embora esse contentor possa ainda não existir.

Para operações relacionadas com um blob específico neste contentor, um cliente de blobs pode ser obtido com a get_blob_client função .

Para obter mais configuração opcional, clique aqui.

ContainerEncryptionScope

A configuração de âmbito de encriptação predefinida para um contentor.

Este âmbito é utilizado implicitamente para todas as escritas futuras no contentor, mas pode ser substituído por operação de blob.

Novidade na versão 12.2.0.

ContainerProperties

Classe de propriedades do contentor de blobs.

As instâncias devolvidas ContainerProperties expõem estes valores através de uma interface de dicionário, por exemplo: container_props["last_modified"]. Além disso, o nome do contentor está disponível como container_props["name"].

ContainerSasPermissions

ContainerSasPermissions class to be used with the generate_container_sas function and for the AccessPolicies used with set_container_access_policy.

ContentSettings

As definições de conteúdo de um blob.

CopyProperties

Propriedades de Cópia de Blobs.

Estas propriedades serão Nenhuma se este blob nunca tiver sido o destino numa operação Copiar Blob ou se este blob tiver sido modificado após uma operação de Copiar Blob concluída, por exemplo, com Definir Propriedades do Blob, Carregar Blob ou Consolidar Lista de Blocos.

CorsRule

O CORS é uma funcionalidade HTTP que permite a execução de uma aplicação Web num domínio para aceder a recursos noutro domínio. Os browsers implementam uma restrição de segurança conhecida como política de origem idêntica, que impede uma página Web de chamar APIs num domínio diferente. O CORS é uma forma segura de permitir que um domínio (o domínio de origem) chame APIs de outro domínio.

CustomerProvidedEncryptionKey

Todos os dados no Armazenamento do Azure são encriptados inativos com uma chave de encriptação ao nível da conta. Nas versões 2018-06-17 e mais recentes, pode gerir a chave utilizada para encriptar conteúdos de blobs e metadados de aplicações por blob ao fornecer uma chave de encriptação AES-256 em pedidos para o serviço de armazenamento.

Quando utiliza uma chave fornecida pelo cliente, o Armazenamento do Azure não gere nem mantém a sua chave. Ao escrever dados num blob, a chave fornecida é utilizada para encriptar os seus dados antes de os escrever no disco. Um hash SHA-256 da chave de encriptação é escrito juntamente com o conteúdo do blob e é utilizado para verificar se todas as operações subsequentes no blob utilizam a mesma chave de encriptação. Este hash não pode ser utilizado para obter a chave de encriptação ou desencriptar o conteúdo do blob. Ao ler um blob, a chave fornecida é utilizada para desencriptar os seus dados depois de os ler a partir do disco. Em ambos os casos, a chave de encriptação fornecida é eliminada em segurança assim que o processo de encriptação ou desencriptação for concluído.

DelimitedJsonDialect

Define a serialização JSON de entrada ou saída para uma consulta de dados de blobs.

delimitador str da palavra-chave: o caráter separador de linha, o valor predefinido é '

'

DelimitedTextDialect

Define a serialização delimitada por entrada ou saída (CSV) para um pedido de consulta blob.

ExponentialRetry

Repetição exponencial.

Constrói um objeto de repetição exponencial. A initial_backoff é utilizada para a primeira repetição. As repetições subsequentes são repetidas após initial_backoff + increment_power^retry_count segundos.

FilteredBlob

Informações de blobs de uma chamada à API de Blobs de Filtros.

ImmutabilityPolicy

Parâmetros opcionais para definir a política de imutabilidade de um blob, instantâneo de blob ou versão de blob.

Novidade na versão 12.10.0: foi introduzida na versão de API "2020-10-02".

LeaseProperties

Propriedades de Concessão de Blobs.

LinearRetry

Repetição linear.

Constrói um objeto de repetição linear.

LocationMode

Especifica a localização para a qual o pedido deve ser enviado. Este modo aplica-se apenas a contas RA-GRS que permitem o acesso de leitura secundário. Todos os outros tipos de conta têm de utilizar PRIMARY.

Metrics

Um resumo das estatísticas de pedido agrupadas por API em agregações de hora ou minuto para blobs.

ObjectReplicationPolicy

ID da política e IDs de regras aplicados a um blob.

ObjectReplicationRule

ID da política e IDs de regras aplicados a um blob.

PageRange

Intervalo de Páginas do blob de páginas.

PartialBatchErrorException

Existe uma falha parcial nas operações de lote.

ResourceTypes

Especifica os tipos de recursos que estão acessíveis com a SAS da conta.

RetentionPolicy

A política de retenção que determina durante quanto tempo os dados associados devem persistir.

StaticWebsite

As propriedades que permitem que uma conta aloje um site estático.

StorageStreamDownloader

Um objeto de transmissão em fluxo a transferir a partir do Armazenamento do Azure.

UserDelegationKey

Representa uma chave de delegação de utilizador, fornecida ao utilizador pelo Armazenamento do Azure com base no token de acesso do Azure Active Directory.

Os campos são guardados como cadeias simples, uma vez que o utilizador não tem de interagir com este objeto; para gerar uma SAS de identificação, o utilizador pode simplesmente passá-la para a API correta.

Enumerações

ArrowType
BlobImmutabilityPolicyMode

Especifica o modo de política de imutabilidade a definir no blob. "Mutable" só pode ser devolvido pelo serviço, não definido como "Mutable".

BlobType
BlockState

Tipos de blocos de blobs de blocos.

PremiumPageBlobTier

Especifica a camada de blob de páginas para definir o blob como. Isto só é aplicável a blobs de páginas em contas de armazenamento premium. Veja: https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets para obter informações detalhadas sobre o IOPS e débito correspondentes por PageBlobTier.

PublicAccess

Especifica se os dados no contentor podem ser acedidos publicamente e o nível de acesso.

QuickQueryDialect

Especifica o dialeto de entrada/saída da consulta rápida.

RehydratePriority

Se um objeto estiver no estado de reidratar pendente, este cabeçalho é devolvido 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 blobs para definir o blob como. Isto só é aplicável a blobs de blocos em contas de armazenamento padrão.

StorageErrorCode

Funções

download_blob_from_url

Transfira o conteúdo de um blob para um ficheiro 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
Necessário

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

output
str ou <xref:<xref:writable stream.>>
Necessário

Para onde os dados devem ser transferidos. Pode ser um caminho de ficheiro para o qual escrever ou um identificador de E/S aberto para escrever.

credential
valor predefinido: None

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

  • exceto no caso do AzureSasCredential, em que os tokens SAS em conflito gerarão um ValueError. Se utilizar uma instância do AzureNamedKeyCredential, "name" deve ser o nome da conta de armazenamento e "chave" deve ser a chave da conta de armazenamento.
overwrite
bool

Se o ficheiro local deve ser substituído se já existir. O valor predefinido é Falso . Nesse caso, será gerado um ValueError se o ficheiro já existir. Se estiver definido como Verdadeiro, será efetuada uma tentativa de escrita no ficheiro existente. Se for transmitida uma alça de transmissão, este valor é ignorado.

max_concurrency
int

O número de ligações paralelas com as quais transferir.

offset
int

Início do intervalo de bytes a utilizar para transferir uma secção do blob. Tem de ser definido se o comprimento for fornecido.

length
int

Número de bytes a ler a partir da transmissão em fluxo. Isto é opcional, mas deve ser fornecido para um desempenho ideal.

validate_content
bool

Se for verdadeiro, calcula um hash MD5 para cada segmento do blob. O serviço de armazenamento compara o hash do conteúdo que chegou ao hash que foi enviado. Isto é importante para detetar bitflips no fio se a utilização de http em vez de https como https (a predefinição) já for validada. Note que este Hash MD5 não está armazenado com a bolha. Tenha também em atenção que, se estiver ativado, o algoritmo de carregamento com eficiência de memória não será utilizado, uma vez que a computação do hash MD5 requer a colocação em memória intermédia de blocos inteiros e, ao fazê-lo, irá derrotar a finalidade do algoritmo com eficiência de memória.

Tipo de retorno

generate_account_sas

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

Utilize a assinatura devolvida 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
Necessário

O nome da conta de armazenamento utilizado para gerar a assinatura de acesso partilhado.

account_key
str
Necessário

A chave de conta, também denominada chave partilhada ou chave de acesso, para gerar a assinatura de acesso partilhado.

resource_types
str ou ResourceTypes
Necessário

Especifica os tipos de recursos que estão acessíveis com a SAS da conta.

permission
str ou AccountSasPermissions
Necessário

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.

expiry
datetime ou str
Necessário

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.

start
datetime ou str
valor predefinido: None

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
valor predefinido: None

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 ip=168.1.5.65 ou ip=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.

encryption_scope
str

Especifica o âmbito de encriptação de um pedido feito para que todas as operações de escrita sejam encriptadas pelo serviço.

Devoluções

Um token de Assinatura de Acesso Partilhado (sas).

Tipo de retorno

str

generate_blob_sas

Gera uma assinatura de acesso partilhado para um blob.

Utilize a assinatura devolvida 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
Necessário

O nome da conta de armazenamento utilizado para gerar a assinatura de acesso partilhado.

container_name
str
Necessário

O nome do contentor.

blob_name
str
Necessário

O nome do blob.

snapshot
str
valor predefinido: None

Um ID de instantâneo de blob opcional.

account_key
str
valor predefinido: None

A chave de conta, também denominada chave partilhada ou chave de acesso, para gerar a assinatura de acesso partilhado. Tem de especificar account_key ou user_delegation_key .

user_delegation_key
UserDelegationKey
valor predefinido: None

Em vez de uma chave partilhada 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 conseguido ao chamar get_user_delegation_key. Quando estiver presente, a SAS é assinada com a chave de delegação de utilizador.

permission
str ou BlobSasPermissions
valor predefinido: None

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

expiry
datetime ou str
valor predefinido: None

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.

start
datetime ou str
valor predefinido: None

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.

policy_id
str
valor predefinido: None

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

ip
str
valor predefinido: None

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

version_id
str

Um ID de versão de blob opcional. Este parâmetro só é aplicável a contas de Armazenamento com controlo de versões ativada. Tenha em atenção que o parâmetro de consulta "versionid" não está incluído no SAS de saída. Por conseguinte, forneça o parâmetro "version_id" a quaisquer APIs ao utilizar a SAS de saída para operar numa versão específica.

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

protocol
str

Especifica o protocolo permitido para um pedido feito. O valor predefinido é https.

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.

encryption_scope
str

Especifica o âmbito de encriptação de um pedido feito para que todas as operações de escrita sejam encriptadas pelo serviço.

correlation_id
str

O ID de correlação para correlacionar os registos de auditoria de armazenamento com os registos de auditoria utilizados pelo principal que gera e distribui a SAS. Isto só pode ser utilizado ao gerar uma SAS com chave de delegação.

Devoluções

Um token de Assinatura de Acesso Partilhado (sas).

Tipo de retorno

str

generate_container_sas

Gera uma assinatura de acesso partilhado para um contentor.

Utilize a assinatura devolvida 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
Necessário

O nome da conta de armazenamento utilizado para gerar a assinatura de acesso partilhado.

container_name
str
Necessário

O nome do contentor.

account_key
str
valor predefinido: None

A chave de conta, também denominada chave partilhada ou chave de acesso, para gerar a assinatura de acesso partilhado. Tem de especificar account_key ou user_delegation_key .

user_delegation_key
UserDelegationKey
valor predefinido: None

Em vez de uma chave partilhada 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 conseguido ao chamar get_user_delegation_key. Quando estiver presente, a SAS é assinada com a chave de delegação de utilizador.

permission
str ou ContainerSasPermissions
valor predefinido: None

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

expiry
datetime ou str
valor predefinido: None

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.

start
datetime ou str
valor predefinido: None

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.

policy_id
str
valor predefinido: None

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

ip
str
valor predefinido: None

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 ip=168.1.5.65 ou ip=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.

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.

encryption_scope
str

Especifica o âmbito de encriptação de um pedido feito para que todas as operações de escrita sejam encriptadas pelo serviço.

correlation_id
str

O ID de correlação para correlacionar os registos de auditoria de armazenamento com os registos de auditoria utilizados pelo principal que gera e distribui a SAS. Isto só pode ser utilizado ao gerar uma SAS com chave de delegação.

Devoluções

Um token de Assinatura de Acesso Partilhado (sas).

Tipo de retorno

str

upload_blob_to_url

Carregar dados para um determinado 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
Necessário

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

data
bytes ou str ou Iterable
Necessário

Os dados a carregar. Isto pode ser bytes, texto, iterável ou um objeto semelhante a um ficheiro.

credential
valor predefinido: None

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

  • exceto no caso do AzureSasCredential, em que os tokens SAS em conflito gerarão um ValueError. Se utilizar uma instância do AzureNamedKeyCredential, "name" deve ser o nome da conta de armazenamento e "chave" deve ser a chave da conta de armazenamento.
overwrite
bool

Se o blob a carregar deve substituir os dados atuais. Se for Verdadeiro, upload_blob_to_url substituirá quaisquer dados existentes. Se estiver definida como Falso, a operação falhará com um ResourceExistsError.

max_concurrency
int

O número de ligações paralelas com as quais transferir.

length
int

Número de bytes a ler a partir da transmissão em fluxo. Isto é opcional, mas deve ser fornecido para um desempenho ideal.

metadata
dict(str,str)

Pares nome-valor associados ao blob como metadados.

validate_content
bool

Se for verdadeiro, calcula um hash MD5 para cada segmento do blob. O serviço de armazenamento compara o hash do conteúdo que chegou ao hash que foi enviado. Isto é importante para detetar bitflips no fio se a utilização de http em vez de https como https (a predefinição) já for validada. Note que este Hash MD5 não está armazenado com a bolha. Tenha também em atenção que, se estiver ativado, o algoritmo de carregamento com eficiência de memória não será utilizado, uma vez que a computação do hash MD5 requer a colocação em memória intermédia de blocos inteiros e, ao fazê-lo, irá derrotar a finalidade do algoritmo com eficiência de memória.

encoding
str

Codificação para utilizar se o texto for fornecido como entrada. A predefinição é UTF-8.

Devoluções

Dict da propriedade atualizada com blobs (Etag e última modificação)

Tipo de retorno