Ange egenskaper för Blob Service

Artikel
05/15/2024

Åtgärden Set Blob Service Properties anger egenskaper för ett lagringskontos Blob Storage-slutpunkt, inklusive egenskaper för Lagringsanalys, CORS-regler (cross-origin resource sharing) och inställningar för mjuk borttagning.

Du kan också använda den här åtgärden för att ange standardversionen för begäranden för alla inkommande begäranden till Blob Storage som inte har en angiven version.

Mer information om CORS-regler finns i CORS-stöd för Azure Storage-tjänsterna.

Förfrågan

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

Metod	URI för förfrågan	HTTP-version
PUT	`https://account-name.blob.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Anteckning

URI:n måste alltid innehålla ett snedstreck (/) för att skilja värdnamnet från sökvägen och frågedelarna i URI:n. I den här åtgärden är sökvägsdelen av URI:n tom.

URI-parametrar

URI-parameter	Description
`restype=service&comp=properties`	Krävs. Kombinationen av båda frågesträngarna krävs för att ange egenskaperna för lagringstjänsten.
`timeout`	Valfritt. Parametern `timeout` uttrycks i sekunder. Mer information finns i Ange tidsgränser för Blob Storage-åtgärder.

Begärandehuvuden

De obligatoriska och valfria begärandehuvudena beskrivs i följande tabell:

Begärandehuvud	Beskrivning
`Authorization`	Krävs. Anger auktoriseringsschema, lagringskontonamn 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-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 loggning 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.

Begärandetext

För version 2012-02-12 och tidigare är formatet för begärandetexten följande:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <Metrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Metrics>  
    <!-- The DefaultServiceVersion element can only be set for Blob Storage, and the request must be made using version 2011-08-18 and later -->  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
</StorageServiceProperties>

För version 2013-08-15 och senare är formatet för begärandetexten följande:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>  
        </CorsRule>  
    </Cors>  
    <!-- The DefaultServiceVersion element can only be set for Blob Storage, and the request must be made using version 2011-08-18 and later -->  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
</StorageServiceProperties>

För version 2017-07-29 och senare är formatet för begärandetexten följande:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>  
        </CorsRule>  
    </Cors>    
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
    <DeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>number-of-days</Days>
    </DeleteRetentionPolicy>   
</StorageServiceProperties>

För version 2018-03-28 och senare är formatet för begärandetexten följande:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>  
        </CorsRule>  
    </Cors>    
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
    <DeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>number-of-days</Days>
    </DeleteRetentionPolicy>
    <StaticWebsite>
        <Enabled>true|false</Enabled>
        <IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
        <ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
    </StaticWebsite>
</StorageServiceProperties>

För version 2019-12-12 och senare är formatet för begärandetexten följande:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>  
        </CorsRule>  
    </Cors>    
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
    <DeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>number-of-days</Days>
    </DeleteRetentionPolicy>
    <StaticWebsite>
        <Enabled>true|false</Enabled>
        <IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
        <DefaultIndexDocumentPath>absolute-path-of-the-default-index-page</DefaultIndexDocumentPath>
        <ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
    </StaticWebsite>
</StorageServiceProperties>

Från och med version 2013-08-15 kan du anropa Set Blob Service Properties med ett eller flera rotelement som anges i begärandetexten. Rotelementen omfattar:

Loggning
HourMetrics
MinuteMetrics
Cors
DefaultServiceVersion
DeleteRetentionPolicy: Version 2017-07-29 och senare
StaticWebsite: Version 2018-03-28 och senare

Du behöver inte längre ange varje rotelement i begäran. Om du utelämnar ett rotelement bevaras de befintliga inställningarna för tjänsten för den funktionen. Men om du anger ett rotelement måste du ange varje underordnat element för det elementet.

I följande tabell beskrivs elementen i begärandetexten:

Elementnamn	Beskrivning
Loggning	Valfritt från och med version 2013-08-15. Krävs för tidigare versioner. Grupper loggningsinställningarna för Azure Analytics.
Mått	Krävs för version 2012-02-12 och tidigare. Gäller inte för version 2013-08-15 och senare. Grupper inställningarna för Azure Analytics-mått, som innehåller en sammanfattning av begärandestatistik som grupperas efter API i timaggregeringar för blobar.
HourMetrics	Valfritt för version 2013-08-15 och senare; gäller inte för tidigare versioner. Grupper inställningarna för Azure Analytics HourMetrics, som innehåller en sammanfattning av begärandestatistik grupperad efter API i timaggregeringar för blobar.
MinuteMetrics	Valfritt för version 2013-08-15 och senare; gäller inte för tidigare versioner. Grupper inställningarna för Azure Analytics MinuteMetrics, som tillhandahåller begärandestatistik för varje minut för blobar. För tidigare versioner än 2013-08-15 ingår inte MinuteMetrics i svarstexten .
Version	Krävs om inställningarna Loggning, Mått, HourMetrics eller MinuteMetrics har angetts . Den version av Lagringsanalys som ska konfigureras.
Ta bort	Krävs om inställningarna Loggning, Mått, HourMetrics eller MinuteMetrics har angetts . Gäller endast för loggningskonfiguration. Anger om alla borttagningsbegäranden ska loggas.
Läsa	Krävs om inställningarna Loggning, Mått, HourMetrics eller MinuteMetrics har angetts . Gäller endast för loggningskonfiguration. Anger om alla läsbegäranden ska loggas.
Skriva	Krävs om inställningarna Loggning, Mått, HourMetrics eller MinuteMetrics har angetts . Gäller endast för loggningskonfiguration. Anger om alla skrivbegäranden ska loggas.
Aktiverad	Krävs. Anger om mått är aktiverade för Blob Storage. Om geo-redundant replikering med läsbehörighet är aktiverat samlas både primära och sekundära mått in. Om geo-redundant replikering med läsbehörighet inte är aktiverad samlas endast primära mått in.
IncludeAPIs	Krävs endast om mått är aktiverade. Gäller endast för måttkonfiguration. Anger om mått ska generera sammanfattningsstatistik för så kallade API-åtgärder.
RetentionPolicy/Aktiverad	Krävs. Anger om en kvarhållningsprincip är aktiverad för lagringstjänsten.
RetentionPolicy/Days	Krävs endast om en kvarhållningsprincip är aktiverad. Anger hur många dagar som mått eller loggningsdata ska behållas. Alla data som är äldre än det här värdet tas bort. Det minsta värde som du kan ange är `1`; det största värdet är `365` (ett år).
RetentionPolicy/AllowPermanentDelete	Valfritt, version 2020-02-10 och senare. Gör att du kan aktivera permanent borttagning på lagringskontot. Standardvärdet är `false.`
DefaultServiceVersion	Valfritt. Om du vill ange DefaultServiceVersion anropar `Set Blob Service Properties` du med version 2011-08-18 och senare. DefaultServiceVersion anger den standardversion som ska användas för begäranden till Blob Storage om en inkommande begärans version inte har angetts. Möjliga värden är version 2008-10-27 och senare. Mer information om tillämpliga versioner finns i Versionshantering för Azure Storage-tjänsterna. Gäller endast för Blob Storage.
Cors	Valfritt. Cors-elementet stöds för version 2013-08-15 och senare. Grupper alla CORS-regler. Om du utelämnar den här elementgruppen skrivs inte befintliga CORS-inställningar över.
CorsRule	Valfritt. Anger en CORS-regel för Blob Storage. Du kan inkludera upp till fem CorsRule-element i begäran. Om inga CorsRule-element ingår i begärandetexten tas alla CORS-regler bort och CORS är inaktiverat för Blob Storage.
AllowedOrigins	Krävs om CorsRule-elementet finns. En kommaavgränsad lista över ursprungsdomäner som tillåts via CORS eller "*" för att tillåta alla domäner. En ursprungsdomän kan också innehålla ett jokertecken i underdomänen för att tillåta begäranden via CORS för alla underdomäner i en domän. Begränsat till 64 ursprungsdomäner. Varje tillåtet ursprung kan innehålla upp till 256 tecken.
ExposedHeaders	Krävs om CorsRule-elementet finns. En kommaavgränsad lista över svarshuvuden som ska exponeras för CORS-klienter. Begränsat till 64 definierade rubriker och två prefixrubriker. Varje rubrik kan vara upp till 256 tecken.
MaxAgeInSeconds	Krävs om CorsRule-elementet finns. Antalet sekunder som klienten/webbläsaren ska cachelagrat ett förhandssvar.
AllowedHeaders	Krävs om CorsRule-elementet finns. En kommaavgränsad lista över rubriker som tillåts vara en del av begäran om korsande ursprung. Begränsat till 64 definierade rubriker och 2 prefixrubriker. Varje rubrik kan vara upp till 256 tecken.
AllowedMethods	Krävs om CorsRule-elementet finns. En kommaavgränsad lista över HTTP-metoder som kan köras av ursprunget. För Azure Storage är tillåtna metoder DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS och PUT.
DeleteRetentionPolicy	Valfritt. Om du vill ange DeleteRetentionPolicy anropar `Set Blob Service Properties` du med version 2017-07-29 och senare. Grupper inställningarna för mjuk borttagning. Gäller endast för Blob Storage.
DeleteRetentionPolicy/Enabled	Krävs. Anger om den borttagna bloben eller ögonblicksbilden behålls eller omedelbart tas bort av en borttagningsåtgärd.
DeleteRetentionPolicy/Days	Krävs endast om DeleteRetentionPolicy/Enabled är sant. Anger hur många dagar som borttagen blob ska behållas. Alla data som är äldre än det här värdet tas bort permanent. Det minsta värde som du kan ange är `1`; det största värdet är `365`.
StaticWebsite	Valfritt. Om du vill ange egenskaper för StaticWebsite anropar`Set Blob Service Properties` du med hjälp av version 2018-03-28 och senare. Gäller endast för Blob Storage.
StaticWebsite/Aktiverad	Krävs. Anger om stöd för statisk webbplats är aktiverat för det angivna kontot.
StaticWebsite/IndexDocument	Valfritt. Webbsidan som Azure Storage hanterar för begäranden till roten på en webbplats eller någon undermapp (till exempel `index.html`). Värdet är skiftlägeskänsligt.
StaticWebsite/DefaultIndexDocumentPath	Valfritt. Den absoluta sökvägen till en webbsida som Azure Storage hanterar för begäranden som inte motsvarar en befintlig fil. Innehållet på sidan returneras med `HTTP 200 OK` (till exempel `index.html`). Elementet är ömsesidigt uteslutande med `StaticWebsite/IndexDocument`. Värdet är skiftlägeskänsligt.
StaticWebsite/ErrorDocument404Path	Valfritt. Den absoluta sökvägen till en webbsida som Azure Storage hanterar för begäranden som inte motsvarar en befintlig fil. Innehållet på sidan returneras med `HTTP 404 Not Found` (till exempel `error/404.html`). Endast en enda anpassad 404-sida stöds på varje statisk webbplats. Värdet är skiftlägeskänsligt.

Svarsåtgärder

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

Statuskod

En lyckad åtgärd returnerar statuskoden 202 (accepterad).

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.

Svarsrubrik	Description
`x-ms-request-id`	Identifierar unikt en begäran mot tjänsten.
`x-ms-version`	Anger vilken version av åtgärden som används för svaret. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
`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 huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. `x-ms-client-request-id` Om rubriken inte finns i begäran visas 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 Service Properties nedan.

