blob Pakket

Pakketten

aio

Klassen

AccessPolicy	Toegangsbeleidsklasse die wordt gebruikt door de ingestelde en get-toegangsbeleidsmethoden in elke service. Een opgeslagen toegangsbeleid kan de begintijd, verlooptijd en machtigingen opgeven voor de Shared Access Signatures waaraan het is gekoppeld. Afhankelijk van hoe u de toegang tot uw resource wilt beheren, kunt u al deze parameters opgeven in het opgeslagen toegangsbeleid en deze weglaten uit de URL voor de Shared Access Signature. Als u dit doet, kunt u het gedrag van de bijbehorende handtekening op elk gewenst moment wijzigen en intrekken. U kunt ook een of meer van de parameters voor het toegangsbeleid opgeven in het opgeslagen toegangsbeleid en de andere parameters op de URL. Ten slotte kunt u alle parameters op de URL opgeven. In dit geval kunt u het opgeslagen toegangsbeleid gebruiken om de handtekening in te trekken, maar niet om het gedrag ervan te wijzigen. De Shared Access Signature en het opgeslagen toegangsbeleid moeten samen alle velden bevatten die nodig zijn om de handtekening te verifiëren. Als er vereiste velden ontbreken, mislukt de aanvraag. Op dezelfde manier mislukt de aanvraag met statuscode 400 (Ongeldige aanvraag) als er een veld is opgegeven in zowel de SHARED Access Signature-URL als in het opgeslagen toegangsbeleid.
AccountSasPermissions	ResourceTypes klasse die moet worden gebruikt met de functie generate_account_sas en voor de AccessPolicies die worden gebruikt met set_*_acl. Er zijn twee typen SAS die kunnen worden gebruikt om toegang tot resources te verlenen. Een daarvan is het verlenen van toegang tot een specifieke resource (resourcespecifiek). Een ander is om toegang te verlenen tot de hele service voor een specifiek account en bepaalde bewerkingen toe te staan op basis van de hier te vinden perms.
ArrowDialect	veld van een pijlschema. Alle vereiste parameters moeten worden ingevuld om naar Azure te kunnen worden verzonden.
BlobAnalyticsLogging	Instellingen voor logboekregistratie van Azure Analytics.
BlobBlock	BlockBlob Block-klasse.
BlobClient	Een client voor interactie met een specifieke blob, hoewel die blob mogelijk nog niet bestaat. Klik hier voor meer optionele configuratie.
BlobLeaseClient	Hiermee maakt u een nieuwe BlobLeaseClient. Deze client biedt leasebewerkingen op een BlobClient of ContainerClient.
BlobPrefix	Een iterable van Blob-eigenschappen. Geretourneerd door walk_blobs wanneer een scheidingsteken wordt gebruikt. Kan worden beschouwd als een virtuele blobmap.
BlobProperties	Blobeigenschappen.
BlobQueryError	De fout is opgetreden tijdens de snelle querybewerking.
BlobQueryReader	Een streaming-object om queryresultaten te lezen.
BlobSasPermissions	BlobSasPermissions-klasse die moet worden gebruikt met de generate_blob_sas functie .
BlobServiceClient	Een client voor interactie met de Blob-service op accountniveau. Deze client biedt bewerkingen voor het ophalen en configureren van de accounteigenschappen, evenals het weergeven, maken en verwijderen van containers in het account. Voor bewerkingen met betrekking tot een specifieke container of blob kunnen clients voor deze entiteiten ook worden opgehaald met behulp van de get_client-functies . Klik hier voor meer optionele configuratie.
ContainerClient	Een client voor interactie met een specifieke container, hoewel die container mogelijk nog niet bestaat. Voor bewerkingen met betrekking tot een specifieke blob in deze container kan een blob-client worden opgehaald met behulp van de get_blob_client functie . Klik hier voor meer optionele configuratie.
ContainerEncryptionScope	De standaardconfiguratie van het versleutelingsbereik voor een container. Dit bereik wordt impliciet gebruikt voor alle toekomstige schrijfbewerkingen binnen de container, maar kan per blobbewerking worden overschreven. Nieuw in versie 12.2.0.
ContainerProperties	De eigenschappenklasse van de blobcontainer. Geretourneerde ContainerProperties exemplaren geven deze waarden weer via een woordenlijstinterface, bijvoorbeeld: container_props["last_modified"]. Daarnaast is de containernaam beschikbaar als container_props["name"].
ContainerSasPermissions	ContainerSasPermissions-klasse die moet worden gebruikt met de generate_container_sas functie en voor de AccessPolicies die wordt gebruikt met set_container_access_policy.
ContentSettings	De inhoudsinstellingen van een blob.
CopyProperties	Eigenschappen van blobkopie. Deze eigenschappen zijn Geen als deze blob nooit het doel is geweest in een blob-bewerking kopiëren of als deze blob is gewijzigd na een voltooide kopieerbewerking, bijvoorbeeld met behulp van Blob-eigenschappen instellen, Blob uploaden of Doorvoerbloklijst.
CorsRule	CORS is een HTTP-functie waarmee een webtoepassing die wordt uitgevoerd onder één domein, toegang kan krijgen tot resources in een ander domein. Webbrowsers implementeren een beveiligingsbeperking die bekend staat als same orgine-beleid waarmee wordt voorkomen dat een webpagina API's in een ander domein aanroept. CORS biedt een veilige manier om het ene domein (het oorspronkelijke domein) toe te staan om API's in een ander domein aan te roepen.
CustomerProvidedEncryptionKey	Alle gegevens in Azure Storage worden in rust versleuteld met behulp van een versleutelingssleutel op accountniveau. In versies 2018-06-17 en hoger kunt u de sleutel beheren die wordt gebruikt voor het versleutelen van blob-inhoud en toepassingsmetagegevens per blob door een AES-256-versleutelingssleutel op te geven in aanvragen voor de opslagservice. Wanneer u een door de klant verstrekte sleutel gebruikt, beheert of bewaart Azure Storage uw sleutel niet. Bij het schrijven van gegevens naar een blob wordt de opgegeven sleutel gebruikt om uw gegevens te versleutelen voordat ze naar de schijf worden geschreven. Een SHA-256-hash van de versleutelingssleutel wordt geschreven naast de blobinhoud en wordt gebruikt om te controleren of alle volgende bewerkingen op de blob dezelfde versleutelingssleutel gebruiken. Deze hash kan niet worden gebruikt om de versleutelingssleutel op te halen of de inhoud van de blob te ontsleutelen. Bij het lezen van een blob wordt de opgegeven sleutel gebruikt om uw gegevens te ontsleutelen nadat deze van schijf zijn gelezen. In beide gevallen wordt de opgegeven versleutelingssleutel veilig verwijderd zodra het versleutelings- of ontsleutelingsproces is voltooid.
DelimitedJsonDialect	Definieert de invoer- of uitvoer-JSON-serialisatie voor een blobgegevensquery. trefwoord str-scheidingsteken: het regelscheidingsteken, de standaardwaarde is ' '
DelimitedTextDialect	Hiermee definieert u de door invoer of uitvoer gescheiden serialisatie (CSV) voor een blobqueryaanvraag.
ExponentialRetry	Exponentieel opnieuw proberen. Maakt een exponentiële pogingsobject. De initial_backoff wordt gebruikt voor de eerste nieuwe poging. Volgende nieuwe pogingen worden opnieuw geprobeerd na initial_backoff + increment_power^retry_count seconden.
FilteredBlob	Blobgegevens van een API-aanroep voor filter-blobs.
ImmutabilityPolicy	Optionele parameters voor het instellen van het onveranderbaarheidsbeleid van een blob, blob-momentopname of blobversie. Nieuw in versie 12.10.0: dit is geïntroduceerd in API-versie '2020-10-02'.
LeaseProperties	Blob-lease-eigenschappen.
LinearRetry	Lineaire nieuwe poging. Maakt een lineair object voor opnieuw proberen.
LocationMode	Hiermee geeft u de locatie op waarnaar de aanvraag moet worden verzonden. Deze modus is alleen van toepassing op RA-GRS-accounts die secundaire leestoegang toestaan. Alle andere accounttypen moeten PRIMARY gebruiken.
Metrics	Een samenvatting van aanvraagstatistieken gegroepeerd per API in aggregaties van uren of minuten voor blobs.
ObjectReplicationPolicy	Beleids-id en regel-id's toegepast op een blob.
ObjectReplicationRule	Beleids-id en regel-id's toegepast op een blob.
PageRange	Paginabereik voor pagina-blob.
PartialBatchErrorException	Er is een gedeeltelijke fout opgetreden in batchbewerkingen.
ResourceTypes	Hiermee geeft u de resourcetypen op die toegankelijk zijn met de account-SAS.
RetentionPolicy	Het bewaarbeleid dat bepaalt hoe lang de gekoppelde gegevens moeten blijven bestaan.
StaticWebsite	De eigenschappen waarmee een account een statische website kan hosten.
StorageStreamDownloader	Een streaming-object om te downloaden van Azure Storage.
UserDelegationKey	Vertegenwoordigt een sleutel voor gebruikersdelegatie, die aan de gebruiker wordt verstrekt door Azure Storage op basis van het Azure Active Directory-toegangstoken. De velden worden opgeslagen als eenvoudige tekenreeksen, omdat de gebruiker niet met dit object hoeft te communiceren; om een identificerende SAS te genereren, kan de gebruiker deze eenvoudig doorgeven aan de juiste API.

