Ange blobegenskaper

  • Artikel

Åtgärden Set Blob Properties anger systemegenskaper på bloben.

Förfrågan

Begäran Set Blob Properties kan konstrueras på följande sätt. Vi rekommenderar att du använder HTTPS. Ersätt myaccount med namnet på ditt lagringskonto:

URI för PUT-metodbegäran HTTP-version
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=properties HTTP/1.1

Emulerad lagringstjänst-URI

När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorns värdnamn och Blob Storage-port som 127.0.0.1:10000, följt av namnet på det emulerade lagringskontot:

URI för PUT-metodbegäran HTTP-version
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties HTTP/1.1

Mer information finns i Använda Azurite-emulatorn för lokal Azure Storage-utveckling.

URI-parametrar

Du kan ange följande ytterligare parametrar för begärande-URI:n:

Parameter Beskrivning
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Storage-åtgärder.

Begärandehuvuden (alla blobtyper)

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden för alla blobtyper.

Begärandehuvud Beskrivning
Authorization Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
Date eller x-ms-date Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
x-ms-version Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
x-ms-blob-cache-control Valfritt. Ändrar cachekontrollsträngen för bloben.

Om den här egenskapen inte har angetts för begäran rensas egenskapen för bloben. Efterföljande anrop till Hämta blobegenskaper returnerar inte den här egenskapen, såvida den inte uttryckligen anges på bloben igen.
x-ms-blob-content-type Valfritt. Anger blobens innehållstyp.

Om den här egenskapen inte har angetts för begäran rensas egenskapen för bloben. Efterföljande anrop till Hämta blobegenskaper returnerar inte den här egenskapen, såvida den inte uttryckligen anges på bloben igen.
x-ms-blob-content-md5 Valfritt. Anger blobens MD5-hash.

Om den här egenskapen inte har angetts för begäran rensas egenskapen för bloben. Efterföljande anrop till Hämta blobegenskaper returnerar inte den här egenskapen, såvida den inte uttryckligen anges på bloben igen.
x-ms-blob-content-encoding Valfritt. Anger blobens innehållskodning.

Om den här egenskapen inte har angetts för begäran rensas egenskapen för bloben. Efterföljande anrop till Hämta blobegenskaper returnerar inte den här egenskapen, såvida den inte uttryckligen anges på bloben igen.
x-ms-blob-content-language Valfritt. Anger blobens innehållsspråk.

Om den här egenskapen inte har angetts för begäran rensas egenskapen för bloben. Efterföljande anrop till Hämta blobegenskaper returnerar inte den här egenskapen, såvida den inte uttryckligen anges på bloben igen.
x-ms-lease-id:<ID> Krävs om bloben har ett aktivt lån. Om du vill utföra den här åtgärden på en blob med ett aktivt lån anger du det giltiga låne-ID:t för det här huvudet.
x-ms-client-request-id Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Blob Storage.
x-ms-blob-content-disposition Valfritt. Anger blobens Content-Disposition sidhuvud. Tillgänglig för version 2013-08-15 och senare.

Fältet Content-Disposition svarshuvud förmedlar ytterligare information om hur du bearbetar svarsnyttolasten och kan användas för att bifoga ytterligare metadata. Om det till exempel är inställt på attachmentanger det att användaragenten inte ska visa svaret, utan i stället visa en Spara som-dialogruta med ett annat filnamn än det angivna blobnamnet.

Svaret från åtgärderna Hämta blobb - och Hämta blobegenskaper innehåller content-disposition huvudet.
Origin Valfritt. Anger ursprunget från vilket begäran utfärdas. Förekomsten av det här huvudet resulterar i resursdelningshuvuden för korsande ursprung i svaret. Mer information finns i CORS-stöd (resursdelning mellan ursprung) för Azure Storage-tjänsterna.

Den här åtgärden stöder också användning av villkorsstyrda rubriker för att ange blobegenskaper endast om ett angivet villkor uppfylls. Mer information finns i Ange villkorsstyrda rubriker för Blob Storage-åtgärder.

Begärandehuvuden (endast sidblobar)

I följande tabell beskrivs begärandehuvuden som endast gäller för åtgärder på sidblobar:

