BlockBlobService Klas

Met blok-blobs kunt u efficiënt grote blobs uploaden. Blok-blobs bestaan uit blokken, die elk worden geïdentificeerd door een blok-id. U maakt of wijzigt een blok-blob door een set blokken te schrijven en deze door te voeren op basis van hun blok-id's. Elk blok kan een andere grootte hebben, maximaal 100 MB, en een blok-blob kan maximaal 50.000 blokken bevatten. De maximale grootte van een blok-blob is daarom ongeveer 4,75 TB (100 MB x 50.000 blokken). Als u een blok-blob schrijft die niet groter is dan 64 MB, kunt u deze in zijn geheel uploaden met één schrijfbewerking; zie create_blob_from_bytes.

:type ~azure.storage.common.TokenCredential

Overname

BaseBlobService

BlockBlobService

Constructor

BlockBlobService(account_name=None, account_key=None, sas_token=None, is_emulated=False, protocol='https', endpoint_suffix='core.windows.net', custom_domain=None, request_session=None, connection_string=None, socket_timeout=None, token_credential=None)

Parameters

account_name

str

standaardwaarde: None

De naam van het opslagaccount. Dit wordt gebruikt om aanvragen te verifiëren die zijn ondertekend met een accountsleutel en om het opslageindpunt te maken. Dit is vereist, tenzij er een verbindingsreeks wordt gegeven of als een aangepast domein wordt gebruikt met anonieme verificatie.

account_key

str

standaardwaarde: None

De opslagaccountsleutel. Dit wordt gebruikt voor verificatie met gedeelde sleutels. Als geen van beide accountsleutels of SAS-token is opgegeven, wordt anonieme toegang gebruikt.

sas_token

str

standaardwaarde: None

Een shared access signature-token dat moet worden gebruikt om aanvragen te verifiëren in plaats van de accountsleutel. Als de accountsleutel en het SAS-token beide zijn opgegeven, wordt de accountsleutel gebruikt om te ondertekenen. Als geen van beide is opgegeven, wordt anonieme toegang gebruikt.

is_emulated

bool

standaardwaarde: False

Of u de emulator wilt gebruiken. Standaard ingesteld op False. Indien opgegeven, worden alle andere parameters naast verbindingsreeks en aanvraagsessie overschreven.

protocol

str

standaardwaarde: https

Het protocol dat moet worden gebruikt voor aanvragen. De standaardinstelling is https.

endpoint_suffix

str

standaardwaarde: core.windows.net

Het hostbasisonderdeel van de URL, minus de accountnaam. De standaardinstelling is Azure (core.windows.net). Overschrijf dit om de China-cloud (core.chinacloudapi.cn) te gebruiken.

custom_domain

str

standaardwaarde: None

Het aangepaste domein dat moet worden gebruikt. Dit kan worden ingesteld in de Azure-portal. Bijvoorbeeld 'www.mydomain.com'.

request_session

<xref:requests.Session>

standaardwaarde: None

Het sessieobject dat moet worden gebruikt voor HTTP-aanvragen.

connection_string

str

standaardwaarde: None

Als dit wordt opgegeven, worden alle andere parameters naast de aanvraagsessie overschreven. Zie http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/ voor de verbindingsreeks-indeling.

socket_timeout

int

standaardwaarde: None

Als dit is opgegeven, overschrijft dit de standaardtime-out van de socket. De opgegeven time-out is in seconden. Zie DEFAULT_SOCKET_TIMEOUT in _constants.py voor de standaardwaarde.

token_credential

standaardwaarde: None

Een tokenreferentie die wordt gebruikt om HTTPS-aanvragen te verifiëren. De tokenwaarde moet worden bijgewerkt voordat deze verloopt.

Variabelen

MAX_SINGLE_PUT_SIZE

int

Uploaden met de grootste grootte wordt ondersteund in één put-aanroep. Dit wordt gebruikt door de create_blob_from_*-methoden als de lengte van de inhoud bekend is en kleiner is dan deze waarde.

MAX_BLOCK_SIZE

int

De grootte van de blokken die met create_blob_from_*-methoden worden geplaatst als de lengte van de inhoud onbekend is of groter is dan MAX_SINGLE_PUT_SIZE. Kleinere blokken kunnen worden geplaatst. De maximale blokgrootte die door de service wordt ondersteund, is 100 MB.

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD

int

De minimale blokgrootte waarbij het voor geheugen geoptimaliseerde blokupload-algoritme wordt overwogen. Dit algoritme is alleen van toepassing op de create_blob_from_file- en create_blob_from_stream-methoden en voorkomt dat blokken volledig worden gebufferd. Naast de blokgrootte moeten ContentMD5-validatie en -versleuteling worden uitgeschakeld, omdat voor deze opties de blokken moeten worden gebufferd.

Methoden

