Delen via


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

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