Delen via


BlobClient Klas

Een client voor interactie met een specifieke blob, hoewel die blob mogelijk nog niet bestaat.

Klik hier voor meer optionele configuratie.

Overname
azure.storage.blob._shared.base_client.StorageAccountHostsMixin
BlobClient
azure.storage.blob._encryption.StorageEncryptionMixin
BlobClient

Constructor

BlobClient(account_url: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any)

Parameters

account_url
str
Vereist

De URI naar het opslagaccount. Als u een client wilt maken op basis van de volledige URI voor de blob, gebruikt u de from_blob_url klassemethode.

container_name
str
Vereist

De containernaam voor de blob.

blob_name
str
Vereist

De naam van de blob waarmee u wilt communiceren. Indien opgegeven, overschrijft deze waarde een blobwaarde die is opgegeven in de blob-URL.

snapshot
str
standaardwaarde: None

De optionele blob-momentopname waarop moet worden uitgevoerd. Dit kan de tekenreeks van de momentopname-id zijn of het antwoord dat wordt geretourneerd door create_snapshot.

credential
standaardwaarde: None

De referenties waarmee moet worden geverifieerd. Dit is optioneel als de account-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 een 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 'naam' de naam van het opslagaccount zijn en moet 'sleutel' de sleutel van het opslagaccount zijn.
api_version
str

De storage-API-versie die moet worden gebruikt voor aanvragen. De standaardwaarde is de meest recente serviceversie die compatibel is met de huidige SDK. Instellen op een oudere versie kan leiden tot verminderde compatibiliteit van functies.

Nieuw in versie 12.2.0.

secondary_hostname
str

De hostnaam van het secundaire eindpunt.

max_block_size
int

De maximale segmentgrootte voor het uploaden van een blok-blob in segmenten. De standaardwaarde is 4*1024*1024 of 4 MB.

max_single_put_size
int

Als de blobgrootte kleiner is dan of gelijk is aan max_single_put_size, wordt de blob geüpload met slechts één HTTP PUT-aanvraag. Als de blob groter is dan max_single_put_size, wordt de blob geüpload in segmenten. De standaardwaarde is 64*1024*1024 of 64 MB.

min_large_block_upload_threshold
int

De minimale segmentgrootte die is vereist om het geheugenefficiënte algoritme te gebruiken bij het uploaden van een blok-blob. De standaardwaarde is 4*1024*1024+1.

use_byte_buffer
bool

Gebruik een bytebuffer voor blok-blobuploads. Standaard ingesteld op False.

max_page_size
int

De maximale segmentgrootte voor het uploaden van een pagina-blob. De standaardwaarde is 4*1024*1024 of 4 MB.

max_single_get_size
int

De maximale grootte voor een blob die in één aanroep moet worden gedownload. Het overschreden deel wordt in segmenten gedownload (kan parallel zijn). De standaardwaarde is 32*1024*1024 of 32 MB.

max_chunk_get_size
int

De maximale segmentgrootte die wordt gebruikt voor het downloaden van een blob. De standaardwaarde is 4*1024*1024 of 4 MB.

version_id
str

De parameter versie-id is een ondoorzichtige DateTime-waarde die, indien aanwezig, aangeeft welke versie van de blob moet worden uitgevoerd.

Methoden

abort_copy

Een lopende kopieerbewerking afbreken.

Hierdoor blijft een doel-blob over met nul lengte en volledige metagegevens. Er treedt een fout op als de kopieerbewerking al is beëindigd.

acquire_lease

Vraagt een nieuwe lease aan.

Als de blob geen actieve lease heeft, maakt de Blob-service een lease op de blob en retourneert een nieuwe lease.

append_block

Hiermee wordt een nieuw gegevensblok doorgevoerd aan het einde van de bestaande toevoeg-blob.

append_block_from_url

Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob, waarbij de inhoud wordt gelezen uit een bron-URL.

clear_page

Wist een reeks pagina's.

close

Deze methode is het sluiten van de sockets die door de client zijn geopend. Deze hoeft niet te worden gebruikt bij gebruik met een contextbeheerder.

commit_block_list

Met de bewerking Lijst met blokkeringen doorvoeren wordt een blob geschreven door de lijst met blok-id's waaruit de blob bestaat op te geven.

create_append_blob

Hiermee maakt u een nieuwe toevoeg-blob. Met deze bewerking maakt u een nieuwe toevoeg-blob met lengte 0. De inhoud van een bestaande blob wordt overschreven met de zojuist geïnitialiseerde toevoeg-blob. Als u inhoud wilt toevoegen aan de toevoeg-blob, roept u de append_block methode of append_block_from_url aan.

create_page_blob

Hiermee maakt u een nieuwe pagina-blob met de opgegeven grootte.

create_snapshot

Hiermee maakt u een momentopname van de blob.

Een momentopname is een alleen-lezen versie van een blob die op een bepaald moment is gemaakt. Deze kan worden gelezen, gekopieerd of verwijderd, maar niet worden gewijzigd. Momentopnamen bieden een manier om een back-up te maken van een blob zoals deze op een moment in de tijd wordt weergegeven.

Een momentopname van een blob heeft dezelfde naam als de basis-blob van waaruit de momentopname wordt gemaakt, waarbij een DateTime-waarde wordt toegevoegd om aan te geven op welk tijdstip de momentopname is gemaakt.

delete_blob

Hiermee wordt de opgegeven blob gemarkeerd voor verwijdering.

De blob wordt later verwijderd tijdens de garbagecollection. Als u een blob wilt verwijderen, moet u alle momentopnamen verwijderen. U kunt beide tegelijk verwijderen met de bewerking delete_blob().

Als een bewaarbeleid voor verwijderen is ingeschakeld voor de service, wordt met deze bewerking de blob voorlopig verwijderd en wordt de blob gedurende een opgegeven aantal dagen bewaard. Na het opgegeven aantal dagen worden de gegevens van de blob verwijderd uit de service tijdens de garbagecollection. Voorlopig verwijderde blob is toegankelijk via list_blobs de optie include=['deleted']. Voorlopig verwijderde blob kan worden hersteld met behulp van een <xref:azure.storage.blob.undelete> bewerking.

delete_immutability_policy

Met de bewerking Onveranderbaarheidsbeleid verwijderen wordt het onveranderbaarheidsbeleid op de blob verwijderd.

Nieuw in versie 12.10.0: deze bewerking is geïntroduceerd in API-versie '2020-10-02'.

download_blob

Hiermee downloadt u een blob naar de StorageStreamDownloader. De methode readall() moet worden gebruikt om alle inhoud te lezen of readinto() moet worden gebruikt om de blob in een stream te downloaden. Het gebruik van chunks() retourneert een iterator waarmee de gebruiker de inhoud in segmenten kan herhalen.

exists

Retourneert True als er een blob bestaat met de gedefinieerde parameters en retourneert anders False.

from_blob_url

BlobClient maken op basis van een blob-URL. Dit biedt geen ondersteuning voor aangepaste blob-URL met /in blobnaam.

from_connection_string

BlobClient maken op basis van een verbindingsreeks.

get_account_information

Hiermee haalt u informatie op met betrekking tot het opslagaccount waarin de blob zich bevindt.

De informatie kan ook worden opgehaald als de gebruiker een SAS voor een container of blob heeft. De sleutels in de geretourneerde woordenlijst bevatten 'sku_name' en 'account_kind'.

get_blob_properties

Retourneert alle door de gebruiker gedefinieerde metagegevens, standaard-HTTP-eigenschappen en systeemeigenschappen voor de blob. De inhoud van de blob wordt niet geretourneerd.

get_blob_tags

Met de bewerking Tags ophalen kunnen gebruikers tags ophalen op een blob of een specifieke blobversie of momentopname.

Nieuw in versie 12.4.0: deze bewerking is geïntroduceerd in API-versie '2019-12-12'.

get_block_list

Met de bewerking Blokkeringslijst ophalen wordt de lijst met blokken opgehaald die zijn geüpload als onderdeel van een blok-blob.

get_page_range_diff_for_managed_disk

Retourneert de lijst met geldige paginabereiken voor een beheerde schijf of momentopname.

Notitie

Deze bewerking is alleen beschikbaar voor beheerde schijfaccounts.

Nieuw in versie 12.2.0: deze bewerking is geïntroduceerd in API-versie '2019-07-07'.

get_page_ranges

AFGESCHAFT: retourneert de lijst met geldige paginabereiken voor een pagina-blob of momentopname van een pagina-blob.

list_page_ranges

Retourneert de lijst met geldige paginabereiken voor een pagina-blob of momentopname van een pagina-blob. Als previous_snapshot is opgegeven, is het resultaat een verschil van wijzigingen tussen de doel-blob en de vorige momentopname.

query_blob

Hiermee kunnen gebruikers blob-/of blobmomentopnamegegevens selecteren/projecteren door eenvoudige query-expressies op te geven. Deze bewerking retourneert een BlobQueryReader. Gebruikers moeten readall() of readinto() gebruiken om querygegevens op te halen.

resize_blob

Hiermee wijzigt u de grootte van een pagina-blob in de opgegeven grootte.

Als de opgegeven waarde kleiner is dan de huidige grootte van de blob, worden alle pagina's boven de opgegeven waarde gewist.