abort_copy_blob	Hiermee wordt een in behandeling zijnde copy_blob bewerking afgebroken en blijft een doel-blob met de lengte nul en volledige metagegevens behouden.
acquire_blob_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-id.
acquire_container_lease	Vraagt een nieuwe lease aan. Als de container geen actieve lease heeft, maakt de Blob-service een lease voor de container en retourneert een nieuwe lease-id.
batch_delete_blobs	Hiermee wordt een batch met meerdere blob-verwijderingsaanvragen verzonden. De methode blob verwijderen verwijdert de opgegeven blob of momentopname. Houd er rekening mee dat als u een blob verwijdert, ook alle momentopnamen worden verwijderd. Zie https://docs.microsoft.com/rest/api/storageservices/delete-blob voor meer informatie
batch_set_standard_blob_tier	Hiermee verzendt u een batch met aanvragen voor meerdere set blok-bloblagen. Deze API wordt alleen ondersteund voor blok-blobs in standaardopslagaccounts.
break_blob_lease	Breekt de lease als de blob een actieve lease heeft. Zodra een lease is verbroken, kan deze niet worden verlengd. Elke geautoriseerde aanvraag kan de lease verbreken; de aanvraag is niet vereist om een overeenkomende lease-id op te geven. Wanneer een lease wordt verbroken, mag de lease-onderbrekingsperiode verlopen, gedurende welke tijd geen leasebewerkingen kunnen worden uitgevoerd, behalve onderbreking en vrijgave op de blob. Wanneer een lease is verbroken, geeft het antwoord het interval in seconden aan totdat een nieuwe lease kan worden verkregen. Een gebroken lease kan ook worden vrijgegeven, in welk geval een andere client onmiddellijk de lease op de blob kan verkrijgen.
break_container_lease	Verbreek de lease als de container een actieve lease heeft. Zodra een lease is verbroken, kan deze niet worden verlengd. Elke geautoriseerde aanvraag kan de lease verbreken; de aanvraag is niet vereist om een overeenkomende lease-id op te geven. Wanneer een lease wordt verbroken, mag de lease-onderbrekingsperiode zijn verstreken, gedurende welke tijd geen leasebewerkingen kunnen worden uitgevoerd, met uitzondering van onderbreking en vrijgave voor de container. Wanneer een lease is verbroken, geeft het antwoord het interval in seconden aan totdat een nieuwe lease kan worden verkregen.
change_blob_lease	Hiermee wijzigt u de lease-id van een actieve lease. Een wijziging moet de huidige lease-id en een nieuwe lease-id bevatten.
change_container_lease	Wijzig de lease-id van een actieve lease. Een wijziging moet de huidige lease-id en een nieuwe lease-id bevatten.
copy_blob	Kopieert een blob. Deze bewerking retourneert een eigenschappenobject voor de kopieerbewerking. De kopieerbewerking kan worden geconfigureerd als een asynchrone bewerking met optimale inspanning of een synchrone bewerking. De bron moet een blok-blob zijn als requires_sync waar is. Elke bestaande doel-blob wordt overschreven. De doel-blob kan niet worden gewijzigd terwijl er een kopieerbewerking wordt uitgevoerd. Wanneer u kopieert vanuit een blok-blob, worden alle vastgelegde blokken en de bijbehorende blok-id's gekopieerd. Niet-verzonden blokken worden niet gekopieerd. Aan het einde van de kopieerbewerking heeft de doel-blob dezelfde vastgelegde bloktelling als de bron. U kunt get_blob_properties aanroepen op de doel-blob om de status van de kopieerbewerking te controleren. De uiteindelijke blob wordt doorgevoerd wanneer het kopiëren is voltooid. Naam van de doelcontainer. De container moet bestaan. :p aram str blob_name: naam van de doel-blob. Als de doel-blob bestaat, wordt deze overschreven. Anders wordt het gemaakt. :p aram str copy_source: een URL van maximaal 2 kB die een Azure-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/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram-metagegevens: 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. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: A DateTime value. 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. :p aram datetime source_if_unmodified_since: 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. :p aram ETag source_if_match: een ETag-waarde of het jokerteken (). Geef deze voorwaardelijke header op om de bron-blob alleen te kopiëren als de ETag overeenkomt met de opgegeven waarde. Als de ETag-waarden niet overeenkomen, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt). Deze header kan niet worden opgegeven als de bron een Azure-bestand is. :p aram ETag source_if_none_match: een ETag-waarde of het jokerteken (). Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de ETag niet overeenkomt met de opgegeven waarde. Als de waarden identiek zijn, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt). Deze header kan niet worden opgegeven als de bron een Azure-bestand is. :p aram datetime destination_if_modified_since: 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). :p aram datetime destination_if_unmodified_since: 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). :p aram ETag destination_if_match: een ETag-waarde of het jokerteken (). Geef een ETag-waarde op voor deze voorwaardelijke header om de blob alleen te kopiëren als de opgegeven ETag-waarde overeenkomt met de ETag-waarde voor een bestaande doel-blob. Als de ETag voor de doel-blob niet overeenkomt met de ETag die is opgegeven voor If-Match, retourneert de Blob-service statuscode 412 (voorwaarde mislukt). :p aram ETag destination_if_none_match: een ETag-waarde of het jokerteken (). Geef een ETag-waarde op voor deze voorwaardelijke header om de blob alleen te kopiëren als de opgegeven ETag-waarde niet overeenkomt met de ETag-waarde voor de doel-blob. Geef het jokerteken (*) op om de bewerking alleen uit te voeren als de doel-blob niet bestaat. Als niet aan de opgegeven voorwaarde wordt voldaan, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt). :p aram str destination_lease_id: 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). :p aram str source_lease_id: geef dit op om de blob kopiëren alleen uit te voeren als de opgegeven lease-id overeenkomt met de actieve lease-id van de bron-blob. :p aram int time-out: de time-outparameter wordt uitgedrukt in seconden. :p aram bool requires_sync: dwingt af dat de service geen antwoord retourneert totdat de kopie is voltooid. :p aram StandardBlobTier standard_blob_tier: een waarde voor de standaard-bloblaag om de blob op in te stellen. Voor deze versie van de bibliotheek is dit alleen van toepassing op blok-blobs in standaardopslagaccounts. :p aram RehydratePriority rehydrate_priority: geeft de prioriteit aan waarmee een gearchiveerde blob moet worden gerehydrateerd:return: eigenschappen van de kopieerbewerking, zoals status, bron en id. :rtype: CopyProperties
create_blob_from_bytes	Hiermee maakt u een nieuwe blob op basis van een matrix van bytes of werkt u de inhoud van een bestaande blob bij met automatische segmentering en voortgangsmeldingen.
create_blob_from_path	Hiermee maakt u een nieuwe blob op basis van een bestandspad of werkt u de inhoud van een bestaande blob bij met automatische segmentering en voortgangsmeldingen.
create_blob_from_stream	Hiermee maakt u een nieuwe blob op basis van een bestand/stream of werkt u de inhoud van een bestaande blob bij met automatische segmentering en voortgangsmeldingen.
create_blob_from_text	Hiermee maakt u een nieuwe blob van str/unicode of werkt u de inhoud van een bestaande blob bij met automatische segmentering en voortgangsmeldingen.
create_container	Hiermee maakt u een nieuwe container onder het opgegeven account. Als de container met dezelfde naam al bestaat, mislukt de bewerking als fail_on_exist True is.
delete_blob	Hiermee markeert u de opgegeven blob of momentopname 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 Blob verwijderen. Als een bewaarbeleid voor verwijderen is ingeschakeld voor de service, wordt met deze bewerking de blob of momentopname voorlopig verwijderd en wordt de blob of momentopname bewaard gedurende het opgegeven aantal dagen. Na het opgegeven aantal dagen worden de gegevens van de blob verwijderd uit de service tijdens garbagecollection. Voorlopig verwijderde blob of momentopname is toegankelijk via list-blobs-API die de optie include=Include.Deleted specificeert. Voorlopig verwijderde blob of momentopname kan worden hersteld met de ONGEDAAN MAKEN-API.
delete_container	Hiermee wordt de opgegeven container gemarkeerd voor verwijdering. De container en eventuele blobs die erin zijn opgenomen, worden later verwijderd tijdens de garbagecollection.
exists	Retourneert een booleaanse waarde die aangeeft of de container bestaat (als blob_name Geen is), of een booleaanse waarde die aangeeft of de blob bestaat.
extract_date_and_request_id
generate_account_shared_access_signature	Hiermee wordt een shared access signature voor de blob-service gegenereerd. Gebruik de geretourneerde handtekening met de parameter sas_token van een BlobService.
generate_blob_shared_access_signature	Hiermee genereert u een shared access signature voor de blob of een van de momentopnamen. Gebruik de geretourneerde handtekening met de parameter sas_token van een BlobService.
generate_container_shared_access_signature	Hiermee genereert u een shared access signature voor de container. Gebruik de geretourneerde handtekening met de parameter sas_token van een BlobService.
get_blob_account_information	Hiermee haalt u informatie op met betrekking tot het opslagaccount. De informatie kan ook worden opgehaald als de gebruiker een SAS voor een container of blob heeft.
get_blob_metadata	Retourneert alle door de gebruiker gedefinieerde metagegevens voor de opgegeven blob of momentopname.
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. Retourneert Blob met BlobProperties en een metagegevensdict.
get_blob_service_properties	Hiermee haalt u de eigenschappen op van de Blob-service van een opslagaccount, waaronder Azure Opslaganalyse.
get_blob_service_stats	Hiermee haalt u statistieken op met betrekking tot replicatie voor de Blob-service. Deze is alleen beschikbaar wanneer geografisch redundante replicatie met leestoegang is ingeschakeld voor het opslagaccount. Met geografisch redundante replicatie onderhoudt Azure Storage uw gegevens duurzaam op twee locaties. Op beide locaties onderhoudt Azure Storage voortdurend meerdere goede replica's van uw gegevens. De locatie waar u gegevens leest, maakt, bijwerkt of verwijdert, is de primaire opslagaccountlocatie. De primaire locatie bestaat in de regio die u kiest op het moment dat u een account maakt via de klassieke Azure Management Azure-portal, bijvoorbeeld VS - noord-centraal. De locatie waarnaar uw gegevens worden gerepliceerd, is de secundaire locatie. De secundaire locatie wordt automatisch bepaald op basis van de locatie van de primaire; het bevindt zich in een tweede datacenter dat zich in dezelfde regio bevindt als de primaire locatie. Alleen-lezentoegang is beschikbaar vanaf de secundaire locatie, als geografisch redundante replicatie met leestoegang is ingeschakeld voor uw opslagaccount.
get_blob_to_bytes	Hiermee downloadt u een blob als een matrix van bytes, met automatische segmentering en voortgangsmeldingen. Retourneert een exemplaar van Blob met eigenschappen, metagegevens en inhoud.
get_blob_to_path	Hiermee downloadt u een blob naar een bestandspad, met automatische segmentering en voortgangsmeldingen. Retourneert een exemplaar van Blob met eigenschappen en metagegevens.
get_blob_to_stream	Hiermee downloadt u een blob naar een stream, met automatische segmentering en voortgangsmeldingen. Retourneert een exemplaar van Blob met eigenschappen en metagegevens.
get_blob_to_text	Hiermee downloadt u een blob als unicode-tekst, met automatische segmentering en voortgangsmeldingen. Retourneert een exemplaar van Blob met eigenschappen, metagegevens en inhoud.
get_block_list	Hiermee haalt u de lijst met blokken op die zijn geüpload als onderdeel van een blok-blob. Er worden twee bloklijsten onderhouden voor een blob: Vastgelegde blokkeringslijst: de lijst met blokken die zijn doorgevoerd naar een bepaalde blob met putbloklijst. Niet-doorgevoerde blokkeringslijst: de lijst met blokken die zijn geüpload voor een blob met behulp van Put Block, maar die nog niet zijn doorgevoerd. Deze blokken worden in Azure opgeslagen in combinatie met een blob, maar maken nog geen deel uit van de blob.
get_container_acl	Hiermee haalt u de machtigingen voor de opgegeven container op. De machtigingen geven aan of containergegevens openbaar kunnen worden geopend.
get_container_metadata	Retourneert alle door de gebruiker gedefinieerde metagegevens voor de opgegeven container.
get_container_properties	Retourneert alle door de gebruiker gedefinieerde metagegevens en systeemeigenschappen voor de opgegeven container. De geretourneerde gegevens bevatten niet de lijst met blobs van de container.
get_user_delegation_key	Verkrijg een sleutel voor gebruikersdelegatie voor het ondertekenen van SAS-tokens. Deze aanvraag slaagt alleen als er een tokenreferentie aanwezig is op het serviceobject.
list_blob_names	Retourneert een generator om de blobnamen onder de opgegeven container weer te geven. De generator volgt langzaam de vervolgtokens die door de service worden geretourneerd en stopt wanneer alle blobs zijn geretourneerd of num_results is bereikt. Als num_results is opgegeven en het account meer dan dat aantal blobs heeft, heeft de generator een ingevuld next_marker veld zodra het is voltooid. Deze markering kan worden gebruikt om een nieuwe generator te maken als meer resultaten gewenst zijn.
list_blobs	Retourneert een generator om de blobs onder de opgegeven container weer te geven. De generator volgt lui de vervolgtokens die door de service worden geretourneerd en stopt wanneer alle blobs zijn geretourneerd of num_results is bereikt. Als num_results is opgegeven en het account meer dan dat aantal blobs heeft, heeft de generator een ingevuld next_marker veld zodra het is voltooid. Deze markering kan worden gebruikt om een nieuwe generator te maken als er meer resultaten worden gewenst.
list_containers	Retourneert een generator om de containers onder het opgegeven account weer te geven. De generator volgt lui de vervolgtokens die door de service worden geretourneerd en stopt wanneer alle containers zijn geretourneerd of num_results is bereikt. Als num_results is opgegeven en het account meer dan dat aantal containers heeft, heeft de generator een ingevuld next_marker veld zodra het is voltooid. Deze markering kan worden gebruikt om een nieuwe generator te maken als er meer resultaten worden gewenst.
make_blob_url	Hiermee maakt u de URL voor toegang tot een blob.
make_container_url	Hiermee maakt u de URL voor toegang tot een container.
put_block	Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob.
put_block_from_url	Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blob.
put_block_list	Hiermee schrijft u een blob door de lijst met blok-id's waaruit de blob bestaat op te geven. Als u wilt worden geschreven als onderdeel van een blob, moet een blok zijn geschreven naar de server in een eerdere Put Block-bewerking. U kunt Put Block List aanroepen om een blob bij te werken door alleen de blokken te uploaden die zijn gewijzigd en vervolgens de nieuwe en bestaande blokken samen door te voeren. U kunt dit doen door op te geven of u een blok wilt doorvoeren vanuit de lijst met vastgelegde blokkeringen of vanuit de lijst met niet-doorgevoerde blokkeringen, of door de meest recent geüploade versie van het blok door te voeren, afhankelijk van de lijst waartoe deze behoort.
release_blob_lease	Hiermee wordt de lease vrijgegeven. De lease kan worden vrijgegeven als de lease-id die is opgegeven in de aanvraag overeenkomt met de lease-id die is gekoppeld aan de blob. Door de lease vrij te geven, kan een andere client onmiddellijk de lease voor de blob verkrijgen zodra de release is voltooid.
release_container_lease	Laat de lease los. De lease kan worden vrijgegeven als de opgegeven lease_id overeenkomt met de opgegeven aan de container. Door de lease vrij te geven, kan een andere client de lease voor de container onmiddellijk verkrijgen zodra de release is voltooid.
renew_blob_lease	Hiermee wordt de lease verlengd. De lease kan worden verlengd als de lease-id die is opgegeven in de aanvraag overeenkomt met de lease-id die is gekoppeld aan de blob. Houd er rekening mee dat de lease kan worden verlengd, zelfs als deze is verlopen zolang de blob niet is gewijzigd of opnieuw is geleased sinds de vervaldatum van die lease. Wanneer u een lease verlengt, wordt de klok voor de leaseduur opnieuw ingesteld.
renew_container_lease	Hiermee wordt de lease verlengd. De lease kan worden vernieuwd als de opgegeven lease-id overeenkomt met de opgegeven lease-id die is gekoppeld aan de container. Houd er rekening mee dat de lease kan worden verlengd, zelfs als deze is verlopen zolang de container niet opnieuw is geleased sinds het verstrijken van die lease. Wanneer u een lease verlengt, wordt de klok voor de leaseduur opnieuw ingesteld.
set_blob_metadata	Hiermee stelt u door de gebruiker gedefinieerde metagegevens voor de opgegeven blob in als een of meer naam-waardeparen.
set_blob_properties	Hiermee stelt u systeemeigenschappen in op de blob. Als er één eigenschap is ingesteld voor de content_settings, worden alle eigenschappen overschreven.
set_blob_service_properties	Hiermee stelt u de eigenschappen van de Blob-service van een opslagaccount in, waaronder Azure Opslaganalyse. Als een element (bijvoorbeeld logboekregistratie) wordt overgelaten op Geen, blijven de bestaande instellingen in de service voor die functionaliteit behouden.
set_container_acl	Hiermee stelt u de machtigingen in voor de opgegeven container of het opgeslagen toegangsbeleid dat kan worden gebruikt met Shared Access Signatures. De machtigingen geven aan of blobs in een container openbaar toegankelijk zijn.
set_container_metadata	Hiermee stelt u een of meer door de gebruiker gedefinieerde naam-waardeparen in voor de opgegeven container. Elke aanroep van deze bewerking vervangt alle bestaande metagegevens die aan de container zijn gekoppeld. Als u alle metagegevens uit de container wilt verwijderen, roept u deze bewerking aan zonder metagegevensdicteerfunctie.
set_proxy	Hiermee stelt u de host en poort van de proxyserver in voor de HTTP CONNECT-tunneling.
set_standard_blob_tier	Hiermee stelt u de blok-bloblagen op de blob in. Deze API wordt alleen ondersteund voor blok-blobs in standaardopslagaccounts. :p aram RehydratePriority rehydrate_priority: geeft de prioriteit aan waarmee een gearchiveerde blob moet worden gerehydrateerd
snapshot_blob	Hiermee maakt u een alleen-lezen momentopname van een blob.
undelete_blob	De verwijdering van blob ongedaan maken herstelt de inhoud en metagegevens van voorlopig verwijderde blob of momentopname. Het ongedaan maken van het verwijderen van een blob of momentopname die niet voorlopig is verwijderd, slaagt zonder wijzigingen.

abort_copy_blob

Hiermee wordt een in behandeling zijnde copy_blob bewerking afgebroken en blijft een doel-blob met de lengte nul en volledige metagegevens behouden.

abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van de doelcontainer.

blob_name

str

Vereist

Naam van doel-blob.

copy_id

str

Vereist

