blob Paket

Paket

aio

Klasser

AccessPolicy

Access Policy-klass som används av uppsättningen och få åtkomstprincipmetoder i varje tjänst.

En lagrad åtkomstprincip kan ange starttid, förfallotid och behörigheter för signaturer för delad åtkomst som den är associerad med. Beroende på hur du vill styra åtkomsten till resursen kan du ange alla dessa parametrar i den lagrade åtkomstprincipen och utelämna dem från URL:en för signaturen för delad åtkomst. På så sätt kan du när som helst ändra den associerade signaturens beteende och återkalla den. Eller så kan du ange en eller flera av åtkomstprincipparametrarna i den lagrade åtkomstprincipen och de andra på URL:en. Slutligen kan du ange alla parametrar på URL:en. I det här fallet kan du använda den lagrade åtkomstprincipen för att återkalla signaturen, men inte för att ändra dess beteende.

Tillsammans måste signaturen för delad åtkomst och den lagrade åtkomstprincipen innehålla alla fält som krävs för att autentisera signaturen. Om obligatoriska fält saknas misslyckas begäran. På samma sätt misslyckas begäran med statuskoden 400 (felaktig begäran) om ett fält anges både i url:en för signatur för delad åtkomst och i principen för lagrad åtkomst.

AccountSasPermissions

ResourceTypes klass som ska användas med funktionen generate_account_sas och för AccessPolicies som används med set_*_acl. Det finns två typer av SAS som kan användas för att bevilja resursåtkomst. Ett är att bevilja åtkomst till en specifik resurs (resursspecifik). En annan är att bevilja åtkomst till hela tjänsten för ett visst konto och tillåta vissa åtgärder baserat på de perms som finns här.

ArrowDialect

i ett pilschema.

Alla obligatoriska parametrar måste fyllas i för att kunna skickas till Azure.

BlobAnalyticsLogging

Loggningsinställningar för Azure Analytics.

BlobBlock

BlockBlob Block-klass.

BlobClient

En klient som ska interagera med en specifik blob, även om den bloben kanske inte finns ännu.

Klicka här om du vill ha mer valfri konfiguration.

BlobLeaseClient

Skapar en ny BlobLeaseClient.

Den här klienten tillhandahåller låneåtgärder på en BlobClient eller ContainerClient.

BlobPrefix

En iterabel av Blob-egenskaper.

Returneras från walk_blobs när en avgränsare används. Kan ses som en virtuell blobkatalog.

BlobProperties

Blobegenskaper.

BlobQueryError

Felet inträffade under snabbfrågeåtgärden.

BlobQueryReader

Ett strömmande objekt för att läsa frågeresultat.

BlobSasPermissions

BlobSasPermissions-klass som ska användas med generate_blob_sas funktionen.

BlobServiceClient

En klient som ska interagera med Blob Service på kontonivå.

Den här klienten tillhandahåller åtgärder för att hämta och konfigurera kontoegenskaper samt lista, skapa och ta bort containrar i kontot. För åtgärder som rör en specifik container eller blob kan klienter för dessa entiteter också hämtas med hjälp av get_client-funktionerna .

Klicka här om du vill ha mer valfri konfiguration.

ContainerClient

En klient som ska interagera med en specifik container, även om den containern kanske inte finns ännu.

För åtgärder som rör en specifik blob i den här containern kan en blobklient hämtas med hjälp av get_blob_client funktionen .

Klicka här om du vill ha mer valfri konfiguration.

ContainerEncryptionScope

Standardkonfigurationen för krypteringsomfång för en container.

Det här omfånget används implicit för alla framtida skrivningar i containern, men kan åsidosättas per blobåtgärd.

Ny i version 12.2.0.

ContainerProperties

Blobcontainerns egenskapsklass.

Returnerade ContainerProperties instanser exponerar dessa värden via ett ordlistegränssnitt, till exempel: container_props["last_modified"]. Dessutom är containernamnet tillgängligt som container_props["name"].

ContainerSasPermissions

ContainerSasPermissions-klassen som ska användas med generate_container_sas funktionen och för AccessPolicies som används med set_container_access_policy.

ContentSettings

Innehållsinställningarna för en blob.

CopyProperties

Egenskaper för blobkopiering.