seal_append_blob

De bewerking Seal verzegelt de toevoeg-blob zodat deze alleen-lezen is.

Nieuw in versie 12.4.0.

set_blob_metadata

Hiermee stelt u door de gebruiker gedefinieerde metagegevens voor de blob in als een of meer naam-waardeparen.

set_blob_tags

Met de bewerking Tags instellen kunnen gebruikers tags instellen op een blob of een specifieke blobversie, maar geen momentopname. Elke aanroep van deze bewerking vervangt alle bestaande tags die aan de blob zijn gekoppeld. Als u alle tags uit de blob wilt verwijderen, roept u deze bewerking aan zonder tags in te stellen.

Nieuw in versie 12.4.0: deze bewerking is geïntroduceerd in API-versie '2019-12-12'.

set_http_headers

Hiermee stelt u systeemeigenschappen voor de blob in.

Als er één eigenschap is ingesteld voor de content_settings, worden alle eigenschappen overschreven.

set_immutability_policy

Met de bewerking Onveranderbaarheidsbeleid instellen wordt het onveranderbaarheidsbeleid ingesteld op de blob.

Nieuw in versie 12.10.0: Deze bewerking is geïntroduceerd in API-versie '2020-10-02'.

set_legal_hold

Met de bewerking Juridische bewaring instellen wordt een juridische bewaring ingesteld voor de blob.

Nieuw in versie 12.10.0: deze bewerking is geïntroduceerd in API-versie '2020-10-02'.

set_premium_page_blob_tier

Hiermee stelt u de pagina-bloblagen op de blob in. Deze API wordt alleen ondersteund voor pagina-blobs op Premium-accounts.

set_sequence_number

Hiermee stelt u het volgnummer van de blob in.

set_standard_blob_tier

Met deze bewerking stelt u de laag in op een blok-blob.

De laag van een blok-blob bepaalt het opslagtype Dynamisch/Statisch/Archief. Met deze bewerking wordt de ETag van de blob niet bijgewerkt.

stage_block

Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob.

stage_block_from_url

Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob waarin de inhoud van een URL wordt gelezen.

start_copy_from_url

Kopieert een blob van de opgegeven URL.

Deze bewerking retourneert een woordenlijst met copy_status en copy_id, die kan worden gebruikt om de status van de kopieerbewerking te controleren of af te breken. copy_status is 'geslaagd' als de kopie synchroon is voltooid of 'in behandeling' als de kopie asynchroon is gestart. Voor asynchrone kopieën kan de status worden gecontroleerd door de get_blob_properties methode te pollen en de kopieerstatus te controleren. Stel requires_sync in op True om af te dwingen dat de kopie synchroon is. De Blob-service kopieert blobs op basis van best-effort.

De bron-blob voor een kopieerbewerking kan een blok-blob, een toevoeg-blob of een pagina-blob zijn. Als de doel-blob al bestaat, moet deze van hetzelfde blobtype zijn als de bron-blob. Elke bestaande doel-blob wordt overschreven. De doel-blob kan niet worden gewijzigd terwijl er een kopieerbewerking wordt uitgevoerd.

Wanneer u kopieert vanuit een pagina-blob, maakt de Blob-service een doelpagina-blob met de lengte van de bron-blob, die in eerste instantie alle nullen bevat. Vervolgens worden de bronpaginabereiken opgesomd en worden niet-lege bereiken gekopieerd.

Voor een blok- of toevoeg-blob maakt de Blob-service een toegewezen blob met de lengte nul voordat deze bewerking wordt geretourneerd. Wanneer u kopieert vanuit een blok-blob, worden alle vastgelegde blokken en de bijbehorende blok-id's gekopieerd. Niet-doorgevoerde blokken worden niet gekopieerd. Aan het einde van de kopieerbewerking heeft de doel-blob hetzelfde aantal vastgelegde blokken als de bron.

Bij het kopiëren vanuit een toevoeg-blob worden alle vastgelegde blokken gekopieerd. Aan het einde van de kopieerbewerking heeft de doel-blob hetzelfde aantal vastgelegde blokken als de bron.

undelete_blob

Herstelt voorlopig verwijderde blobs of momentopnamen.

De bewerking is alleen geslaagd als deze wordt gebruikt binnen het opgegeven aantal dagen dat is ingesteld in het bewaarbeleid voor verwijderen.

Als blobversiebeheer is ingeschakeld, kan de basis-blob niet worden hersteld met deze methode. Gebruik start_copy_from_url in plaats daarvan met de URL van de blobversie die u wilt promoveren naar de huidige versie.

upload_blob

Hiermee maakt u een nieuwe blob op basis van een gegevensbron met automatische segmentering.

upload_blob_from_url

Hiermee maakt u een nieuwe blok-blob waarin de inhoud van de blob wordt gelezen vanaf een bepaalde URL. De inhoud van een bestaande blob wordt overschreven met de nieuwe blob.

upload_page

Met de bewerking Pagina's uploaden wordt een reeks pagina's naar een pagina-blob geschreven.

upload_pages_from_url

Met de bewerking Pagina's uploaden wordt een reeks pagina's naar een pagina-blob geschreven waar de inhoud wordt gelezen vanuit een URL.

abort_copy

Een lopende kopieerbewerking afbreken.

Hierdoor blijft een doel-blob over met nul lengte en volledige metagegevens. Er treedt een fout op als de kopieerbewerking al is beëindigd.

abort_copy(copy_id: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> None

Parameters

copy_id
str of BlobProperties
Vereist

De kopieerbewerking die moet worden afgebroken. Dit kan een id-tekenreeks of een exemplaar van BlobProperties zijn.

Retourtype

acquire_lease

Vraagt een nieuwe lease aan.

Als de blob geen actieve lease heeft, maakt de Blob-service een lease op de blob en retourneert een nieuwe lease.

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

Parameters

lease_duration
int
Vereist

Hiermee geeft u de duur van de lease op, in seconden, of negatief (-1) voor een lease die nooit verloopt. Een niet-oneindige lease kan tussen 15 en 60 seconden duren. Een leaseduur kan niet worden gewijzigd met behulp van vernieuwen of wijzigen. De standaardwaarde is -1 (oneindige lease).

lease_id
str
Vereist

Voorgestelde lease-id, in een GUID-tekenreeksindeling. De Blob-service retourneert 400 (ongeldige aanvraag) als de voorgestelde lease-id niet de juiste indeling heeft.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Een BlobLeaseClient-object.

Retourtype

append_block

Hiermee wordt een nieuw gegevensblok doorgevoerd aan het einde van de bestaande toevoeg-blob.

append_block(data: bytes | str | Iterable[AnyStr] | IO[AnyStr], length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]

Parameters

data
bytes of str of Iterable
Vereist

Inhoud van het blok. Dit kunnen bytes, tekst, een itereerbaar of een bestand-achtig object zijn.

length
int
Vereist

Grootte van het blok in bytes.

validate_content
bool

Als dit waar is, wordt een MD5-hash van de blokinhoud berekend. De opslagservice controleert de hash van de inhoud die is aangekomen met de hash die is verzonden. Dit is vooral nuttig 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.

maxsize_condition
int

Optionele voorwaardelijke header. De maximale lengte in bytes die is toegestaan voor de toevoeg-blob. Als de bewerking Toevoegblok ervoor zorgt dat de blob deze limiet overschrijdt of als de blobgrootte al groter is dan de waarde die in deze header is opgegeven, mislukt de aanvraag met de fout MaxBlobSizeConditionNotMet (HTTP-statuscode 412 - Voorwaarde is mislukt).

appendpos_condition
int

Optionele voorwaardelijke header, die alleen wordt gebruikt voor de bewerking Toevoegblok. Een getal dat de byte offset aangeeft die moet worden vergeleken. Toevoegblok slaagt alleen als de toevoegpositie gelijk is aan dit getal. Als dat niet zo is, mislukt de aanvraag met de fout AppendPositionConditionNotMet (HTTP-statuscode 412 - Voorwaarde mislukt).

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

encoding
str

De standaardinstelling is UTF-8.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.

Nieuw in versie 12.2.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Blob bijgewerkt eigenschapsdict (Etag, laatst gewijzigd, offset toevoegen, toegewezen aantal blokken).

Retourtype

append_block_from_url

Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob, waarbij de inhoud wordt gelezen uit een bron-URL.

append_block_from_url(copy_source_url: str, source_offset: int | None = None, source_length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]

Parameters

copy_source_url
str
Vereist

De URL van de brongegevens. Deze kan verwijzen naar een Azure-blob of -bestand dat openbaar is of waaraan een handtekening voor gedeelde toegang is gekoppeld.

source_offset
int
Vereist

Dit geeft het begin aan van het bereik van bytes (inclusief) dat moet worden genomen uit de kopieerbron.

source_length
int
Vereist

Dit geeft het einde aan van het bereik van bytes dat moet worden genomen uit de kopieerbron.

source_content_md5
bytearray

Als dit wordt opgegeven, berekent de service de MD5-hash van de blokinhoud en vergelijkt deze met deze waarde.

maxsize_condition
int

Optionele voorwaardelijke header. De maximale lengte in bytes die is toegestaan voor de toevoeg-blob. Als de bewerking Append Block ervoor zorgt dat de blob deze limiet overschrijdt of als de blobgrootte al groter is dan de waarde die in deze header is opgegeven, mislukt de aanvraag met de fout MaxBlobSizeConditionNotMet (HTTP-statuscode 412 - Voorwaarde is mislukt).

appendpos_condition
int

Optionele voorwaardelijke header, die alleen wordt gebruikt voor de bewerking Toevoegblok. Een getal dat de byte offset aangeeft die moet worden vergeleken. Toevoegblok slaagt alleen als de toevoegpositie gelijk is aan dit getal. Als dat niet zo is, mislukt de aanvraag met de fout AppendPositionConditionNotMet (HTTP-statuscode 412 - Voorwaarde mislukt).

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

De waarde van de doel-ETag of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De doelovereenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

source_if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de bronresource is gewijzigd sinds de opgegeven tijd.

source_if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de bronresource niet is gewijzigd sinds de opgegeven datum/tijd.

source_etag
str

De bron-ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

source_match_condition
MatchConditions

De bronovereenkomstvoorwaarde die moet worden gebruikt voor de etag.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.

Nieuw in versie 12.2.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

source_authorization
str

Verifiëren als een service-principal met behulp van een clientgeheim voor toegang tot een bron-blob. Zorg ervoor dat bearer het voorvoegsel is van de source_authorization tekenreeks.

clear_page

Wist een reeks pagina's.

clear_page(offset: int, length: int, **kwargs: Any) -> Dict[str, str | datetime]

Parameters

offset
int
Vereist

Begin van bytebereik dat moet worden gebruikt voor het schrijven naar een sectie van de blob. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de begin offset moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

length
int
Vereist

Het aantal bytes dat moet worden gebruikt om naar een sectie van de blob te schrijven. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de begin offset moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_sequence_number_lte
int

Als het volgnummer van de blob kleiner is dan of gelijk is aan de opgegeven waarde, gaat de aanvraag door; anders mislukt het.

if_sequence_number_lt
int

Als het volgnummer van de blob kleiner is dan de opgegeven waarde, gaat de aanvraag door; anders mislukt het.

if_sequence_number_eq
int

Als het volgnummer van de blob gelijk is aan de opgegeven waarde, gaat de aanvraag door; anders mislukt het.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).