Enums

ArrowType
BlobImmutabilityPolicyMode	Hiermee geeft u de beleidsmodus voor onveranderbaarheid op die moet worden ingesteld op de blob. 'Veranderlijk' kan alleen worden geretourneerd door de service, niet ingesteld op 'Veranderlijk'.
BlobType
BlockState	Blok-blobbloktypen.
PremiumPageBlobTier	Hiermee geeft u de pagina-bloblaag op waarop de blob moet worden ingesteld. Dit is alleen van toepassing op pagina-blobs in Premium Storage-accounts. Kijk op: https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets voor gedetailleerde informatie over de bijbehorende IOPS en doorvoer per PageBlobTier.
PublicAccess	Hiermee geeft u op of gegevens in de container openbaar kunnen worden geopend en het toegangsniveau.
QuickQueryDialect	Hiermee geeft u het invoer-/uitvoerdialect voor snelle query's op.
RehydratePriority	Als een object de status Rehydrate in behandeling heeft, wordt deze header geretourneerd met de prioriteit van rehydrate. Geldige waarden zijn Hoog en Standaard.
SequenceNumberAction	Reeksnummeracties.
StandardBlobTier	Hiermee geeft u de bloblaag op om de blob in te stellen. Dit is alleen van toepassing op blok-blobs in standaardopslagaccounts.
StorageErrorCode

