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

None

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

dict(str, Any)