Retourtype

close

Deze methode is het sluiten van de sockets die door de client zijn geopend. Deze hoeft niet te worden gebruikt bij gebruik met een contextbeheerder.

close()

commit_block_list

Met de bewerking Lijst met blokkeringen doorvoeren wordt een blob geschreven door de lijst met blok-id's waaruit de blob bestaat op te geven.

commit_block_list(block_list: List[BlobBlock], content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]

Parameters

block_list
list
Vereist

Lijst met blockblobs.

content_settings
ContentSettings
Vereist

ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen. Wordt gebruikt voor het instellen van inhoudstype, codering, taal, verwijdering, md5 en cachebeheer.

metadata
dict[str, str]
Vereist

Naam-waardeparen die als metagegevens aan de blob zijn gekoppeld.

tags
dict(str, str)

Naam-waardeparen die zijn gekoppeld aan de blob als tag. Tags zijn hoofdlettergevoelig. De tagset kan maximaal 10 tags bevatten. Tagsleutels moeten tussen 1 en 128 tekens zijn en tagwaarden moeten tussen 0 en 256 tekens zijn. Geldige tagsleutel en waardetekens zijn: kleine letters en hoofdletters, cijfers (0-9), spatie ( >><<), plusteken (+), minteken (-), punt (.), solidus (/), dubbele punt (:), is gelijk aan (=), onderstrepingsteken (_)

Nieuw in versie 12.4.0.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

immutability_policy
ImmutabilityPolicy

Hiermee geeft u het beleid voor onveranderbaarheid van een blob, blob-momentopname of blobversie op.

Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie 2020-10-02.

legal_hold
bool

Opgegeven als een juridische bewaring moet worden ingesteld voor de blob.

Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie 2020-10-02.

validate_content
bool

Als dit waar is, wordt een MD5-hash van de pagina-inhoud berekend. 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 kabel 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.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op de doel-blob met een overeenkomende waarde.

Nieuw in versie 12.4.0.

standard_blob_tier
StandardBlobTier

Een standaard-bloblaagwaarde om de blob op in te stellen. Voor deze versie van de bibliotheek is dit alleen van toepassing op blok-blobs in standaardopslagaccounts.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.

Nieuw in versie 12.2.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).

Retourtype

create_append_blob

Hiermee maakt u een nieuwe toevoeg-blob. Met deze bewerking maakt u een nieuwe toevoeg-blob met lengte 0. De inhoud van een bestaande blob wordt overschreven met de zojuist geïnitialiseerde toevoeg-blob. Als u inhoud wilt toevoegen aan de toevoeg-blob, roept u de append_block methode of append_block_from_url aan.

create_append_blob(content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parameters

content_settings
ContentSettings
Vereist

ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen. Wordt gebruikt voor het instellen van inhoudstype, codering, taal, verwijdering, md5 en cachebeheer.

metadata
dict(str, str)
Vereist

Naam-waardeparen die als metagegevens aan de blob zijn gekoppeld.

tags
dict(str, str)

Naam-waardeparen die zijn gekoppeld aan de blob als tag. Tags zijn hoofdlettergevoelig. De tagset kan maximaal 10 tags bevatten. Tagsleutels moeten tussen 1 en 128 tekens zijn en tagwaarden moeten tussen 0 en 256 tekens zijn. Geldige tagsleutel en waardetekens zijn: kleine letters en hoofdletters, cijfers (0-9), spatie ( >><<), plusteken (+), minteken (-), punt (.), solidus (/), dubbele punt (:), is gelijk aan (=), onderstrepingsteken (_)

Nieuw in versie 12.4.0.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

immutability_policy
ImmutabilityPolicy

Hiermee geeft u het beleid voor onveranderbaarheid van een blob, blob-momentopname of blobversie op.

Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie 2020-10-02.

legal_hold
bool

Opgegeven als een juridische bewaring moet worden ingesteld voor de blob.

Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie 2020-10-02.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.

Nieuw in versie 12.2.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).

Retourtype

create_page_blob

Hiermee maakt u een nieuwe pagina-blob met de opgegeven grootte.

create_page_blob(size: int, content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, premium_page_blob_tier: str | PremiumPageBlobTier | None = None, **kwargs) -> Dict[str, str | datetime]

Parameters

size
int
Vereist

Hiermee geeft u de maximale grootte voor de pagina-blob op, maximaal 1 TB. De pagina-blobgrootte moet worden uitgelijnd op een grens van 512 bytes.

content_settings
ContentSettings
Vereist

ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen. Wordt gebruikt voor het instellen van inhoudstype, codering, taal, verwijdering, md5 en cachebeheer.

metadata
dict(str, str)
Vereist

Naam-waardeparen die als metagegevens aan de blob zijn gekoppeld.

premium_page_blob_tier
PremiumPageBlobTier
Vereist

Een pagina-bloblaagwaarde waarop de blob moet worden ingesteld. De laag komt overeen met de grootte van de blob en het aantal toegestane IOPS. Dit is alleen van toepassing op pagina-blobs in Premium Storage-accounts.

tags
dict(str, str)

Naam-waardeparen die zijn gekoppeld aan de blob als tag. Tags zijn hoofdlettergevoelig. De tagset kan maximaal 10 tags bevatten. Tagsleutels moeten tussen 1 en 128 tekens zijn en tagwaarden moeten tussen 0 en 256 tekens zijn. Geldige tagsleutel en waardetekens zijn: kleine letters en hoofdletters, cijfers (0-9), spatie ( >><<), plusteken (+), minteken (-), punt (.), solidus (/), dubbele punt (:), is gelijk aan (=), onderstrepingsteken (_)

Nieuw in versie 12.4.0.

sequence_number
int

Alleen voor pagina-blobs. Het volgnummer is een door de gebruiker beheerde waarde die u kunt gebruiken om aanvragen bij te houden. De waarde van het volgnummer moet tussen 0 en 2^63 - 1 zijn. De standaardwaarde is 0.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

immutability_policy
ImmutabilityPolicy

Hiermee geeft u het beleid voor onveranderbaarheid van een blob, blob-momentopname of blobversie op.

Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie 2020-10-02.

legal_hold
bool

Opgegeven als een juridische bewaring moet worden ingesteld voor de blob.

Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie 2020-10-02.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.

Nieuw in versie 12.2.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).

Retourtype

create_snapshot

Hiermee maakt u een momentopname van de blob.

Een momentopname is een alleen-lezen versie van een blob die op een bepaald moment is gemaakt. Deze kan worden gelezen, gekopieerd of verwijderd, maar niet worden gewijzigd. Momentopnamen bieden een manier om een back-up te maken van een blob zoals deze op een moment in de tijd wordt weergegeven.

Een momentopname van een blob heeft dezelfde naam als de basis-blob van waaruit de momentopname wordt gemaakt, waarbij een DateTime-waarde wordt toegevoegd om aan te geven op welk tijdstip de momentopname is gemaakt.

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

Parameters

metadata
dict(str, str)
Vereist

Naam-waardeparen die als metagegevens aan de blob zijn gekoppeld.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op de doel-blob met een overeenkomende waarde.