Kopieer de id die is opgegeven in de copy.id van de oorspronkelijke copy_blob bewerking.

lease_id

str

standaardwaarde: None

Vereist als de doel-blob een actieve oneindige lease heeft.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

acquire_blob_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-id.

acquire_blob_lease(container_name, blob_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

lease_duration

int

standaardwaarde: -1

Hiermee geeft u de duur van de lease, in seconden, of een negatieve (-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).

proposed_lease_id

str

standaardwaarde: None

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

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

Str

acquire_container_lease

Vraagt een nieuwe lease aan. Als de container geen actieve lease heeft, maakt de Blob-service een lease voor de container en retourneert een nieuwe lease-id.

acquire_container_lease(container_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

lease_duration

int

standaardwaarde: -1

Hiermee geeft u de duur van de lease, in seconden, of een negatieve (-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).

proposed_lease_id

str

standaardwaarde: None

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

standaardwaarde: None

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

standaardwaarde: None

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.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

Str

batch_delete_blobs

Hiermee wordt een batch met meerdere blob-verwijderingsaanvragen verzonden.

De methode blob verwijderen verwijdert de opgegeven blob of momentopname. Houd er rekening mee dat als u een blob verwijdert, ook alle momentopnamen worden verwijderd. Zie https://docs.microsoft.com/rest/api/storageservices/delete-blob voor meer informatie

batch_delete_blobs(batch_delete_sub_requests, timeout=None)

Parameters

batch_delete_sub_requests

list(BatchDeleteSubRequest)

Vereist

De aanvragen voor het verwijderen van de blob die als batch moeten worden verzonden.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

HTTP-antwoord geparseerd batch verwijderen

Retourtype

list <xref:of> BatchSubResponse

batch_set_standard_blob_tier

Hiermee verzendt u een batch met aanvragen voor meerdere set blok-bloblagen. Deze API wordt alleen ondersteund voor blok-blobs in standaardopslagaccounts.

batch_set_standard_blob_tier(batch_set_blob_tier_sub_requests, timeout=None)

Parameters

batch_set_blob_tier_sub_requests

list(BatchSetBlobTierSubRequest)

Vereist

De aanvragen voor de blok-bloblaag instellen die als een batch moeten worden verzonden.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden. Met deze methode kunnen meerdere aanroepen naar de Azure-service worden uitgevoerd en de time-out is van toepassing op elke aanroep afzonderlijk.

Retouren

Geparseerd HTTP-antwoord van de laag batchset, waarmee wordt aangegeven of elke subaanvraag is geslaagd.

Retourtype

list <xref:of> BatchSubResponse

break_blob_lease

Breekt de lease als de blob een actieve lease heeft. Zodra een lease is verbroken, kan deze niet worden verlengd. Elke geautoriseerde aanvraag kan de lease verbreken; de aanvraag is niet vereist om een overeenkomende lease-id op te geven. Wanneer een lease wordt verbroken, mag de lease-onderbrekingsperiode verlopen, gedurende welke tijd geen leasebewerkingen kunnen worden uitgevoerd, behalve onderbreking en vrijgave op de blob. Wanneer een lease is verbroken, geeft het antwoord het interval in seconden aan totdat een nieuwe lease kan worden verkregen.

Een gebroken lease kan ook worden vrijgegeven, in welk geval een andere client onmiddellijk de lease op de blob kan verkrijgen.

break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

lease_break_period

int

standaardwaarde: None

Voor een onderbrekingsbewerking is dit de voorgestelde duur van seconden die de lease moet voortzetten voordat deze wordt verbroken, tussen 0 en 60 seconden. Deze onderbrekingsperiode wordt alleen gebruikt als deze korter is dan de resterende tijd van de lease. Als het langer is, wordt de resterende tijd van de lease gebruikt. Een nieuwe lease is niet beschikbaar voordat de onderbrekingsperiode is verstreken, maar de lease kan langer worden vastgehouden dan de onderbrekingsperiode. Als deze header niet wordt weergegeven met een onderbrekingsbewerking, breekt een lease met een vaste duur na het verstrijken van de resterende leaseperiode en een oneindige lease onmiddellijk af.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

int

break_container_lease

Verbreek de lease als de container een actieve lease heeft. Zodra een lease is verbroken, kan deze niet worden verlengd. Elke geautoriseerde aanvraag kan de lease verbreken; de aanvraag is niet vereist om een overeenkomende lease-id op te geven. Wanneer een lease wordt verbroken, mag de lease-onderbrekingsperiode zijn verstreken, gedurende welke tijd geen leasebewerkingen kunnen worden uitgevoerd, met uitzondering van onderbreking en vrijgave voor de container. Wanneer een lease is verbroken, geeft het antwoord het interval in seconden aan totdat een nieuwe lease kan worden verkregen.

break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

lease_break_period

int

standaardwaarde: None

Dit is de voorgestelde duur van seconden die de lease moet voortzetten voordat deze wordt verbroken, tussen 0 en 60 seconden. Deze onderbrekingsperiode wordt alleen gebruikt als deze korter is dan de resterende tijd van de lease. Als het langer is, wordt de resterende tijd van de lease gebruikt. Een nieuwe lease is niet beschikbaar voordat de onderbrekingsperiode is verstreken, maar de lease kan langer worden vastgehouden dan de onderbrekingsperiode. Als deze header niet wordt weergegeven met een onderbrekingsbewerking, breekt een lease met een vaste duur na het verstrijken van de resterende leaseperiode en een oneindige lease onmiddellijk af.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

int

change_blob_lease

Hiermee wijzigt u de lease-id van een actieve lease. Een wijziging moet de huidige lease-id en een nieuwe lease-id bevatten.

change_blob_lease(container_name, blob_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

lease_id

str

Vereist

Vereist als de blob een actieve lease heeft.

proposed_lease_id

str

Vereist

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

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

change_container_lease

Wijzig de lease-id van een actieve lease. Een wijziging moet de huidige lease-id en een nieuwe lease-id bevatten.

change_container_lease(container_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

lease_id

str

Vereist

Lease-id voor actieve lease.

proposed_lease_id

str

Vereist

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

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

copy_blob

Kopieert een blob. Deze bewerking retourneert een eigenschappenobject voor de kopieerbewerking. De kopieerbewerking kan worden geconfigureerd als een asynchrone bewerking met optimale inspanning of een synchrone bewerking.

De bron moet een blok-blob zijn als requires_sync waar is. Elke bestaande doel-blob wordt overschreven. De doel-blob kan niet worden gewijzigd terwijl er een kopieerbewerking wordt uitgevoerd.

Wanneer u kopieert vanuit een blok-blob, worden alle vastgelegde blokken en de bijbehorende blok-id's gekopieerd. Niet-verzonden blokken worden niet gekopieerd. Aan het einde van de kopieerbewerking heeft de doel-blob dezelfde vastgelegde bloktelling als de bron.

U kunt get_blob_properties aanroepen op de doel-blob om de status van de kopieerbewerking te controleren. De uiteindelijke blob wordt doorgevoerd wanneer het kopiëren is voltooid.

Naam van de doelcontainer. De container moet bestaan. :p aram str blob_name: naam van de doel-blob. Als de doel-blob bestaat, wordt deze overschreven. Anders wordt het gemaakt. :p aram str copy_source: een URL van maximaal 2 kB die een Azure-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/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken :p aram-metagegevens: 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. :type metadata: dict(str, str) :p aram datetime source_if_modified_since: A DateTime value. 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. :p aram datetime source_if_unmodified_since: 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. :p aram ETag source_if_match: een ETag-waarde of het jokerteken (). Geef deze voorwaardelijke header op om de bron-blob alleen te kopiëren als de ETag overeenkomt met de opgegeven waarde. Als de ETag-waarden niet overeenkomen, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt). Deze header kan niet worden opgegeven als de bron een Azure-bestand is. :p aram ETag source_if_none_match: een ETag-waarde of het jokerteken (). Geef deze voorwaardelijke header op om de blob alleen te kopiëren als de ETag niet overeenkomt met de opgegeven waarde. Als de waarden identiek zijn, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt). Deze header kan niet worden opgegeven als de bron een Azure-bestand is. :p aram datetime destination_if_modified_since: 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). :p aram datetime destination_if_unmodified_since: 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). :p aram ETag destination_if_match: een ETag-waarde of het jokerteken (). Geef een ETag-waarde op voor deze voorwaardelijke header om de blob alleen te kopiëren als de opgegeven ETag-waarde overeenkomt met de ETag-waarde voor een bestaande doel-blob. Als de ETag voor de doel-blob niet overeenkomt met de ETag die is opgegeven voor If-Match, retourneert de Blob-service statuscode 412 (voorwaarde mislukt). :p aram ETag destination_if_none_match: een ETag-waarde of het jokerteken (). Geef een ETag-waarde op voor deze voorwaardelijke header om de blob alleen te kopiëren als de opgegeven ETag-waarde niet overeenkomt met de ETag-waarde voor de doel-blob. Geef het jokerteken (*) op om de bewerking alleen uit te voeren als de doel-blob niet bestaat. Als niet aan de opgegeven voorwaarde wordt voldaan, retourneert de Blob-service statuscode 412 (Voorwaarde mislukt). :p aram str destination_lease_id: 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). :p aram str source_lease_id: geef dit op om de blob kopiëren alleen uit te voeren als de opgegeven lease-id overeenkomt met de actieve lease-id van de bron-blob. :p aram int time-out: de time-outparameter wordt uitgedrukt in seconden. :p aram bool requires_sync: dwingt af dat de service geen antwoord retourneert totdat de kopie is voltooid. :p aram StandardBlobTier standard_blob_tier: een waarde voor de standaard-bloblaag om de blob op in te stellen. Voor deze versie van de bibliotheek is dit alleen van toepassing op blok-blobs in standaardopslagaccounts. :p aram RehydratePriority rehydrate_priority: geeft de prioriteit aan waarmee een gearchiveerde blob moet worden gerehydrateerd:return: eigenschappen van de kopieerbewerking, zoals status, bron en id. :rtype: CopyProperties

copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None, requires_sync=None, standard_blob_tier=None, rehydrate_priority=None)

Parameters

container_name

str

Vereist

blob_name

Vereist

copy_source

Vereist

metadata

standaardwaarde: None

source_if_modified_since

standaardwaarde: None

source_if_unmodified_since

standaardwaarde: None

source_if_match

standaardwaarde: None

source_if_none_match

standaardwaarde: None

destination_if_modified_since

standaardwaarde: None

destination_if_unmodified_since

standaardwaarde: None

destination_if_match

standaardwaarde: None

destination_if_none_match

standaardwaarde: None

destination_lease_id

standaardwaarde: None

source_lease_id

standaardwaarde: None

timeout

standaardwaarde: None

requires_sync

standaardwaarde: None

standard_blob_tier

standaardwaarde: None

rehydrate_priority

standaardwaarde: None

create_blob_from_bytes

Hiermee maakt u een nieuwe blob op basis van een matrix van bytes of werkt u de inhoud van een bestaande blob bij met automatische segmentering en voortgangsmeldingen.