Begärandehuvud Beskrivning
x-ms-blob-content-length: byte value Valfritt. Ändrar storlek på en sidblob till den angivna storleken. Om det angivna värdet är mindre än blobens aktuella storlek rensas alla sidblobar med värden som är större än det angivna värdet.

Den här egenskapen kan inte användas för att ändra storleken på en blockblob eller en tilläggsblob. Om du anger den här egenskapen för en blockblob eller en tilläggsblob returneras statuskoden 400 (felaktig begäran).
x-ms-sequence-number-action: {max, update, increment} Valfritt, men obligatoriskt om x-ms-blob-sequence-number rubriken har angetts för begäran. Den här egenskapen gäller endast sidblobar.

Den här egenskapen anger hur tjänsten ska ändra blobens sekvensnummer. Ange något av följande alternativ för den här egenskapen:

- max: Anger att sekvensnumret ska vara det högre av värdet som ingår i begäran och det värde som för närvarande lagras för blobben.
- update: Anger sekvensnumret till det värde som ingår i begäran.
- increment: Ökar värdet för sekvensnumret med 1. Om du anger det här alternativet ska du inte ta med x-ms-blob-sequence-number header. Då returneras statuskoden 400 (felaktig begäran).
x-ms-blob-sequence-number: <num> Valfritt, men obligatoriskt om egenskapen x-ms-sequence-number-action är inställd på max eller update. Den här egenskapen gäller endast sidblobar.

Egenskapen anger blobens sekvensnummer. Sekvensnumret är en användarkontrollerad egenskap som du kan använda för att spåra begäranden och hantera samtidighetsproblem. Mer information finns i åtgärden Put Page (Lägg till sida).

Använd den här egenskapen tillsammans med x-ms-sequence-number-action för att uppdatera blobens sekvensnummer till antingen det angivna värdet eller det högre av de värden som anges med begäran eller som för närvarande lagras med bloben. Det här huvudet ska inte anges om x-ms-sequence-number-action är inställt på increment, i vilket fall tjänsten automatiskt ökar sekvensnumret med ett.

Om du vill ange sekvensnumret till ett värde som du väljer måste den här egenskapen anges i begäran tillsammans med x-ms-sequence-number-action.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskod 200 (OK).

Mer information om statuskoder finns i Status och felkoder.

Svarshuvuden

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.

Syntax Description
ETag Innehåller ett värde som du kan använda för att utföra åtgärder villkorligt. Mer information finns i Ange villkorsstyrda rubriker för Blob Storage-åtgärder . Om begärandeversionen är 2011-08-18 eller senare omges ETag-värdet av citattecken.
Last-Modified Datum/tid då bloben senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representera datum-/tidsvärden i rubriker.

Alla skrivåtgärder på bloben (inklusive uppdateringar av blobens metadata eller egenskaper) ändrar blobens senast ändrade tid.
x-ms-blob-sequence-number Om bloben är en sidblob returneras blobens aktuella sekvensnummer med det här huvudet.
x-ms-request-id Identifierar den begäran som gjordes unikt och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version Anger den Blob Storage-version som användes för att köra begäran. Den här rubriken returneras för begäranden som har gjorts mot version 2009-09-19 och senare.
Date Ett DATUM-/tidsvärde för UTC som genereras av tjänsten, vilket anger den tid då svaret initierades.
Access-Control-Allow-Origin Returneras om begäran innehåller ett Origin huvud och CORS är aktiverat med en matchande regel. Om det finns en matchning returnerar den här rubriken värdet för ursprungsbegärandehuvudet.
Access-Control-Expose-Headers Returneras om begäran innehåller ett Origin huvud och CORS är aktiverat med en matchande regel. Returnerar listan med svarshuvuden som ska exponeras för klienten eller utfärdaren av begäran.
Access-Control-Allow-Credentials Returneras om begäran innehåller ett Origin huvud och CORS är aktiverat med en matchande regel som inte tillåter alla ursprung. Rubriken anges till true.
x-ms-client-request-id Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet x-ms-client-request-id för rubriken om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om rubriken x-ms-client-request-id inte finns i begäran finns den inte i svaret.