Nieuw in versie 12.4.0.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.

Nieuw in versie 12.2.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Blob bijgewerkt eigenschapsdict (momentopname-id, Etag en laatst gewijzigd).

Retourtype

delete_blob

Hiermee wordt de opgegeven blob gemarkeerd voor verwijdering.

De blob wordt later verwijderd tijdens de garbagecollection. Als u een blob wilt verwijderen, moet u alle momentopnamen verwijderen. U kunt beide tegelijk verwijderen met de bewerking delete_blob().

Als een bewaarbeleid voor verwijderen is ingeschakeld voor de service, wordt met deze bewerking de blob voorlopig verwijderd en wordt de blob gedurende een opgegeven aantal dagen bewaard. Na het opgegeven aantal dagen worden de gegevens van de blob verwijderd uit de service tijdens de garbagecollection. Voorlopig verwijderde blob is toegankelijk via list_blobs de optie include=['deleted']. Voorlopig verwijderde blob kan worden hersteld met behulp van een <xref:azure.storage.blob.undelete> bewerking.

delete_blob(delete_snapshots: str = None, **kwargs: Any) -> None

Parameters

delete_snapshots
str
Vereist

Vereist als de blob gekoppelde momentopnamen bevat. De waarden zijn:

  • 'alleen': hiermee verwijdert u alleen de momentopnamen van blobs.

  • 'include': hiermee verwijdert u de blob samen met alle momentopnamen.

version_id
str

De parameter versie-id is een ondoorzichtige DateTime-waarde die, indien aanwezig, de versie van de blob aangeeft die moet worden verwijderd.

Nieuw in versie 12.4.0.

Dit trefwoordargument is geïntroduceerd in API-versie '2019-12-12'.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Indien opgegeven, slaagt delete_blob alleen als de lease van de blob actief is en overeenkomt met deze id. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retourtype

delete_immutability_policy

Met de bewerking Onveranderbaarheidsbeleid verwijderen wordt het onveranderbaarheidsbeleid op de blob verwijderd.

Nieuw in versie 12.10.0: deze bewerking is geïntroduceerd in API-versie '2020-10-02'.

delete_immutability_policy(**kwargs: Any) -> None

Parameters

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Sleutelwaardeparen van blobtags.

Retourtype

download_blob

Hiermee downloadt u een blob naar de StorageStreamDownloader. De methode readall() moet worden gebruikt om alle inhoud te lezen of readinto() moet worden gebruikt om de blob in een stream te downloaden. Het gebruik van chunks() retourneert een iterator waarmee de gebruiker de inhoud in segmenten kan herhalen.

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

Parameters

offset
int
Vereist

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
Vereist

Het aantal bytes dat uit de stream moet worden gelezen. Dit is optioneel, maar moet worden opgegeven voor optimale prestaties.

version_id
str

De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, aangeeft welke versie van de blob moet worden gedownload.

Nieuw in versie 12.4.0.

Dit trefwoordargument is geïntroduceerd in API-versie '2019-12-12'.

validate_content
bool

Indien waar, berekent u een MD5-hash 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 nuttig 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 verslagen.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Indien opgegeven, slaagt download_blob alleen als de lease van de blob actief is en overeenkomt met deze id. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf wordt opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

max_concurrency
int

Het aantal parallelle verbindingen waarmee moet worden gedownload.

encoding
str

Codering om de gedownloade bytes te decoderen. De standaardwaarde is Geen, d.w.w.v. geen decodering.

progress_hook
Callable[[int, int], None]

Een callback om de voortgang van een langlopende download bij te houden. De handtekening is function(current: int, total: int) waarbij current het aantal bytes is dat tot nu toe is overgedragen en total de totale grootte van de download.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier. Deze methode kan meerdere aanroepen naar de service uitvoeren en de time-out is van toepassing op elke aanroep afzonderlijk. meerdere aanroepen naar de Azure-service en de time-out is van toepassing op elke aanroep afzonderlijk.

Retouren

Een streamingobject (StorageStreamDownloader)

Retourtype

exists

Retourneert True als er een blob bestaat met de gedefinieerde parameters en retourneert anders False.

exists(**kwargs: Any) -> bool

Parameters

version_id
str

De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de versie van de blob aangeeft om te controleren of deze bestaat.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

booleaans

Retourtype

from_blob_url

BlobClient maken op basis van een blob-URL. Dit biedt geen ondersteuning voor aangepaste blob-URL met /in blobnaam.

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

Parameters

blob_url
str
Vereist

De volledige eindpunt-URL naar de blob, inclusief SAS-token en momentopname indien gebruikt. Dit kan het primaire eindpunt of het secundaire eindpunt zijn, afhankelijk van de huidige location_mode.

credential
Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
standaardwaarde: None

De referenties waarmee moet worden geverifieerd. Dit is optioneel als de account-URL al een SAS-token heeft of als de verbindingsreeks al gedeelde toegangssleutelwaarden 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.
snapshot
str
standaardwaarde: None

De optionele blob-momentopname waarop moet worden uitgevoerd. Dit kan de tekenreeks van de momentopname-id zijn of het antwoord dat wordt geretourneerd van create_snapshot. Als dit is opgegeven, wordt de momentopname in de URL overschreven.

version_id
str

De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de versie van de blob aangeeft waarop moet worden gewerkt.

Retouren

Een Blob-client.

Retourtype

from_connection_string

BlobClient maken op basis van een verbindingsreeks.

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

Parameters

conn_str
str
Vereist

Een verbindingsreeks naar een Azure Storage-account.

container_name
str
Vereist

De containernaam voor de blob.

blob_name
str
Vereist

De naam van de blob waarmee moet worden gecommuniceerd.

snapshot
str
standaardwaarde: None

De optionele blob-momentopname waarop moet worden uitgevoerd. Dit kan de tekenreeks van de momentopname-id zijn of het antwoord dat wordt geretourneerd van create_snapshot.

credential
Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
standaardwaarde: None

De referenties waarmee moet worden geverifieerd. Dit is optioneel als de account-URL al een SAS-token heeft of als de verbindingsreeks al gedeelde toegangssleutelwaarden 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. Referenties die hier worden opgegeven, hebben voorrang op de referenties in de verbindingsreeks. Als u een exemplaar van AzureNamedKeyCredential gebruikt, moet 'name' de naam van het opslagaccount zijn en moet 'sleutel' de sleutel van het opslagaccount zijn.

version_id
str

De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de versie van de blob aangeeft waarop moet worden gewerkt.

Retouren

Een Blob-client.

Retourtype

get_account_information

Hiermee haalt u informatie op met betrekking tot het opslagaccount waarin de blob zich bevindt.

De informatie kan ook worden opgehaald als de gebruiker een SAS voor een container of blob heeft. De sleutels in de geretourneerde woordenlijst bevatten 'sku_name' en 'account_kind'.

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

Retouren

Een dictaat met accountgegevens (SKU en accounttype).

Retourtype

get_blob_properties

Retourneert alle door de gebruiker gedefinieerde metagegevens, standaard-HTTP-eigenschappen en systeemeigenschappen voor de blob. De inhoud van de blob wordt niet geretourneerd.

get_blob_properties(**kwargs: Any) -> BlobProperties

Parameters

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

version_id
str

De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de versie van de blob aangeeft om eigenschappen op te halen.

Nieuw in versie 12.4.0.

Dit trefwoordargument is geïntroduceerd in API-versie 2019-12-12.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

BlobProperties

Retourtype

get_blob_tags

Met de bewerking Tags ophalen kunnen gebruikers tags ophalen op een blob of een specifieke blobversie of momentopname.

Nieuw in versie 12.4.0: deze bewerking is geïntroduceerd in API-versie '2019-12-12'.

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

Parameters

version_id
str

De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de versie van de blob aangeeft waaraan tags moeten worden toegevoegd.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op de doel-blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Sleutelwaardeparen van blobtags.

Retourtype

get_block_list

Met de bewerking Blokkeringslijst ophalen wordt de lijst met blokken opgehaald die zijn geüpload als onderdeel van een blok-blob.

get_block_list(block_list_type: str | None = 'committed', **kwargs: Any) -> Tuple[List[BlobBlock], List[BlobBlock]]

Parameters

block_list_type
str
Vereist

Hiermee geeft u op of de lijst met vastgelegde blokken, de lijst met niet-doorgevoerde blokken of beide lijsten samen moet retourneren. Mogelijke waarden zijn: 'committed', 'uncommitted', 'all'

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op de doel-blob met een overeenkomende waarde.

Nieuw in versie 12.4.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Een tuple van twee lijsten - vastgelegde en niet-doorgevoerde blokken

Retourtype

get_page_range_diff_for_managed_disk

Retourneert de lijst met geldige paginabereiken voor een beheerde schijf of momentopname.

Notitie

Deze bewerking is alleen beschikbaar voor beheerde schijfaccounts.

Nieuw in versie 12.2.0: deze bewerking is geïntroduceerd in API-versie '2019-07-07'.

get_page_range_diff_for_managed_disk(previous_snapshot_url: str, offset: int | None = None, length: int | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]

Parameters

previous_snapshot_url
Vereist

Hiermee geeft u de URL van een vorige momentopname van de beheerde schijf. Het antwoord bevat alleen pagina's die zijn gewijzigd tussen de doel-blob en de vorige momentopname.