Functies

download_blob_from_url

Download de inhoud van een blob naar een lokaal bestand of een lokale stream.

download_blob_from_url(blob_url: str, output: str, credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> None

Parameters

blob_url

str

Vereist

De volledige URI naar de blob. Dit kan ook een SAS-token bevatten.

output

str of <xref:<xref:writable stream.>>

Vereist

Waar de gegevens naartoe moeten worden gedownload. Dit kan een bestandspad zijn om naar te schrijven of een open IO-ingang om naar te schrijven.

credential

standaardwaarde: None

De referenties waarmee moet worden geverifieerd. Dit is optioneel als de blob-URL al een SAS-token heeft of als de blob openbaar is. De waarde kan een SAS-tokentekenreeks zijn, een exemplaar van een AzureSasCredential of AzureNamedKeyCredential van azure.core.credentials, een gedeelde toegangssleutel voor het account of een exemplaar van een TokenCredentials-klasse van azure.identity. Als de resource-URI al een SAS-token bevat, wordt dit genegeerd ten gunste van een expliciete referentie

• behalve in het geval van AzureSasCredential, waarbij de conflicterende SAS-tokens een ValueError genereren. Als u een exemplaar van AzureNamedKeyCredential gebruikt, moet 'name' de naam van het opslagaccount zijn en moet 'sleutel' de sleutel van het opslagaccount zijn.

overwrite

bool

Of het lokale bestand moet worden overschreven als het al bestaat. De standaardwaarde is False . In dat geval wordt een ValueError gegenereerd als het bestand al bestaat. Als deze optie is ingesteld op True, wordt geprobeerd om naar het bestaande bestand te schrijven. Als een stream-ingang wordt doorgegeven, wordt deze waarde genegeerd.

max_concurrency

int

Het aantal parallelle verbindingen waarmee moet worden gedownload.

offset

int

Begin van het bytebereik dat moet worden gebruikt voor het downloaden van een sectie van de blob. Moet worden ingesteld als de lengte is opgegeven.

length

int

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

validate_content

bool

Als dit waar is, wordt een MD5-hash berekend voor elk segment van de blob. De opslagservice controleert de hash van de inhoud die is aangekomen met de hash die is verzonden. Dit is vooral waardevol voor het detecteren van bitflips op de 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 genegeerd.

Retourtype

None

generate_account_sas

Hiermee wordt een shared access signature voor de blob-service gegenereerd.

Gebruik de geretourneerde handtekening met de referentieparameter van een BlobServiceClient, ContainerClient of BlobClient.

generate_account_sas(account_name: str, account_key: str, resource_types: ResourceTypes | str, permission: AccountSasPermissions | str, expiry: datetime | str | None, start: datetime | str | None = None, ip: str | None = None, **kwargs: Any) -> str

Parameters

account_name

str

Vereist

De naam van het opslagaccount dat wordt gebruikt voor het genereren van de Shared Access Signature.

account_key

str

Vereist

De accountsleutel, ook wel gedeelde sleutel of toegangssleutel genoemd, om de shared access signature te genereren.

resource_types

str of ResourceTypes

Vereist

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

permission

str of AccountSasPermissions

Vereist

De machtigingen die zijn gekoppeld aan de Shared Access Signature. De gebruiker is beperkt tot bewerkingen die zijn toegestaan door de machtigingen. 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

Vereist

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.

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 ip=168.1.5.65 of ip=168.1.5.60-168.1.5.70 opgeeft op de SAS, wordt de aanvraag beperkt tot deze IP-adressen.

protocol

str

Hiermee geeft u het protocol op dat is toegestaan voor een aanvraag die is gedaan. De standaardwaarde is https.

encryption_scope

str

Hiermee geeft u het versleutelingsbereik voor een aanvraag op, zodat alle schrijfbewerkingen door de service worden versleuteld.

Retouren

Een Sas-token (Shared Access Signature).

Retourtype

str

generate_blob_sas

Hiermee genereert u een shared access signature voor een blob.

Gebruik de geretourneerde handtekening met de referentieparameter van een BlobServiceClient, ContainerClient of BlobClient.

generate_blob_sas(account_name: str, container_name: str, blob_name: str, snapshot: str | None = None, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: BlobSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parameters

account_name

str

Vereist

De naam van het opslagaccount dat wordt gebruikt voor het genereren van de Shared Access Signature.

container_name

str

Vereist

De naam van de container.

blob_name

str

Vereist

De naam van de blob.

snapshot

str

standaardwaarde: None

Een optionele blob-momentopname-id.

account_key

str

standaardwaarde: None

De accountsleutel, ook wel gedeelde sleutel of toegangssleutel genoemd, om de shared access signature te genereren. U moet account_key of user_delegation_key opgeven.

user_delegation_key

UserDelegationKey

standaardwaarde: None

In plaats van een gedeelde sleutel voor een account, 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 aan te roepen get_user_delegation_key. Indien aanwezig, wordt de SAS in plaats daarvan ondertekend met de sleutel voor gebruikersdelegatie.

permission

str of BlobSasPermissions

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 besteld als racwdxytmei. 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.

policy_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_access_policy.

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 ip=168.1.5.65 of ip=168.1.5.60-168.1.5.70 opgeeft op de SAS, wordt de aanvraag beperkt tot deze IP-adressen.

version_id

str

Een optionele blobversie-id. Deze parameter is alleen van toepassing op opslagaccounts waarvoor versiebeheer is ingeschakeld. Houd er rekening mee dat de queryparameter versionid niet is opgenomen in de uitvoer-SAS. Geef daarom de parameter 'version_id' op voor eventuele API's wanneer u de uitvoer-SAS gebruikt om op een specifieke versie te werken.

Nieuw in versie 12.4.0: dit trefwoordargument is geïntroduceerd in API-versie '2019-12-12'.

protocol

str

Hiermee geeft u het protocol op dat is toegestaan voor een aanvraag die is gedaan. De standaardwaarde is https.

cache_control

str

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

content_disposition

str

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

content_encoding

str

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

content_language

str

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

content_type

str

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

encryption_scope

str

Hiermee geeft u het versleutelingsbereik voor een aanvraag op, zodat alle schrijfbewerkingen door de service worden versleuteld.

correlation_id

str

De correlatie-id om de auditlogboeken van de opslag te correleren met de auditlogboeken die worden gebruikt door de principal die de SAS genereert en distribueert. Dit kan alleen worden gebruikt bij het genereren van een SAS met delegatiesleutel.

Retouren

Een Sas-token (Shared Access Signature).

Retourtype

str

generate_container_sas

Hiermee wordt een shared access signature voor een container gegenereerd.

Gebruik de geretourneerde handtekening met de referentieparameter van een BlobServiceClient, ContainerClient of BlobClient.

generate_container_sas(account_name: str, container_name: str, account_key: str | None = None, user_delegation_key: UserDelegationKey | None = None, permission: ContainerSasPermissions | str | None = None, expiry: datetime | str | None = None, start: datetime | str | None = None, policy_id: str | None = None, ip: str | None = None, **kwargs: Any) -> Any

Parameters

account_name

str

Vereist

De naam van het opslagaccount dat wordt gebruikt voor het genereren van de Shared Access Signature.

container_name

str

Vereist

De naam van de container.

account_key

str

standaardwaarde: None

De accountsleutel, ook wel gedeelde sleutel of toegangssleutel genoemd, om de shared access signature te genereren. U moet account_key of user_delegation_key opgeven.

user_delegation_key

UserDelegationKey

standaardwaarde: None

In plaats van een gedeelde sleutel voor een account, 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 aan te roepen get_user_delegation_key. Indien aanwezig, wordt de SAS in plaats daarvan ondertekend met de sleutel voor gebruikersdelegatie.

permission

str of ContainerSasPermissions

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 als racwdxyltfmei. 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.

policy_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_access_policy.

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 ip=168.1.5.65 of ip=168.1.5.60-168.1.5.70 opgeeft op de SAS, wordt de aanvraag beperkt tot deze IP-adressen.

protocol

str

Hiermee geeft u het protocol op dat is toegestaan voor een aanvraag die is gedaan. De standaardwaarde is https.

cache_control

str

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

content_disposition

str

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

content_encoding

str

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

content_language

str

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

content_type

str

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

encryption_scope

str

Hiermee geeft u het versleutelingsbereik voor een aanvraag op, zodat alle schrijfbewerkingen door de service worden versleuteld.

correlation_id

str

De correlatie-id om de auditlogboeken van de opslag te correleren met de auditlogboeken die worden gebruikt door de principal die de SAS genereert en distribueert. Dit kan alleen worden gebruikt bij het genereren van een SAS met delegatiesleutel.

Retouren

Een Sas-token (Shared Access Signature).

Retourtype

str

upload_blob_to_url

Gegevens uploaden naar een bepaalde URL

De gegevens worden geüpload als een blok-blob.

upload_blob_to_url(blob_url: str, data: Union[Iterable[AnyStr], IO[AnyStr]], credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> Dict[str, Any]

Parameters

blob_url

str

Vereist

De volledige URI naar de blob. Dit kan ook een SAS-token bevatten.

data

bytes of str of Iterable

Vereist

De gegevens die moeten worden geüpload. Dit kunnen bytes, tekst, een itereerbaar of een bestand-achtig object zijn.

credential

standaardwaarde: None

De referenties waarmee moet worden geverifieerd. Dit is optioneel als de blob-URL al een SAS-token heeft. De waarde kan een SAS-tokentekenreeks zijn, een exemplaar van een AzureSasCredential of AzureNamedKeyCredential van azure.core.credentials, een gedeelde toegangssleutel voor het account of een exemplaar van een TokenCredentials-klasse van azure.identity. Als de resource-URI al een SAS-token bevat, wordt dit genegeerd ten gunste van een expliciete referentie

• behalve in het geval van AzureSasCredential, waarbij de conflicterende SAS-tokens een ValueError genereren. Als u een exemplaar van AzureNamedKeyCredential gebruikt, moet 'name' de naam van het opslagaccount zijn en moet 'sleutel' de sleutel van het opslagaccount zijn.

overwrite

bool

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

max_concurrency

int

Het aantal parallelle verbindingen waarmee moet worden gedownload.

length

int

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

metadata

dict(str,str)

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

validate_content

bool

Als dit waar is, wordt een MD5-hash berekend voor elk segment van de blob. De opslagservice controleert de hash van de inhoud die is aangekomen met de hash die is verzonden. Dit is vooral waardevol voor het detecteren van bitflips op de 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 genegeerd.

encoding

str

Codering die moet worden gebruikt als tekst wordt opgegeven als invoer. De standaardinstelling is UTF-8.

Retouren

Blob bijgewerkt eigenschapsdict (Etag en laatst gewijzigd)

Retourtype

dict(str, Any)