Dessa egenskaper är Ingen om den här bloben aldrig har varit målet i en kopieringsblobåtgärd, eller om den här bloben har ändrats efter en avslutad kopieringsblobåtgärd, till exempel med hjälp av Ange blobegenskaper, Ladda upp blob eller Checka in blockeringslista.

CorsRule

CORS är en HTTP-funktion som gör det möjligt för ett webbprogram som körs i en domän att komma åt resurser i en annan domän. Webbläsare implementerar en säkerhetsbegränsning som har samma ursprungsprincip som förhindrar att en webbsida anropar API:er i en annan domän. CORS är ett säkert sätt att tillåta en domän (ursprungsdomänen) att anropa API:er i en annan domän.

CustomerProvidedEncryptionKey

Alla data i Azure Storage krypteras i vila med hjälp av en krypteringsnyckel på kontonivå. I versionerna 2018-06-17 och senare kan du hantera nyckeln som används för att kryptera blobinnehåll och programmetadata per blob genom att tillhandahålla en AES-256-krypteringsnyckel i begäranden till lagringstjänsten.

När du använder en kundtilldelad nyckel hanterar eller sparar inte Azure Storage din nyckel. När du skriver data till en blob används den angivna nyckeln för att kryptera dina data innan du skriver dem till disken. En SHA-256-hash för krypteringsnyckeln skrivs tillsammans med blobinnehållet och används för att verifiera att alla efterföljande åtgärder mot bloben använder samma krypteringsnyckel. Den här hashen kan inte användas för att hämta krypteringsnyckeln eller dekryptera innehållet i bloben. När du läser en blob används den angivna nyckeln för att dekryptera dina data när du har läst dem från disken. I båda fallen ignoreras den angivna krypteringsnyckeln på ett säkert sätt så snart krypterings- eller dekrypteringsprocessen har slutförts.

DelimitedJsonDialect

Definierar JSON-serialiseringen för indata eller utdata för en blobdatafråga.

keyword str delimiter: Radavgränsarens tecken, standardvärdet är '

'

DelimitedTextDialect

Definierar den indata- eller utdataavgränsade serialiseringen (CSV) för en blobfrågebegäran.

ExponentialRetry

Exponentiellt återförsök.

Skapar ett exponentiellt återförsöksobjekt. Initial_backoff används för det första återförsöket. Efterföljande återförsök görs på nytt efter initial_backoff + increment_power^retry_count sekunder.

FilteredBlob

Blobinformation från ett Filter Blobs API-anrop.

ImmutabilityPolicy

Valfria parametrar för att ange oföränderlighetsprincipen för en blob, blobögonblicksbild eller blobversion.

Ny i version 12.10.0: Detta introducerades i API-versionen "2020-10-02".

LeaseProperties

Egenskaper för bloblån.

LinearRetry

Linjärt återförsök.

Skapar ett linjärt återförsöksobjekt.

LocationMode

Anger den plats som begäran ska skickas till. Det här läget gäller endast för RA-GRS-konton som tillåter sekundär läsåtkomst. Alla andra kontotyper måste använda PRIMARY.

Metrics

En sammanfattning av begärandestatistik grupperad efter API i tim- eller minutaggregeringar för blobar.

ObjectReplicationPolicy

Princip-ID och regel-ID:t som tillämpas på en blob.

ObjectReplicationRule

Princip-ID och regel-ID:t som tillämpas på en blob.

PageRange

Sidintervall för sidblob.

PartialBatchErrorException

Det finns ett partiellt fel i batchåtgärder.

ResourceTypes

Anger de resurstyper som är tillgängliga med kontots SAS.

RetentionPolicy

Kvarhållningsprincipen som avgör hur länge de associerade data ska sparas.

StaticWebsite

De egenskaper som gör det möjligt för ett konto att vara värd för en statisk webbplats.

StorageStreamDownloader

Ett strömmande objekt som ska laddas ned från Azure Storage.

UserDelegationKey

Representerar en användardelegeringsnyckel som tillhandahålls till användaren av Azure Storage baserat på deras Azure Active Directory-åtkomsttoken.

Fälten sparas som enkla strängar eftersom användaren inte behöver interagera med det här objektet. för att generera en identifierad SAS kan användaren helt enkelt skicka den till rätt API.