offset
int
Vereist

Begin van het bytebereik dat moet worden gebruikt voor het verkrijgen van geldige paginabereiken. Als er geen lengte wordt opgegeven, worden alle bytes na de offset doorzocht. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de beginverschuiving moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

length
int
Vereist

Het aantal bytes dat moet worden gebruikt voor het ophalen van geldige paginabereiken. Als de lengte wordt opgegeven, moet er een verschuiving worden opgegeven. Dit bereik retourneert geldige paginabereiken vanaf het begin tot de opgegeven lengte. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de beginverschuiving moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Een tuple van twee lijsten met paginabereiken als woordenlijsten met de toetsen 'begin' en 'eind'. Het eerste element zijn gevulde paginabereiken, het tweede element is gewiste paginabereiken.

Retourtype

get_page_ranges

AFGESCHAFT: retourneert de lijst met geldige paginabereiken voor een pagina-blob of momentopname van een pagina-blob.

get_page_ranges(offset: int | None = None, length: int | None = None, previous_snapshot_diff: str | Dict[str, Any] | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]

Parameters

offset
int
Vereist

Begin van het bytebereik dat moet worden gebruikt voor het verkrijgen van geldige paginabereiken. Als er geen lengte wordt opgegeven, worden alle bytes na de offset doorzocht. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de beginverschuiving moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

length
int
Vereist

Het aantal bytes dat moet worden gebruikt voor het ophalen van geldige paginabereiken. Als de lengte wordt opgegeven, moet er een verschuiving worden opgegeven. Dit bereik retourneert geldige paginabereiken vanaf het begin tot de opgegeven lengte. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de beginverschuiving moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

previous_snapshot_diff
str
Vereist

De diff-parameter voor momentopnamen die een ondoorzichtige DateTime-waarde bevat die een eerdere blob-momentopname aangeeft die moet worden vergeleken met een recentere momentopname of de huidige blob.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Een tuple van twee lijsten met paginabereiken als woordenlijsten met de toetsen 'begin' en 'eind'. Het eerste element zijn gevulde paginabereiken, het tweede element is gewiste paginabereiken.

Retourtype

list_page_ranges

Retourneert de lijst met geldige paginabereiken voor een pagina-blob of momentopname van een pagina-blob. Als previous_snapshot is opgegeven, is het resultaat een verschil van wijzigingen tussen de doel-blob en de vorige momentopname.

list_page_ranges(*, offset: int | None = None, length: int | None = None, previous_snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> ItemPaged[PageRange]

Parameters

offset
int

Begin van het bytebereik dat moet worden gebruikt voor het verkrijgen van geldige paginabereiken. Als er geen lengte wordt opgegeven, worden alle bytes na de offset doorzocht. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de beginverschuiving moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

length
int

Het aantal bytes dat moet worden gebruikt voor het ophalen van geldige paginabereiken. Als de lengte wordt opgegeven, moet er een verschuiving worden opgegeven. Dit bereik retourneert geldige paginabereiken vanaf het begin tot de opgegeven lengte. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de beginverschuiving moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

previous_snapshot
str of Dict[str, Any]

Een momentopnamewaarde die aangeeft dat het antwoord alleen pagina's bevat die zijn gewijzigd tussen de doel-blob en de vorige momentopname. Gewijzigde pagina's bevatten zowel bijgewerkte als gewiste pagina's. De doel-blob kan een momentopname zijn, zolang de momentopname die is opgegeven door previous_snapshot de oudere van de twee is.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

results_per_page
int

Het maximum aantal paginabereiken dat per API-aanroep moet worden opgehaald.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Een iterable (automatisch pagineren) van PageRange.

Retourtype

query_blob

Hiermee kunnen gebruikers blob-/of blobmomentopnamegegevens selecteren/projecteren door eenvoudige query-expressies op te geven. Deze bewerking retourneert een BlobQueryReader. Gebruikers moeten readall() of readinto() gebruiken om querygegevens op te halen.

query_blob(query_expression: str, **kwargs: Any) -> BlobQueryReader

Parameters

query_expression
str
Vereist

Vereist. een query-instructie. Zie https://learn.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference voor meer informatie.

on_error
Callable[BlobQueryError]

Een functie die moet worden aangeroepen voor eventuele verwerkingsfouten die door de service worden geretourneerd.

blob_format
DelimitedTextDialect of DelimitedJsonDialect of QuickQueryDialect of str

Optioneel. Definieert de serialisatie van de gegevens die momenteel zijn opgeslagen in de blob. Standaard worden de blobgegevens behandeld als CSV-gegevens die zijn opgemaakt in het standaarddialect. Dit kan worden overschreven met een aangepaste DelimitedTextDialect of DelimitedJsonDialect of ParquetDialect (doorgegeven als een tekenreeks of opsomming). Deze dialecten kunnen worden doorgegeven via hun respectieve klassen, de QuickQueryDialect-opsomming of als een tekenreeks

output_format
DelimitedTextDialect of DelimitedJsonDialect of list[ArrowDialect] of QuickQueryDialect of str

Optioneel. Definieert de uitvoerserialisatie voor de gegevensstroom. Standaard worden de gegevens geretourneerd zoals deze worden weergegeven in de blob (Parquet-indelingen zijn standaard DelimitedTextDialect). Door een uitvoerindeling op te geven, worden de blobgegevens opnieuw opgemaakt op basis van dat profiel. Deze waarde kan een DelimitedTextDialect of een DelimitedJsonDialect of ArrowDialect zijn. Deze dialecten kunnen worden doorgegeven via hun respectieve klassen, de QuickQueryDialect-opsomming of als een tekenreeks

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf wordt opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Een streaming-object (BlobQueryReader)

Retourtype

resize_blob

Hiermee wijzigt u de grootte van een pagina-blob in de opgegeven grootte.

Als de opgegeven waarde kleiner is dan de huidige grootte van de blob, worden alle pagina's boven de opgegeven waarde gewist.

resize_blob(size: int, **kwargs: Any) -> Dict[str, str | datetime]

Parameters

size
int
Vereist

Grootte die wordt gebruikt om het formaat van de blob te wijzigen. De maximale grootte voor een pagina-blob is maximaal 1 TB. De pagina-blobgrootte moet worden uitgelijnd op een grens van 512 bytes.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

premium_page_blob_tier
PremiumPageBlobTier

Een pagina-bloblaagwaarde waarop de blob moet worden ingesteld. De laag is gerelateerd aan de grootte van de blob en het aantal toegestane IOPS. Dit is alleen van toepassing op pagina-blobs in Premium Storage-accounts.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).

Retourtype

seal_append_blob

De bewerking Seal verzegelt de toevoeg-blob zodat deze alleen-lezen is.

Nieuw in versie 12.4.0.

seal_append_blob(**kwargs) -> Dict[str, str | datetime | int]

Parameters

appendpos_condition
int

Optionele voorwaardelijke header, die alleen wordt gebruikt voor de bewerking Toevoegblok. Een getal dat de byte offset aangeeft die moet worden vergeleken. Toevoegblok slaagt alleen als de toevoegpositie gelijk is aan dit getal. Als dit niet zo is, mislukt de aanvraag met de fout AppendPositionConditionNotMet (HTTP-statuscode 412 - Voorwaarde mislukt).

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Blob bijgewerkt eigenschapsdict (Etag, laatst gewijzigd, toevoeg offset, doorgevoerd aantal blokken).

Retourtype

set_blob_metadata

Hiermee stelt u door de gebruiker gedefinieerde metagegevens voor de blob in als een of meer naam-waardeparen.

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

Parameters

metadata
dict(str, str)
Vereist

Dict met naam- en waardeparen. Elke aanroep van deze bewerking vervangt alle bestaande metagegevens die aan de blob zijn gekoppeld. Als u alle metagegevens uit de blob wilt verwijderen, roept u deze bewerking aan zonder metagegevensheaders.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.

Nieuw in versie 12.2.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd)

set_blob_tags

Met de bewerking Tags instellen kunnen gebruikers tags instellen op een blob of een specifieke blobversie, maar geen momentopname. Elke aanroep van deze bewerking vervangt alle bestaande tags die aan de blob zijn gekoppeld. Als u alle tags uit de blob wilt verwijderen, roept u deze bewerking aan zonder tags in te stellen.

Nieuw in versie 12.4.0: deze bewerking is geïntroduceerd in API-versie '2019-12-12'.

set_blob_tags(tags: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, Any]

Parameters

tags
dict(str, str)
Vereist

Naam-waardeparen die zijn gekoppeld aan de blob als tag. Tags zijn hoofdlettergevoelig. De tagset kan maximaal 10 tags bevatten. Tagsleutels moeten tussen 1 en 128 tekens zijn en tagwaarden moeten tussen 0 en 256 tekens zijn. Geldige tagsleutel en waardetekens zijn: kleine letters en hoofdletters, cijfers (0-9), spatie ( >><<), plusteken (+), minteken (-), punt (.), solidus (/), dubbele punt (:), is gelijk aan (=), onderstrepingsteken (_)

version_id
str

De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de versie van de blob aangeeft waaraan tags moeten worden toegevoegd.

validate_content
bool

