aio Pacote

Classes

BlobClient	Um cliente para interagir com um blob específico, embora esse blob ainda não exista.
BlobLeaseClient	Cria um novo BlobLeaseClient. Esse cliente fornece operações de concessão em um BlobClient ou ContainerClient.
BlobPrefix	Um Iterável das propriedades do Blob. Retornado de walk_blobs quando um delimitador é usado. Pode ser considerado como um diretório de blob virtual.
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 .
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 .
ExponentialRetry	Repetição exponencial. Constrói um objeto de repetição exponencial. O initial_backoff é usado para a primeira repetição. As repetições subsequentes são repetidas após initial_backoff + increment_power^retry_count segundos. Por exemplo, por padrão, a primeira repetição ocorre após 15 segundos, a segunda após (15+3^1) = 18 segundos e a terceira após (15+3^2) = 24 segundos.
LinearRetry	Repetição linear. Constrói um objeto de repetição Linear.
StorageStreamDownloader	Um objeto de streaming a ser baixado do Armazenamento do Azure.

Funções

download_blob_from_url

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

async 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

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 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 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 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 gravação 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 o 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 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.

Tipo de retorno

None

upload_blob_to_url

Carregar dados em uma determinada URL

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

param str blob_url: o URI completo para o blob. Isso também pode incluir um token SAS.

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

dados de tipo: bytes ou str ou Iterable

async 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

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.

credencial paramtype: Opcional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long

palavra-chave substituição 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.

palavra-chave int max_concurrency: o número de conexões paralelas com as quais baixar.

palavra-chave comprimento int: número de bytes a serem lidos do fluxo. Isso é opcional, mas deve ser fornecido para o desempenho ideal.

palavra-chave metadados dict(str,str): pares nome-valor associados ao blob como metadados.

palavra-chave validate_content bool: se verdadeiro, calcula 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.

palavra-chave codificação str: codificação a ser usada se o texto for fornecido como entrada. O padrão é UTF-8.

returns: dict de propriedade atualizada por blob (Etag e última modificação)

rtype: dict(str, Any)

blob_url

data