Viktigt

Microsoft rekommenderar att du använder Microsoft Entra ID med hanterade identiteter för att auktorisera begäranden till Azure Storage. Microsoft Entra ID ger överlägsen säkerhet och användarvänlighet jämfört med auktorisering av delad nyckel.

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 Microsoft Entra ID.

Behörigheter

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

Azure RBAC-åtgärd:Microsoft.Storage/storageAccounts/blobServices/write
Minst privilegierad inbyggd roll:Lagringskontodeltagare

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

En signatur för delad åtkomst (SAS) ger säker delegerad åtkomst till resurser i ett lagringskonto. Med en SAS har du detaljerad kontroll över hur en klient kan komma åt data. Du kan ange vilken resurs klienten kan komma åt, vilka behörigheter de har till dessa resurser och hur länge SAS är giltigt.

Åtgärden Set Blob Service Properties stöder auktorisering med hjälp av ett konto-SAS.

När åtkomst med delad nyckel inte tillåts för lagringskontot tillåts inte en SAS-token för kontot på en begäran till Blob Storage. Mer information finns i Förstå hur nekande av delad nyckel påverkar SAS-token.

Konto-SAS

Ett SAS-konto skyddas med lagringskontonyckeln. En konto-SAS delegerar åtkomst till resurser i en eller flera av lagringstjänsterna. Alla åtgärder som är tillgängliga via en tjänst eller sas för användardelegering är också tillgängliga via ett konto-SAS.