Als dit waar is, wordt een MD5-hash van de inhoud van de tags berekend. 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 kabel 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.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op de doel-blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd)

Retourtype

set_http_headers

Hiermee stelt u systeemeigenschappen voor de blob in.

Als er één eigenschap is ingesteld voor de content_settings, worden alle eigenschappen overschreven.

set_http_headers(content_settings: ContentSettings | None = None, **kwargs: Any) -> None

Parameters

content_settings
ContentSettings
Vereist

ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen. Wordt gebruikt voor het instellen van inhoudstype, codering, taal, verwijdering, md5 en cachebeheer.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd)

Retourtype

set_immutability_policy

Met de bewerking Onveranderbaarheidsbeleid instellen wordt het onveranderbaarheidsbeleid ingesteld op de blob.

Nieuw in versie 12.10.0: Deze bewerking is geïntroduceerd in API-versie '2020-10-02'.

set_immutability_policy(immutability_policy: ImmutabilityPolicy, **kwargs: Any) -> Dict[str, str]

Parameters

immutability_policy
ImmutabilityPolicy
Vereist

Hiermee geeft u het beleid voor onveranderbaarheid van een blob, blob-momentopname of blobversie op.

Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie 2020-10-02.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Sleutelwaardeparen van blobtags.

Retourtype

Met de bewerking Juridische bewaring instellen wordt een juridische bewaring ingesteld voor de blob.

Nieuw in versie 12.10.0: deze bewerking is geïntroduceerd in API-versie '2020-10-02'.

set_legal_hold(legal_hold: bool, **kwargs: Any) -> Dict[str, str | datetime | bool]

Parameters

legal_hold
bool
Vereist

Opgegeven als een juridische bewaring moet worden ingesteld voor de blob.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Sleutelwaardeparen van blobtags.

Retourtype

set_premium_page_blob_tier

Hiermee stelt u de pagina-bloblagen op de blob in. Deze API wordt alleen ondersteund voor pagina-blobs op Premium-accounts.

set_premium_page_blob_tier(premium_page_blob_tier: str | PremiumPageBlobTier, **kwargs: Any) -> None

Parameters

premium_page_blob_tier
PremiumPageBlobTier
Vereist

Een pagina-bloblaagwaarde waarop de blob moet worden ingesteld. De laag is gerelateerd aan de grootte van de blob en het aantal toegestane IOPS. Dit is alleen van toepassing op pagina-blobs in Premium Storage-accounts.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

Retourtype

set_sequence_number

Hiermee stelt u het volgnummer van de blob in.

set_sequence_number(sequence_number_action: str | SequenceNumberAction, sequence_number: str | None = None, **kwargs: Any) -> Dict[str, str | datetime]

Parameters

sequence_number_action
str
Vereist

Deze eigenschap geeft aan hoe de service het volgnummer van de blob moet wijzigen. Zie SequenceNumberAction voor meer informatie.

sequence_number
str
Vereist

Met deze eigenschap stelt u het volgnummer van de blob in. Het volgnummer is een door de gebruiker beheerde eigenschap die u kunt gebruiken om aanvragen bij te houden en gelijktijdigheidsproblemen te beheren.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).

Retourtype

set_standard_blob_tier

Met deze bewerking stelt u de laag in op een blok-blob.

De laag van een blok-blob bepaalt het opslagtype Dynamisch/Statisch/Archief. Met deze bewerking wordt de ETag van de blob niet bijgewerkt.

set_standard_blob_tier(standard_blob_tier: str | StandardBlobTier, **kwargs: Any) -> None

Parameters

standard_blob_tier
str of StandardBlobTier
Vereist

Geeft de laag aan die moet worden ingesteld op de blob. Opties zijn onder andere 'Dynamisch', 'Statisch', 'Archiveren'. De dynamische laag is geoptimaliseerd voor het opslaan van gegevens die regelmatig worden geopend. De statische opslaglaag is geoptimaliseerd voor het opslaan van gegevens die zelden worden geopend en die gedurende ten minste een maand worden opgeslagen. De archieflaag is geoptimaliseerd voor het opslaan van gegevens die zelden worden geopend en die gedurende ten minste zes maanden worden opgeslagen met flexibele latentievereisten.

rehydrate_priority
RehydratePriority

Geeft de prioriteit aan waarmee een gearchiveerde blob moet worden gerehydrateerd

version_id
str

De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, aangeeft welke versie van de blob moet worden gedownload.

Nieuw in versie 12.4.0.

Dit trefwoordargument is geïntroduceerd in API-versie '2019-12-12'.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

Retourtype

stage_block

Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob.

stage_block(block_id: str, data: Iterable | IO, length: int | None = None, **kwargs) -> Dict[str, Any]

Parameters

block_id
str
Vereist

Een tekenreekswaarde die het blok identificeert. De tekenreeks moet kleiner zijn dan of gelijk zijn aan 64 bytes. Voor een bepaalde blob moet de block_id voor elk blok dezelfde grootte hebben.

data
Vereist

De blobgegevens.

length
int
Vereist

Grootte van het blok.

validate_content
bool

Indien waar, berekent u een MD5-hash 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 nuttig 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 verslagen.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

encoding
str

De standaardinstelling is UTF-8.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf wordt opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens in de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam worden vermeld. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders wordt er een fout gegenereerd.

Nieuw in versie 12.2.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

Retouren

Dicteren van blob-eigenschap.

Retourtype

stage_block_from_url

Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob waarin de inhoud van een URL wordt gelezen.

stage_block_from_url(block_id: str | int, source_url: str, source_offset: int | None = None, source_length: int | None = None, source_content_md5: bytes | bytearray | None = None, **kwargs) -> Dict[str, Any]

Parameters

block_id
str
Vereist

Een tekenreekswaarde die het blok identificeert. De tekenreeks moet kleiner zijn dan of gelijk zijn aan 64 bytes. Voor een bepaalde blob moet de block_id voor elk blok dezelfde grootte hebben.

source_url
str
Vereist

De URL.

source_offset
int
Vereist

Begin van het bytebereik dat moet worden gebruikt voor het blok. Moet worden ingesteld als de bronlengte is opgegeven.

source_length
int
Vereist

De grootte van het blok in bytes.

source_content_md5
bytearray
Vereist

Geef de md5 op die is berekend voor het bereik van bytes dat moet worden gelezen uit de kopieerbron.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf wordt opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens in de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam worden vermeld. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders wordt er een fout gegenereerd.

Nieuw in versie 12.2.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

source_authorization
str

Verifieer als een service-principal met behulp van een clientgeheim om toegang te krijgen tot een bron-blob. Zorg ervoor dat 'bearer ' het voorvoegsel is van de source_authorization tekenreeks.

Retouren

Dicteren van blob-eigenschap.

Retourtype

start_copy_from_url

Kopieert een blob van de opgegeven URL.

Deze bewerking retourneert een woordenlijst met copy_status en copy_id, die kan worden gebruikt om de status van de kopieerbewerking te controleren of af te breken. copy_status is 'geslaagd' als de kopie synchroon is voltooid of 'in behandeling' als de kopie asynchroon is gestart. Voor asynchrone kopieën kan de status worden gecontroleerd door de get_blob_properties methode te pollen en de kopieerstatus te controleren. Stel requires_sync in op True om af te dwingen dat de kopie synchroon is. De Blob-service kopieert blobs op basis van best-effort.

De bron-blob voor een kopieerbewerking kan een blok-blob, een toevoeg-blob of een pagina-blob zijn. Als de doel-blob al bestaat, moet deze van hetzelfde blobtype zijn als de bron-blob. Elke bestaande doel-blob wordt overschreven. De doel-blob kan niet worden gewijzigd terwijl er een kopieerbewerking wordt uitgevoerd.

Wanneer u kopieert vanuit een pagina-blob, maakt de Blob-service een doelpagina-blob met de lengte van de bron-blob, die in eerste instantie alle nullen bevat. Vervolgens worden de bronpaginabereiken opgesomd en worden niet-lege bereiken gekopieerd.

Voor een blok- of toevoeg-blob maakt de Blob-service een toegewezen blob met de lengte nul voordat deze bewerking wordt geretourneerd. Wanneer u kopieert vanuit een blok-blob, worden alle vastgelegde blokken en de bijbehorende blok-id's gekopieerd. Niet-doorgevoerde blokken worden niet gekopieerd. Aan het einde van de kopieerbewerking heeft de doel-blob hetzelfde aantal vastgelegde blokken als de bron.

Bij het kopiëren vanuit een toevoeg-blob worden alle vastgelegde blokken gekopieerd. Aan het einde van de kopieerbewerking heeft de doel-blob hetzelfde aantal vastgelegde blokken als de bron.

start_copy_from_url(source_url: str, metadata: Dict[str, str] | None = None, incremental_copy: bool = False, **kwargs: Any) -> Dict[str, str | datetime]

Parameters

source_url
str
Vereist

Een URL van maximaal 2 kB die een bestand of blob aangeeft. De waarde moet URL-gecodeerd zijn zoals deze wordt weergegeven in een aanvraag-URI. Als de bron zich in een ander account bevindt, moet de bron openbaar zijn of worden geverifieerd via een shared access signature. Als de bron openbaar is, is geen verificatie vereist. Voorbeelden: https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