Uppräkningar

ArrowType
BlobImmutabilityPolicyMode

Anger det oföränderliga principläge som ska anges på bloben. "Mutable" kan bara returneras av tjänsten, ställ inte in på "Föränderlig".

BlobType
BlockState

Blockblobblocktyper.

PremiumPageBlobTier

Anger den sidblobnivå som bloben ska anges till. Detta gäller endast sidblobar på Premium Storage-konton. Ta en titt på: https://docs.microsoft.com/en-us/azure/storage/storage-premium-storage#scalability-and-performance-targets för detaljerad information om motsvarande IOPS och dataflöde per PageBlobTier.

PublicAccess

Anger om data i containern kan nås offentligt och åtkomstnivån.

QuickQueryDialect

Anger snabbfrågeindata/utdatadialekt.

RehydratePriority

Om ett objekt är i väntande tillstånd returneras det här huvudet med rehydratprioritet. Giltiga värden är Hög och Standard.

SequenceNumberAction

Sekvensnummeråtgärder.

StandardBlobTier

Anger den blobnivå som bloben ska anges till. Detta gäller endast för blockblobar på standardlagringskonton.

StorageErrorCode

Funktioner

download_blob_from_url

Ladda ned innehållet i en blob till en lokal fil eller dataström.

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

Parametrar

blob_url
str
Obligatorisk

Den fullständiga URI:n till bloben. Detta kan även innehålla en SAS-token.

output
str eller <xref:<xref:writable stream.>>
Obligatorisk

Där data ska laddas ned till. Det kan vara antingen en filsökväg att skriva till eller ett öppet I/O-handtag att skriva till.

credential
standardvärde: None

De autentiseringsuppgifter som ska autentiseras med. Det här är valfritt om blob-URL:en redan har en SAS-token eller om bloben är offentlig. Värdet kan vara en SAS-tokensträng, en instans av en AzureSasCredential eller AzureNamedKeyCredential från azure.core.credentials, en kontodelad åtkomstnyckel eller en instans av en TokenCredentials-klass från azure.identity. Om resurs-URI:n redan innehåller en SAS-token ignoreras detta till förmån för en explicit autentiseringsuppgift

  • utom när det gäller AzureSasCredential, där de motstridiga SAS-token genererar en ValueError. Om du använder en instans av AzureNamedKeyCredential ska "name" vara lagringskontots namn och "nyckel" ska vara lagringskontonyckeln.
overwrite
bool

Om den lokala filen ska skrivas över om den redan finns. Standardvärdet är False . I så fall utlöses en ValueError om filen redan finns. Om värdet är True görs ett försök att skriva till den befintliga filen. Om en strömreferens skickas ignoreras det här värdet.

max_concurrency
int

Antalet parallella anslutningar som ska laddas ned.

offset
int

Start av byteintervall som ska användas för att ladda ned ett avsnitt av bloben. Måste anges om längden anges.

length
int

Antal byte som ska läsas från strömmen. Detta är valfritt, men bör anges för optimala prestanda.

validate_content
bool

Om det är sant beräknas en MD5-hash för varje segment i bloben. Lagringstjänsten kontrollerar hashen för det innehåll som har anlänt med den hash som skickades. Detta är främst värdefullt för att identifiera bitflips på kabeln om http i stället för https som https (standard) redan verifieras. Observera att denna MD5-hash inte lagras med bloben. Observera också att om den är aktiverad används inte den minneseffektiva uppladdningsalgoritmen eftersom databehandling av MD5-hashen kräver buffring av hela block, och detta motverkar syftet med den minneseffektiva algoritmen.

Returtyp

generate_account_sas

Genererar en signatur för delad åtkomst för blobtjänsten.

Använd den returnerade signaturen med autentiseringsparametern för BlobServiceClient, ContainerClient eller 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

Parametrar

account_name
str
Obligatorisk

Namnet på lagringskontot som används för att generera signaturen för delad åtkomst.

account_key
str
Obligatorisk

Kontonyckeln, som även kallas delad nyckel eller åtkomstnyckel, för att generera signaturen för delad åtkomst.

resource_types
str eller ResourceTypes
Obligatorisk

Anger de resurstyper som är tillgängliga med kontots SAS.

