Dela via


ContainerClient Klass

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 .

Arv
azure.storage.blob._shared.base_client_async.AsyncStorageAccountHostsMixin
ContainerClient
azure.storage.blob._container_client.ContainerClient
ContainerClient
azure.storage.blob._encryption.StorageEncryptionMixin
ContainerClient

Konstruktor

ContainerClient(account_url: str, container_name: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | AsyncTokenCredential | None = None, **kwargs: Any)

Parametrar

account_url
str
Obligatorisk

URI:n till lagringskontot. Använd classmethod för att skapa en klient med den fullständiga URI:n till containern from_container_url .

container_name
str
Obligatorisk

Namnet på containern för bloben.

credential
standardvärde: None

De autentiseringsuppgifter som ska autentiseras med. Detta är valfritt om konto-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 "name" vara lagringskontots namn och "nyckel" ska vara lagringskontonyckeln.
api_version
str

Den Storage API-version som ska användas för begäranden. Standardvärdet är den senaste tjänstversionen som är kompatibel med aktuell SDK. Om du anger en äldre version kan funktionskompatibiliteten minska.

Ny i version 12.2.0.

secondary_hostname
str

Värdnamnet för den sekundära slutpunkten.

max_block_size
int

Den maximala segmentstorleken för att ladda upp en blockblob i segment. Standardvärdet är 4*1024*1024 eller 4 MB.

max_single_put_size
int

Om blobstorleken är mindre än eller lika med max_single_put_size laddas bloben bara upp med en http PUT-begäran. Om blobstorleken är större än max_single_put_size laddas bloben upp i segment. Standardvärdet är 64*1024*1024 eller 64 MB.

min_large_block_upload_threshold
int

Den minsta segmentstorlek som krävs för att använda den minneseffektiva algoritmen när du laddar upp en blockblob. Standardvärdet är 4*1024*1024+1.

use_byte_buffer
bool

Använd en bytebuffert för blockblobuppladdningar. Standardvärdet är False.

max_page_size
int

Den maximala segmentstorleken för att ladda upp en sidblob. Standardvärdet är 4*1024*1024 eller 4 MB.

max_single_get_size
int

Den maximala storleken för en blob som ska laddas ned i ett enda anrop. Den överskred delen laddas ned i segment (kan vara parallell). Standardvärdet är 32*1024*1024 eller 32 MB.

max_chunk_get_size
int

Den maximala segmentstorleken som används för att ladda ned en blob. Standardvärdet är 4*1024*1024 eller 4 MB.

Metoder

acquire_lease

Begär ett nytt lån. Om containern inte har ett aktivt lån skapar Blob Service ett lån för containern och returnerar ett nytt låne-ID.

close

Den här metoden är att stänga de sockets som öppnas av klienten. Den behöver inte användas när du använder med en kontexthanterare.

create_container

Skapar en ny container under det angivna kontot. Om containern med samma namn redan finns misslyckas åtgärden.

delete_blob

Markerar den angivna bloben eller ögonblicksbilden för borttagning.

Bloben tas senare bort under skräpinsamlingen. Observera att om du vill ta bort en blob måste du ta bort alla dess ögonblicksbilder. Du kan ta bort båda samtidigt med åtgärden delete_blob.

Om en kvarhållningsprincip för borttagning är aktiverad för tjänsten tar den här åtgärden mjukt bort bloben eller ögonblicksbilden och behåller bloben eller ögonblicksbilden under angivet antal dagar. Efter angivet antal dagar tas blobens data bort från tjänsten under skräpinsamlingen. Mjukt borttagna blobar eller ögonblicksbilder är tillgängliga genom list_blobs att ange include=["deleted"] Mjuk borttagning av blob eller ögonblicksbild kan återställas med hjälp av <xref:azure.storage.blob.aio.BlobClient.undelete>

delete_blobs

Markerar de angivna blobarna eller ögonblicksbilderna för borttagning.

Blobarna tas senare bort under skräpinsamlingen. Observera att om du vill ta bort blobar måste du ta bort alla deras ögonblicksbilder. Du kan ta bort båda samtidigt med åtgärden delete_blobs.

Om en kvarhållningsprincip för borttagning är aktiverad för tjänsten tar den här åtgärden mjukt bort blobarna eller ögonblicksbilderna och behåller blobarna eller ögonblicksbilderna under angivet antal dagar. Efter angivet antal dagar tas blobarnas data bort från tjänsten under skräpinsamlingen. Mjukt borttagna blobar eller ögonblicksbilder är tillgängliga genom list_blobs att ange include=["deleted"] Mjukt borttagna blobar eller ögonblicksbilder kan återställas med hjälp av <xref:azure.storage.blob.aio.BlobClient.undelete>

Det maximala antalet blobar som kan tas bort i en enskild begäran är 256.

delete_container

Markerar den angivna containern för borttagning. Containern och eventuella blobar som finns i den tas senare bort under skräpinsamlingen.

download_blob