metadata
dict(str, str)
Vereist

Naam-waardeparen die als metagegevens aan de blob zijn gekoppeld. Als er geen naam-waardeparen zijn opgegeven, worden de metagegevens van de bron-blob of het bronbestand naar de doel-blob gekopieerd. Als een of meer naam-waardeparen zijn opgegeven, wordt de doel-blob gemaakt met de opgegeven metagegevens en worden metagegevens niet gekopieerd uit de bron-blob of het bronbestand.

incremental_copy
bool
Vereist

Kopieert de momentopname van de bronpagina-blob naar een doelpagina-blob. De momentopname wordt zodanig gekopieerd dat alleen de differentiële wijzigingen tussen de eerder gekopieerde momentopname worden overgebracht naar de bestemming. De gekopieerde momentopnamen zijn volledige kopieën van de oorspronkelijke momentopname en kunnen zoals gebruikelijk worden gelezen of gekopieerd. Standaard ingesteld op False.

tags
dict(str, str) of Literal["COPY"]

Naam-waardeparen die zijn gekoppeld aan de blob als tag. Tags zijn hoofdlettergevoelig. De tagset kan maximaal 10 tags bevatten. Tagsleutels moeten tussen 1 en 128 tekens zijn en tagwaarden moeten tussen 0 en 256 tekens zijn. Geldige codesleutel- en waardetekens zijn: kleine letters en hoofdletters, cijfers (0-9), spatie ( >><<), plusteken (+), minteken (-), punt (.), solidus (/), dubbele punt (:), is gelijk aan (=), onderstrepingsteken (_).

De (hoofdlettergevoelige) letterlijke 'COPY' kan in plaats daarvan worden doorgegeven om tags uit de bron-blob te kopiëren. Deze optie is alleen beschikbaar als incremental_copy=False en requires_sync=True.

Nieuw in versie 12.4.0.

immutability_policy
ImmutabilityPolicy

Hiermee geeft u het onveranderbaarheidsbeleid van een blob, blob-momentopname of blobversie op.

Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie '2020-10-02'.

legal_hold
bool

Opgegeven als een juridische bewaring moet worden ingesteld op de blob.

Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie '2020-10-02'.

source_if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de bron-blob is gewijzigd sinds de opgegeven datum/tijd.

source_if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de bron-blob niet is gewijzigd sinds de opgegeven datum/tijd.

source_etag
str

De bron-ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

source_match_condition
MatchConditions

De bronovereenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de doel-blob is gewijzigd sinds de opgegeven datum/tijd. Als de doel-blob niet is gewijzigd, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt).

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de doel-blob niet is gewijzigd sinds de opgegeven datum/tijd. Als de doel-blob is gewijzigd, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt).

etag
str

De doel-ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De doelovereenkomstvoorwaarde die moet worden gebruikt voor de etag.

destination_lease
BlobLeaseClient of str

De lease-id die voor deze header is opgegeven, moet overeenkomen met de lease-id van de doel-blob. Als de aanvraag de lease-id niet bevat of niet geldig is, mislukt de bewerking met statuscode 412 (Voorwaarde is mislukt).

source_lease
BlobLeaseClient of str

Geef dit op om de bewerking Blob kopiëren alleen uit te voeren als de opgegeven lease-id overeenkomt met de actieve lease-id van de bron-blob.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

premium_page_blob_tier
PremiumPageBlobTier

Een pagina-bloblaagwaarde waarop de blob moet worden ingesteld. De laag is gerelateerd aan de grootte van de blob en het aantal toegestane IOPS. Dit is alleen van toepassing op pagina-blobs in Premium Storage-accounts.

standard_blob_tier
StandardBlobTier

Een standaard bloblaagwaarde om de blob op in te stellen. Voor deze versie van de bibliotheek is dit alleen van toepassing op blok-blobs in standaardopslagaccounts.

rehydrate_priority
RehydratePriority

Geeft de prioriteit aan waarmee een gearchiveerde blob moet worden gerehydrateerd

seal_destination_blob
bool

Verzegel de bestemmings-toevoeg-blob. Deze bewerking is alleen bedoeld voor toevoeg-blob.

Nieuw in versie 12.4.0.

requires_sync
bool

Hiermee wordt afgedwongen dat de service pas een antwoord retourneert als het kopiëren is voltooid.

source_authorization
str

Verifieer als een service-principal met behulp van een clientgeheim om toegang te krijgen tot een bron-blob. Zorg ervoor dat 'bearer ' het voorvoegsel is van de source_authorization tekenreeks. Deze optie is alleen beschikbaar als incremental_copy is ingesteld op Onwaar en requires_sync is ingesteld op Waar.

Nieuw in versie 12.9.0.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt voor het versleutelen van de gegevens in de met de synchronisatie gekopieerde blob. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam worden vermeld. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders wordt er een fout gegenereerd.

Nieuw in versie 12.10.0.

Retouren

Een woordenlijst met kopieereigenschappen (etag, last_modified, copy_id, copy_status).

Retourtype

undelete_blob

Herstelt voorlopig verwijderde blobs of momentopnamen.

De bewerking is alleen geslaagd als deze wordt gebruikt binnen het opgegeven aantal dagen dat is ingesteld in het bewaarbeleid voor verwijderen.

Als blobversiebeheer is ingeschakeld, kan de basis-blob niet worden hersteld met deze methode. Gebruik start_copy_from_url in plaats daarvan met de URL van de blobversie die u wilt promoveren naar de huidige versie.

undelete_blob(**kwargs: Any) -> None

Parameters

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retourtype

upload_blob

Hiermee maakt u een nieuwe blob op basis van een gegevensbron met automatische segmentering.

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

Parameters

data
Vereist

De blobgegevens die moeten worden geüpload.

blob_type
BlobType
Vereist

Het type blob. Dit kan BlockBlob, PageBlob of AppendBlob zijn. De standaardwaarde is BlockBlob.

length
int
Vereist

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

metadata
dict(str, str)
Vereist

Naam-waardeparen die als metagegevens aan de blob zijn gekoppeld.

tags
dict(str, str)

Naam-waardeparen die zijn gekoppeld aan de blob als tag. Tags zijn hoofdlettergevoelig. De tagset kan maximaal 10 tags bevatten. Tagsleutels moeten tussen 1 en 128 tekens zijn en tagwaarden moeten tussen 0 en 256 tekens zijn. Geldige tagsleutel en waardetekens zijn: kleine letters en hoofdletters, cijfers (0-9), spatie ( >><<), plusteken (+), minteken (-), punt (.), solidus (/), dubbele punt (:), is gelijk aan (=), onderstrepingsteken (_)

Nieuw in versie 12.4.0.

overwrite
bool

Of de blob die moet worden geüpload, de huidige gegevens moet overschrijven. Indien Waar, overschrijft upload_blob de bestaande gegevens. Als deze optie is ingesteld op False, mislukt de bewerking met ResourceExistsError. De uitzondering op het bovenstaande is bij toevoeg-blobtypen: als deze is ingesteld op Onwaar en de gegevens al bestaan, wordt er geen fout gegenereerd en worden de gegevens toegevoegd aan de bestaande blob. Als overwrite=True is ingesteld, wordt de bestaande toevoeg-blob verwijderd en wordt er een nieuwe gemaakt. Standaard ingesteld op False.

content_settings
ContentSettings

ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen. Wordt gebruikt voor het instellen van inhoudstype, codering, taal, verwijdering, md5 en cachebeheer.

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 kabel 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 algoritme voor geheugenefficiënte upload 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.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Indien opgegeven, slaagt upload_blob alleen als de lease van de blob actief is en overeenkomt met deze id. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

premium_page_blob_tier
PremiumPageBlobTier

Een pagina-bloblaagwaarde waarop de blob moet worden ingesteld. De laag komt overeen met de grootte van de blob en het aantal toegestane IOPS. Dit is alleen van toepassing op pagina-blobs in Premium Storage-accounts.

standard_blob_tier
StandardBlobTier

Een standaard-bloblaagwaarde om de blob op in te stellen. Voor deze versie van de bibliotheek is dit alleen van toepassing op blok-blobs in standaardopslagaccounts.

immutability_policy
ImmutabilityPolicy

Hiermee geeft u het beleid voor onveranderbaarheid van een blob, blob-momentopname of blobversie op. Op dit moment is deze parameter van upload_blob() API alleen voor BlockBlob.

Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie 2020-10-02.

legal_hold
bool

Opgegeven als een juridische bewaring moet worden ingesteld voor de blob. Op dit moment is deze parameter van upload_blob() API alleen voor BlockBlob.

Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie 2020-10-02.

maxsize_condition
int

Optionele voorwaardelijke header. De maximale lengte in bytes die is toegestaan voor de toevoeg-blob. Als de bewerking Append Block ervoor zorgt dat de blob deze limiet overschrijdt of als de blobgrootte al groter is dan de waarde die in deze header is opgegeven, mislukt de aanvraag met de fout MaxBlobSizeConditionNotMet (HTTP-statuscode 412 - Voorwaarde is mislukt).

max_concurrency
int

Maximum aantal parallelle verbindingen dat moet worden gebruikt wanneer de blob groter is dan 64 MB.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.

Nieuw in versie 12.2.0.

encoding
str