permission
str eller AccountSasPermissions
Obligatorisk

De behörigheter som är associerade med signaturen för delad åtkomst. Användaren är begränsad till åtgärder som tillåts av behörigheterna. Krävs om inte ett ID anges som refererar till en lagrad åtkomstprincip som innehåller det här fältet. Det här fältet måste utelämnas om det har angetts i en associerad lagrad åtkomstprincip.

expiry
datetime eller str
Obligatorisk

Den tidpunkt då signaturen för delad åtkomst blir ogiltig. Krävs om inte ett ID anges som refererar till en lagrad åtkomstprincip som innehåller det här fältet. Det här fältet måste utelämnas om det har angetts i en associerad lagrad åtkomstprincip. Azure konverterar alltid värden till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC.

start
datetime eller str
standardvärde: None

Den tidpunkt då signaturen för delad åtkomst blir giltig. Om det utelämnas antas starttiden för det här anropet vara den tid då lagringstjänsten tar emot begäran. Azure konverterar alltid värden till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC.

ip
str
standardvärde: None

Anger en IP-adress eller ett intervall med IP-adresser som begäranden ska accepteras från. Om IP-adressen som begäran kommer från inte matchar IP-adressen eller adressintervallet som anges i SAS-token autentiseras inte begäran. Om du till exempel anger ip=168.1.5.65 eller ip=168.1.5.60-168.1.5.70 på SAS begränsas begäran till dessa IP-adresser.

protocol
str

Anger vilket protokoll som tillåts för en begäran. Standardvärdet är https.

encryption_scope
str

Anger krypteringsomfånget för en begäran som görs så att alla skrivåtgärder kommer att vara tjänstkrypterade.

Returer

En sas-token (signatur för delad åtkomst).

Returtyp

str

generate_blob_sas

Genererar en signatur för delad åtkomst för en blob.

Använd den returnerade signaturen med autentiseringsparametern för BlobServiceClient, ContainerClient eller 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

Parametrar

account_name
str
Obligatorisk

Namnet på lagringskontot som används för att generera signaturen för delad åtkomst.

container_name
str
Obligatorisk

Namnet på containern.

blob_name
str
Obligatorisk

Namnet på bloben.

snapshot
str
standardvärde: None

Ett valfritt blobögonblicks-ID.

account_key
str
standardvärde: None

Kontonyckeln, som även kallas delad nyckel eller åtkomstnyckel, för att generera signaturen för delad åtkomst. Du måste ange account_key eller user_delegation_key .

user_delegation_key
UserDelegationKey
standardvärde: None

I stället för en kontodelad nyckel kan användaren skicka in en användardelegeringsnyckel. En nyckel för användardelegering kan hämtas från tjänsten genom autentisering med en AAD-identitet. detta kan åstadkommas genom att anropa get_user_delegation_key. När den finns signeras SAS med användarens delegeringsnyckel i stället.

permission
str eller BlobSasPermissions
standardvärde: None

De behörigheter som är associerade med signaturen för delad åtkomst. Användaren är begränsad till åtgärder som tillåts av behörigheterna. Behörigheter måste beställas racwdxytmei. Krävs om inte ett ID anges som refererar till en lagrad åtkomstprincip som innehåller det här fältet. Det här fältet måste utelämnas om det har angetts i en associerad lagrad åtkomstprincip.

expiry
datetime eller str
standardvärde: None

Den tidpunkt då signaturen för delad åtkomst blir ogiltig. Krävs om inte ett ID anges som refererar till en lagrad åtkomstprincip som innehåller det här fältet. Det här fältet måste utelämnas om det har angetts i en associerad lagrad åtkomstprincip. Azure konverterar alltid värden till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC.

start
datetime eller str
standardvärde: None

Den tidpunkt då signaturen för delad åtkomst blir giltig. Om det utelämnas antas starttiden för det här anropet vara den tid då lagringstjänsten tar emot begäran. Azure konverterar alltid värden till UTC. Om ett datum skickas in utan tidszonsinformation antas det vara UTC.

policy_id
str
standardvärde: None

Ett unikt värde på upp till 64 tecken som korrelerar med en lagrad åtkomstprincip. Om du vill skapa en lagrad åtkomstprincip använder du set_container_access_policy.