Laddar ned en blob till StorageStreamDownloader. Metoden readall() måste användas för att läsa allt innehåll eller readinto() måste användas för att ladda ned bloben till en dataström. Med segment() returneras en asynkron iterator som gör att användaren kan iterera över innehållet i segment.

exists

Returnerar Sant om det finns en container och returnerar False annars.

find_blobs_by_tags

Returnerar en generator för att visa blobarna under den angivna containern vars taggar matchar det angivna sökuttrycket. Generatorn följer lazily fortsättningstoken som returneras av tjänsten.

from_connection_string

Skapa ContainerClient från en anslutningssträng.

from_container_url

Skapa ContainerClient från en container-URL.

get_account_information

Hämtar information om lagringskontot.

Informationen kan också hämtas om användaren har en SAS till en container eller blob. Nycklarna i den returnerade ordlistan innehåller "sku_name" och "account_kind".

get_blob_client

Hämta en klient för att interagera med den angivna bloben.

Bloben behöver inte redan finnas.

get_container_access_policy

Hämtar behörigheterna för den angivna containern. Behörigheterna anger om containerdata kan kommas åt offentligt.

get_container_properties

Returnerar alla användardefinierade metadata och systemegenskaper för den angivna containern. De data som returneras innehåller inte containerns lista över blobar.

list_blob_names

Returnerar en generator för att visa namnen på blobar under den angivna containern. Generatorn följer lazily fortsättningstoken som returneras av tjänsten.

Observera att inga ytterligare egenskaper eller metadata returneras när du använder det här API:et. Det här API:et har inte heller något alternativ för att inkludera ytterligare blobar, till exempel ögonblicksbilder, versioner, mjukt borttagna blobar osv. Om du vill hämta någon av dessa data använder du list_blobs.

list_blobs

Returnerar en generator för att visa blobarna under den angivna containern. Generatorn följer lazily fortsättningstoken som returneras av tjänsten.

set_container_access_policy

Anger behörigheter för den angivna containern eller lagrade åtkomstprinciper som kan användas med signaturer för delad åtkomst. Behörigheterna anger om blobar i en container kan kommas åt offentligt.

set_container_metadata

Anger ett eller flera användardefinierade namn/värde-par för den angivna containern. Varje anrop till den här åtgärden ersätter alla befintliga metadata som är kopplade till containern. Om du vill ta bort alla metadata från containern anropar du den här åtgärden utan metadatadikt.

set_premium_page_blob_tier_blobs

Anger sidblobnivåerna på blobarna. Det här API:et stöds endast för sidblobar på Premium-konton.

Det maximala antalet blobar som kan uppdateras i en enda begäran är 256.

set_standard_blob_tier_blobs

Den här åtgärden anger nivån på blockblobar.

Blockblobens nivå avgör lagringstypen Frekvent/Lågfrekvent/Arkivlagring. Den här åtgärden uppdaterar inte blobens ETag.

Det maximala antalet blobar som kan uppdateras i en enda begäran är 256.

upload_blob

Skapar en ny blob från en datakälla med automatisk segmentering.

walk_blobs

Returnerar en generator för att visa blobarna under den angivna containern. Generatorn följer lazily fortsättningstoken som returneras av tjänsten. Den här åtgärden visar blobar i enlighet med en hierarki, som avgränsas av det angivna avgränsartecknet.

acquire_lease

Begär ett nytt lån. Om containern inte har ett aktivt lån skapar Blob Service ett lån för containern och returnerar ett nytt låne-ID.

async acquire_lease(lease_duration: int = -1, lease_id: str | None = None, **kwargs) -> BlobLeaseClient

Parametrar

lease_duration
int
Obligatorisk

Anger lånets varaktighet, i sekunder eller negativt (-1) för ett lån som aldrig upphör att gälla. Ett icke-oändligt lån kan vara mellan 15 och 60 sekunder. Det går inte att ändra en lånetid med hjälp av förnyelse eller ändring. Standardvärdet är -1 (oändligt lån).

lease_id
str
Obligatorisk

Föreslaget låne-ID i ett GUID-strängformat. Blob-tjänsten returnerar 400 (ogiltig begäran) om det föreslagna låne-ID:t inte har rätt format.

if_modified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen har ändrats sedan den angivna tiden.

if_unmodified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen inte har ändrats sedan det angivna datumet/tiden.

etag
str

Ett ETag-värde eller jokertecknet (*). Används för att kontrollera om resursen har ändrats och agera enligt villkoret som anges av parametern match_condition .

match_condition
MatchConditions

Matchningsvillkoret som ska användas på etag.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

Ett BlobLeaseClient-objekt som kan köras i en kontexthanterare.

Returtyp

close

Den här metoden är att stänga de sockets som öppnas av klienten. Den behöver inte användas när du använder med en kontexthanterare.

async close()

create_container

Skapar en ny container under det angivna kontot. Om containern med samma namn redan finns misslyckas åtgärden.