De standaardinstelling is UTF-8.

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

Een callback om de voortgang van een langlopende upload bij te houden. De handtekening is function(current: int, total: Optional[int]) waarbij de huidige het aantal bytes is dat tot nu toe is overgedragen en het totaal de grootte van de blob of Geen als de grootte onbekend is.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier. Deze methode kan meerdere aanroepen naar de service uitvoeren en de time-out is van toepassing op elke aanroep afzonderlijk.

Retouren

Eigenschapsdicteren bijgewerkt met blob (Etag en laatst gewijzigd)

Retourtype

upload_blob_from_url

Hiermee maakt u een nieuwe blok-blob waarin de inhoud van de blob wordt gelezen vanaf een bepaalde URL. De inhoud van een bestaande blob wordt overschreven met de nieuwe blob.

upload_blob_from_url(source_url: str, **kwargs: Any) -> Dict[str, Any]

Parameters

source_url
str
Vereist

Een URL van maximaal 2 kB die een bestand of blob aangeeft. De waarde moet URL-gecodeerd zijn zoals deze wordt weergegeven in een aanvraag-URI. Als de bron zich in een ander account bevindt, moet de bron openbaar zijn of worden geverifieerd via een shared access signature. Als de bron openbaar is, is geen verificatie vereist. Voorbeelden: https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

overwrite
bool

Of de blob die moet worden geüpload, de huidige gegevens moet overschrijven. Indien waar, overschrijft upload_blob de bestaande gegevens. Als deze optie is ingesteld op False, mislukt de bewerking met ResourceExistsError.

include_source_blob_properties
bool

Geeft aan of eigenschappen van de bron-blob moeten worden gekopieerd. De standaardwaarde is Waar.

tags
dict(str, str)

Naam-waardeparen die zijn gekoppeld aan de blob als tag. Tags zijn hoofdlettergevoelig. De tagset kan maximaal 10 tags bevatten. Tagsleutels moeten tussen 1 en 128 tekens zijn en tagwaarden moeten tussen 0 en 256 tekens zijn. Geldige codesleutel- en waardetekens zijn: kleine letters en hoofdletters, cijfers (0-9), spatie ( >><<), plusteken (+), minteken (-), punt (.), solidus (/), dubbele punt (:), is gelijk aan (=), onderstrepingsteken (_)

source_content_md5
bytearray

Geef de md5 op die wordt gebruikt om de integriteit van de bronbytes te controleren.

source_if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de bronresource is gewijzigd sinds het opgegeven tijdstip.

source_if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de bronresource niet is gewijzigd sinds de opgegeven datum/tijd.

source_etag
str

De bron-ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

source_match_condition
MatchConditions

De bronovereenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

De doel-ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De doelovereenkomstvoorwaarde die moet worden gebruikt voor de etag.

destination_lease
BlobLeaseClient of str

De lease-id die voor deze header is opgegeven, moet overeenkomen met de lease-id van de doel-blob. Als de aanvraag de lease-id niet bevat of niet geldig is, mislukt de bewerking met statuscode 412 (Voorwaarde is mislukt).

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.

content_settings
ContentSettings

ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen. Wordt gebruikt voor het instellen van inhoudstype, codering, taal, verwijdering, md5 en cachebeheer.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf wordt opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens in de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam worden vermeld. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders wordt er een fout gegenereerd.

standard_blob_tier
StandardBlobTier

Een standaard bloblaagwaarde om de blob op in te stellen. Voor deze versie van de bibliotheek is dit alleen van toepassing op blok-blobs in standaardopslagaccounts.

source_authorization
str

Verifieer als een service-principal met behulp van een clientgeheim om toegang te krijgen tot een bron-blob. Zorg ervoor dat 'bearer ' het voorvoegsel is van de source_authorization tekenreeks.

upload_page

Met de bewerking Pagina's uploaden wordt een reeks pagina's naar een pagina-blob geschreven.

upload_page(page: bytes, offset: int, length: int, **kwargs) -> Dict[str, str | datetime]

Parameters

page
bytes
Vereist

Inhoud van de pagina.

offset
int
Vereist

Begin van het bytebereik dat moet worden gebruikt voor het schrijven naar een sectie van de blob. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de beginverschuiving moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

length
int
Vereist

Het aantal bytes dat moet worden gebruikt voor het schrijven naar een sectie van de blob. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de beginverschuiving moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

validate_content
bool

Als dit waar is, wordt een MD5-hash van de pagina-inhoud berekend. De opslagservice controleert de hash van de inhoud die is aangekomen met de hash die is verzonden. Dit is vooral nuttig 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.

if_sequence_number_lte
int

Als het volgnummer van de blob kleiner is dan of gelijk is aan de opgegeven waarde, wordt de aanvraag voortgezet; anders mislukt het.

if_sequence_number_lt
int

Als het volgnummer van de blob kleiner is dan de opgegeven waarde, wordt de aanvraag voortgezet; anders mislukt het.

if_sequence_number_eq
int

Als het volgnummer van de blob gelijk is aan de opgegeven waarde, wordt de aanvraag voortgezet; anders mislukt het.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.

Nieuw in versie 12.2.0.

encoding
str

De standaardinstelling is UTF-8.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

Retouren

Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).

Retourtype

upload_pages_from_url

Met de bewerking Pagina's uploaden wordt een reeks pagina's naar een pagina-blob geschreven waar de inhoud wordt gelezen vanuit een URL.

upload_pages_from_url(source_url: str, offset: int, length: int, source_offset: int, **kwargs) -> Dict[str, Any]

Parameters

source_url
str
Vereist

De URL van de brongegevens. Deze kan verwijzen naar een Azure-blob of -bestand dat openbaar is of waaraan een handtekening voor gedeelde toegang is gekoppeld.

offset
int
Vereist

Begin van bytebereik dat moet worden gebruikt voor het schrijven naar een sectie van de blob. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de begin offset moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

length
int
Vereist

Het aantal bytes dat moet worden gebruikt om naar een sectie van de blob te schrijven. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de begin offset moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.

source_offset
int
Vereist

Dit geeft het begin aan van het bereik van bytes (inclusief) dat moet worden genomen uit de kopieerbron. De service leest hetzelfde aantal bytes als het doelbereik (lengte-verschuiving).

source_content_md5
bytes

Als dit wordt opgegeven, berekent de service de MD5-hash van de blokinhoud en vergelijkt deze met deze waarde.

source_if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de bronresource is gewijzigd sinds de opgegeven tijd.

source_if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de bronresource niet is gewijzigd sinds de opgegeven datum/tijd.

source_etag
str

De bron-ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

source_match_condition
MatchConditions

De bronovereenkomstvoorwaarde die moet worden gebruikt voor de etag.

lease
BlobLeaseClient of str

Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.

if_sequence_number_lte
int

Als het volgnummer van de blob kleiner is dan of gelijk is aan de opgegeven waarde, gaat de aanvraag door; anders mislukt het.

if_sequence_number_lt
int

Als het volgnummer van de blob kleiner is dan de opgegeven waarde, gaat de aanvraag door; anders mislukt het.

if_sequence_number_eq
int

Als het volgnummer van de blob gelijk is aan de opgegeven waarde, gaat de aanvraag door; anders mislukt het.

if_modified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.

if_unmodified_since
datetime

Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.

etag
str

De waarde van de doel-ETag of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .

match_condition
MatchConditions

De doelovereenkomstvoorwaarde die moet worden gebruikt voor de etag.

if_tags_match_condition
str

Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op blob met een overeenkomende waarde. bijvoorbeeld "\"tagname\"='my tag'"

Nieuw in versie 12.4.0.

cpk
CustomerProvidedEncryptionKey

Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.

encryption_scope
str

Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.

Nieuw in versie 12.2.0.

timeout
int

Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.

source_authorization
str

Verifiëren als een service-principal met behulp van een clientgeheim voor toegang tot een bron-blob. Zorg ervoor dat bearer het voorvoegsel is van de source_authorization tekenreeks.

Kenmerken

api_version

De versie van de Storage-API die wordt gebruikt voor aanvragen.

location_mode

De locatiemodus die de client momenteel gebruikt.

Dit is standaard 'primair'. Opties zijn 'primair' en 'secundair'.

primary_endpoint

De volledige URL van het primaire eindpunt.

primary_hostname

De hostnaam van het primaire eindpunt.

secondary_endpoint

De volledige URL van het secundaire eindpunt, indien geconfigureerd.

Als dit niet beschikbaar is, wordt er een ValueError gegenereerd. Als u expliciet een secundaire hostnaam wilt opgeven, gebruikt u het optionele secondary_hostname sleutelwoordargument bij instantiëring.

Uitzonderingen

secondary_hostname

De hostnaam van het secundaire eindpunt.

Als dit niet beschikbaar is, is dit Geen. Als u expliciet een secundaire hostnaam wilt opgeven, gebruikt u het optionele secondary_hostname sleutelwoordargument bij instantiëring.

url

De volledige eindpunt-URL naar deze entiteit, inclusief SAS-token indien gebruikt.

Dit kan het primaire eindpunt of het secundaire eindpunt zijn, afhankelijk van de huidige location_mode. :retourneert: de volledige eindpunt-URL naar deze entiteit, inclusief SAS-token indien gebruikt. :rtype: str