ip
str
standardvärde: None

Anger en IP-adress eller ett intervall med IP-adresser som begäranden ska accepteras från. Om IP-adressen som begäran kommer från inte matchar IP-adressen eller adressintervallet som anges i SAS-token autentiseras inte begäran. Om du till exempel anger ip=168.1.5.65 eller ip=168.1.5.60-168.1.5.70 på SAS begränsas begäran till dessa IP-adresser.

version_id
str

Ett valfritt blobversions-ID. Den här parametern gäller endast för versionsaktiverade lagringskonton. Observera att frågeparametern "versionid" inte ingår i SAS-utdata. Ange därför parametern "version_id" till alla API:er när du använder SAS-utdata för att köra på en viss version.

Nytt i version 12.4.0: Det här nyckelordsargumentet introducerades i API-versionen "2019-12-12".

protocol
str

Anger vilket protokoll som tillåts för en begäran. Standardvärdet är https.

cache_control
str

Svarshuvudvärde för Cache-Control när resursen används med den här signaturen för delad åtkomst.

content_disposition
str

Svarshuvudvärde för Content-Disposition när resursen nås med den här signaturen för delad åtkomst.

content_encoding
str

Svarshuvudvärde för Content-Encoding när resursen används med den här signaturen för delad åtkomst.

content_language
str

Svarshuvudvärde för Content-Language när resursen används med den här signaturen för delad åtkomst.

content_type
str

Svarshuvudvärde för Content-Type när resursen används med den här signaturen för delad åtkomst.

encryption_scope
str

Anger krypteringsomfånget för en begäran som görs så att alla skrivåtgärder kommer att vara tjänstkrypterade.

correlation_id
str

Korrelations-ID:t för att korrelera lagringsgranskningsloggarna med de granskningsloggar som används av huvudkontot som genererar och distribuerar SAS. Detta kan endast användas när du genererar en SAS med delegeringsnyckel.

Returer

En sas-token (signatur för delad åtkomst).

Returtyp

str

generate_container_sas

Genererar en signatur för delad åtkomst för en container.

Använd den returnerade signaturen med parametern autentiseringsuppgifter för alla BlobServiceClient, ContainerClient eller 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

Parametrar

account_name
str
Obligatorisk

Namnet på lagringskontot som används för att generera signaturen för delad åtkomst.

container_name
str
Obligatorisk

Namnet på containern.

account_key
str
standardvärde: None

Kontonyckeln, som även kallas delad nyckel eller åtkomstnyckel, för att generera signaturen för delad åtkomst. Du måste ange account_key eller user_delegation_key .

user_delegation_key
UserDelegationKey
standardvärde: None

I stället för en kontodelad nyckel kan användaren skicka in en användardelegeringsnyckel. En nyckel för användardelegering kan hämtas från tjänsten genom autentisering med en AAD-identitet. detta kan åstadkommas genom att anropa get_user_delegation_key. När den finns signeras SAS med användarens delegeringsnyckel i stället.

permission
str eller ContainerSasPermissions
standardvärde: None

De behörigheter som är associerade med signaturen för delad åtkomst. Användaren är begränsad till åtgärder som tillåts av behörigheterna. Behörigheter måste beställas racwdxyltfmei. Krävs om inte ett ID anges som refererar till en lagrad åtkomstprincip som innehåller det här fältet. Det här fältet måste utelämnas om det har angetts i en associerad lagrad åtkomstprincip.

expiry
datetime eller str
standardvärde: None

Den tidpunkt då signaturen för delad åtkomst blir ogiltig. Krävs om inte ett ID anges som refererar till en lagrad åtkomstprincip som innehåller det här fältet. Det här fältet måste utelämnas om det har angetts i en associerad lagrad åtkomstprincip. Azure konverterar alltid värden till UTC. Om ett datum skickas utan tidszonsinformation antas det vara UTC.

start
datetime eller str
standardvärde: None

Den tidpunkt då signaturen för delad åtkomst blir giltig. Om det utelämnas antas starttiden för det här anropet vara den tid då lagringstjänsten tar emot begäran. Azure konverterar alltid värden till UTC. Om ett datum skickas utan tidszonsinformation antas det vara UTC.

policy_id
str
standardvärde: None

