BlobClient Klas
Een client voor interactie met een specifieke blob, hoewel die blob mogelijk nog niet bestaat.
Klik hier voor meer optionele configuratie.
- Overname
-
azure.storage.blob._shared.base_client.StorageAccountHostsMixinBlobClientazure.storage.blob._encryption.StorageEncryptionMixinBlobClient
Constructor
BlobClient(account_url: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any)Parameters
- account_url
- str
De URI naar het opslagaccount. Als u een client wilt maken op basis van de volledige URI voor de blob, gebruikt u de from_blob_url klassemethode.
- blob_name
- str
De naam van de blob waarmee u wilt communiceren. Indien opgegeven, overschrijft deze waarde een blobwaarde die is opgegeven in de blob-URL.
- snapshot
- str
De optionele blob-momentopname waarop moet worden uitgevoerd. Dit kan de tekenreeks van de momentopname-id zijn of het antwoord dat wordt geretourneerd door create_snapshot.
- credential
De referenties waarmee moet worden geverifieerd. Dit is optioneel als de account-URL al een SAS-token heeft. De waarde kan een SAS-tokentekenreeks zijn, een exemplaar van een AzureSasCredential of AzureNamedKeyCredential van azure.core.credentials, een gedeelde toegangssleutel voor een account of een exemplaar van een TokenCredentials-klasse van azure.identity. Als de resource-URI al een SAS-token bevat, wordt dit genegeerd ten gunste van een expliciete referentie
- behalve in het geval van AzureSasCredential, waarbij de conflicterende SAS-tokens een ValueError genereren. Als u een exemplaar van AzureNamedKeyCredential gebruikt, moet 'naam' de naam van het opslagaccount zijn en moet 'sleutel' de sleutel van het opslagaccount zijn.
- api_version
- str
De storage-API-versie die moet worden gebruikt voor aanvragen. De standaardwaarde is de meest recente serviceversie die compatibel is met de huidige SDK. Instellen op een oudere versie kan leiden tot verminderde compatibiliteit van functies.
Nieuw in versie 12.2.0.
- secondary_hostname
- str
De hostnaam van het secundaire eindpunt.
- max_block_size
- int
De maximale segmentgrootte voor het uploaden van een blok-blob in segmenten.
De standaardwaarde is 4*1024*1024 of 4 MB.
- max_single_put_size
- int
Als de blobgrootte kleiner is dan of gelijk is aan max_single_put_size, wordt de blob geüpload met slechts één HTTP PUT-aanvraag. Als de blob groter is dan max_single_put_size, wordt de blob geüpload in segmenten. De standaardwaarde is 64*1024*1024 of 64 MB.
- min_large_block_upload_threshold
- int
De minimale segmentgrootte die is vereist om het geheugenefficiënte algoritme te gebruiken bij het uploaden van een blok-blob. De standaardwaarde is 4*1024*1024+1.
- use_byte_buffer
- bool
Gebruik een bytebuffer voor blok-blobuploads. Standaard ingesteld op False.
- max_page_size
- int
De maximale segmentgrootte voor het uploaden van een pagina-blob. De standaardwaarde is 4*1024*1024 of 4 MB.
- max_single_get_size
- int
De maximale grootte voor een blob die in één aanroep moet worden gedownload. Het overschreden deel wordt in segmenten gedownload (kan parallel zijn). De standaardwaarde is 32*1024*1024 of 32 MB.
- max_chunk_get_size
- int
De maximale segmentgrootte die wordt gebruikt voor het downloaden van een blob. De standaardwaarde is 4*1024*1024 of 4 MB.
- version_id
- str
De parameter versie-id is een ondoorzichtige DateTime-waarde die, indien aanwezig, aangeeft welke versie van de blob moet worden uitgevoerd.
Methoden
| abort_copy |
Een lopende kopieerbewerking afbreken. Hierdoor blijft een doel-blob over met nul lengte en volledige metagegevens. Er treedt een fout op als de kopieerbewerking al is beëindigd. |
| acquire_lease |
Vraagt een nieuwe lease aan. Als de blob geen actieve lease heeft, maakt de Blob-service een lease op de blob en retourneert een nieuwe lease. |
| append_block |
Hiermee wordt een nieuw gegevensblok doorgevoerd aan het einde van de bestaande toevoeg-blob. |
| append_block_from_url |
Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob, waarbij de inhoud wordt gelezen uit een bron-URL. |
| clear_page |
Wist een reeks pagina's. |
| close |
Deze methode is het sluiten van de sockets die door de client zijn geopend. Deze hoeft niet te worden gebruikt bij gebruik met een contextbeheerder. |
| commit_block_list |
Met de bewerking Lijst met blokkeringen doorvoeren wordt een blob geschreven door de lijst met blok-id's waaruit de blob bestaat op te geven. |
| create_append_blob |
Hiermee maakt u een nieuwe toevoeg-blob. Met deze bewerking maakt u een nieuwe toevoeg-blob met lengte 0. De inhoud van een bestaande blob wordt overschreven met de zojuist geïnitialiseerde toevoeg-blob. Als u inhoud wilt toevoegen aan de toevoeg-blob, roept u de append_block methode of append_block_from_url aan. |
| create_page_blob |
Hiermee maakt u een nieuwe pagina-blob met de opgegeven grootte. |
| create_snapshot |
Hiermee maakt u een momentopname van de blob. Een momentopname is een alleen-lezen versie van een blob die op een bepaald moment is gemaakt. Deze kan worden gelezen, gekopieerd of verwijderd, maar niet worden gewijzigd. Momentopnamen bieden een manier om een back-up te maken van een blob zoals deze op een moment in de tijd wordt weergegeven. Een momentopname van een blob heeft dezelfde naam als de basis-blob van waaruit de momentopname wordt gemaakt, waarbij een DateTime-waarde wordt toegevoegd om aan te geven op welk tijdstip de momentopname is gemaakt. |
| delete_blob |
Hiermee wordt de opgegeven blob gemarkeerd voor verwijdering. De blob wordt later verwijderd tijdens de garbagecollection. Als u een blob wilt verwijderen, moet u alle momentopnamen verwijderen. U kunt beide tegelijk verwijderen met de bewerking delete_blob(). Als een bewaarbeleid voor verwijderen is ingeschakeld voor de service, wordt met deze bewerking de blob voorlopig verwijderd en wordt de blob gedurende een opgegeven aantal dagen bewaard. Na het opgegeven aantal dagen worden de gegevens van de blob verwijderd uit de service tijdens de garbagecollection. Voorlopig verwijderde blob is toegankelijk via list_blobs de optie include=['deleted']. Voorlopig verwijderde blob kan worden hersteld met behulp van een <xref:azure.storage.blob.undelete> bewerking. |
| delete_immutability_policy |
Met de bewerking Onveranderbaarheidsbeleid verwijderen wordt het onveranderbaarheidsbeleid op de blob verwijderd. Nieuw in versie 12.10.0: deze bewerking is geïntroduceerd in API-versie '2020-10-02'. |
| download_blob |
Hiermee downloadt u een blob naar de StorageStreamDownloader. De methode readall() moet worden gebruikt om alle inhoud te lezen of readinto() moet worden gebruikt om de blob in een stream te downloaden. Het gebruik van chunks() retourneert een iterator waarmee de gebruiker de inhoud in segmenten kan herhalen. |
| exists |
Retourneert True als er een blob bestaat met de gedefinieerde parameters en retourneert anders False. |
| from_blob_url |
BlobClient maken op basis van een blob-URL. Dit biedt geen ondersteuning voor aangepaste blob-URL met /in blobnaam. |
| from_connection_string |
BlobClient maken op basis van een verbindingsreeks. |
| get_account_information |
Hiermee haalt u informatie op met betrekking tot het opslagaccount waarin de blob zich bevindt. De informatie kan ook worden opgehaald als de gebruiker een SAS voor een container of blob heeft. De sleutels in de geretourneerde woordenlijst bevatten 'sku_name' en 'account_kind'. |
| get_blob_properties |
Retourneert alle door de gebruiker gedefinieerde metagegevens, standaard-HTTP-eigenschappen en systeemeigenschappen voor de blob. De inhoud van de blob wordt niet geretourneerd. |
| get_blob_tags |
Met de bewerking Tags ophalen kunnen gebruikers tags ophalen op een blob of een specifieke blobversie of momentopname. Nieuw in versie 12.4.0: deze bewerking is geïntroduceerd in API-versie '2019-12-12'. |
| get_block_list |
Met de bewerking Blokkeringslijst ophalen wordt de lijst met blokken opgehaald die zijn geüpload als onderdeel van een blok-blob. |
| get_page_range_diff_for_managed_disk |
Retourneert de lijst met geldige paginabereiken voor een beheerde schijf of momentopname. Notitie Deze bewerking is alleen beschikbaar voor beheerde schijfaccounts. Nieuw in versie 12.2.0: deze bewerking is geïntroduceerd in API-versie '2019-07-07'. |
| get_page_ranges |
AFGESCHAFT: retourneert de lijst met geldige paginabereiken voor een pagina-blob of momentopname van een pagina-blob. |
| list_page_ranges |
Retourneert de lijst met geldige paginabereiken voor een pagina-blob of momentopname van een pagina-blob. Als previous_snapshot is opgegeven, is het resultaat een verschil van wijzigingen tussen de doel-blob en de vorige momentopname. |
| query_blob |
Hiermee kunnen gebruikers blob-/of blobmomentopnamegegevens selecteren/projecteren door eenvoudige query-expressies op te geven. Deze bewerking retourneert een BlobQueryReader. Gebruikers moeten readall() of readinto() gebruiken om querygegevens op te halen. |
| resize_blob |
Hiermee wijzigt u de grootte van een pagina-blob in de opgegeven grootte. Als de opgegeven waarde kleiner is dan de huidige grootte van de blob, worden alle pagina's boven de opgegeven waarde gewist. |
| seal_append_blob |
De bewerking Seal verzegelt de toevoeg-blob zodat deze alleen-lezen is. Nieuw in versie 12.4.0. |
| set_blob_metadata |
Hiermee stelt u door de gebruiker gedefinieerde metagegevens voor de blob in als een of meer naam-waardeparen. |
| set_blob_tags |
Met de bewerking Tags instellen kunnen gebruikers tags instellen op een blob of een specifieke blobversie, maar geen momentopname. Elke aanroep van deze bewerking vervangt alle bestaande tags die aan de blob zijn gekoppeld. Als u alle tags uit de blob wilt verwijderen, roept u deze bewerking aan zonder tags in te stellen. Nieuw in versie 12.4.0: deze bewerking is geïntroduceerd in API-versie '2019-12-12'. |
| set_http_headers |
Hiermee stelt u systeemeigenschappen voor de blob in. Als er één eigenschap is ingesteld voor de content_settings, worden alle eigenschappen overschreven. |
| set_immutability_policy |
Met de bewerking Onveranderbaarheidsbeleid instellen wordt het onveranderbaarheidsbeleid ingesteld op de blob. Nieuw in versie 12.10.0: Deze bewerking is geïntroduceerd in API-versie '2020-10-02'. |
| set_legal_hold |
Met de bewerking Juridische bewaring instellen wordt een juridische bewaring ingesteld voor de blob. Nieuw in versie 12.10.0: deze bewerking is geïntroduceerd in API-versie '2020-10-02'. |
| set_premium_page_blob_tier |
Hiermee stelt u de pagina-bloblagen op de blob in. Deze API wordt alleen ondersteund voor pagina-blobs op Premium-accounts. |
| set_sequence_number |
Hiermee stelt u het volgnummer van de blob in. |
| set_standard_blob_tier |
Met deze bewerking stelt u de laag in op een blok-blob. De laag van een blok-blob bepaalt het opslagtype Dynamisch/Statisch/Archief. Met deze bewerking wordt de ETag van de blob niet bijgewerkt. |
| stage_block |
Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob. |
| stage_block_from_url |
Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob waarin de inhoud van een URL wordt gelezen. |
| start_copy_from_url |
Kopieert een blob van de opgegeven URL. Deze bewerking retourneert een woordenlijst met copy_status en copy_id, die kan worden gebruikt om de status van de kopieerbewerking te controleren of af te breken. copy_status is 'geslaagd' als de kopie synchroon is voltooid of 'in behandeling' als de kopie asynchroon is gestart. Voor asynchrone kopieën kan de status worden gecontroleerd door de get_blob_properties methode te pollen en de kopieerstatus te controleren. Stel requires_sync in op True om af te dwingen dat de kopie synchroon is. De Blob-service kopieert blobs op basis van best-effort. De bron-blob voor een kopieerbewerking kan een blok-blob, een toevoeg-blob of een pagina-blob zijn. Als de doel-blob al bestaat, moet deze van hetzelfde blobtype zijn als de bron-blob. Elke bestaande doel-blob wordt overschreven. De doel-blob kan niet worden gewijzigd terwijl er een kopieerbewerking wordt uitgevoerd. Wanneer u kopieert vanuit een pagina-blob, maakt de Blob-service een doelpagina-blob met de lengte van de bron-blob, die in eerste instantie alle nullen bevat. Vervolgens worden de bronpaginabereiken opgesomd en worden niet-lege bereiken gekopieerd. Voor een blok- of toevoeg-blob maakt de Blob-service een toegewezen blob met de lengte nul voordat deze bewerking wordt geretourneerd. Wanneer u kopieert vanuit een blok-blob, worden alle vastgelegde blokken en de bijbehorende blok-id's gekopieerd. Niet-doorgevoerde blokken worden niet gekopieerd. Aan het einde van de kopieerbewerking heeft de doel-blob hetzelfde aantal vastgelegde blokken als de bron. Bij het kopiëren vanuit een toevoeg-blob worden alle vastgelegde blokken gekopieerd. Aan het einde van de kopieerbewerking heeft de doel-blob hetzelfde aantal vastgelegde blokken als de bron. |
| undelete_blob |
Herstelt voorlopig verwijderde blobs of momentopnamen. De bewerking is alleen geslaagd als deze wordt gebruikt binnen het opgegeven aantal dagen dat is ingesteld in het bewaarbeleid voor verwijderen. Als blobversiebeheer is ingeschakeld, kan de basis-blob niet worden hersteld met deze methode. Gebruik start_copy_from_url in plaats daarvan met de URL van de blobversie die u wilt promoveren naar de huidige versie. |
| upload_blob |
Hiermee maakt u een nieuwe blob op basis van een gegevensbron met automatische segmentering. |
| upload_blob_from_url |
Hiermee maakt u een nieuwe blok-blob waarin de inhoud van de blob wordt gelezen vanaf een bepaalde URL. De inhoud van een bestaande blob wordt overschreven met de nieuwe blob. |
| upload_page |
Met de bewerking Pagina's uploaden wordt een reeks pagina's naar een pagina-blob geschreven. |
| upload_pages_from_url |
Met de bewerking Pagina's uploaden wordt een reeks pagina's naar een pagina-blob geschreven waar de inhoud wordt gelezen vanuit een URL. |
abort_copy
Een lopende kopieerbewerking afbreken.
Hierdoor blijft een doel-blob over met nul lengte en volledige metagegevens. Er treedt een fout op als de kopieerbewerking al is beëindigd.
abort_copy(copy_id: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> NoneParameters
- copy_id
- str of BlobProperties
De kopieerbewerking die moet worden afgebroken. Dit kan een id-tekenreeks of een exemplaar van BlobProperties zijn.
Retourtype
acquire_lease
Vraagt een nieuwe lease aan.
Als de blob geen actieve lease heeft, maakt de Blob-service een lease op de blob en retourneert een nieuwe lease.
acquire_lease(lease_duration: int = -1, lease_id: str | None = None, **kwargs: Any) -> BlobLeaseClientParameters
- lease_duration
- int
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
Voorgestelde lease-id, in een GUID-tekenreeksindeling. De Blob-service retourneert 400 (ongeldige aanvraag) als de voorgestelde lease-id niet de juiste indeling heeft.
- if_modified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.
- if_unmodified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.
- etag
- str
Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .
- match_condition
- MatchConditions
De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde.
bijvoorbeeld "\"tagname\"='my tag'"
Nieuw in versie 12.4.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retouren
Een BlobLeaseClient-object.
Retourtype
append_block
Hiermee wordt een nieuw gegevensblok doorgevoerd aan het einde van de bestaande toevoeg-blob.
append_block(data: bytes | str | Iterable[AnyStr] | IO[AnyStr], length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]Parameters
Inhoud van het blok. Dit kunnen bytes, tekst, een itereerbaar of een bestand-achtig object zijn.
- 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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.
Nieuw in versie 12.2.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
Blob bijgewerkt eigenschapsdict (Etag, laatst gewijzigd, offset toevoegen, toegewezen aantal blokken).
Retourtype
append_block_from_url
Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob, waarbij de inhoud wordt gelezen uit een bron-URL.
append_block_from_url(copy_source_url: str, source_offset: int | None = None, source_length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]Parameters
- copy_source_url
- str
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
Dit geeft het begin aan van het bereik van bytes (inclusief) dat moet worden genomen uit de kopieerbron.
- source_length
- int
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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.
Nieuw in versie 12.2.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
- source_authorization
- str
Verifiëren als een service-principal met behulp van een clientgeheim voor toegang tot een bron-blob. Zorg ervoor dat bearer het voorvoegsel is van de source_authorization tekenreeks.
clear_page
Wist een reeks pagina's.
clear_page(offset: int, length: int, **kwargs: Any) -> Dict[str, str | datetime]Parameters
- offset
- int
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
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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).
Retourtype
close
Deze methode is het sluiten van de sockets die door de client zijn geopend. Deze hoeft niet te worden gebruikt bij gebruik met een contextbeheerder.
close()commit_block_list
Met de bewerking Lijst met blokkeringen doorvoeren wordt een blob geschreven door de lijst met blok-id's waaruit de blob bestaat op te geven.
commit_block_list(block_list: List[BlobBlock], content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]Parameters
- 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.
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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.
Nieuw in versie 12.2.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).
Retourtype
create_append_blob
Hiermee maakt u een nieuwe toevoeg-blob. Met deze bewerking maakt u een nieuwe toevoeg-blob met lengte 0. De inhoud van een bestaande blob wordt overschreven met de zojuist geïnitialiseerde toevoeg-blob. Als u inhoud wilt toevoegen aan de toevoeg-blob, roept u de append_block methode of append_block_from_url aan.
create_append_blob(content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]Parameters
- content_settings
- ContentSettings
ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen. Wordt gebruikt voor het instellen van inhoudstype, codering, taal, verwijdering, md5 en cachebeheer.
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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.
Nieuw in versie 12.2.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).
Retourtype
create_page_blob
Hiermee maakt u een nieuwe pagina-blob met de opgegeven grootte.
create_page_blob(size: int, content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, premium_page_blob_tier: str | PremiumPageBlobTier | None = None, **kwargs) -> Dict[str, str | datetime]Parameters
- size
- int
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
ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen. Wordt gebruikt voor het instellen van inhoudstype, codering, taal, verwijdering, md5 en cachebeheer.
- 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.
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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.
Nieuw in versie 12.2.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).
Retourtype
create_snapshot
Hiermee maakt u een momentopname van de blob.
Een momentopname is een alleen-lezen versie van een blob die op een bepaald moment is gemaakt. Deze kan worden gelezen, gekopieerd of verwijderd, maar niet worden gewijzigd. Momentopnamen bieden een manier om een back-up te maken van een blob zoals deze op een moment in de tijd wordt weergegeven.
Een momentopname van een blob heeft dezelfde naam als de basis-blob van waaruit de momentopname wordt gemaakt, waarbij een DateTime-waarde wordt toegevoegd om aan te geven op welk tijdstip de momentopname is gemaakt.
create_snapshot(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]Parameters
- 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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.
Nieuw in versie 12.2.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retouren
Blob bijgewerkt eigenschapsdict (momentopname-id, Etag en laatst gewijzigd).
Retourtype
delete_blob
Hiermee wordt de opgegeven blob gemarkeerd voor verwijdering.
De blob wordt later verwijderd tijdens de garbagecollection. Als u een blob wilt verwijderen, moet u alle momentopnamen verwijderen. U kunt beide tegelijk verwijderen met de bewerking delete_blob().
Als een bewaarbeleid voor verwijderen is ingeschakeld voor de service, wordt met deze bewerking de blob voorlopig verwijderd en wordt de blob gedurende een opgegeven aantal dagen bewaard. Na het opgegeven aantal dagen worden de gegevens van de blob verwijderd uit de service tijdens de garbagecollection. Voorlopig verwijderde blob is toegankelijk via list_blobs de optie include=['deleted']. Voorlopig verwijderde blob kan worden hersteld met behulp van een <xref:azure.storage.blob.undelete> bewerking.
delete_blob(delete_snapshots: str = None, **kwargs: Any) -> NoneParameters
- delete_snapshots
- str
Vereist als de blob gekoppelde momentopnamen bevat. De waarden zijn:
'alleen': hiermee verwijdert u alleen de momentopnamen van blobs.
'include': hiermee verwijdert u de blob samen met alle momentopnamen.
- version_id
- str
De parameter versie-id is een ondoorzichtige DateTime-waarde die, indien aanwezig, de versie van de blob aangeeft die moet worden verwijderd.
Nieuw in versie 12.4.0.
Dit trefwoordargument is geïntroduceerd in API-versie '2019-12-12'.
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. Indien opgegeven, slaagt delete_blob alleen als de lease van de blob actief is en overeenkomt met deze id. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
- if_modified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.
- if_unmodified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.
- etag
- str
Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .
- match_condition
- MatchConditions
De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde.
bijvoorbeeld "\"tagname\"='my tag'"
Nieuw in versie 12.4.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retourtype
delete_immutability_policy
Met de bewerking Onveranderbaarheidsbeleid verwijderen wordt het onveranderbaarheidsbeleid op de blob verwijderd.
Nieuw in versie 12.10.0: deze bewerking is geïntroduceerd in API-versie '2020-10-02'.
delete_immutability_policy(**kwargs: Any) -> NoneParameters
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retouren
Sleutelwaardeparen van blobtags.
Retourtype
download_blob
Hiermee downloadt u een blob naar de StorageStreamDownloader. De methode readall() moet worden gebruikt om alle inhoud te lezen of readinto() moet worden gebruikt om de blob in een stream te downloaden. Het gebruik van chunks() retourneert een iterator waarmee de gebruiker de inhoud in segmenten kan herhalen.
download_blob(offset: int = None, length: int = None, *, encoding: str, **kwargs) -> StorageStreamDownloader[str]Parameters
- offset
- int
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
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.
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.
Een callback om de voortgang van een langlopende download bij te houden. De handtekening is function(current: int, total: int) waarbij current het aantal bytes is dat tot nu toe is overgedragen en total de totale grootte van de download.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier. Deze methode kan meerdere aanroepen naar de service uitvoeren en de time-out is van toepassing op elke aanroep afzonderlijk. meerdere aanroepen naar de Azure-service en de time-out is van toepassing op elke aanroep afzonderlijk.
Retouren
Een streamingobject (StorageStreamDownloader)
Retourtype
exists
Retourneert True als er een blob bestaat met de gedefinieerde parameters en retourneert anders False.
exists(**kwargs: Any) -> boolParameters
- version_id
- str
De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de versie van de blob aangeeft om te controleren of deze bestaat.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
booleaans
Retourtype
from_blob_url
BlobClient maken op basis van een blob-URL. Dit biedt geen ondersteuning voor aangepaste blob-URL met /in blobnaam.
from_blob_url(blob_url: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> SelfParameters
- blob_url
- str
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:./>
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
De optionele blob-momentopname waarop moet worden uitgevoerd. Dit kan de tekenreeks van de momentopname-id zijn of het antwoord dat wordt geretourneerd van create_snapshot. Als dit is opgegeven, wordt de momentopname in de URL overschreven.
- version_id
- str
De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de versie van de blob aangeeft waarop moet worden gewerkt.
Retouren
Een Blob-client.
Retourtype
from_connection_string
BlobClient maken op basis van een verbindingsreeks.
from_connection_string(conn_str: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> SelfParameters
- snapshot
- str
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:./>
De referenties waarmee moet worden geverifieerd. Dit is optioneel als de account-URL al een SAS-token heeft of als de verbindingsreeks al gedeelde toegangssleutelwaarden heeft. De waarde kan een SAS-tokentekenreeks zijn, een exemplaar van een AzureSasCredential of AzureNamedKeyCredential van azure.core.credentials, een gedeelde toegangssleutel voor het account of een exemplaar van een TokenCredentials-klasse van azure.identity. Referenties die hier worden opgegeven, hebben voorrang op de referenties in de verbindingsreeks. Als u een exemplaar van AzureNamedKeyCredential gebruikt, moet 'name' de naam van het opslagaccount zijn en moet 'sleutel' de sleutel van het opslagaccount zijn.
- version_id
- str
De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de versie van de blob aangeeft waarop moet worden gewerkt.
Retouren
Een Blob-client.
Retourtype
get_account_information
Hiermee haalt u informatie op met betrekking tot het opslagaccount waarin de blob zich bevindt.
De informatie kan ook worden opgehaald als de gebruiker een SAS voor een container of blob heeft. De sleutels in de geretourneerde woordenlijst bevatten 'sku_name' en 'account_kind'.
get_account_information(**kwargs: Any) -> Dict[str, str]Retouren
Een dictaat met accountgegevens (SKU en accounttype).
Retourtype
get_blob_properties
Retourneert alle door de gebruiker gedefinieerde metagegevens, standaard-HTTP-eigenschappen en systeemeigenschappen voor de blob. De inhoud van de blob wordt niet geretourneerd.
get_blob_properties(**kwargs: Any) -> BlobPropertiesParameters
- 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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
BlobProperties
Retourtype
get_blob_tags
Met de bewerking Tags ophalen kunnen gebruikers tags ophalen op een blob of een specifieke blobversie of momentopname.
Nieuw in versie 12.4.0: deze bewerking is geïntroduceerd in API-versie '2019-12-12'.
get_blob_tags(**kwargs: Any) -> Dict[str, str]Parameters
- version_id
- str
De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de versie van de blob aangeeft waaraan tags moeten worden toegevoegd.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op de doel-blob met een overeenkomende waarde.
bijvoorbeeld "\"tagname\"='my tag'"
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
Sleutelwaardeparen van blobtags.
Retourtype
get_block_list
Met de bewerking Blokkeringslijst ophalen wordt de lijst met blokken opgehaald die zijn geüpload als onderdeel van een blok-blob.
get_block_list(block_list_type: str | None = 'committed', **kwargs: Any) -> Tuple[List[BlobBlock], List[BlobBlock]]Parameters
- block_list_type
- str
Hiermee geeft u op of de lijst met vastgelegde blokken, de lijst met niet-doorgevoerde blokken of beide lijsten samen moet retourneren. Mogelijke waarden zijn: 'committed', 'uncommitted', 'all'
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op de doel-blob met een overeenkomende waarde.
Nieuw in versie 12.4.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
Een tuple van twee lijsten - vastgelegde en niet-doorgevoerde blokken
Retourtype
get_page_range_diff_for_managed_disk
Retourneert de lijst met geldige paginabereiken voor een beheerde schijf of momentopname.
Notitie
Deze bewerking is alleen beschikbaar voor beheerde schijfaccounts.
Nieuw in versie 12.2.0: deze bewerking is geïntroduceerd in API-versie '2019-07-07'.
get_page_range_diff_for_managed_disk(previous_snapshot_url: str, offset: int | None = None, length: int | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]Parameters
- previous_snapshot_url
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
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.
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
- if_modified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.
- if_unmodified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.
- etag
- str
Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .
- match_condition
- MatchConditions
De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retouren
Een tuple van twee lijsten met paginabereiken als woordenlijsten met de toetsen 'begin' en 'eind'. Het eerste element zijn gevulde paginabereiken, het tweede element is gewiste paginabereiken.
Retourtype
get_page_ranges
AFGESCHAFT: retourneert de lijst met geldige paginabereiken voor een pagina-blob of momentopname van een pagina-blob.
get_page_ranges(offset: int | None = None, length: int | None = None, previous_snapshot_diff: str | Dict[str, Any] | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]Parameters
- offset
- int
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_diff
- str
De diff-parameter voor momentopnamen die een ondoorzichtige DateTime-waarde bevat die een eerdere blob-momentopname aangeeft die moet worden vergeleken met een recentere momentopname of de huidige blob.
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
- if_modified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.
- if_unmodified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.
- etag
- str
Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .
- match_condition
- MatchConditions
De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde.
bijvoorbeeld "\"tagname\"='my tag'"
Nieuw in versie 12.4.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retouren
Een tuple van twee lijsten met paginabereiken als woordenlijsten met de toetsen 'begin' en 'eind'. Het eerste element zijn gevulde paginabereiken, het tweede element is gewiste paginabereiken.
Retourtype
list_page_ranges
Retourneert de lijst met geldige paginabereiken voor een pagina-blob of momentopname van een pagina-blob. Als previous_snapshot is opgegeven, is het resultaat een verschil van wijzigingen tussen de doel-blob en de vorige momentopname.
list_page_ranges(*, offset: int | None = None, length: int | None = None, previous_snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> ItemPaged[PageRange]Parameters
- offset
- int
Begin van het bytebereik dat moet worden gebruikt voor het verkrijgen van geldige paginabereiken. Als er geen lengte wordt opgegeven, worden alle bytes na de offset doorzocht. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de beginverschuiving moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.
- length
- int
Het aantal bytes dat moet worden gebruikt voor het ophalen van geldige paginabereiken. Als de lengte wordt opgegeven, moet er een verschuiving worden opgegeven. Dit bereik retourneert geldige paginabereiken vanaf het begin tot de opgegeven lengte. Pagina's moeten worden uitgelijnd met grenzen van 512 bytes, de beginverschuiving moet een modulus van 512 zijn en de lengte moet een modulus van 512 zijn.
Een momentopnamewaarde die aangeeft dat het antwoord alleen pagina's bevat die zijn gewijzigd tussen de doel-blob en de vorige momentopname. Gewijzigde pagina's bevatten zowel bijgewerkte als gewiste pagina's. De doel-blob kan een momentopname zijn, zolang de momentopname die is opgegeven door previous_snapshot de oudere van de twee is.
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
- if_modified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.
- if_unmodified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.
- etag
- str
Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .
- match_condition
- MatchConditions
De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde.
bijvoorbeeld "\"tagname\"='my tag'"
Nieuw in versie 12.4.0.
- results_per_page
- int
Het maximum aantal paginabereiken dat per API-aanroep moet worden opgehaald.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retouren
Een iterable (automatisch pagineren) van PageRange.
Retourtype
query_blob
Hiermee kunnen gebruikers blob-/of blobmomentopnamegegevens selecteren/projecteren door eenvoudige query-expressies op te geven. Deze bewerking retourneert een BlobQueryReader. Gebruikers moeten readall() of readinto() gebruiken om querygegevens op te halen.
query_blob(query_expression: str, **kwargs: Any) -> BlobQueryReaderParameters
- query_expression
- str
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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf wordt opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retouren
Een streaming-object (BlobQueryReader)
Retourtype
resize_blob
Hiermee wijzigt u de grootte van een pagina-blob in de opgegeven grootte.
Als de opgegeven waarde kleiner is dan de huidige grootte van de blob, worden alle pagina's boven de opgegeven waarde gewist.
resize_blob(size: int, **kwargs: Any) -> Dict[str, str | datetime]Parameters
- size
- int
Grootte die wordt gebruikt om het formaat van de blob te wijzigen. De maximale grootte voor een pagina-blob is maximaal 1 TB. De pagina-blobgrootte moet worden uitgelijnd op een grens van 512 bytes.
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
- if_modified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.
- if_unmodified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.
- etag
- str
Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .
- match_condition
- MatchConditions
De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde.
bijvoorbeeld "\"tagname\"='my tag'"
Nieuw in versie 12.4.0.
- premium_page_blob_tier
- PremiumPageBlobTier
Een pagina-bloblaagwaarde waarop de blob moet worden ingesteld. De laag is gerelateerd aan de grootte van de blob en het aantal toegestane IOPS. Dit is alleen van toepassing op pagina-blobs in Premium Storage-accounts.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retouren
Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).
Retourtype
seal_append_blob
De bewerking Seal verzegelt de toevoeg-blob zodat deze alleen-lezen is.
Nieuw in versie 12.4.0.
seal_append_blob(**kwargs) -> Dict[str, str | datetime | int]Parameters
- appendpos_condition
- int
Optionele voorwaardelijke header, die alleen wordt gebruikt voor de bewerking Toevoegblok. Een getal dat de byte offset aangeeft die moet worden vergeleken. Toevoegblok slaagt alleen als de toevoegpositie gelijk is aan dit getal. Als dit niet zo is, mislukt de aanvraag met de fout AppendPositionConditionNotMet (HTTP-statuscode 412 - Voorwaarde mislukt).
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
- if_modified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.
- if_unmodified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.
- etag
- str
Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .
- match_condition
- MatchConditions
De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retouren
Blob bijgewerkt eigenschapsdict (Etag, laatst gewijzigd, toevoeg offset, doorgevoerd aantal blokken).
Retourtype
set_blob_metadata
Hiermee stelt u door de gebruiker gedefinieerde metagegevens voor de blob in als een of meer naam-waardeparen.
set_blob_metadata(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]Parameters
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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.
Nieuw in versie 12.2.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd)
set_blob_tags
Met de bewerking Tags instellen kunnen gebruikers tags instellen op een blob of een specifieke blobversie, maar geen momentopname. Elke aanroep van deze bewerking vervangt alle bestaande tags die aan de blob zijn gekoppeld. Als u alle tags uit de blob wilt verwijderen, roept u deze bewerking aan zonder tags in te stellen.
Nieuw in versie 12.4.0: deze bewerking is geïntroduceerd in API-versie '2019-12-12'.
set_blob_tags(tags: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, Any]Parameters
Naam-waardeparen die zijn gekoppeld aan de blob als tag. Tags zijn hoofdlettergevoelig.
De tagset kan maximaal 10 tags bevatten. Tagsleutels moeten tussen 1 en 128 tekens zijn en tagwaarden moeten tussen 0 en 256 tekens zijn.
Geldige tagsleutel en waardetekens zijn: kleine letters en hoofdletters, cijfers (0-9), spatie ( >><<), plusteken (+), minteken (-), punt (.), solidus (/), dubbele punt (:), is gelijk aan (=), onderstrepingsteken (_)
- version_id
- str
De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de versie van de blob aangeeft waaraan tags moeten worden toegevoegd.
- validate_content
- bool
Als dit waar is, wordt een MD5-hash van de inhoud van de tags berekend. De opslagservice controleert de hash van de inhoud die is aangekomen met de hash die is verzonden. Dit is vooral waardevol voor het detecteren van bitflips op de kabel als u http gebruikt in plaats van https, omdat https (de standaardinstelling) al wordt gevalideerd. Houd er rekening mee dat deze MD5-hash niet wordt opgeslagen met de blob.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op de doel-blob met een overeenkomende waarde.
bijvoorbeeld "\"tagname\"='my tag'"
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd)
Retourtype
set_http_headers
Hiermee stelt u systeemeigenschappen voor de blob in.
Als er één eigenschap is ingesteld voor de content_settings, worden alle eigenschappen overschreven.
set_http_headers(content_settings: ContentSettings | None = None, **kwargs: Any) -> NoneParameters
- 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.
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. De waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
- if_modified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds de opgegeven tijd is gewijzigd.
- if_unmodified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.
- etag
- str
Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .
- match_condition
- MatchConditions
De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags die alleen moeten worden uitgevoerd op blob met een overeenkomende waarde.
bijvoorbeeld "\"tagname\"='my tag'"
Nieuw in versie 12.4.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd)
Retourtype
set_immutability_policy
Met de bewerking Onveranderbaarheidsbeleid instellen wordt het onveranderbaarheidsbeleid ingesteld op de blob.
Nieuw in versie 12.10.0: Deze bewerking is geïntroduceerd in API-versie '2020-10-02'.
set_immutability_policy(immutability_policy: ImmutabilityPolicy, **kwargs: Any) -> Dict[str, str]Parameters
- immutability_policy
- ImmutabilityPolicy
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
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_legal_hold(legal_hold: bool, **kwargs: Any) -> Dict[str, str | datetime | bool]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
set_premium_page_blob_tier
Hiermee stelt u de pagina-bloblagen op de blob in. Deze API wordt alleen ondersteund voor pagina-blobs op Premium-accounts.
set_premium_page_blob_tier(premium_page_blob_tier: str | PremiumPageBlobTier, **kwargs: Any) -> NoneParameters
- 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.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde.
bijvoorbeeld "\"tagname\"='my tag'"
Nieuw in versie 12.4.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
Retourtype
set_sequence_number
Hiermee stelt u het volgnummer van de blob in.
set_sequence_number(sequence_number_action: str | SequenceNumberAction, sequence_number: str | None = None, **kwargs: Any) -> Dict[str, str | datetime]Parameters
- sequence_number_action
- str
Deze eigenschap geeft aan hoe de service het volgnummer van de blob moet wijzigen. Zie SequenceNumberAction voor meer informatie.
- sequence_number
- str
Met deze eigenschap stelt u het volgnummer van de blob in. Het volgnummer is een door de gebruiker beheerde eigenschap die u kunt gebruiken om aanvragen bij te houden en gelijktijdigheidsproblemen te beheren.
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
- if_modified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource sinds het opgegeven tijdstip is gewijzigd.
- if_unmodified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze header op om de bewerking alleen uit te voeren als de resource niet is gewijzigd sinds de opgegeven datum/tijd.
- etag
- str
Een ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .
- match_condition
- MatchConditions
De overeenkomstvoorwaarde die moet worden gebruikt voor de etag.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde.
bijvoorbeeld "\"tagname\"='my tag'"
Nieuw in versie 12.4.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retouren
Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).
Retourtype
set_standard_blob_tier
Met deze bewerking stelt u de laag in op een blok-blob.
De laag van een blok-blob bepaalt het opslagtype Dynamisch/Statisch/Archief. Met deze bewerking wordt de ETag van de blob niet bijgewerkt.
set_standard_blob_tier(standard_blob_tier: str | StandardBlobTier, **kwargs: Any) -> NoneParameters
- standard_blob_tier
- str of StandardBlobTier
Geeft de laag aan die moet worden ingesteld op de blob. Opties zijn onder andere 'Dynamisch', 'Statisch', 'Archiveren'. De dynamische laag is geoptimaliseerd voor het opslaan van gegevens die regelmatig worden geopend. De statische opslaglaag is geoptimaliseerd voor het opslaan van gegevens die zelden worden geopend en die gedurende ten minste een maand worden opgeslagen. De archieflaag is geoptimaliseerd voor het opslaan van gegevens die zelden worden geopend en die gedurende ten minste zes maanden worden opgeslagen met flexibele latentievereisten.
- rehydrate_priority
- RehydratePriority
Geeft de prioriteit aan waarmee een gearchiveerde blob moet worden gerehydrateerd
- version_id
- str
De parameter versie-id is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, aangeeft welke versie van de blob moet worden gedownload.
Nieuw in versie 12.4.0.
Dit trefwoordargument is geïntroduceerd in API-versie '2019-12-12'.
- if_tags_match_condition
- str
Geef een SQL where-component op voor blobtags om alleen te werken op blob met een overeenkomende waarde.
bijvoorbeeld "\"tagname\"='my tag'"
Nieuw in versie 12.4.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
- lease
- BlobLeaseClient of str
Vereist als de blob een actieve lease heeft. Waarde kan een BlobLeaseClient-object zijn of de lease-id als een tekenreeks.
Retourtype
stage_block
Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob.
stage_block(block_id: str, data: Iterable | IO, length: int | None = None, **kwargs) -> Dict[str, Any]Parameters
- block_id
- str
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
De blobgegevens.
- 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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf wordt opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens in de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam worden vermeld. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders wordt er een fout gegenereerd.
Nieuw in versie 12.2.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
Retouren
Dicteren van blob-eigenschap.
Retourtype
stage_block_from_url
Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob waarin de inhoud van een URL wordt gelezen.
stage_block_from_url(block_id: str | int, source_url: str, source_offset: int | None = None, source_length: int | None = None, source_content_md5: bytes | bytearray | None = None, **kwargs) -> Dict[str, Any]Parameters
- block_id
- str
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_offset
- int
Begin van het bytebereik dat moet worden gebruikt voor het blok. Moet worden ingesteld als de bronlengte is opgegeven.
- source_content_md5
- bytearray
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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf wordt opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens in de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam worden vermeld. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders wordt er een fout gegenereerd.
Nieuw in versie 12.2.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
- source_authorization
- str
Verifieer als een service-principal met behulp van een clientgeheim om toegang te krijgen tot een bron-blob. Zorg ervoor dat 'bearer ' het voorvoegsel is van de source_authorization tekenreeks.
Retouren
Dicteren van blob-eigenschap.
Retourtype
start_copy_from_url
Kopieert een blob van de opgegeven URL.
Deze bewerking retourneert een woordenlijst met copy_status en copy_id, die kan worden gebruikt om de status van de kopieerbewerking te controleren of af te breken. copy_status is 'geslaagd' als de kopie synchroon is voltooid of 'in behandeling' als de kopie asynchroon is gestart. Voor asynchrone kopieën kan de status worden gecontroleerd door de get_blob_properties methode te pollen en de kopieerstatus te controleren. Stel requires_sync in op True om af te dwingen dat de kopie synchroon is. De Blob-service kopieert blobs op basis van best-effort.
De bron-blob voor een kopieerbewerking kan een blok-blob, een toevoeg-blob of een pagina-blob zijn. Als de doel-blob al bestaat, moet deze van hetzelfde blobtype zijn als de bron-blob. Elke bestaande doel-blob wordt overschreven. De doel-blob kan niet worden gewijzigd terwijl er een kopieerbewerking wordt uitgevoerd.
Wanneer u kopieert vanuit een pagina-blob, maakt de Blob-service een doelpagina-blob met de lengte van de bron-blob, die in eerste instantie alle nullen bevat. Vervolgens worden de bronpaginabereiken opgesomd en worden niet-lege bereiken gekopieerd.
Voor een blok- of toevoeg-blob maakt de Blob-service een toegewezen blob met de lengte nul voordat deze bewerking wordt geretourneerd. Wanneer u kopieert vanuit een blok-blob, worden alle vastgelegde blokken en de bijbehorende blok-id's gekopieerd. Niet-doorgevoerde blokken worden niet gekopieerd. Aan het einde van de kopieerbewerking heeft de doel-blob hetzelfde aantal vastgelegde blokken als de bron.
Bij het kopiëren vanuit een toevoeg-blob worden alle vastgelegde blokken gekopieerd. Aan het einde van de kopieerbewerking heeft de doel-blob hetzelfde aantal vastgelegde blokken als de bron.
start_copy_from_url(source_url: str, metadata: Dict[str, str] | None = None, incremental_copy: bool = False, **kwargs: Any) -> Dict[str, str | datetime]Parameters
- source_url
- str
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
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
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.
Naam-waardeparen die zijn gekoppeld aan de blob als tag. Tags zijn hoofdlettergevoelig.
De tagset kan maximaal 10 tags bevatten. Tagsleutels moeten tussen 1 en 128 tekens zijn en tagwaarden moeten tussen 0 en 256 tekens zijn.
Geldige codesleutel- en waardetekens zijn: kleine letters en hoofdletters, cijfers (0-9), spatie ( >><<), plusteken (+), minteken (-), punt (.), solidus (/), dubbele punt (:), is gelijk aan (=), onderstrepingsteken (_).
De (hoofdlettergevoelige) letterlijke 'COPY' kan in plaats daarvan worden doorgegeven om tags uit de bron-blob te kopiëren. Deze optie is alleen beschikbaar als incremental_copy=False en requires_sync=True.
Nieuw in versie 12.4.0.
- immutability_policy
- ImmutabilityPolicy
Hiermee geeft u het onveranderbaarheidsbeleid van een blob, blob-momentopname of blobversie op.
Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie '2020-10-02'.
- legal_hold
- bool
Opgegeven als een juridische bewaring moet worden ingesteld op de blob.
Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie '2020-10-02'.
- source_if_modified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de bron-blob is gewijzigd sinds de opgegeven datum/tijd.
- source_if_unmodified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de bron-blob niet is gewijzigd sinds de opgegeven datum/tijd.
- source_etag
- str
De bron-ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .
- source_match_condition
- MatchConditions
De bronovereenkomstvoorwaarde die moet worden gebruikt voor de etag.
- if_modified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de doel-blob is gewijzigd sinds de opgegeven datum/tijd. Als de doel-blob niet is gewijzigd, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt).
- if_unmodified_since
- datetime
Een datum/tijd-waarde. Azure verwacht dat de doorgegeven datumwaarde UTC is. Als tijdzone is opgenomen, worden alle niet-UTC-datums geconverteerd naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is. Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de doel-blob niet is gewijzigd sinds de opgegeven datum/tijd. Als de doel-blob is gewijzigd, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt).
- etag
- str
De doel-ETag-waarde of het jokerteken (*). Wordt gebruikt om te controleren of de resource is gewijzigd en om te handelen volgens de voorwaarde die is opgegeven door de parameter match_condition .
- match_condition
- MatchConditions
De doelovereenkomstvoorwaarde die moet worden gebruikt voor de etag.
- destination_lease
- BlobLeaseClient of str
De lease-id die voor deze header is opgegeven, moet overeenkomen met de lease-id van de doel-blob. Als de aanvraag de lease-id niet bevat of niet geldig is, mislukt de bewerking met statuscode 412 (Voorwaarde is mislukt).
- source_lease
- BlobLeaseClient of str
Geef dit op om de bewerking Blob kopiëren alleen uit te voeren als de opgegeven lease-id overeenkomt met de actieve lease-id van de bron-blob.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier.
- premium_page_blob_tier
- PremiumPageBlobTier
Een pagina-bloblaagwaarde waarop de blob moet worden ingesteld. De laag is gerelateerd aan de grootte van de blob en het aantal toegestane IOPS. Dit is alleen van toepassing op pagina-blobs in Premium Storage-accounts.
- standard_blob_tier
- StandardBlobTier
Een standaard bloblaagwaarde om de blob op in te stellen. Voor deze versie van de bibliotheek is dit alleen van toepassing op blok-blobs in standaardopslagaccounts.
- rehydrate_priority
- RehydratePriority
Geeft de prioriteit aan waarmee een gearchiveerde blob moet worden gerehydrateerd
- seal_destination_blob
- bool
Verzegel de bestemmings-toevoeg-blob. Deze bewerking is alleen bedoeld voor toevoeg-blob.
Nieuw in versie 12.4.0.
- requires_sync
- bool
Hiermee wordt afgedwongen dat de service pas een antwoord retourneert als het kopiëren is voltooid.
- source_authorization
- str
Verifieer als een service-principal met behulp van een clientgeheim om toegang te krijgen tot een bron-blob. Zorg ervoor dat 'bearer ' het voorvoegsel is van de source_authorization tekenreeks. Deze optie is alleen beschikbaar als incremental_copy is ingesteld op Onwaar en requires_sync is ingesteld op Waar.
Nieuw in versie 12.9.0.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt voor het versleutelen van de gegevens in de met de synchronisatie gekopieerde blob. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam worden vermeld. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders wordt er een fout gegenereerd.
Nieuw in versie 12.10.0.
Retouren
Een woordenlijst met kopieereigenschappen (etag, last_modified, copy_id, copy_status).
Retourtype
undelete_blob
Herstelt voorlopig verwijderde blobs of momentopnamen.
De bewerking is alleen geslaagd als deze wordt gebruikt binnen het opgegeven aantal dagen dat is ingesteld in het bewaarbeleid voor verwijderen.
Als blobversiebeheer is ingeschakeld, kan de basis-blob niet worden hersteld met deze methode. Gebruik start_copy_from_url in plaats daarvan met de URL van de blobversie die u wilt promoveren naar de huidige versie.
undelete_blob(**kwargs: Any) -> NoneParameters
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retourtype
upload_blob
Hiermee maakt u een nieuwe blob op basis van een gegevensbron met automatische segmentering.
upload_blob(data: bytes | str | Iterable | IO, blob_type: str | BlobType = BlobType.BLOCKBLOB, length: int | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, Any]Parameters
- data
De blobgegevens die moeten worden geüpload.
- blob_type
- BlobType
Het type blob. Dit kan BlockBlob, PageBlob of AppendBlob zijn. De standaardwaarde is BlockBlob.
- length
- int
Aantal bytes dat uit de stream moet worden gelezen. Dit is optioneel, maar moet worden geleverd voor optimale prestaties.
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.
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.
Een callback om de voortgang van een langlopende upload bij te houden. De handtekening is function(current: int, total: Optional[int]) waarbij de huidige het aantal bytes is dat tot nu toe is overgedragen en het totaal de grootte van de blob of Geen als de grootte onbekend is.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Als u netwerktime-outs aan de clientzijde wilt configureren, raadpleegt u hier. Deze methode kan meerdere aanroepen naar de service uitvoeren en de time-out is van toepassing op elke aanroep afzonderlijk.
Retouren
Eigenschapsdicteren bijgewerkt met blob (Etag en laatst gewijzigd)
Retourtype
upload_blob_from_url
Hiermee maakt u een nieuwe blok-blob waarin de inhoud van de blob wordt gelezen vanaf een bepaalde URL. De inhoud van een bestaande blob wordt overschreven met de nieuwe blob.
upload_blob_from_url(source_url: str, **kwargs: Any) -> Dict[str, Any]Parameters
- source_url
- str
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.
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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf wordt opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens in de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam worden vermeld. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders wordt er een fout gegenereerd.
- standard_blob_tier
- StandardBlobTier
Een standaard bloblaagwaarde om de blob op in te stellen. Voor deze versie van de bibliotheek is dit alleen van toepassing op blok-blobs in standaardopslagaccounts.
- source_authorization
- str
Verifieer als een service-principal met behulp van een clientgeheim om toegang te krijgen tot een bron-blob. Zorg ervoor dat 'bearer ' het voorvoegsel is van de source_authorization tekenreeks.
upload_page
Met de bewerking Pagina's uploaden wordt een reeks pagina's naar een pagina-blob geschreven.
upload_page(page: bytes, offset: int, length: int, **kwargs) -> Dict[str, str | datetime]Parameters
- offset
- int
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
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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.
Nieuw in versie 12.2.0.
- encoding
- str
De standaardinstelling is UTF-8.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
Retouren
Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd).
Retourtype
upload_pages_from_url
Met de bewerking Pagina's uploaden wordt een reeks pagina's naar een pagina-blob geschreven waar de inhoud wordt gelezen vanuit een URL.
upload_pages_from_url(source_url: str, offset: int, length: int, source_offset: int, **kwargs) -> Dict[str, Any]Parameters
- source_url
- str
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
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
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
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.
Versleutelt de gegevens aan de servicezijde met de opgegeven sleutel. Het gebruik van door de klant verstrekte sleutels moet worden uitgevoerd via HTTPS. Omdat de versleutelingssleutel zelf is opgegeven in de aanvraag, moet er een beveiligde verbinding tot stand worden gebracht om de sleutel over te dragen.
- encryption_scope
- str
Een vooraf gedefinieerd versleutelingsbereik dat wordt gebruikt om de gegevens op de service te versleutelen. Een versleutelingsbereik kan worden gemaakt met behulp van de Management-API en hier op naam naar verwijzen. Als er een standaardversleutelingsbereik is gedefinieerd in de container, wordt deze waarde overschreven als het bereik op containerniveau is geconfigureerd om onderdrukkingen toe te staan. Anders treedt er een fout op.
Nieuw in versie 12.2.0.
- timeout
- int
Hiermee stelt u de time-out aan de serverzijde voor de bewerking in seconden in. Zie https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations voor meer informatie. Deze waarde wordt niet bijgehouden of gevalideerd op de client. Zie hier als u netwerktime-outs aan de clientzijde wilt configureren.
- source_authorization
- str
Verifiëren als een service-principal met behulp van een clientgeheim voor toegang tot een bron-blob. Zorg ervoor dat bearer het voorvoegsel is van de source_authorization tekenreeks.
Kenmerken
api_version
De versie van de Storage-API die wordt gebruikt voor aanvragen.
location_mode
De locatiemodus die de client momenteel gebruikt.
Dit is standaard 'primair'. Opties zijn 'primair' en 'secundair'.
primary_endpoint
De volledige URL van het primaire eindpunt.
primary_hostname
De hostnaam van het primaire eindpunt.
secondary_endpoint
De volledige URL van het secundaire eindpunt, indien geconfigureerd.
Als dit niet beschikbaar is, wordt er een ValueError gegenereerd. Als u expliciet een secundaire hostnaam wilt opgeven, gebruikt u het optionele secondary_hostname sleutelwoordargument bij instantiëring.
Uitzonderingen
secondary_hostname
De hostnaam van het secundaire eindpunt.
Als dit niet beschikbaar is, is dit Geen. Als u expliciet een secundaire hostnaam wilt opgeven, gebruikt u het optionele secondary_hostname sleutelwoordargument bij instantiëring.
url
De volledige eindpunt-URL naar deze entiteit, inclusief SAS-token indien gebruikt.
Dit kan het primaire eindpunt of het secundaire eindpunt zijn, afhankelijk van de huidige location_mode. :retourneert: de volledige eindpunt-URL naar deze entiteit, inclusief SAS-token indien gebruikt. :rtype: str
Azure SDK for Python
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor