Partilhar via

aio Pacote

  • Referência

Classes

BlobClient

Um cliente para interagir com um blob específico, embora esse blob possa ainda não existir.
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.
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 .
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 .
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. Por exemplo, por predefiniçã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 transmissão em fluxo a transferir a partir do Armazenamento do Azure.

Funções

download_blob_from_url

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

None

upload_blob_to_url

Carregar dados para um determinado URL

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

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

Dados de parâmetros: os dados a carregar. Isto pode ser bytes, texto, iterável ou um objeto semelhante a um ficheiro.

escrever dados: 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 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.

Credencial do parâmetro: Opcional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long

substituição do bool de palavra-chave: 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.

palavra-chave int max_concurrency: o número de ligações paralelas com as quais transferir.

comprimento de int da palavra-chave: número de bytes a ler a partir da transmissão em fluxo. Isto é opcional, mas deve ser fornecido para um desempenho ideal.

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

validate_content bool de palavra-chave: 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.

codificação de cadeia de palavras-chave: codificação para utilizar se o texto for fornecido como entrada. A predefinição é UTF-8.

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

rtype: dict(str, Any)

blob_url
data