azure.storage.blob.BlobClient class

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

None

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

BlobLeaseClient

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

dict(str, Any)

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.

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

dict(str, Any)

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()

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

dict(str, Any)

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

dict[str, Any]

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

dict[str, Any]

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

dict[str, Any]

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

None

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

Dict[str, str]

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

StorageStreamDownloader

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

bool

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

BlobClient

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

BlobClient

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

dict(str, str)

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

BlobProperties

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

Dict[str, str]

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

tuple(list(BlobBlock), list(BlobBlock))

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

tuple(list(dict(str, str), list(dict(str, str))

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

tuple(list(dict(str, str), list(dict(str, str))

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

ItemPaged[PageRange]

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

BlobQueryReader

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

dict(str, Any)

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

dict(str, Any)

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)

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

Dict[str, Any]

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

Dict[str, Any]

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

Dict[str, str]

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

Dict[str, Union[str, datetime, bool]]

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

None

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

dict(str, Any)

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

None

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

dict[str, Any]

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

dict[str, Any]

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

dict[str, Union[str, datetime]]

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

None

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

dict[str, Any]

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.

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

dict(str, Any)

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.

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

De locatiemodus die de client momenteel gebruikt.

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

De volledige URL van het primaire eindpunt.

De hostnaam van het primaire eindpunt.

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

ValueError

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.

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

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.

Delen via

BlobClient Klas

Constructor

Parameters

Methoden

abort_copy

Parameters

Retourtype

acquire_lease

Parameters

Retouren

Retourtype

append_block

Parameters

Retouren

Retourtype

append_block_from_url

Parameters

clear_page

Parameters

Retouren

Retourtype

close

commit_block_list

Parameters

Retouren

Retourtype

create_append_blob

Parameters

Retouren

Retourtype

create_page_blob

Parameters

Retouren

Retourtype

create_snapshot

Parameters

Retouren

Retourtype

delete_blob

Parameters

Retourtype

delete_immutability_policy

Parameters

Retouren

Retourtype

download_blob

Parameters

Retouren

Retourtype

exists

Parameters

Retouren

Retourtype

from_blob_url

Parameters

Retouren

Retourtype

from_connection_string

Parameters

Retouren

Retourtype

get_account_information

Retouren

Retourtype

get_blob_properties

Parameters

Retouren

Retourtype

get_blob_tags

Parameters

Retouren

Retourtype

get_block_list

Parameters

Retouren

Retourtype

get_page_range_diff_for_managed_disk

Parameters

Retouren