async create_container(metadata: Dict[str, str] | None = None, public_access: PublicAccess | str | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parametrar

metadata
dict[str, str]
Obligatorisk

En diktering med name_value par som ska associeras med containern som metadata. Exempel:{'Kategori':'test'}

public_access
PublicAccess
Obligatorisk

Möjliga värden är: "container", "blob".

container_encryption_scope
dict eller ContainerEncryptionScope

Anger standardkrypteringsomfånget som ska anges för containern och används för alla framtida skrivningar.

Ny i version 12.2.0.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

En ordlista med svarshuvuden.

Returtyp

delete_blob

Markerar den angivna bloben eller ögonblicksbilden för borttagning.

Bloben tas senare bort under skräpinsamlingen. Observera att om du vill ta bort en blob måste du ta bort alla dess ögonblicksbilder. Du kan ta bort båda samtidigt med åtgärden delete_blob.

Om en kvarhållningsprincip för borttagning är aktiverad för tjänsten tar den här åtgärden mjukt bort bloben eller ögonblicksbilden och behåller bloben eller ögonblicksbilden under angivet antal dagar. Efter angivet antal dagar tas blobens data bort från tjänsten under skräpinsamlingen. Mjukt borttagna blobar eller ögonblicksbilder är tillgängliga genom list_blobs att ange include=["deleted"] Mjuk borttagning av blob eller ögonblicksbild kan återställas med hjälp av <xref:azure.storage.blob.aio.BlobClient.undelete>

async delete_blob(blob: str | BlobProperties, delete_snapshots: str | None = None, **kwargs) -> None

Parametrar

blob
str eller BlobProperties
Obligatorisk

Bloben som du vill interagera med. Om det här värdet anges åsidosätts ett blobvärde som anges i blob-URL:en.

delete_snapshots
str
Obligatorisk

Krävs om bloben har associerade ögonblicksbilder. Exempel på värden:

  • "only": Tar bara bort ögonblicksbilderna av blobar.

  • "include": Tar bort bloben tillsammans med alla ögonblicksbilder.

version_id
str

Parametern för versions-ID är ett täckande DateTime-värde som, när det finns, anger vilken version av bloben som ska tas bort.

Ny i version 12.4.0.

Det här nyckelordsargumentet introducerades i API-versionen "2019-12-12".

lease
BlobLeaseClient eller str

Krävs om bloben har ett aktivt lån. Värdet kan vara ett låneobjekt eller låne-ID:t som en sträng.

if_modified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen har ändrats sedan den angivna tiden.

if_unmodified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen inte har ändrats sedan det angivna datumet/tiden.

etag
str

Ett ETag-värde eller jokertecknet (*). Används för att kontrollera om resursen har ändrats och agera enligt villkoret som anges av parametern match_condition .

match_condition
MatchConditions

Matchningsvillkoret som ska användas på etag.

if_tags_match_condition
str

Ange en SQL where-sats för blobtaggar som endast ska användas på blobar med ett matchande värde. t.ex. "\"tagname\"='my tag'"

Ny i version 12.4.0.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returtyp

delete_blobs

Markerar de angivna blobarna eller ögonblicksbilderna för borttagning.

Blobarna tas senare bort under skräpinsamlingen. Observera att om du vill ta bort blobar måste du ta bort alla deras ögonblicksbilder. Du kan ta bort båda samtidigt med åtgärden delete_blobs.

Om en kvarhållningsprincip för borttagning är aktiverad för tjänsten tar den här åtgärden mjukt bort blobarna eller ögonblicksbilderna och behåller blobarna eller ögonblicksbilderna under angivet antal dagar. Efter angivet antal dagar tas blobarnas data bort från tjänsten under skräpinsamlingen. Mjukt borttagna blobar eller ögonblicksbilder är tillgängliga genom list_blobs att ange include=["deleted"] Mjukt borttagna blobar eller ögonblicksbilder kan återställas med hjälp av <xref:azure.storage.blob.aio.BlobClient.undelete>

Det maximala antalet blobar som kan tas bort i en enskild begäran är 256.

async delete_blobs(*blobs: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> AsyncIterator[AsyncHttpResponse]

Parametrar

blobs
str eller dict(str, Any) eller BlobProperties
Obligatorisk

De blobar som ska tas bort. Det kan vara en enda blob, eller så kan flera värden anges, där varje värde antingen är namnet på bloben (str) eller BlobProperties.

Anteckning

Här är en lista över nycklar och värderegler när blobtypen är diktamen.

blobnamn:

key: 'name', value type: str

ögonblicksbild som du vill ta bort:

key: 'snapshot', value type: str

om du vill ta bort ögonblicksbilder när du tar bort blob:

nyckel: "delete_snapshots", värde: "include" eller "only"

om bloben ändrades eller inte:

key: 'if_modified_since', 'if_unmodified_since', value type: datetime

Etag:

key: 'etag', value type: str

matcha etag eller inte:

key: "match_condition", värdetyp: MatchConditions

taggar matchar villkor:

key: "if_tags_match_condition", värdetyp: str

Leasing:

key: 'lease_id', value type: Union[str, LeaseClient]

Timeout för underbegäran:

key: 'timeout', value type: int

delete_snapshots
str

Krävs om en blob har associerade ögonblicksbilder. Exempel på värden:

  • "only": Tar bara bort ögonblicksbilderna av blobar.

  • "include": Tar bort bloben tillsammans med alla ögonblicksbilder.

if_modified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen har ändrats sedan den angivna tiden.

if_unmodified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen inte har ändrats sedan det angivna datumet/tiden.

if_tags_match_condition
str

Ange en SQL where-sats för blobtaggar som endast ska användas på blobar med ett matchande värde. t.ex. "\"tagname\"='my tag'"

Ny i version 12.4.0.

raise_on_any_failure
bool

Det här är en boolesk param som standard är True. När detta anges utlöses ett undantag även om det uppstår ett enskilt åtgärdsfel. För optimala prestanda ska detta anges till Falskt

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

En asynkron iterator av svar, en för varje blob i ordning

Returtyp

<xref:asynciterator>[AsyncHttpResponse]

delete_container

Markerar den angivna containern för borttagning. Containern och eventuella blobar som finns i den tas senare bort under skräpinsamlingen.

async delete_container(**kwargs: Any) -> None

Parametrar

lease
BlobLeaseClient eller str

Om det anges lyckas delete_container bara om containerns lån är aktivt och matchar detta ID. Krävs om containern har ett aktivt lån.

if_modified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen har ändrats sedan den angivna tiden.

if_unmodified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen inte har ändrats sedan det angivna datumet/tiden.

etag
str

Ett ETag-värde eller jokertecknet (*). Används för att kontrollera om resursen har ändrats och agera enligt villkoret som anges av parametern match_condition .

match_condition
MatchConditions

Matchningsvillkoret som ska användas på etag.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returtyp

download_blob

Laddar ned en blob till StorageStreamDownloader. Metoden readall() måste användas för att läsa allt innehåll eller readinto() måste användas för att ladda ned bloben till en dataström. Med segment() returneras en asynkron iterator som gör att användaren kan iterera över innehållet i segment.

async download_blob(blob: str | BlobProperties, offset: int = None, length: int = None, *, encoding: str, **kwargs) -> StorageStreamDownloader[str]

Parametrar

blob
str eller BlobProperties
Obligatorisk

Den blob som du vill interagera med. Om det här värdet anges åsidosätter det ett blobvärde som anges i blob-URL:en.

offset
int
Obligatorisk

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
Obligatorisk

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

version_id
str

Parametern versions-ID är ett ogenomskinliga DateTime-värde som när det finns anger vilken version av bloben som ska laddas ned.

Nytt i version 12.4.0.

Det här nyckelordsargumentet introducerades i API-versionen "2019-12-12".

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.

lease
BlobLeaseClient eller str

Krävs om bloben har ett aktivt lån. Om det anges lyckas download_blob endast om blobens lån är aktivt och matchar detta ID. Värdet kan vara ett BlobLeaseClient-objekt eller låne-ID:t som en sträng.

if_modified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas in är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen har ändrats sedan den angivna tiden.

if_unmodified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas in är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen inte har ändrats sedan det angivna datumet/tiden.

etag
str

Ett ETag-värde eller jokertecknet (*). Används för att kontrollera om resursen har ändrats och agera enligt villkoret som anges av parametern match_condition .

match_condition
MatchConditions

Matchningsvillkoret som ska användas på etag.

if_tags_match_condition
str

Ange en SQL where-sats för blobtaggar som endast ska användas på blob med ett matchande värde. t.ex. "\"tagname\"='my tag'"

Nytt i version 12.4.0.

cpk
CustomerProvidedEncryptionKey

Krypterar data på tjänstsidan med den angivna nyckeln. Användning av kundspecifika nycklar måste göras via HTTPS. Eftersom själva krypteringsnyckeln anges i begäran måste en säker anslutning upprättas för att överföra nyckeln.

max_concurrency
int

Antalet parallella anslutningar som du kan ladda ned.

encoding
str

Kodning för att avkoda nedladdade byte. Standardvärdet är Ingen, dvs. ingen avkodning.

progress_hook
Callable[[int, int], Awaitable[None]]

Ett asynkront återanrop för att spåra förloppet för en tidskrävande nedladdning. Signaturen är function(current: int, total: int) där aktuellt är antalet byte som överförts hittills, och summan är den totala storleken på nedladdningen.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här. Den här metoden kan göra flera anrop till tjänsten och tidsgränsen gäller för varje anrop individuellt. flera anrop till Azure-tjänsten och tidsgränsen gäller för varje anrop individuellt.

Returer

Ett strömmande objekt. (StorageStreamDownloader)

Returtyp

exists

Returnerar Sant om det finns en container och returnerar False annars.

async exists(**kwargs: Any) -> bool

Parametrar

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

boolean

Returtyp

find_blobs_by_tags

Returnerar en generator för att visa blobarna under den angivna containern vars taggar matchar det angivna sökuttrycket. Generatorn följer lazily fortsättningstoken som returneras av tjänsten.

find_blobs_by_tags(filter_expression: str, **kwargs: Any | None) -> AsyncItemPaged[FilteredBlob]

Parametrar

filter_expression
str
Obligatorisk

Uttrycket för att hitta blobar vars taggar matchar det angivna villkoret. t.ex. ""yourtagname"='firsttag' och "yourtagname2"='secondtag'"

results_per_page
int

Det maximala resultatet per sida vid sidnumrering.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

Ett iterbart svar (automatisk växling) av FilteredBlob.

Returtyp

from_connection_string

Skapa ContainerClient från en anslutningssträng.

from_connection_string(conn_str: str, container_name: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self

Parametrar

conn_str
str
Obligatorisk

En anslutningssträng till ett Azure Storage-konto.

container_name
str
Obligatorisk

Containernamnet för bloben.

credential
standardvärde: None

De autentiseringsuppgifter som ska autentiseras med. Det här är valfritt om konto-URL:en redan har en SAS-token, eller om anslutningssträngen redan har värden för delad åtkomstnyckel. 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. Autentiseringsuppgifterna som anges här har företräde framför dem i anslutningssträngen. Om du använder en instans av AzureNamedKeyCredential ska "namn" vara lagringskontots namn och "nyckel" ska vara lagringskontonyckeln.

Returer

En containerklient.

Returtyp

from_container_url

Skapa ContainerClient från en container-URL.

from_container_url(container_url: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self

Parametrar

container_url
str
Obligatorisk

Den fullständiga slutpunkts-URL:en till containern, inklusive SAS-token om den används. Detta kan vara antingen den primära slutpunkten eller den sekundära slutpunkten beroende på den aktuella location_mode.

credential
standardvärde: None

De autentiseringsuppgifter som ska autentiseras med. Det här är valfritt om konto-URL:en redan har en SAS-token, eller om anslutningssträngen redan har värden för delad åtkomstnyckel. 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.

Returer

En containerklient.

Returtyp

get_account_information

Hämtar information om lagringskontot.

Informationen kan också hämtas om användaren har en SAS till en container eller blob. Nycklarna i den returnerade ordlistan innehåller "sku_name" och "account_kind".

async get_account_information(**kwargs: Any) -> Dict[str, str]

Returer

En dikta av kontoinformation (SKU och kontotyp).

Returtyp

get_blob_client

Hämta en klient för att interagera med den angivna bloben.

Bloben behöver inte redan finnas.

get_blob_client(blob: BlobProperties | str, snapshot: str = None, *, version_id: str | None = None) -> BlobClient

Parametrar

blob
str eller BlobProperties
Obligatorisk

Den blob som du vill interagera med.

snapshot
str
standardvärde: None

Den valfria blobögonblicksbilden som ska användas. Detta kan vara ögonblicksbildens ID-sträng eller svaret som returneras från create_snapshot.

version_id
str

Parametern versions-ID är ett ogenomskinliga DateTime-värde som när det finns anger vilken version av bloben som ska användas.

Returer

En BlobClient.

Returtyp

get_container_access_policy

Hämtar behörigheterna för den angivna containern. Behörigheterna anger om containerdata kan kommas åt offentligt.

async get_container_access_policy(**kwargs: Any) -> Dict[str, Any]

Parametrar

lease
BlobLeaseClient eller str

Om det anges lyckas get_container_access_policy endast om containerns lån är aktivt och matchar detta ID.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

Få åtkomst till principinformation i en diktamen.

Returtyp

get_container_properties

Returnerar alla användardefinierade metadata och systemegenskaper för den angivna containern. De data som returneras innehåller inte containerns lista över blobar.

async get_container_properties(**kwargs: Any) -> ContainerProperties

Parametrar

lease
BlobLeaseClient eller str

Om det anges lyckas get_container_properties bara om containerns lån är aktivt och matchar detta ID.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

Egenskaper för den angivna containern i ett containerobjekt.

Returtyp

list_blob_names

Returnerar en generator för att visa namnen på blobar under den angivna containern. Generatorn följer lazily fortsättningstoken som returneras av tjänsten.

Observera att inga ytterligare egenskaper eller metadata returneras när du använder det här API:et. Det här API:et har inte heller något alternativ för att inkludera ytterligare blobar, till exempel ögonblicksbilder, versioner, mjukt borttagna blobar osv. Om du vill hämta någon av dessa data använder du list_blobs.

list_blob_names(**kwargs: Any) -> AsyncItemPaged[str]

Parametrar

name_starts_with
str

Filtrerar resultatet så att endast blobar vars namn börjar med det angivna prefixet returneras.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

Ett iterabelt svar (automatisk sidindelning) för blobnamn som strängar.

Returtyp

list_blobs

Returnerar en generator för att visa blobarna under den angivna containern. Generatorn följer lazily fortsättningstoken som returneras av tjänsten.

list_blobs(name_starts_with: str | None = None, include: str | List[str] | None = None, **kwargs: Any) -> AsyncItemPaged[BlobProperties]

Parametrar

name_starts_with
str
Obligatorisk

Filtrerar resultatet så att endast blobar vars namn börjar med det angivna prefixet returneras.

include
list[str] eller str
Obligatorisk

Anger en eller flera ytterligare datauppsättningar som ska ingå i svaret. Alternativen är: "snapshots", "metadata", "uncommittedblobs", "copy", "deleted", "deletedwithversions", "tags", "versions", "immutabilitypolicy", "legalhold".

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

Ett iterabelt svar (automatisk sidindelning) för BlobProperties.

Returtyp

set_container_access_policy

Anger behörigheter för den angivna containern eller lagrade åtkomstprinciper som kan användas med signaturer för delad åtkomst. Behörigheterna anger om blobar i en container kan kommas åt offentligt.

async set_container_access_policy(signed_identifiers: Dict[str, AccessPolicy], public_access: str | PublicAccess | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parametrar

signed_identifiers
dict[str, AccessPolicy]
Obligatorisk

En ordlista med åtkomstprinciper som ska associeras med containern. Ordlistan kan innehålla upp till 5 element. En tom ordlista rensar de åtkomstprinciper som angetts för tjänsten.

public_access
PublicAccess
Obligatorisk

Möjliga värden är: "container", "blob".

lease
BlobLeaseClient eller str

Krävs om containern har ett aktivt lån. Värdet kan vara ett BlobLeaseClient-objekt eller låne-ID:t som en sträng.

if_modified_since
datetime

Ett datetime-värde. Azure förväntar sig att det datumvärde som skickas är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen har ändrats sedan det angivna datumet/tiden.

if_unmodified_since
datetime

Ett datetime-värde. Azure förväntar sig att det datumvärde som skickas är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen inte har ändrats sedan det angivna datumet/tiden.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

Containeruppdaterad egenskapsdikt (Etag och senast ändrad).

Returtyp

set_container_metadata

Anger ett eller flera användardefinierade namn/värde-par för den angivna containern. Varje anrop till den här åtgärden ersätter alla befintliga metadata som är kopplade till containern. Om du vill ta bort alla metadata från containern anropar du den här åtgärden utan metadatadikt.

async set_container_metadata(metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]

Parametrar

metadata
dict[str, str]
Obligatorisk

En diktamen som innehåller namn/värde-par som ska associeras med containern som metadata. Exempel: {'category':'test'}

lease
BlobLeaseClient eller str

Om det anges lyckas set_container_metadata endast om containerns lån är aktivt och matchar detta ID.

if_modified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen har ändrats sedan den angivna tiden.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

Containeruppdaterad egenskapsdikt (Etag och senast ändrad).

set_premium_page_blob_tier_blobs

Anger sidblobnivåerna på blobarna. Det här API:et stöds endast för sidblobar på Premium-konton.

Det maximala antalet blobar som kan uppdateras i en enda begäran är 256.

async set_premium_page_blob_tier_blobs(premium_page_blob_tier: str | PremiumPageBlobTier, *blobs: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> AsyncIterator[AsyncHttpResponse]

Parametrar

premium_page_blob_tier
PremiumPageBlobTier
Obligatorisk

Ett sidblobnivåvärde som ska anges för alla blobar till. Nivån korrelerar med storleken på bloben och antalet tillåtna IOPS. Detta gäller endast sidblobar på Premium Storage-konton.

Anteckning

Om du vill ange en annan nivå för olika blobar anger du den här positionsparametern till Ingen.

Sedan tas blobnivån på varje BlobProperties.

blobs
str eller dict(str, Any) eller BlobProperties
Obligatorisk

De blobar som du vill interagera med. Det kan vara en enda blob, eller så kan flera värden anges, där varje värde antingen är namnet på bloben (str) eller BlobProperties.

Anteckning

Här är en lista över nycklar och värderegler när blobtypen är diktamen.

blobnamn:

key: 'name', value type: str

premiumblobnivå:

key: "blob_tier", värdetyp: PremiumPageBlobTier

Leasing:

key: 'lease_id', value type: Union[str, LeaseClient]

Timeout för underbegäran:

key: 'timeout', value type: int

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

raise_on_any_failure
bool

Det här är en boolesk param som standard är True. När detta anges utlöses ett undantag även om det uppstår ett enskilt åtgärdsfel. För optimala prestanda bör detta anges till Falskt.

Returer

En asynkron iterator av svar, en för varje blob i ordning

Returtyp

<xref:asynciterator>[AsyncHttpResponse]

set_standard_blob_tier_blobs

Den här åtgärden anger nivån på blockblobar.

Blockblobens nivå avgör lagringstypen Frekvent/Lågfrekvent/Arkivlagring. Den här åtgärden uppdaterar inte blobens ETag.

Det maximala antalet blobar som kan uppdateras i en enda begäran är 256.

async set_standard_blob_tier_blobs(standard_blob_tier: str | StandardBlobTier, *blobs: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> AsyncIterator[AsyncHttpResponse]

Parametrar

standard_blob_tier
str eller StandardBlobTier
Obligatorisk

Anger vilken nivå som ska anges för alla blobar. Alternativen är "Hot", "Cool", "Archive". Frekvent nivå är optimerad för lagring av data som används ofta. Lågfrekvent lagringsnivå är optimerad för lagring av data som inte används sällan och som lagras i minst en månad. Arkivnivån är optimerad för lagring av data som sällan används och lagras i minst sex månader med flexibla svarstider.

Anteckning

Om du vill ange en annan nivå på olika blobar anger du den här positionsparametern till Ingen.

Sedan tas blobnivån på varje BlobProperties.

blobs
str eller dict(str, Any) eller BlobProperties
Obligatorisk

De blobar som du vill interagera med. Detta kan vara en enda blob, eller så kan flera värden anges, där varje värde antingen är namnet på bloben (str) eller BlobProperties.

Anteckning

När blobtypen är diktamen finns här en lista över nycklar, värderegler.

blobnamn:

key: 'name', value type: str

standardblobnivå:

nyckel: "blob_tier", värdetyp: StandardBlobTier

rehydrera prioritet:

nyckel: "rehydrate_priority", värdetyp: RehydratePriority

Leasing:

nyckel: "lease_id", värdetyp: Union[str, LeaseClient]

taggar matchar villkor:

nyckel: "if_tags_match_condition", värdetyp: str

timeout för underbegäran:

nyckel: "timeout", värdetyp: int

rehydrate_priority
RehydratePriority

Anger med vilken prioritet en arkiverad blob ska extraheras

if_tags_match_condition
str

Ange en SQL where-sats för blobtaggar som endast ska användas på blob med ett matchande värde. t.ex. "\"tagname\"='my tag'"

Nytt i version 12.4.0.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

raise_on_any_failure
bool

Det här är en boolesk param som standard är True. När detta anges utlöses ett undantag även om det uppstår ett enskilt åtgärdsfel. För optimala prestanda bör detta anges till Falskt.

Returer

En asynkron iterator av svar, en för varje blob i ordning

Returtyp

<xref:asynciterator>[AsyncHttpResponse]

upload_blob

Skapar en ny blob från en datakälla med automatisk segmentering.

async upload_blob(name: str | BlobProperties, data: bytes | str | Iterable | AsyncIterable | IO, blob_type: str | BlobType = BlobType.BLOCKBLOB, length: int | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> BlobClient

Parametrar

name
str eller BlobProperties
Obligatorisk

Den blob som du vill interagera med. Om det här värdet anges åsidosätter det ett blobvärde som anges i blob-URL:en.

data
Obligatorisk

De blobdata som ska laddas upp.

blob_type
BlobType
Obligatorisk

Typen av blob. Detta kan vara antingen BlockBlob, PageBlob eller AppendBlob. Standardvärdet är BlockBlob.

length
int
Obligatorisk

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

metadata
dict(str, str)
Obligatorisk

Namn/värde-par som är associerade med bloben som metadata.

overwrite
bool

Om den blob som ska laddas upp ska skriva över aktuella data. Om det är sant skriver upload_blob över befintliga data. Om värdet är Falskt misslyckas åtgärden med ResourceExistsError. Undantaget till ovanstående är med tilläggsblobtyper: om det är inställt på Falskt och data redan finns utlöses inget fel och data läggs till i den befintliga bloben. Om du anger overwrite=True tas den befintliga tilläggsbloben bort och en ny skapas. Standardvärdet är Falskt.

content_settings
ContentSettings

ContentSettings-objekt som används för att ange blobegenskaper. Används för att ange innehållstyp, kodning, språk, disposition, md5 och cachekontroll.

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.

lease
BlobLeaseClient eller str

Krävs om containern har ett aktivt lån. Värdet kan vara ett BlobLeaseClient-objekt eller låne-ID:t som en sträng.

if_modified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas in är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen har ändrats sedan den angivna tiden.

if_unmodified_since
datetime

Ett DateTime-värde. Azure förväntar sig att det datumvärde som skickas in är UTC. Om tidszonen ingår konverteras alla icke-UTC-datetimes till UTC. Om ett datum skickas utan tidszonsinformation antas det vara UTC. Ange det här huvudet för att utföra åtgärden endast om resursen inte har ändrats sedan det angivna datumet/tiden.

etag
str

Ett ETag-värde eller jokertecknet (*). Används för att kontrollera om resursen har ändrats och agera enligt villkoret som anges av parametern match_condition .

match_condition
MatchConditions

Matchningsvillkoret som ska användas på etag.

if_tags_match_condition
str

Ange en SQL where-sats för blobtaggar som endast ska användas på blob med ett matchande värde. t.ex. "\"tagname\"='my tag'"

Nytt i version 12.4.0.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här. Den här metoden kan göra flera anrop till tjänsten och tidsgränsen gäller för varje anrop individuellt. flera anrop till Azure-tjänsten och tidsgränsen gäller för varje anrop individuellt.

premium_page_blob_tier
PremiumPageBlobTier

Ett sidblobnivåvärde som bloben ska anges till. Nivån korrelerar med storleken på bloben och antalet tillåtna IOPS. Detta gäller endast sidblobar på Premium Storage-konton.

standard_blob_tier
StandardBlobTier

Ett standardvärde för blobnivå som bloben ska anges till. För den här versionen av biblioteket gäller detta endast för blockblobar på standardlagringskonton.

maxsize_condition
int

Valfritt villkorsstyrt huvud. Den maximala längden i byte som tillåts för tilläggsbloben. Om åtgärden Lägg till block skulle göra att bloben överskrider den gränsen eller om blobstorleken redan är större än det värde som anges i det här huvudet misslyckas begäran med Felet MaxBlobSizeConditionNotMet (HTTP-statuskod 412 – Villkoret misslyckades).

max_concurrency
int

Maximalt antal parallella anslutningar som ska användas när blobstorleken överskrider 64 MB.

cpk
CustomerProvidedEncryptionKey

Krypterar data på tjänstsidan med den angivna nyckeln. Användning av kundspecifika nycklar måste göras via HTTPS. Eftersom själva krypteringsnyckeln anges i begäran måste en säker anslutning upprättas för att överföra nyckeln.

encryption_scope
str

Ett fördefinierat krypteringsomfång som används för att kryptera data i tjänsten. Ett krypteringsomfång kan skapas med hjälp av hanterings-API:et och refereras här efter namn. Om ett standardkrypteringsomfång har definierats i containern åsidosätter det här värdet det om omfånget på containernivå har konfigurerats för att tillåta åsidosättningar. Annars utlöses ett fel.

Ny i version 12.2.0.

encoding
str

Standardvärdet ÄR UTF-8.

progress_hook
Callable[[int, Optional[int]], Awaitable[None]]

Ett asynkront återanrop för att spåra förloppet för en tidskrävande uppladdning. Signaturen är function(current: int, total: Optional[int]) där aktuellt är antalet byte som har överförts hittills, och summan är storleken på bloben eller Ingen om storleken är okänd.

Returer

En BlobClient för att interagera med den nyligen uppladdade bloben.

Returtyp

walk_blobs

Returnerar en generator för att visa blobarna under den angivna containern. Generatorn följer lazily fortsättningstoken som returneras av tjänsten. Den här åtgärden visar blobar i enlighet med en hierarki, som avgränsas av det angivna avgränsartecknet.

walk_blobs(name_starts_with: str | None = None, include: str | List[str] | None = None, delimiter: str = '/', **kwargs: Any | None) -> AsyncItemPaged[BlobProperties]

Parametrar

name_starts_with
str
Obligatorisk

Filtrerar resultatet så att endast blobar vars namn börjar med det angivna prefixet returneras.

include
list[str] eller str
Obligatorisk

Anger en eller flera ytterligare datauppsättningar som ska ingå i svaret. Alternativen är: "snapshots", "metadata", "uncommittedblobs", "copy", "deleted", "deletedwithversions", "tags", "versions", "immutabilitypolicy", "legalhold".

delimiter
str
Obligatorisk

När begäran innehåller den här parametern returnerar åtgärden ett BlobPrefix-element i svarstexten som fungerar som platshållare för alla blobar vars namn börjar med samma delsträng upp till avgränsarens utseende. Avgränsaren kan vara ett enskilt tecken eller en sträng.

timeout
int

Anger tidsgränsen på serversidan för åtgärden i sekunder. Mer information finns i: https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. Det här värdet spåras eller verifieras inte på klienten. Information om hur du konfigurerar tidsgränser för nätverk på klientsidan finns här.

Returer

Ett iterabelt svar (automatisk växling) för BlobProperties.

Returtyp

Attribut

api_version

Den version av Storage-API:et som används för begäranden.

location_mode

Det platsläge som klienten använder för närvarande.

Som standard är detta "primärt". Alternativen är "primär" och "sekundär".

primary_endpoint

Den fullständiga primära slutpunkts-URL:en.

primary_hostname

Värdnamnet för den primära slutpunkten.

secondary_endpoint

Den fullständiga sekundära slutpunkts-URL:en om den har konfigurerats.

Om den inte är tillgänglig utlöses en ValueError. Om du uttryckligen vill ange ett sekundärt värdnamn använder du det valfria nyckelordsargumentet secondary_hostname vid instansiering.

Undantag

secondary_hostname

Värdnamnet för den sekundära slutpunkten.

Om det inte är tillgängligt blir detta Ingen. Om du uttryckligen vill ange ett sekundärt värdnamn använder du det valfria nyckelordsargumentet secondary_hostname vid instansiering.

url

Den fullständiga slutpunkts-URL:en till den här entiteten, inklusive SAS-token om den används.

Detta kan vara antingen den primära slutpunkten eller den sekundära slutpunkten beroende på aktuell location_mode. :returns: Den fullständiga slutpunkts-URL:en till den här entiteten, inklusive SAS-token om den används. :rtype: str