Följande tabell anger den signerade resurstypen och signerade behörigheter som ska anges när åtkomst delegeras:

Åtgärd	Signerad tjänst	Signerad resurstyp	Signerad behörighet
Ange egenskaper för blobtjänsten	Blob (b)	Tjänst (s)	Skriva (w)

Mer information om kontots SAS finns i Skapa ett KONTO-SAS.

Kommentarer

Följande begränsningar och begränsningar gäller för CORS-regler i Azure Storage:

Högst fem regler kan lagras.
Den maximala storleken på alla CORS-regelinställningar för begäran, exklusive XML-taggar, får inte överstiga 2 KiB.
Längden på ett tillåtet huvud, ett exponerat huvud eller ett tillåtet ursprung får inte överstiga 256 tecken.
Tillåtna rubriker och exponerade rubriker kan vara antingen:
- Literalrubriker, där det exakta rubriknamnet anges, till exempel x-ms-meta-processed. Högst 64 literalrubriker kan anges i begäran.
- Prefixrubriker, där ett prefix för huvudet tillhandahålls, till exempel x-ms-meta-data*. Om du anger ett prefix på det här sättet tillåts eller exponeras alla rubriker som börjar med det angivna prefixet. Högst två prefixrubriker kan anges i begäran.
De metoder (eller HTTP-verb) som anges i elementet AllowedMethods måste överensstämma med de metoder som stöds av Azure Storage-API:erna. Metoder som stöds är DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS och PUT.