Ett unikt värde på upp till 64 tecken som korrelerar med en lagrad åtkomstprincip. Om du vill skapa en lagrad åtkomstprincip använder du set_container_access_policy.

ip
str
standardvärde: None

Anger en IP-adress eller ett intervall med IP-adresser som begäranden ska accepteras från. Om DEN IP-adress som begäran kommer från inte matchar IP-adressen eller adressintervallet som anges på SAS-token autentiseras inte begäran. Om du till exempel anger ip=168.1.5.65 eller ip=168.1.5.60-168.1.5.70 på SAS begränsas begäran till dessa IP-adresser.

protocol
str

Anger vilket protokoll som tillåts för en begäran. Standardvärdet är https.

cache_control
str

Svarshuvudvärde för Cache-Control när resursen används med den här signaturen för delad åtkomst.

content_disposition
str

Svarshuvudvärde för Content-Disposition när resursen används med den här signaturen för delad åtkomst.

content_encoding
str

Svarshuvudvärde för Content-Encoding när resursen används med den här signaturen för delad åtkomst.

content_language
str

Svarshuvudvärde för Content-Language när resursen används med den här signaturen för delad åtkomst.

content_type
str

Svarshuvudvärde för Innehållstyp när resursen används med den här signaturen för delad åtkomst.

encryption_scope
str

Anger krypteringsomfånget för en begäran som görs så att alla skrivåtgärder blir tjänstkrypterade.

correlation_id
str

Korrelations-ID:t för att korrelera lagringsgranskningsloggarna med de granskningsloggar som används av huvudkontot som genererar och distribuerar SAS. Detta kan bara användas när du genererar en SAS med delegeringsnyckel.

Returer

En sas-token (signatur för delad åtkomst).

Returtyp

str

upload_blob_to_url

Ladda upp data till en viss URL

Data laddas upp som en blockblob.

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]

Parametrar

blob_url
str
Obligatorisk

Den fullständiga URI:n till bloben. Detta kan även innehålla en SAS-token.

data
bytes eller str eller Iterable
Obligatorisk

De data som ska laddas upp. Detta kan vara byte, text, ett iterbart eller ett filliknande objekt.

credential
standardvärde: None

De autentiseringsuppgifter som ska autentiseras med. Det här är valfritt om blob-URL:en redan har en SAS-token. Värdet kan vara en SAS-tokensträng, en instans av en AzureSasCredential eller AzureNamedKeyCredential från azure.core.credentials, en kontodelad åtkomstnyckel eller en instans av en TokenCredentials-klass från azure.identity. Om resurs-URI:n redan innehåller en SAS-token ignoreras detta till förmån för en explicit autentiseringsuppgift

  • utom när det gäller AzureSasCredential, där de motstridiga SAS-token genererar en ValueError. Om du använder en instans av AzureNamedKeyCredential ska "namn" vara lagringskontots namn och "nyckel" ska vara lagringskontonyckeln.
overwrite
bool

Om den blob som ska laddas upp ska skriva över aktuella data. Om det är sant skriver upload_blob_to_url över befintliga data. Om värdet är Falskt misslyckas åtgärden med en ResourceExistsError.

max_concurrency
int

Antalet parallella anslutningar som du kan ladda ned.

length
int

Antal byte som ska läsas från dataströmmen. Detta är valfritt, men bör tillhandahållas för optimala prestanda.

metadata
dict(str,str)

Namn/värde-par som är associerade med bloben som metadata.

validate_content
bool

Om det är sant beräknas en MD5-hash för varje segment av blobben. Lagringstjänsten kontrollerar hashen för det innehåll som har anlänt med hashen som skickades. Detta är främst värdefullt för att identifiera bitflips på tråden om http i stället för https som https (standard) redan verifieras. Observera att denna MD5-hash inte lagras med bloben. Observera också att om den är aktiverad används inte den minneseffektiva uppladdningsalgoritmen, eftersom databehandling av MD5-hashen kräver buffring av hela block, och detta minskar syftet med den minneseffektiva algoritmen.

encoding
str

Kodning som ska användas om text anges som indata. Standardvärdet ÄR UTF-8.

Returer

Blob-uppdaterad egenskapsdikt (Etag och senast ändrad)

Returtyp