create_blob_from_bytes(container_name, blob_name, blob, index=0, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van de blob die moet worden gemaakt of bijgewerkt.

blob

bytes

Vereist

Inhoud van blob als een matrix van bytes.

index

int

standaardwaarde: 0

Index starten in de matrix van bytes.

count

int

standaardwaarde: None

Aantal bytes dat moet worden geüpload. Stel in op Geen of negatieve waarde om alle bytes te uploaden vanaf index.

content_settings

ContentSettings

standaardwaarde: None

ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen.

metadata

dict(str, str)

standaardwaarde: None

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

validate_content

bool

standaardwaarde: False

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 waardevol 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.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

standaardwaarde: None

Callback voor voortgang met handtekeningfunctie (huidig, totaal) waarbij huidig het aantal bytes is dat tot nu toe is overgedragen en totaal de grootte van de blob is, of Geen als de totale grootte onbekend is.

max_connections

int

standaardwaarde: 2

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

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden. Deze methode kan meerdere aanroepen naar de Azure-service uitvoeren en de time-out is van toepassing op elke aanroep afzonderlijk.

standard_blob_tier

StandardBlobTier

standaardwaarde: None

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.

Retouren

ETag en laatst gewijzigde eigenschappen voor de blok-blob

Retourtype

ResourceProperties

create_blob_from_path

Hiermee maakt u een nieuwe blob op basis van een bestandspad of werkt u de inhoud van een bestaande blob bij met automatische segmentering en voortgangsmeldingen.

create_blob_from_path(container_name, blob_name, file_path, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van de blob die moet worden gemaakt of bijgewerkt.

file_path

str

Vereist

Pad van het bestand dat moet worden geüpload als de blob-inhoud.

content_settings

ContentSettings

standaardwaarde: None

ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen.

metadata

dict(str, str)

standaardwaarde: None

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

validate_content

bool

standaardwaarde: False

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 waardevol 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.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

standaardwaarde: None

Callback voor voortgang met handtekeningfunctie (huidig, totaal) waarbij huidig het aantal bytes is dat tot nu toe is overgedragen en totaal de grootte van de blob is, of Geen als de totale grootte onbekend is.

max_connections

int

standaardwaarde: 2

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

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden. Deze methode kan meerdere aanroepen naar de Azure-service uitvoeren en de time-out is van toepassing op elke aanroep afzonderlijk.

standard_blob_tier

StandardBlobTier

standaardwaarde: None

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.

Retouren

ETag en laatst gewijzigde eigenschappen voor de blok-blob

Retourtype

ResourceProperties

create_blob_from_stream

Hiermee maakt u een nieuwe blob op basis van een bestand/stream of werkt u de inhoud van een bestaande blob bij met automatische segmentering en voortgangsmeldingen.

create_blob_from_stream(container_name, blob_name, stream, count=None, content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, use_byte_buffer=False, standard_blob_tier=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van de blob die moet worden gemaakt of bijgewerkt.

stream

IOBase

Vereist

Geopend bestand/stream om te uploaden als de blobinhoud.

count

int

standaardwaarde: None

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

content_settings

ContentSettings

standaardwaarde: None

ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen.

metadata

dict(str, str)

standaardwaarde: None

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

validate_content

bool

standaardwaarde: False

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 waardevol 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.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

standaardwaarde: None

Callback voor voortgang met handtekeningfunctie (huidig, totaal) waarbij huidig het aantal bytes is dat tot nu toe is overgedragen en totaal de grootte van de blob is, of Geen als de totale grootte onbekend is.

max_connections

int

standaardwaarde: 2

Maximum aantal parallelle verbindingen dat moet worden gebruikt wanneer de blob groter is dan 64 MB. Houd er rekening mee dat parallel uploaden vereist dat de stream kan worden gezocht.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden. Deze methode kan meerdere aanroepen naar de Azure-service uitvoeren en de time-out is van toepassing op elke aanroep afzonderlijk.

use_byte_buffer

bool

standaardwaarde: False

Als dit waar is, wordt het oorspronkelijke uploadpad voor volledige blokbuffers geforceerd gebruikt. Deze waarde is standaard Onwaar en maakt gebruik van een geheugenefficiënt, streaming-upload-algoritme onder de volgende voorwaarden: De opgegeven stream is doorzoekbaar, 'require_encryption' is Onwaar en MAX_BLOCK_SIZE >= MIN_LARGE_BLOCK_UPLOAD_THRESHOLD. Men moet rekening houden met de nadelen van het gebruik van deze benadering. Om geheugenefficiëntie te bereiken, wordt een IOBase-stroom of een bestandachtig object gesegmenteerd in logische blokken met behulp van een SubStream-wrapper. Als u de juiste gegevens wilt lezen, moet elke SubStream een vergrendeling krijgen, zodat deze veilig naar de juiste positie op de gedeelde, onderliggende stroom kan zoeken. Als max_connections > 1, resulteert de gelijktijdigheid in een aanzienlijke hoeveelheid zoeken op de onderliggende stroom. Voor de meest voorkomende invoer, zoals een bestand-achtig stroomobject, is zoeken een goedkope bewerking en dit is niet erg belangrijk. Voor andere varianten van streams is dit echter mogelijk niet het geval. De afweging voor geheugenefficiëntie moet worden afgewogen tegen de kosten van het zoeken met uw invoerstroom. De klasse SubStream probeert intern maximaal 4 MB te bufferen om de hoeveelheid zoek- en leesoproepen naar de onderliggende stroom te verminderen. Dit is met name handig bij het uploaden van grotere blokken.

standard_blob_tier

StandardBlobTier

standaardwaarde: None

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.

Retouren

ETag en laatst gewijzigde eigenschappen voor de blok-blob

Retourtype

ResourceProperties

create_blob_from_text

Hiermee maakt u een nieuwe blob van str/unicode of werkt u de inhoud van een bestaande blob bij met automatische segmentering en voortgangsmeldingen.

create_blob_from_text(container_name, blob_name, text, encoding='utf-8', content_settings=None, metadata=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van de blob die moet worden gemaakt of bijgewerkt.

text

str

Vereist

Tekst die naar de blob moet worden geüpload.

encoding

str

standaardwaarde: utf-8

Python-codering om te gebruiken om de tekst te converteren naar bytes.

content_settings

ContentSettings

standaardwaarde: None

ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen.

metadata

dict(str, str)

standaardwaarde: None

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

validate_content

bool

standaardwaarde: False

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 waardevol 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.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

standaardwaarde: None

Callback voor voortgang met handtekeningfunctie (huidig, totaal) waarbij huidig het aantal bytes is dat tot nu toe is overgedragen en totaal de grootte van de blob is, of Geen als de totale grootte onbekend is.

max_connections

int

standaardwaarde: 2

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

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden. Deze methode kan meerdere aanroepen naar de Azure-service uitvoeren en de time-out is van toepassing op elke aanroep afzonderlijk.

standard_blob_tier

StandardBlobTier

standaardwaarde: None

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.

Retouren

ETag en laatst gewijzigde eigenschappen voor de blok-blob

Retourtype

ResourceProperties

create_container

Hiermee maakt u een nieuwe container onder het opgegeven account. Als de container met dezelfde naam al bestaat, mislukt de bewerking als fail_on_exist True is.

create_container(container_name, metadata=None, public_access=None, fail_on_exist=False, timeout=None)

Parameters

container_name

str

Vereist

Naam van de container die moet worden gemaakt. De containernaam mag alleen kleine letters, cijfers en afbreekstreepjes bevatten en moet beginnen met een letter of een cijfer. Elk afbreekstreepje moet worden voorafgegaan en gevolgd door een cijfer of letter. De naam moet bovendien tussen 3 en 63 tekens lang zijn.

metadata

dict(str, str)

standaardwaarde: None

Een dicteerfunctie met name_value paren om als metagegevens aan de container te koppelen. Voorbeeld:{'Category':'test'}

public_access

PublicAccess

standaardwaarde: None

Mogelijke waarden zijn: container, blob.

fail_on_exist

bool

standaardwaarde: False

Geef op of er een uitzondering moet worden gegenereerd wanneer de container bestaat.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

Waar als de container is gemaakt, Onwaar als de container al bestaat.

Retourtype

bool

delete_blob

Hiermee markeert u de opgegeven blob of momentopname 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 Blob verwijderen.

Als een bewaarbeleid voor verwijderen is ingeschakeld voor de service, wordt met deze bewerking de blob of momentopname voorlopig verwijderd en wordt de blob of momentopname bewaard gedurende het opgegeven aantal dagen. Na het opgegeven aantal dagen worden de gegevens van de blob verwijderd uit de service tijdens garbagecollection. Voorlopig verwijderde blob of momentopname is toegankelijk via list-blobs-API die de optie include=Include.Deleted specificeert. Voorlopig verwijderde blob of momentopname kan worden hersteld met de ONGEDAAN MAKEN-API.

delete_blob(container_name, blob_name, snapshot=None, lease_id=None, delete_snapshots=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

snapshot

str

standaardwaarde: None

De parameter momentopname is een ondoorzichtige DateTime-waarde die, indien aanwezig, de blobmomentopname aangeeft die moet worden verwijderd.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

delete_snapshots

DeleteSnapshot

standaardwaarde: None

Vereist als de blob gekoppelde momentopnamen bevat.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

delete_container

Hiermee wordt de opgegeven container gemarkeerd voor verwijdering. De container en eventuele blobs die erin zijn opgenomen, worden later verwijderd tijdens de garbagecollection.

delete_container(container_name, fail_not_exist=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van de container die moet worden verwijderd.

fail_not_exist

bool

standaardwaarde: False

Geef op of er een uitzondering moet worden gegenereerd wanneer de container niet bestaat.

lease_id

str

standaardwaarde: None

Indien opgegeven, slaagt delete_container alleen als de lease van de container actief is en overeenkomt met deze id. Vereist als de container een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

Waar als de container is verwijderd, bestaat de onwaarcontainer niet.

Retourtype

bool

exists

Retourneert een booleaanse waarde die aangeeft of de container bestaat (als blob_name Geen is), of een booleaanse waarde die aangeeft of de blob bestaat.

exists(container_name, blob_name=None, snapshot=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van een container.

blob_name

str

standaardwaarde: None

Naam van een blob. Bij Geen wordt de container gecontroleerd op bestaan.

snapshot

str

standaardwaarde: None

De parameter momentopname is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de momentopname aangeeft.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

Een booleaanse waarde die aangeeft of de resource bestaat.

Retourtype

bool

extract_date_and_request_id

static extract_date_and_request_id(retry_context)

Parameters

retry_context

Vereist

generate_account_shared_access_signature

Hiermee wordt een shared access signature voor de blob-service gegenereerd. Gebruik de geretourneerde handtekening met de parameter sas_token van een BlobService.

generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)

Parameters

resource_types

<xref:ResourceTypes>

Vereist

Hiermee geeft u de resourcetypen op die toegankelijk zijn met de account-SAS.

permission

<xref:AccountPermissions>

Vereist

De machtigingen die zijn gekoppeld aan de handtekening voor gedeelde toegang. De gebruiker is beperkt tot bewerkingen die zijn toegestaan door de machtigingen. Vereist, tenzij een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid.

expiry

datetime of str

Vereist

Het tijdstip waarop de handtekening voor gedeelde toegang ongeldig wordt. Vereist, tenzij een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

start

datetime of str

standaardwaarde: None

Het tijdstip waarop de handtekening voor gedeelde toegang geldig wordt. Als u dit weglaat, wordt ervan uitgegaan dat de begintijd voor deze aanroep het tijdstip is waarop de opslagservice de aanvraag ontvangt. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

ip

str

standaardwaarde: None

Hiermee geeft u een IP-adres of een bereik van IP-adressen van waaruit aanvragen te accepteren. Als het IP-adres van waaruit de aanvraag afkomstig is, niet overeenkomt met het IP-adres of het adresbereik dat is opgegeven in het SAS-token, wordt de aanvraag niet geverifieerd. Als u bijvoorbeeld sip=168.1.5.65 of sip=168.1.5.60-168.1.5.70 opgeeft op de SAS, wordt de aanvraag beperkt tot deze IP-adressen.

protocol

str

standaardwaarde: None

Hiermee geeft u het protocol op dat is toegestaan voor een aanvraag die is gedaan. De standaardwaarde is https,http. Zie Protocol voor mogelijke waarden.

Retouren

Een Sas-token (Shared Access Signature).

Retourtype

str

generate_blob_shared_access_signature

Hiermee genereert u een shared access signature voor de blob of een van de momentopnamen. Gebruik de geretourneerde handtekening met de parameter sas_token van een BlobService.

generate_blob_shared_access_signature(container_name, blob_name, snapshot=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

Parameters

container_name

str

Vereist

Naam van container.

blob_name

str

Vereist

Naam van blob.

snapshot

str

standaardwaarde: None

De parameter momentopname is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de blobmomentopname aangeeft die machtigingen moet verlenen.

permission

BlobPermissions

standaardwaarde: None

De machtigingen die zijn gekoppeld aan de Shared Access Signature. De gebruiker is beperkt tot bewerkingen die zijn toegestaan door de machtigingen. Machtigingen moeten worden gerangschikt op lezen, schrijven, verwijderen, lijst. Vereist tenzij er een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid.

expiry

datetime of str

standaardwaarde: None

Het tijdstip waarop de handtekening voor gedeelde toegang ongeldig wordt. Vereist tenzij er een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

start

datetime of str

standaardwaarde: None

Het tijdstip waarop de Shared Access Signature geldig wordt. Als u dit weglaat, wordt ervan uitgegaan dat de begintijd voor deze aanroep het tijdstip is waarop de opslagservice de aanvraag ontvangt. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

id

str

standaardwaarde: None

Een unieke waarde van maximaal 64 tekens die overeenkomt met een opgeslagen toegangsbeleid. Gebruik om een opgeslagen toegangsbeleid te maken set_container_acl.

ip

str

standaardwaarde: None

Hiermee geeft u een IP-adres of een bereik van IP-adressen van waaruit aanvragen te accepteren. Als het IP-adres waaruit de aanvraag afkomstig is, niet overeenkomt met het IP-adres of adresbereik dat is opgegeven in het SAS-token, wordt de aanvraag niet geverifieerd. Als u bijvoorbeeld sip=168.1.5.65 of sip=168.1.5.60-168.1.5.70 opgeeft op de SAS, wordt de aanvraag beperkt tot deze IP-adressen.

protocol

str

standaardwaarde: None

Hiermee geeft u het protocol op dat is toegestaan voor een aanvraag die is gedaan. De standaardwaarde is https,http. Zie Protocol voor mogelijke waarden.

cache_control

str

standaardwaarde: None

Antwoordheaderwaarde voor Cache-Control wanneer de resource wordt geopend met behulp van deze shared access signature.

content_disposition

str

standaardwaarde: None

De waarde van de antwoordheader voor Content-Disposition wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

content_encoding

str

standaardwaarde: None

Antwoordheaderwaarde voor inhoudscodering wanneer de resource wordt geopend met behulp van deze shared access signature.

content_language

str

standaardwaarde: None

Antwoordheaderwaarde voor Content-Language wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

content_type

str

standaardwaarde: None

Antwoordheaderwaarde voor Inhoudstype wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

user_delegation_key

UserDelegationKey

standaardwaarde: None

In plaats van een accountsleutel kan de gebruiker een gebruikersdelegatiesleutel doorgeven. Een sleutel voor gebruikersdelegatie kan worden verkregen van de service door te verifiëren met een AAD-identiteit; dit kan worden bereikt door get_user_delegation_key aan te roepen. Indien aanwezig, wordt de SAS in plaats daarvan ondertekend met de sleutel voor gebruikersdelegatie.

Retouren

Een Sas-token (Shared Access Signature).

Retourtype

str

generate_container_shared_access_signature

Hiermee genereert u een shared access signature voor de container. Gebruik de geretourneerde handtekening met de parameter sas_token van een BlobService.

generate_container_shared_access_signature(container_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

Parameters

container_name

str

Vereist

Naam van container.

permission

ContainerPermissions

standaardwaarde: None

De machtigingen die zijn gekoppeld aan de Shared Access Signature. De gebruiker is beperkt tot bewerkingen die zijn toegestaan door de machtigingen. Machtigingen moeten worden gerangschikt op lezen, schrijven, verwijderen, lijst. Vereist tenzij er een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid.

expiry

datetime of str

standaardwaarde: None

Het tijdstip waarop de handtekening voor gedeelde toegang ongeldig wordt. Vereist tenzij er een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

start

datetime of str

standaardwaarde: None

Het tijdstip waarop de Shared Access Signature geldig wordt. Als u dit weglaat, wordt ervan uitgegaan dat de begintijd voor deze aanroep het tijdstip is waarop de opslagservice de aanvraag ontvangt. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

id

str

standaardwaarde: None

Een unieke waarde van maximaal 64 tekens die overeenkomt met een opgeslagen toegangsbeleid. Gebruik set_blob_service_properties om een opgeslagen toegangsbeleid te maken.

ip

str

standaardwaarde: None

Hiermee geeft u een IP-adres of een bereik van IP-adressen van waaruit aanvragen te accepteren. Als het IP-adres waaruit de aanvraag afkomstig is, niet overeenkomt met het IP-adres of adresbereik dat is opgegeven in het SAS-token, wordt de aanvraag niet geverifieerd. Als u bijvoorbeeld sip=168.1.5.65 of sip=168.1.5.60-168.1.5.70 opgeeft op de SAS, wordt de aanvraag beperkt tot deze IP-adressen.

protocol

str

standaardwaarde: None

Hiermee geeft u het protocol op dat is toegestaan voor een aanvraag die is gedaan. De standaardwaarde is https,http. Zie Protocol voor mogelijke waarden.

cache_control

str

standaardwaarde: None

Antwoordheaderwaarde voor Cache-Control wanneer de resource wordt geopend met behulp van deze shared access signature.

content_disposition

str

standaardwaarde: None

De waarde van de antwoordheader voor Content-Disposition wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

content_encoding

str

standaardwaarde: None

Antwoordheaderwaarde voor inhoudscodering wanneer de resource wordt geopend met behulp van deze shared access signature.

content_language

str

standaardwaarde: None

Antwoordheaderwaarde voor Content-Language wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

content_type

str

standaardwaarde: None

Antwoordheaderwaarde voor Inhoudstype wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

user_delegation_key

UserDelegationKey

standaardwaarde: None

In plaats van een accountsleutel kan de gebruiker een gebruikersdelegatiesleutel doorgeven. Een sleutel voor gebruikersdelegatie kan worden verkregen van de service door te verifiëren met een AAD-identiteit; dit kan worden bereikt door get_user_delegation_key aan te roepen. Indien aanwezig, wordt de SAS in plaats daarvan ondertekend met de sleutel voor gebruikersdelegatie.

Retouren

Een Sas-token (Shared Access Signature).

Retourtype

str

get_blob_account_information

Hiermee haalt u informatie op met betrekking tot het opslagaccount. De informatie kan ook worden opgehaald als de gebruiker een SAS voor een container of blob heeft.

get_blob_account_information(container_name=None, blob_name=None, timeout=None)

Parameters

container_name

str

standaardwaarde: None

Naam van bestaande container. Optioneel, tenzij u een SAS-token gebruikt voor een specifieke container of blob. In dat geval is dit vereist.

blob_name

str

standaardwaarde: None

Naam van bestaande blob. Optioneel, tenzij u een SAS-token gebruikt voor een specifieke blob. In dat geval is dit vereist.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

De AccountInformation.

get_blob_metadata

Retourneert alle door de gebruiker gedefinieerde metagegevens voor de opgegeven blob of momentopname.

get_blob_metadata(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

snapshot

str

standaardwaarde: None

De parameter momentopname is een ondoorzichtige waarde die, indien aanwezig, de blob-momentopname aangeeft die moet worden opgehaald.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

Ontsleutelt 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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

Een woordenlijst die de naam van de blobmetagegevens en waardeparen vertegenwoordigt.

Retourtype

dict(str, str)

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. Retourneert Blob met BlobProperties en een metagegevensdict.

get_blob_properties(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

snapshot

str

standaardwaarde: None

De parameter momentopname is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de blobmomentopname aangeeft die moet worden opgehaald.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

Ontsleutelt 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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

een blob-object met eigenschappen en metagegevens.

Retourtype

Blob

get_blob_service_properties

Hiermee haalt u de eigenschappen op van de Blob-service van een opslagaccount, waaronder Azure Opslaganalyse.

get_blob_service_properties(timeout=None)

Parameters

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

De blob ServiceProperties met een gekoppelde target_version eigenschap.

get_blob_service_stats

Hiermee haalt u statistieken op met betrekking tot replicatie voor de Blob-service. Deze is alleen beschikbaar wanneer geografisch redundante replicatie met leestoegang is ingeschakeld voor het opslagaccount.

Met geografisch redundante replicatie onderhoudt Azure Storage uw gegevens duurzaam op twee locaties. Op beide locaties onderhoudt Azure Storage voortdurend meerdere goede replica's van uw gegevens. De locatie waar u gegevens leest, maakt, bijwerkt of verwijdert, is de primaire opslagaccountlocatie. De primaire locatie bestaat in de regio die u kiest op het moment dat u een account maakt via de klassieke Azure Management Azure-portal, bijvoorbeeld VS - noord-centraal. De locatie waarnaar uw gegevens worden gerepliceerd, is de secundaire locatie. De secundaire locatie wordt automatisch bepaald op basis van de locatie van de primaire; het bevindt zich in een tweede datacenter dat zich in dezelfde regio bevindt als de primaire locatie. Alleen-lezentoegang is beschikbaar vanaf de secundaire locatie, als geografisch redundante replicatie met leestoegang is ingeschakeld voor uw opslagaccount.

get_blob_service_stats(timeout=None)

Parameters

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

De blobservicestatistieken.

Retourtype

ServiceStats

get_blob_to_bytes

Hiermee downloadt u een blob als een matrix van bytes, met automatische segmentering en voortgangsmeldingen. Retourneert een exemplaar van Blob met eigenschappen, metagegevens en inhoud.

get_blob_to_bytes(container_name, blob_name, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

snapshot

str

standaardwaarde: None

De parameter momentopname is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de blobmomentopname aangeeft die moet worden opgehaald.

start_range

int

standaardwaarde: None

Begin van het bytebereik dat moet worden gebruikt voor het downloaden van een sectie van de blob. Als er geen end_range wordt gegeven, worden alle bytes na de start_range gedownload. De start_range en end_range parameters zijn inclusief. Bijvoorbeeld: start_range=0, downloadt end_range=511 de eerste 512 bytes aan blob.

end_range

int

standaardwaarde: None

Einde van het bytebereik dat moet worden gebruikt voor het downloaden van een sectie van de blob. Als end_range wordt gegeven, moet start_range worden opgegeven. De start_range en end_range parameters zijn inclusief. Bijvoorbeeld: start_range=0, downloadt end_range=511 de eerste 512 bytes aan blob.

validate_content

bool

standaardwaarde: False

Indien ingesteld op true, valideert een MD5-hash voor elk opgehaald gedeelte van de blob. Dit is vooral waardevol 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 de service alleen transactionele MD5's retourneert voor segmenten van 4 MB of minder, zodat de eerste aanvraag voor ophalen zelf de grootte heeft. MAX_CHUNK_GET_SIZE in plaats van zelf. MAX_SINGLE_GET_SIZE. Als het zelf is. MAX_CHUNK_GET_SIZE is ingesteld op meer dan 4 MB, wordt er een fout gegenereerd. Omdat het berekenen van de MD5 verwerkingstijd kost en er meer aanvragen moeten worden uitgevoerd vanwege de kleinere segmentgrootte, kan er enige toename van de latentie optreden.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

standaardwaarde: None

Callback voor voortgang met handtekeningfunctie (huidig, totaal) waarbij huidige het aantal bytes is dat tot nu toe is overgedragen en totaal de grootte van de blob is, indien bekend.

max_connections

int

standaardwaarde: 2

Als dit is ingesteld op 2 of hoger, wordt een eerste keer get uitgevoerd voor de eerste zelf. MAX_SINGLE_GET_SIZE bytes van de blob. Als dit de hele blob is, retourneert de methode op dit punt. Als dat niet zo is, worden de resterende gegevens parallel gedownload met behulp van het aantal threads dat gelijk is aan max_connections. Elk segment heeft zelf de grootte. MAX_CHUNK_GET_SIZE. Als dit is ingesteld op 1, wordt één grote get-aanvraag uitgevoerd. Dit wordt over het algemeen niet aanbevolen, maar is beschikbaar als er zeer weinig threads moeten worden gebruikt, netwerkaanvragen erg duur zijn of als een niet-doorzoekbare stroom parallelle downloads verhindert. Dit kan ook handig zijn als veel blobs naar verwachting leeg zijn, omdat er een extra aanvraag is vereist voor lege blobs als max_connections groter is dan 1.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

Ontsleutelt 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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden. Met deze methode kunnen meerdere aanroepen naar de Azure-service worden uitgevoerd en de time-out is van toepassing op elke aanroep afzonderlijk.

Retouren

Een blob met eigenschappen en metagegevens. Als max_connections groter is dan 1, wordt de content_md5 (indien ingesteld op de blob) niet geretourneerd. Als u deze waarde nodig hebt, gebruikt u get_blob_properties of stelt u max_connections in op 1.

Retourtype

Blob

get_blob_to_path

Hiermee downloadt u een blob naar een bestandspad, met automatische segmentering en voortgangsmeldingen. Retourneert een exemplaar van Blob met eigenschappen en metagegevens.

get_blob_to_path(container_name, blob_name, file_path, open_mode='wb', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

file_path

str

Vereist

Pad van het bestand om naar uit te schrijven.

open_mode

str

standaardwaarde: wb

Modus die moet worden gebruikt bij het openen van het bestand. Houd er rekening mee dat het opgeven van alleen toevoegen open_mode parallel downloaden voorkomt. Max_connections moet dus worden ingesteld op 1 als deze open_mode wordt gebruikt.

snapshot

str

standaardwaarde: None

De parameter momentopname is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de blobmomentopname aangeeft die moet worden opgehaald.

start_range

int

standaardwaarde: None

Begin van het bytebereik dat moet worden gebruikt voor het downloaden van een sectie van de blob. Als er geen end_range wordt gegeven, worden alle bytes na de start_range gedownload. De start_range en end_range parameters zijn inclusief. Bijvoorbeeld: start_range=0, downloadt end_range=511 de eerste 512 bytes aan blob.

end_range

int

standaardwaarde: None

Einde van het bytebereik dat moet worden gebruikt voor het downloaden van een sectie van de blob. Als end_range wordt gegeven, moet start_range worden opgegeven. De start_range en end_range parameters zijn inclusief. Bijvoorbeeld: start_range=0, downloadt end_range=511 de eerste 512 bytes aan blob.

validate_content

bool

standaardwaarde: False

Indien ingesteld op true, valideert een MD5-hash voor elk opgehaald gedeelte van de blob. Dit is vooral waardevol 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 de service alleen transactionele MD5's retourneert voor segmenten van 4 MB of minder, zodat de eerste aanvraag voor ophalen zelf de grootte heeft. MAX_CHUNK_GET_SIZE in plaats van zelf. MAX_SINGLE_GET_SIZE. Als het zelf is. MAX_CHUNK_GET_SIZE is ingesteld op meer dan 4 MB, wordt er een fout gegenereerd. Omdat het berekenen van de MD5 verwerkingstijd kost en er meer aanvragen moeten worden uitgevoerd vanwege de kleinere segmentgrootte, kan er enige toename van de latentie optreden.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

standaardwaarde: None

Callback voor voortgang met handtekeningfunctie (huidig, totaal) waarbij huidige het aantal bytes is dat tot nu toe is overgedragen en totaal de grootte van de blob is, indien bekend.

max_connections

int

standaardwaarde: 2

Als dit is ingesteld op 2 of hoger, wordt een eerste keer get uitgevoerd voor de eerste zelf. MAX_SINGLE_GET_SIZE bytes van de blob. Als dit de hele blob is, retourneert de methode op dit punt. Als dat niet zo is, worden de resterende gegevens parallel gedownload met behulp van het aantal threads dat gelijk is aan max_connections. Elk segment heeft zelf de grootte. MAX_CHUNK_GET_SIZE. Als dit is ingesteld op 1, wordt één grote get-aanvraag uitgevoerd. Dit wordt over het algemeen niet aanbevolen, maar is beschikbaar als er zeer weinig threads moeten worden gebruikt, netwerkaanvragen erg duur zijn of als een niet-doorzoekbare stroom parallelle downloads verhindert. Dit kan ook handig zijn als veel blobs naar verwachting leeg zijn, omdat er een extra aanvraag is vereist voor lege blobs als max_connections groter is dan 1.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

Ontsleutelt 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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden. Met deze methode kunnen meerdere aanroepen naar de Azure-service worden uitgevoerd en de time-out is van toepassing op elke aanroep afzonderlijk.

Retouren

Een blob met eigenschappen en metagegevens. Als max_connections groter is dan 1, wordt de content_md5 (indien ingesteld op de blob) niet geretourneerd. Als u deze waarde nodig hebt, gebruikt u get_blob_properties of stelt u max_connections in op 1.

Retourtype

Blob

get_blob_to_stream

Hiermee downloadt u een blob naar een stream, met automatische segmentering en voortgangsmeldingen. Retourneert een exemplaar van Blob met eigenschappen en metagegevens.

get_blob_to_stream(container_name, blob_name, stream, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

stream

IOBase

Vereist

Er is een stream geopend om naar te schrijven.

snapshot

str

standaardwaarde: None

De parameter momentopname is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de blobmomentopname aangeeft die moet worden opgehaald.

start_range

int

standaardwaarde: None

Begin van het bytebereik dat moet worden gebruikt voor het downloaden van een sectie van de blob. Als er geen end_range wordt gegeven, worden alle bytes na de start_range gedownload. De start_range en end_range parameters zijn inclusief. Bijvoorbeeld: start_range=0, downloadt end_range=511 de eerste 512 bytes aan blob.

end_range

int

standaardwaarde: None

Einde van het bytebereik dat moet worden gebruikt voor het downloaden van een sectie van de blob. Als end_range wordt gegeven, moet start_range worden opgegeven. De start_range en end_range parameters zijn inclusief. Bijvoorbeeld: start_range=0, downloadt end_range=511 de eerste 512 bytes aan blob.

validate_content

bool

standaardwaarde: False

Indien ingesteld op true, valideert een MD5-hash voor elk opgehaald gedeelte van de blob. Dit is vooral waardevol 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 de service alleen transactionele MD5's retourneert voor segmenten van 4 MB of minder, zodat de eerste aanvraag voor ophalen zelf de grootte heeft. MAX_CHUNK_GET_SIZE in plaats van zelf. MAX_SINGLE_GET_SIZE. Als het zelf is. MAX_CHUNK_GET_SIZE is ingesteld op meer dan 4 MB, wordt er een fout gegenereerd. Omdat het berekenen van de MD5 verwerkingstijd kost en er meer aanvragen moeten worden uitgevoerd vanwege de kleinere segmentgrootte, kan er enige toename van de latentie optreden.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

standaardwaarde: None

Callback voor voortgang met handtekeningfunctie (huidig, totaal) waarbij huidige het aantal bytes is dat tot nu toe is overgedragen en totaal de grootte van de blob is, indien bekend.

max_connections

int

standaardwaarde: 2

Als dit is ingesteld op 2 of hoger, wordt een eerste keer get uitgevoerd voor de eerste zelf. MAX_SINGLE_GET_SIZE bytes van de blob. Als dit de hele blob is, retourneert de methode op dit punt. Als dat niet zo is, worden de resterende gegevens parallel gedownload met behulp van het aantal threads dat gelijk is aan max_connections. Elk segment heeft zelf de grootte. MAX_CHUNK_GET_SIZE. Als dit is ingesteld op 1, wordt één grote get-aanvraag uitgevoerd. Dit wordt over het algemeen niet aanbevolen, maar is beschikbaar als er zeer weinig threads moeten worden gebruikt, netwerkaanvragen erg duur zijn of als een niet-doorzoekbare stroom parallelle downloads verhindert. Dit kan ook handig zijn als veel blobs naar verwachting leeg zijn, omdat er een extra aanvraag is vereist voor lege blobs als max_connections groter is dan 1.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

Ontsleutelt 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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden. Met deze methode kunnen meerdere aanroepen naar de Azure-service worden uitgevoerd en de time-out is van toepassing op elke aanroep afzonderlijk.

Retouren

Een blob met eigenschappen en metagegevens. Als max_connections groter is dan 1, wordt de content_md5 (indien ingesteld op de blob) niet geretourneerd. Als u deze waarde nodig hebt, gebruikt u get_blob_properties of stelt u max_connections in op 1.

Retourtype

Blob

get_blob_to_text

Hiermee downloadt u een blob als unicode-tekst, met automatische segmentering en voortgangsmeldingen. Retourneert een exemplaar van Blob met eigenschappen, metagegevens en inhoud.

get_blob_to_text(container_name, blob_name, encoding='utf-8', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

encoding

str

standaardwaarde: utf-8

Python-codering die moet worden gebruikt bij het decoderen van de blobgegevens.

snapshot

str

standaardwaarde: None

De parameter momentopname is een ondoorzichtige Datum/tijd-waarde die, indien aanwezig, de blobmomentopname aangeeft die moet worden opgehaald.

start_range

int

standaardwaarde: None

Begin van het bytebereik dat moet worden gebruikt voor het downloaden van een sectie van de blob. Als er geen end_range wordt opgegeven, worden alle bytes na de start_range gedownload. De start_range en end_range zijn inclusief. Bijvoorbeeld: start_range=0, end_range=511 downloadt de eerste 512 bytes blob.

end_range

int

standaardwaarde: None

Einde van bytebereik dat moet worden gebruikt voor het downloaden van een sectie van de blob. Als end_range wordt opgegeven, moet start_range worden opgegeven. De start_range en end_range zijn inclusief. Bijvoorbeeld: start_range=0, end_range=511 downloadt de eerste 512 bytes blob.

validate_content

bool

standaardwaarde: False

Indien ingesteld op true, valideert een MD5-hash voor elk opgehaald gedeelte van de blob. Dit is vooral waardevol 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 de service alleen transactionele MD5's retourneert voor segmenten van 4 MB of minder, dus de eerste get-aanvraag is van de grootte zelf. MAX_CHUNK_GET_SIZE in plaats van zelf. MAX_SINGLE_GET_SIZE. Als je zelf bent. MAX_CHUNK_GET_SIZE is ingesteld op meer dan 4 MB, wordt er een fout gegenereerd. Omdat het berekenen van de MD5 verwerkingstijd kost en er meer aanvragen moeten worden uitgevoerd vanwege de kleinere segmentgrootte, kan de latentie enigszins toenemen.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

standaardwaarde: None

Callback voor voortgang met de handtekeningfunctie (huidig, totaal) waarbij huidig het aantal bytes is dat tot nu toe is overgedragen en totaal de grootte van de blob is, indien bekend.

max_connections

int

standaardwaarde: 2

Als deze optie is ingesteld op 2 of hoger, wordt een eerste keer get uitgevoerd voor de eerste zelf. MAX_SINGLE_GET_SIZE bytes van de blob. Als dit de hele blob is, retourneert de methode op dit punt. Als dat niet zo is, worden de resterende gegevens parallel gedownload met behulp van het aantal threads dat gelijk is aan max_connections. Elk segment heeft de grootte zelf. MAX_CHUNK_GET_SIZE. Als dit is ingesteld op 1, wordt één grote get-aanvraag uitgevoerd. Dit wordt over het algemeen niet aanbevolen, maar is beschikbaar als er zeer weinig threads moeten worden gebruikt, netwerkaanvragen erg duur zijn of als een niet-doorzoekbare stroom parallelle download verhindert. Dit kan ook handig zijn als veel blobs naar verwachting leeg zijn, omdat er een extra aanvraag is vereist voor lege blobs als max_connections groter is dan 1.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

Ontsleutelt 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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden. Deze methode kan meerdere aanroepen naar de Azure-service uitvoeren en de time-out is van toepassing op elke aanroep afzonderlijk.

Retouren

Een blob met eigenschappen en metagegevens. Als max_connections groter is dan 1, wordt de content_md5 (indien ingesteld op de blob) niet geretourneerd. Als u deze waarde nodig hebt, gebruikt u get_blob_properties of stelt u max_connections in op 1.

Retourtype

Blob

get_block_list

Hiermee haalt u de lijst met blokken op die zijn geüpload als onderdeel van een blok-blob. Er worden twee bloklijsten onderhouden voor een blob:

Vastgelegde blokkeringslijst: de lijst met blokken die zijn doorgevoerd naar een bepaalde blob met putbloklijst.

Niet-doorgevoerde blokkeringslijst: de lijst met blokken die zijn geüpload voor een blob met behulp van Put Block, maar die nog niet zijn doorgevoerd. Deze blokken worden in Azure opgeslagen in combinatie met een blob, maar maken nog geen deel uit van de blob.

get_block_list(container_name, blob_name, snapshot=None, block_list_type=None, lease_id=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

snapshot

str

standaardwaarde: None

Datum/tijd om de tijd te bepalen waarop de blokken moeten worden opgehaald.

block_list_type

str

standaardwaarde: None

Hiermee geeft u op of de lijst met vastgelegde blokken, de lijst met niet-doorgevoerde blokken of beide lijsten samen moet worden geretourneerd. Geldige waarden zijn: vastgelegd, niet-doorgevoerd of alle.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

vastgelegde en/of niet-doorgevoerde blokken voor blok-blob weergeven

Retourtype

BlobBlockList

get_container_acl

Hiermee haalt u de machtigingen voor de opgegeven container op. De machtigingen geven aan of containergegevens openbaar kunnen worden geopend.

get_container_acl(container_name, lease_id=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

lease_id

standaardwaarde: None

Indien opgegeven, slaagt get_container_acl alleen als de lease van de container actief is en overeenkomt met deze id.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

Een woordenlijst met toegangsbeleidsregels die zijn gekoppeld aan de container. dict of str to AccessPolicy en een public_access eigenschap als openbare toegang is ingeschakeld

get_container_metadata

Retourneert alle door de gebruiker gedefinieerde metagegevens voor de opgegeven container.

get_container_metadata(container_name, lease_id=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

lease_id

str

standaardwaarde: None

Indien opgegeven, slaagt get_container_metadata alleen als de lease van de container actief is en overeenkomt met deze id.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

Een woordenlijst die de naam van de metagegevens van de container en waardeparen vertegenwoordigt.

Retourtype

dict(str, str)

get_container_properties

Retourneert alle door de gebruiker gedefinieerde metagegevens en systeemeigenschappen voor de opgegeven container. De geretourneerde gegevens bevatten niet de lijst met blobs van de container.

get_container_properties(container_name, lease_id=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

lease_id

str

standaardwaarde: None

Indien opgegeven, slaagt get_container_properties alleen als de lease van de container actief is en overeenkomt met deze id.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

eigenschappen voor de opgegeven container in een containerobject.

Retourtype

Container

get_user_delegation_key

Verkrijg een sleutel voor gebruikersdelegatie voor het ondertekenen van SAS-tokens. Deze aanvraag slaagt alleen als er een tokenreferentie aanwezig is op het serviceobject.

get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)

Parameters

key_start_time

datetime

Vereist

Een datum/tijd-waarde. Geeft aan wanneer de sleutel geldig wordt.

key_expiry_time

datetime

Vereist

Een datum/tijd-waarde. Geeft aan wanneer de sleutel niet meer geldig is.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

De sleutel voor gebruikersdelegatie.

Retourtype

UserDelegationKey

list_blob_names

Retourneert een generator om de blobnamen onder de opgegeven container weer te geven. De generator volgt langzaam de vervolgtokens die door de service worden geretourneerd en stopt wanneer alle blobs zijn geretourneerd of num_results is bereikt.

Als num_results is opgegeven en het account meer dan dat aantal blobs heeft, heeft de generator een ingevuld next_marker veld zodra het is voltooid. Deze markering kan worden gebruikt om een nieuwe generator te maken als meer resultaten gewenst zijn.

list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

prefix

str

standaardwaarde: None

Filtert de resultaten om alleen blobs te retourneren waarvan de naam begint met het opgegeven voorvoegsel.

num_results

int

standaardwaarde: None

Hiermee geeft u het maximum aantal blobs dat moet worden geretourneerd, inclusief alle <xref:azure.storage.blob.blockblobservice.BlobPrefix> elementen. Als de aanvraag geen num_results of een waarde opgeeft die groter is dan 5000, retourneert de server maximaal 5000 items. Als u num_results instelt op een waarde die kleiner is dan of gelijk is aan nul, resulteert dit in foutcode 400 (ongeldige aanvraag).

include

Include

standaardwaarde: None

Hiermee geeft u een of meer aanvullende gegevenssets op die moeten worden opgenomen in het antwoord.

delimiter

str

standaardwaarde: None

Wanneer de aanvraag deze parameter bevat, retourneert de bewerking een BlobPrefix element in de resultatenlijst dat fungeert als een tijdelijke aanduiding voor alle blobs waarvan de namen beginnen met dezelfde subtekenreeks tot het uiterlijk van het scheidingsteken. Het scheidingsteken kan één teken of een tekenreeks zijn.

marker

str

standaardwaarde: None

Een ondoorzichtig vervolgtoken. Deze waarde kan worden opgehaald uit het veld next_marker van een vorige generatorobject als num_results is opgegeven en de resultaten van die generator zijn voltooid. Indien opgegeven, begint deze generator met het retourneren van resultaten vanaf het punt waar de vorige generator is gestopt.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

list_blobs

Retourneert een generator om de blobs onder de opgegeven container weer te geven. De generator volgt lui de vervolgtokens die door de service worden geretourneerd en stopt wanneer alle blobs zijn geretourneerd of num_results is bereikt.

Als num_results is opgegeven en het account meer dan dat aantal blobs heeft, heeft de generator een ingevuld next_marker veld zodra het is voltooid. Deze markering kan worden gebruikt om een nieuwe generator te maken als er meer resultaten worden gewenst.

list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

prefix

str

standaardwaarde: None

Filtert de resultaten om alleen blobs te retourneren waarvan de naam begint met het opgegeven voorvoegsel.

num_results

int

standaardwaarde: None

Hiermee geeft u het maximum aantal blobs op dat moet worden geretourneerd, inclusief alle <xref:azure.storage.blob.blockblobservice.BlobPrefix> elementen. Als de aanvraag geen num_results of een waarde opgeeft die groter is dan 5000, retourneert de server maximaal 5000 items. Als u num_results instelt op een waarde die kleiner is dan of gelijk is aan nul, resulteert dit in foutcode 400 (Ongeldige aanvraag).

include

Include

standaardwaarde: None

Hiermee geeft u een of meer extra gegevenssets op die moeten worden opgenomen in het antwoord.

delimiter

str

standaardwaarde: None

Wanneer de aanvraag deze parameter bevat, retourneert de bewerking een BlobPrefix element in de resultatenlijst dat fungeert als een tijdelijke aanduiding voor alle blobs waarvan de namen beginnen met dezelfde subtekenreeks tot het uiterlijk van het scheidingsteken. Het scheidingsteken kan één teken of een tekenreeks zijn.

marker

str

standaardwaarde: None

Een ondoorzichtig vervolgtoken. Deze waarde kan worden opgehaald uit het veld next_marker van een eerder generatorobject als num_results is opgegeven en die generator klaar is met het inventariseren van de resultaten. Indien opgegeven, begint deze generator met het retourneren van resultaten vanaf het punt waar de vorige generator is gestopt.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

list_containers

Retourneert een generator om de containers onder het opgegeven account weer te geven. De generator volgt lui de vervolgtokens die door de service worden geretourneerd en stopt wanneer alle containers zijn geretourneerd of num_results is bereikt.

Als num_results is opgegeven en het account meer dan dat aantal containers heeft, heeft de generator een ingevuld next_marker veld zodra het is voltooid. Deze markering kan worden gebruikt om een nieuwe generator te maken als er meer resultaten worden gewenst.

list_containers(prefix=None, num_results=None, include_metadata=False, marker=None, timeout=None)

Parameters

prefix

str

standaardwaarde: None

Filtert de resultaten om alleen containers te retourneren waarvan de naam begint met het opgegeven voorvoegsel.

num_results

int

standaardwaarde: None

Hiermee geeft u het maximum aantal containers op dat moet worden geretourneerd. Een enkele lijstaanvraag kan maximaal 1000 contianers retourneren en mogelijk een vervolgtoken dat moet worden gevolgd om extra resutls te krijgen.

include_metadata

bool

standaardwaarde: False

Hiermee geeft u op dat containermetagegevens worden geretourneerd in het antwoord.

marker

str

standaardwaarde: None

Een ondoorzichtig vervolgtoken. Deze waarde kan worden opgehaald uit het veld next_marker van een eerder generatorobject als num_results is opgegeven en die generator klaar is met het inventariseren van de resultaten. Indien opgegeven, begint deze generator met het retourneren van resultaten vanaf het punt waar de vorige generator is gestopt.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

make_blob_url

Hiermee maakt u de URL voor toegang tot een blob.

make_blob_url(container_name, blob_name, protocol=None, sas_token=None, snapshot=None)

Parameters

container_name

str

Vereist

Naam van container.

blob_name

str

Vereist

Naam van blob.

protocol

str

standaardwaarde: None

Te gebruiken protocol: 'http' of 'https'. Als dit niet is opgegeven, wordt het protocol gebruikt dat is opgegeven toen BaseBlobService werd geïnitialiseerd.

sas_token

str

standaardwaarde: None

Shared Access Signature-token gemaakt met generate_shared_access_signature.

snapshot

str

standaardwaarde: None

Een tekenreekswaarde die de momentopname uniek identificeert. De waarde van deze queryparameter geeft de versie van de momentopname aan.

Retouren

URL voor blob-toegang.

Retourtype

str

make_container_url

Hiermee maakt u de URL voor toegang tot een container.

make_container_url(container_name, protocol=None, sas_token=None)

Parameters

container_name

str

Vereist

Naam van container.

protocol

str

standaardwaarde: None

Te gebruiken protocol: 'http' of 'https'. Als dit niet is opgegeven, wordt het protocol gebruikt dat is opgegeven toen BaseBlobService werd geïnitialiseerd.

sas_token

str

standaardwaarde: None

Shared Access Signature-token gemaakt met generate_shared_access_signature.

Retouren

URL voor containertoegang.

Retourtype

str

put_block

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

put_block(container_name, blob_name, block, block_id, validate_content=False, lease_id=None, timeout=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van blob.

block

IOBase of <xref:<xref:bytes Content> of <xref:the block.>>

Vereist

Inhoud van het blok.

block_id

str

Vereist

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

validate_content

bool

standaardwaarde: False

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 waardevol 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.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

put_block_from_url

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

put_block_from_url(container_name, blob_name, copy_source_url, block_id, source_range_start=None, source_range_end=None, source_content_md5=None, lease_id=None, timeout=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van blob.

copy_source_url

str

Vereist

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

source_range_start

int

standaardwaarde: None

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

source_range_end

int

standaardwaarde: None

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

block_id

str

Vereist

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

source_content_md5

str

standaardwaarde: None

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

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

put_block_list

Hiermee schrijft u een blob door de lijst met blok-id's waaruit de blob bestaat op te geven. Als u wilt worden geschreven als onderdeel van een blob, moet een blok zijn geschreven naar de server in een eerdere Put Block-bewerking.

U kunt Put Block List aanroepen om een blob bij te werken door alleen de blokken te uploaden die zijn gewijzigd en vervolgens de nieuwe en bestaande blokken samen door te voeren. U kunt dit doen door op te geven of u een blok wilt doorvoeren vanuit de lijst met vastgelegde blokkeringen of vanuit de lijst met niet-doorgevoerde blokkeringen, of door de meest recent geüploade versie van het blok door te voeren, afhankelijk van de lijst waartoe deze behoort.

put_block_list(container_name, blob_name, block_list, content_settings=None, metadata=None, validate_content=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

block_list

list(BlobBlock)

Vereist

Een lijst met <xref:azure.storeage.blob.models.BlobBlock> de blok-id's en de blokkeringsstatus.

content_settings

ContentSettings

standaardwaarde: None

ContentSettings-object dat wordt gebruikt om eigenschappen in te stellen op de blob.

metadata

dict(str, str)

standaardwaarde: None

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

validate_content

bool

standaardwaarde: False

Als dit waar is, wordt een MD5-hash van de inhoud van de bloklijst berekend. De opslagservice controleert de hash van de inhoud van de bloklijst die is aangekomen met de hash die is verzonden. Dit is vooral waardevol 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 controle is gekoppeld aan de inhoud van de bloklijst en niet aan de inhoud van de blob zelf.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

standard_blob_tier

StandardBlobTier

standaardwaarde: None

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.

Retouren

ETag en laatst gewijzigde eigenschappen voor de bijgewerkte blok-blob

Retourtype

ResourceProperties

release_blob_lease

Hiermee wordt de lease vrijgegeven. De lease kan worden vrijgegeven als de lease-id die is opgegeven in de aanvraag overeenkomt met de lease-id die is gekoppeld aan de blob. Door de lease vrij te geven, kan een andere client onmiddellijk de lease voor de blob verkrijgen zodra de release is voltooid.

release_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

lease_id

str

Vereist

Lease-id voor actieve lease.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

release_container_lease

Laat de lease los. De lease kan worden vrijgegeven als de opgegeven lease_id overeenkomt met de opgegeven aan de container. Door de lease vrij te geven, kan een andere client de lease voor de container onmiddellijk verkrijgen zodra de release is voltooid.

release_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

lease_id

str

Vereist

Lease-id voor actieve lease.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

renew_blob_lease

Hiermee wordt de lease verlengd. De lease kan worden verlengd als de lease-id die is opgegeven in de aanvraag overeenkomt met de lease-id die is gekoppeld aan de blob. Houd er rekening mee dat de lease kan worden verlengd, zelfs als deze is verlopen zolang de blob niet is gewijzigd of opnieuw is geleased sinds de vervaldatum van die lease. Wanneer u een lease verlengt, wordt de klok voor de leaseduur opnieuw ingesteld.

renew_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

lease_id

str

Vereist

Lease-id voor actieve lease.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

Str

renew_container_lease

Hiermee wordt de lease verlengd. De lease kan worden vernieuwd als de opgegeven lease-id overeenkomt met de opgegeven lease-id die is gekoppeld aan de container. Houd er rekening mee dat de lease kan worden verlengd, zelfs als deze is verlopen zolang de container niet opnieuw is geleased sinds het verstrijken van die lease. Wanneer u een lease verlengt, wordt de klok voor de leaseduur opnieuw ingesteld.

renew_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

lease_id

str

Vereist

Lease-id voor actieve lease.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

Str

set_blob_metadata

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

set_blob_metadata(container_name, blob_name, metadata=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

metadata

dict(str, str)

standaardwaarde: None

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_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

ETag en laatst gewijzigde eigenschappen voor de bijgewerkte blob

Retourtype

ResourceProperties

set_blob_properties

Hiermee stelt u systeemeigenschappen in op de blob. Als er één eigenschap is ingesteld voor de content_settings, worden alle eigenschappen overschreven.

set_blob_properties(container_name, blob_name, content_settings=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

content_settings

ContentSettings

standaardwaarde: None

ContentSettings-object dat wordt gebruikt om blobeigenschappen in te stellen.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

ETag en laatst gewijzigde eigenschappen voor de bijgewerkte blob

Retourtype

ResourceProperties

set_blob_service_properties

Hiermee stelt u de eigenschappen van de Blob-service van een opslagaccount in, waaronder Azure Opslaganalyse. Als een element (bijvoorbeeld logboekregistratie) wordt overgelaten op Geen, blijven de bestaande instellingen in de service voor die functionaliteit behouden.

set_blob_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, target_version=None, timeout=None, delete_retention_policy=None, static_website=None)

Parameters

logging

Logging

standaardwaarde: None

Groepeert de azure Analytics-instellingen voor logboekregistratie.

hour_metrics

Metrics

standaardwaarde: None

De instellingen voor metrische uurgegevens bieden een samenvatting van aanvraagstatistieken gegroepeerd per API in aggregaties per uur voor blobs.

minute_metrics

Metrics

standaardwaarde: None

De instellingen voor metrische minuutgegevens bieden aanvraagstatistieken voor elke minuut voor blobs.

cors

list(CorsRule)

standaardwaarde: None

U kunt maximaal vijf CorsRule-elementen in de lijst opnemen. Als er een lege lijst is opgegeven, worden alle CORS-regels verwijderd en CORS uitgeschakeld voor de service.

target_version

str

standaardwaarde: None

Geeft de standaardversie aan die moet worden gebruikt voor aanvragen als de versie van een binnenkomende aanvraag niet is opgegeven.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

delete_retention_policy

DeleteRetentionPolicy

standaardwaarde: None

Het bewaarbeleid voor verwijderen geeft aan of verwijderde blobs moeten worden behouden. Ook wordt het aantal dagen en versies van de blob opgegeven dat moet worden bewaard.

static_website

StaticWebsite

standaardwaarde: None

Hiermee geeft u op of de functie statische website is ingeschakeld en zo ja, geeft u het indexdocument en het 404-foutdocument aan dat moet worden gebruikt.

set_container_acl

Hiermee stelt u de machtigingen in voor de opgegeven container of het opgeslagen toegangsbeleid dat kan worden gebruikt met Shared Access Signatures. De machtigingen geven aan of blobs in een container openbaar toegankelijk zijn.

set_container_acl(container_name, signed_identifiers=None, public_access=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

signed_identifiers

dict(str, AccessPolicy)

standaardwaarde: None

Een woordenlijst met toegangsbeleidsregels die aan de container moeten worden gekoppeld. De woordenlijst kan maximaal 5 elementen bevatten. Met een lege woordenlijst wordt het toegangsbeleid dat voor de service is ingesteld, gewist.

public_access

PublicAccess

standaardwaarde: None

Mogelijke waarden zijn: container, blob.

lease_id

str

standaardwaarde: None

Indien opgegeven, slaagt set_container_acl alleen als de lease van de container actief is en overeenkomt met deze id.

if_modified_since

datetime

standaardwaarde: None

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 is gewijzigd sinds de opgegeven datum/tijd.

if_unmodified_since

datetime

standaardwaarde: None

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.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

ETag en laatst gewijzigde eigenschappen voor de bijgewerkte container

Retourtype

ResourceProperties

set_container_metadata

Hiermee stelt u een of meer door de gebruiker gedefinieerde naam-waardeparen in voor de opgegeven container. Elke aanroep van deze bewerking vervangt alle bestaande metagegevens die aan de container zijn gekoppeld. Als u alle metagegevens uit de container wilt verwijderen, roept u deze bewerking aan zonder metagegevensdicteerfunctie.

set_container_metadata(container_name, metadata=None, lease_id=None, if_modified_since=None, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

metadata

dict(str, str)

standaardwaarde: None

Een dicteerfunctie met naam-waardeparen die als metagegevens aan de container moeten worden gekoppeld. Voorbeeld: {'category':'test'}

lease_id

str

standaardwaarde: None

Indien opgegeven, slaagt set_container_metadata alleen als de lease van de container actief is en overeenkomt met deze id.

if_modified_since

datetime

standaardwaarde: None

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.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

ETag en laatst gewijzigde eigenschappen voor de bijgewerkte container

Retourtype

ResourceProperties

set_proxy

Hiermee stelt u de host en poort van de proxyserver in voor de HTTP CONNECT-tunneling.

set_proxy(host, port, user=None, password=None)

Parameters

host

str

Vereist

Adres van de proxy. Bijvoorbeeld: '192.168.0.100'

port

int

Vereist

Poort van de proxy. Bijvoorbeeld: 6000

user

str

standaardwaarde: None

Gebruiker voor proxyautorisatie.

password

str

standaardwaarde: None

Wachtwoord voor proxyautorisatie.

set_standard_blob_tier

Hiermee stelt u de blok-bloblagen op de blob in. Deze API wordt alleen ondersteund voor blok-blobs in standaardopslagaccounts.

:p aram RehydratePriority rehydrate_priority: geeft de prioriteit aan waarmee een gearchiveerde blob moet worden gerehydrateerd

set_standard_blob_tier(container_name, blob_name, standard_blob_tier, timeout=None, rehydrate_priority=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van de blob die moet worden bijgewerkt.

standard_blob_tier

StandardBlobTier

Vereist

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.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden. Deze methode kan meerdere aanroepen naar de Azure-service uitvoeren en de time-out is van toepassing op elke aanroep afzonderlijk.

rehydrate_priority

standaardwaarde: None

snapshot_blob

Hiermee maakt u een alleen-lezen momentopname van een blob.

snapshot_blob(container_name, blob_name, metadata=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, lease_id=None, timeout=None, cpk=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

metadata

dict(str, str)

standaardwaarde: None

Hiermee geeft u een door de gebruiker gedefinieerde naam-waardepaar dat is gekoppeld aan de blob. Als er geen naam-waardeparen zijn opgegeven, kopieert de bewerking de metagegevens van de basisblob naar de momentopname. Als een of meer naam-waardeparen worden opgegeven, wordt de momentopname gemaakt met de opgegeven metagegevens en worden metagegevens niet gekopieerd uit de basis-blob.

if_modified_since

datetime

standaardwaarde: None

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

standaardwaarde: None

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.

if_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (*). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource overeenkomt met de opgegeven waarde.

if_none_match

str

standaardwaarde: None

Een ETag-waarde of het jokerteken (). Geef deze header op om de bewerking alleen uit te voeren als de ETag van de resource niet overeenkomt met de opgegeven waarde. Geef het jokerteken () op om de bewerking alleen uit te voeren als de resource niet bestaat en mislukt de bewerking als deze wel bestaat.

lease_id

str

standaardwaarde: None

Vereist als de blob een actieve lease heeft.

cpk

CustomerProvidedEncryptionKey

standaardwaarde: None

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

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Retouren

momentopname-eigenschappen

Retourtype

Blob

undelete_blob

De verwijdering van blob ongedaan maken herstelt de inhoud en metagegevens van voorlopig verwijderde blob of momentopname. Het ongedaan maken van het verwijderen van een blob of momentopname die niet voorlopig is verwijderd, slaagt zonder wijzigingen.

undelete_blob(container_name, blob_name, timeout=None)

Parameters

container_name

str

Vereist

Naam van bestaande container.

blob_name

str

Vereist

Naam van bestaande blob.

timeout

int

standaardwaarde: None

De time-outparameter wordt uitgedrukt in seconden.

Kenmerken

protocol

request_session

socket_timeout

MAX_BLOCK_SIZE

MAX_BLOCK_SIZE = 4194304

MAX_CHUNK_GET_SIZE

MAX_CHUNK_GET_SIZE = 4194304

MAX_SINGLE_GET_SIZE

MAX_SINGLE_GET_SIZE = 33554432

MAX_SINGLE_PUT_SIZE

MAX_SINGLE_PUT_SIZE = 67108864

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD = 4194305