aio Paket

Klasser

BlobClient	En klient som ska interagera med en specifik blob, även om den bloben kanske inte finns ännu.
BlobLeaseClient	Skapar en ny BlobLeaseClient. Den här klienten tillhandahåller låneåtgärder på en BlobClient eller ContainerClient.
BlobPrefix	En iterabel av Blob-egenskaper. Returneras från walk_blobs när en avgränsare används. Kan ses som en virtuell blobkatalog.
BlobServiceClient	En klient som ska interagera med Blob Service på kontonivå. Den här klienten tillhandahåller åtgärder för att hämta och konfigurera kontoegenskaper samt lista, skapa och ta bort containrar i kontot. För åtgärder som rör en specifik container eller blob kan klienter för dessa entiteter också hämtas med hjälp av get_client-funktionerna .
ContainerClient	En klient som ska interagera med en specifik container, även om den containern kanske inte finns ännu. För åtgärder som rör en specifik blob i den här containern kan en blobklient hämtas med hjälp av get_blob_client funktionen .
ExponentialRetry	Exponentiellt återförsök. Skapar ett exponentiellt återförsöksobjekt. Initial_backoff används för det första återförsöket. Efterföljande återförsök görs på nytt efter initial_backoff + increment_power^retry_count sekunder. Som standard sker det första återförsöket efter 15 sekunder, det andra efter (15+3^1) = 18 sekunder och det tredje efter (15+3^2) = 24 sekunder.
LinearRetry	Linjärt återförsök. Skapar ett linjärt återförsöksobjekt.
StorageStreamDownloader	Ett strömmande objekt som ska laddas ned från Azure Storage.

Funktioner

download_blob_from_url

Ladda ned innehållet i en blob till en lokal fil eller dataström.

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

Parametrar

blob_url

str

Obligatorisk

Den fullständiga URI:n till bloben. Detta kan även innehålla en SAS-token.

output

str eller <xref:<xref:writable stream>>

Obligatorisk

Där data ska laddas ned till. Det kan vara antingen en filsökväg att skriva till eller ett öppet I/O-handtag att skriva till.

credential

standardvärde: None

De autentiseringsuppgifter som ska autentiseras med. Det här är valfritt om blob-URL:en redan har en SAS-token eller om bloben är offentlig. Värdet kan vara en SAS-tokensträng, en instans av en AzureSasCredential eller AzureNamedKeyCredential från azure.core.credentials, en kontodelad åtkomstnyckel eller en instans av en TokenCredentials-klass från azure.identity. Om resurs-URI:n redan innehåller en SAS-token ignoreras detta till förmån för en explicit autentiseringsuppgift

• utom när det gäller AzureSasCredential, där de motstridiga SAS-token genererar en ValueError. Om du använder en instans av AzureNamedKeyCredential ska "namn" vara lagringskontots namn och "nyckel" ska vara lagringskontonyckeln.

overwrite

bool

Om den lokala filen ska skrivas över om den redan finns. Standardvärdet är False – i så fall utlöses en ValueError om filen redan finns. Om värdet är True görs ett försök att skriva till den befintliga filen. Om ett strömhandtag skickas ignoreras det här värdet.

max_concurrency

int

Antalet parallella anslutningar som du kan ladda ned.

offset

int

Start av byteintervall som ska användas för att ladda ned ett avsnitt av blobben. Måste anges om längden anges.

length

int

Antal byte som ska läsas från dataströmmen. Detta är valfritt, men bör tillhandahållas för optimala prestanda.

validate_content

bool

Om det är sant beräknas en MD5-hash för varje segment av blobben. Lagringstjänsten kontrollerar hashen för det innehåll som har anlänt med hashen som skickades. Detta är främst värdefullt för att identifiera bitflips på tråden om http i stället för https som https (standard) redan verifieras. Observera att denna MD5-hash inte lagras med bloben. Observera också att om den är aktiverad används inte den minneseffektiva uppladdningsalgoritmen, eftersom databehandling av MD5-hashen kräver buffring av hela block, och detta minskar syftet med den minneseffektiva algoritmen.

Returtyp

None

upload_blob_to_url

Ladda upp data till en viss URL

Data laddas upp som en blockblob.

param str blob_url: Den fullständiga URI:n till bloben. Detta kan även innehålla en SAS-token.

param-data: De data som ska laddas upp. Detta kan vara byte, text, ett iterbart eller ett filliknande objekt.

typdata: byte eller str eller 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]

Parametrar

credential

standardvärde: None

De autentiseringsuppgifter som ska autentiseras med. Det här är valfritt om blob-URL:en redan har en SAS-token. Värdet kan vara en SAS-tokensträng, en instans av en AzureSasCredential eller AzureNamedKeyCredential från azure.core.credentials, en kontodelad åtkomstnyckel eller en instans av en TokenCredentials-klass från azure.identity. Om resurs-URI:n redan innehåller en SAS-token ignoreras detta till förmån för en explicit autentiseringsuppgift

• utom när det gäller AzureSasCredential, där de motstridiga SAS-token genererar en ValueError. Om du använder en instans av AzureNamedKeyCredential ska "namn" vara lagringskontots namn och "nyckel" ska vara lagringskontonyckeln.

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

keyword bool overwrite: Om bloben som ska laddas upp ska skriva över aktuella data. Om det är sant skriver upload_blob_to_url över befintliga data. Om värdet är Falskt misslyckas åtgärden med en ResourceExistsError.

keyword int max_concurrency: Antalet parallella anslutningar som du kan ladda ned.

nyckelordets int-längd: Antal byte som ska läsas från dataströmmen. Detta är valfritt, men bör tillhandahållas för optimala prestanda.

keyword dict(str,str) metadata: Namn/värde-par som är associerade med blobben som metadata.

keyword bool validate_content: Om det är sant beräknas en MD5-hash för varje segment i blobben. Lagringstjänsten kontrollerar hashen för det innehåll som har anlänt med hashen som skickades. Detta är främst värdefullt för att identifiera bitflips på tråden om http i stället för https som https (standard) redan verifieras. Observera att denna MD5-hash inte lagras med bloben. Observera också att om den är aktiverad används inte den minneseffektiva uppladdningsalgoritmen, eftersom databehandling av MD5-hashen kräver buffring av hela block, och detta minskar syftet med den minneseffektiva algoritmen.

keyword str encoding: Kodning som ska användas om text anges som indata. Standardvärdet ÄR UTF-8.

returns: Blob-uppdaterad egenskapsdikt (Etag och senast ändrad)

rtype: dict(str, any)

blob_url

data