aio Pakket

Klassen

BlobClient	Een client voor interactie met een specifieke blob, hoewel die blob mogelijk nog niet bestaat.
BlobLeaseClient	Hiermee maakt u een nieuwe BlobLeaseClient. Deze client biedt leasebewerkingen op een BlobClient of ContainerClient.
BlobPrefix	Een iterable van Blob-eigenschappen. Geretourneerd door walk_blobs wanneer een scheidingsteken wordt gebruikt. Kan worden beschouwd als een virtuele blobmap.
BlobServiceClient	Een client voor interactie met de Blob-service op accountniveau. Deze client biedt bewerkingen voor het ophalen en configureren van de accounteigenschappen, evenals het weergeven, maken en verwijderen van containers in het account. Voor bewerkingen met betrekking tot een specifieke container of blob kunnen clients voor deze entiteiten ook worden opgehaald met behulp van de get_client-functies .
ContainerClient	Een client voor interactie met een specifieke container, hoewel die container mogelijk nog niet bestaat. Voor bewerkingen met betrekking tot een specifieke blob in deze container kan een blobclient worden opgehaald met behulp van de get_blob_client functie.
ExponentialRetry	Exponentieel opnieuw proberen. Maakt een exponentieel object voor opnieuw proberen. De initial_backoff wordt gebruikt voor de eerste nieuwe poging. Volgende nieuwe pogingen worden opnieuw geprobeerd na initial_backoff + increment_power^retry_count seconden. De eerste poging vindt bijvoorbeeld standaard plaats na 15 seconden, de tweede na (15+3^1) = 18 seconden en de derde na (15+3^2) = 24 seconden.
LinearRetry	Lineaire nieuwe poging. Maakt een lineaire pogingsobject.
StorageStreamDownloader	Een streaming-object om te downloaden uit Azure Storage.

Functies

download_blob_from_url

Download de inhoud van een blob naar een lokaal bestand of een lokale stream.

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

Parameters

blob_url

str

Vereist

De volledige URI naar de blob. Dit kan ook een SAS-token bevatten.

output

str of <xref:<xref:writable stream>>

Vereist

Waar de gegevens naar moeten worden gedownload. Dit kan een bestandspad zijn om naar te schrijven of een open IO-ingang om naar te schrijven.

credential

standaardwaarde: None

De referenties waarmee moet worden geverifieerd. Dit is optioneel als de blob-URL al een SAS-token heeft of als de blob openbaar is. De waarde kan een SAS-tokentekenreeks zijn, een exemplaar van een AzureSasCredential of AzureNamedKeyCredential van azure.core.credentials, een gedeelde toegangssleutel voor het account of een exemplaar van een TokenCredentials-klasse van azure.identity. Als de resource-URI al een SAS-token bevat, wordt dit genegeerd ten gunste van een expliciete referentie

• behalve in het geval van AzureSasCredential, waarbij de conflicterende SAS-tokens een ValueError genereren. Als u een exemplaar van AzureNamedKeyCredential gebruikt, moet 'name' de naam van het opslagaccount zijn en moet 'sleutel' de sleutel van het opslagaccount zijn.

overwrite

bool

Of het lokale bestand moet worden overschreven als het al bestaat. De standaardwaarde is False . In dat geval wordt een ValueError gegenereerd als het bestand al bestaat. Als deze optie is ingesteld op True, wordt geprobeerd om naar het bestaande bestand te schrijven. Als een stream-ingang wordt doorgegeven, wordt deze waarde genegeerd.

max_concurrency

int

Het aantal parallelle verbindingen waarmee moet worden gedownload.

offset

int

Begin van het bytebereik dat moet worden gebruikt voor het downloaden van een sectie van de blob. Moet worden ingesteld als de lengte is opgegeven.

length

int

Aantal bytes dat uit de stream moet worden gelezen. Dit is optioneel, maar moet worden geleverd voor optimale prestaties.

validate_content

bool

Als dit waar is, wordt een MD5-hash berekend voor elk segment van de blob. De opslagservice controleert de hash van de inhoud die is aangekomen met de hash die is verzonden. Dit is vooral waardevol voor het detecteren van bitflips op de draad als u http gebruikt in plaats van https omdat https (de standaardinstelling) al wordt gevalideerd. Houd er rekening mee dat deze MD5-hash niet wordt opgeslagen met de blob. Houd er ook rekening mee dat als dit is ingeschakeld, het geheugenefficiënte upload-algoritme niet wordt gebruikt, omdat voor het berekenen van de MD5-hash hele blokken moeten worden gebufferd, waardoor het doel van het geheugenefficiënte algoritme wordt genegeerd.

Retourtype

None

upload_blob_to_url

Gegevens uploaden naar een bepaalde URL

De gegevens worden geüpload als een blok-blob.

param str blob_url: de volledige URI naar de blob. Dit kan ook een SAS-token bevatten.

param-gegevens: de gegevens die moeten worden geüpload. Dit kunnen bytes, tekst, een itereerbaar of een bestand-achtig object zijn.

type gegevens: bytes of str of 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]

Parameters

credential

standaardwaarde: None

De referenties waarmee moet worden geverifieerd. Dit is optioneel als de blob-URL al een SAS-token heeft. De waarde kan een SAS-tokentekenreeks zijn, een exemplaar van een AzureSasCredential of AzureNamedKeyCredential van azure.core.credentials, een gedeelde toegangssleutel voor het account of een exemplaar van een TokenCredentials-klasse van azure.identity. Als de resource-URI al een SAS-token bevat, wordt dit genegeerd ten gunste van een expliciete referentie

• behalve in het geval van AzureSasCredential, waarbij de conflicterende SAS-tokens een ValueError genereren. Als u een exemplaar van AzureNamedKeyCredential gebruikt, moet 'name' de naam van het opslagaccount zijn en moet 'sleutel' de sleutel van het opslagaccount zijn.

paramtypereferentie: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long

keyword bool overwrite: of de blob die moet worden geüpload, de huidige gegevens moet overschrijven. Indien Waar, overschrijft upload_blob_to_url alle bestaande gegevens. Als deze optie is ingesteld op False, mislukt de bewerking met een ResourceExistsError.

keyword int max_concurrency: het aantal parallelle verbindingen waarmee moet worden gedownload.

lengte van trefwoord int: het aantal bytes dat uit de stream moet worden gelezen. Dit is optioneel, maar moet worden geleverd voor optimale prestaties.

metagegevens van keyword dict(str,str): naam-waardeparen die als metagegevens aan de blob zijn gekoppeld.

trefwoord bool validate_content: indien waar, wordt een MD5-hash berekend voor elk segment van de blob. De opslagservice controleert de hash van de inhoud die is aangekomen met de hash die is verzonden. Dit is vooral waardevol voor het detecteren van bitflips op de draad als u http gebruikt in plaats van https omdat https (de standaardinstelling) al wordt gevalideerd. Houd er rekening mee dat deze MD5-hash niet wordt opgeslagen met de blob. Houd er ook rekening mee dat als dit is ingeschakeld, het geheugenefficiënte upload-algoritme niet wordt gebruikt, omdat voor het berekenen van de MD5-hash hele blokken moeten worden gebufferd, waardoor het doel van het geheugenefficiënte algoritme wordt genegeerd.

keyword str encoding: codering die moet worden gebruikt als tekst wordt opgegeven als invoer. De standaardinstelling is UTF-8.

retourneert: Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd)

rtype: dict(str, Any)

blob_url

data