Det är valfritt att ange CORS-regler för begäran. Om du anropar Set Blob Service Properties utan att ange Cors-elementet i begärandetexten underhålls alla befintliga CORS-regler.

Om du vill inaktivera CORS anropar du Set Blob Service Properties med en tom CORS-regelinställning (dvs</Cors>. ) och inga inre CORS-regler. Det här anropet tar bort alla befintliga regler och inaktiverar CORS för Blob Storage.

Alla CORS-regelelement krävs om CorsRule-elementet anges. Begäran misslyckas med felkoden 400 (Bad Request) om något element saknas.

Från och med version 2013-08-15 är XML-inställningselement valfria, så du kan uppdatera ett visst element genom att skicka en XML som endast innehåller det uppdaterade elementet. Andra inställningar påverkas inte.

Detaljerad information om CORS-regler och utvärderingslogik finns i CORS-stöd för Azure Storage-tjänsterna.

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 till exempel tillfaller en annan faktureringskategori än skrivtransaktioner. I följande tabell visas faktureringskategorin för Set Blob Service Properties begäranden baserat på lagringskontotypen:

Åtgärd	Typ av lagringskonto	Faktureringskategori
Ange egenskaper för blobtjänsten	Premium-blockblob Standard generell användning v2	Andra åtgärder
Ange egenskaper för blobtjänsten	Standard generell användning v1	Skrivåtgärder

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

Exempel på begäran och svar

Följande exempel-URI gör en begäran om att ändra Blob Storage-egenskaper för det fiktiva lagringskontot med namnet myaccount:

PUT https://myaccount.blob.core.windows.net/?restype=service&comp=properties HTTP/1.1

Begäran skickas med följande rubriker:

x-ms-version: 2018-03-28
x-ms-date: Tue, 12 Sep 2018 23:38:35 GMT 
Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.blob.core.windows.net

Begäran skickas med följande XML-brödtext:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>1.0</Version>  
        <Delete>true</Delete>  
        <Read>false</Read>  
        <Write>true</Write>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>true</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>  
            <AllowedMethods>GET,PUT</AllowedMethods>  
            <MaxAgeInSeconds>500</MaxAgeInSeconds>  
            <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>  
            <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>  
        </CorsRule>  
    </Cors>
    <DeleteRetentionPolicy>
        <Enabled>true</Enabled>
        <Days>5</Days>
    </DeleteRetentionPolicy>  
    <StaticWebsite>  
        <Enabled>true</Enabled>  
        <IndexDocument>index.html</IndexDocument>  
        <ErrorDocument404Path>error/404.html</ErrorDocument404Path>  
    </StaticWebsite>  
    <DefaultServiceVersion>2018-03-28</DefaultServiceVersion>  
</StorageServiceProperties>

När begäran har skickats returneras följande svar:

HTTP/1.1 202 Accepted
Transfer-Encoding: chunked
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30 
x-ms-version: 2018-03-28
Date: Tue, 12 Sep 2018 23:38:35 GMT

Se även

Lagringsanalys
CORS-stöd för Azure Storage-tjänsterna
HTTP-specifikation för CORS

Dela via