Själva svaret

Inga.

Auktorisering

Auktorisering krävs när du anropar en dataåtkomståtgärd i Azure Storage. Du kan auktorisera åtgärden enligt beskrivningen Set Blob Properties nedan.

Azure Storage stöder användning av Microsoft Entra ID för att auktorisera begäranden till blobdata. Med Microsoft Entra ID kan du använda rollbaserad åtkomstkontroll i Azure (Azure RBAC) för att bevilja behörigheter till ett säkerhetsobjekt. Säkerhetsobjektet kan vara en användare, grupp, programtjänstens huvudnamn eller en hanterad Azure-identitet. Säkerhetsobjektet autentiseras av Microsoft Entra ID för att returnera en OAuth 2.0-token. Token kan sedan användas för att auktorisera en begäran mot Blob-tjänsten.

Mer information om auktorisering med Microsoft Entra ID finns i Auktorisera åtkomst till blobar med hjälp av Microsoft Entra ID.

Behörigheter

Nedan visas den RBAC-åtgärd som krävs för att en Microsoft Entra användare, grupp eller tjänstens huvudnamn ska kunna anropa Set Blob Properties åtgärden och den minst privilegierade inbyggda Azure RBAC-rollen som innehåller den här åtgärden:

Mer information om hur du tilldelar roller med hjälp av Azure RBAC finns i Tilldela en Azure-roll för åtkomst till blobdata.

Kommentarer

Semantiken för att uppdatera en blobs egenskaper är följande:

  • En sidblobs sekvensnummer uppdateras endast om begäran uppfyller något av följande villkor:

    • Begäran anger x-ms-sequence-number-action till max eller updateoch anger ett värde för x-ms-blob-sequence-number huvudet.

    • Begäran anger x-ms-sequence-number-action till increment, vilket indikerar att tjänsten ska öka sekvensnumret med ett.

  • En sidblobs storlek ändras endast om begäran anger ett värde för x-ms-content-length rubriken.

  • Om du vill ändra sidblobens storlek i ett Premium Storage-konto får den nya storleken inte överskrida den innehållslängd som tillåts av den befintliga nivån. Anropa Ange blobnivå innan du ändrar storlek på bloben. En lista över nivåer och tillåten innehållslängd finns i Premium-lagring med höga prestanda och hanterade diskar för virtuella datorer.

  • Om en begäran endast x-ms-blob-sequence-number anger eller x-ms-content-lengthändras ingen av blobens andra egenskaper.

  • Om en eller flera av följande egenskaper anges i begäran anges alla egenskaper tillsammans. Om ett värde inte anges för en egenskap när minst en av dem har angetts rensas den egenskapen för bloben.

    • x-ms-blob-cache-control
    • x-ms-blob-content-type
    • x-ms-blob-content-md5
    • x-ms-blob-content-encoding
    • x-ms-blob-content-language
    • x-ms-blob-content-disposition

Anteckning

För en signatur för delad åtkomst (SAS) kan du åsidosätta vissa egenskaper som lagras för bloben genom att ange frågeparametrar som en del av signaturen för delad åtkomst. Dessa egenskaper omfattar cache-controlegenskaperna , content-type, content-encoding, content-languageoch content-disposition . Mer information finns i Skapa en tjänst-SAS.

Fakturering

Prisbegäranden kan komma från klienter som använder Blob Storage-API:er, antingen direkt via REST-API:et för Blob Storage eller från ett Azure Storage-klientbibliotek. Dessa begäranden ackumulerar avgifter per transaktion. Typen av transaktion påverkar hur kontot debiteras. Lästransaktioner ackumuleras till exempel till en annan faktureringskategori än skrivtransaktioner. I följande tabell visas faktureringskategorin för Set Blob Properties begäranden baserat på lagringskontotypen:

Åtgärd Typ av lagringskonto Faktureringskategori
Ange blobegenskaper Premium-blockblob
Standard generell användning v2		 Andra åtgärder
Ange blobegenskaper Standard generell användning v1 Skrivåtgärder

Mer information om priser för den angivna faktureringskategorin finns i Azure Blob Storage Prissättning.

Se även