Ange kötjänstegenskaper

  • Artikel

Åtgärden Set Queue Service Properties anger egenskaper för ett lagringskontos kötjänstslutpunkt, inklusive egenskaper för Lagringsanalys och CORS-regler (cross-origin resource sharing). Mer information om CORS-regler finns i CORS-stöd för Lagringstjänster .

Förfrågan

Du kan ange begäran enligt Set Queue Service Properties följande. Vi rekommenderar att du använder HTTPS. Ersätt kontonamnet med namnet på ditt lagringskonto:

Metod URI för förfrågan HTTP-version
PUT https://account-name.queue.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

Parameter Beskrivning
restype=service&comp=properties Krävs. Kombinationen av båda frågesträngarna krävs för att ange egenskaperna för Azure Storage-tjänsten.
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för kötjänståtgärder.

Begärandehuvuden

De obligatoriska och valfria begäranderubrikerna 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 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 Queue 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>  
</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-verb</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-seperated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders>  
        </CorsRule>  
    </Cors>  
</StorageServiceProperties>

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

  • Loggning
  • HourMetrics
  • MinuteMetrics
  • Cors

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 angivet rotelement måste du ange varje underordnat element för det elementet.

Elementen i begärandetexten beskrivs i följande tabell:

Elementnamn Beskrivning
Loggning Valfritt från och med version 2013-08-15. Krävs för tidigare versioner. Grupperar inställningarna för Lagringsanalys loggning.
Mått Krävs för version 2012-02-12 och tidigare. Gäller inte för version 2013-08-15 och senare. Grupperar inställningarna för Lagringsanalys mått. Inställningarna för mått ger en sammanfattning av begärandestatistik grupperad efter API i timaggregeringar för köer.
HourMetrics Valfritt för version 2013-08-15 och senare. Gäller inte för tidigare versioner. Grupperar inställningarna för Lagringsanalys HourMetrics. HourMetrics-inställningarna ger en sammanfattning av begärandestatistik grupperad efter API i timaggregeringar för köer.
MinuteMetrics Valfritt för version 2013-08-15 och senare. Gäller inte för tidigare versioner. Grupperar inställningarna för Lagringsanalys MinuteMetrics. MinuteMetrics-inställningarna tillhandahåller begärandestatistik för varje minut för köer. 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 anges. Den version av Lagringsanalys som ska konfigureras.
Ta bort Krävs om inställningarna Loggning, Mått, HourMetrics eller MinuteMetrics anges. 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 anges. 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 anges. Gäller endast för loggningskonfiguration. Anger om alla skrivbegäranden ska loggas.
Aktiverad Krävs. Anger om mått är aktiverade för kötjänsten.

Om geo-redundant replikering med läsåtkomst är aktiverad samlas både primära och sekundära mått in. Om geo-redundant replikering med läsåtkomst inte är aktiverat 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, och det maximala värdet är 365 (ett år).
Cors Valfritt. Cors-elementet stöds för version 2013-08-15 och senare. Grupperar 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 kötjänsten. 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 inaktiveras för kötjänsten.
AllowedOrigins Krävs om Elementet CorsRule 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 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 elementet CorsRule 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 innehålla upp till 256 tecken.
MaxAgeInSeconds Krävs om elementet CorsRule finns. Antalet sekunder som klienten/webbläsaren ska cachelagrat ett förinställt svar.
AllowedHeaders Krävs om elementet CorsRule 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 innehålla upp till 256 tecken.
AllowedMethods Krävs om elementet CorsRule finns. En kommaavgränsad lista över HTTP-metoder som kan köras av ursprunget. För Azure Storage är DELETEtillåtna metoder , GET, HEAD, MERGE, POST, OPTIONSeller PUT.

Svarsåtgärder

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

Statuskod

En lyckad åtgärd returnerar statuskod 202 (godkänd).

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 som görs mot tjänsten.
x-ms-version Anger versionen av åtgärden som användes 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 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

Endast kontoinnehavaren kan anropa den här åtgärden.

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å en tillåten rubrik, exponerad rubrik eller tillåtet ursprung får inte överstiga 256 tecken.

  • Tillåtna rubriker och exponerade rubriker kan vara något av följande:

    • 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 rubriken 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-tjänstens API:er. Metoder som stöds är DELETE, GET, HEAD, MERGE, POST, OPTIONSoch PUT.

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

Om du vill inaktivera CORS anropar Set Queue Service Properties du med en tom CORS-regelinställningar (det vill säga*</Cors>) och inga inre CORS-regler. Det här anropet tar bort alla befintliga regler och inaktiverar CORS för kötjänsten.

Alla CORS-regelelement krävs om CorsRule-elementet har angetts. 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.

Exempel på begäran och svar

Följande exempel-URI gör en begäran om att ändra kötjänstegenskaperna för ett fiktivt lagringskonto med namnet myaccount:

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

Begäran skickas med följande rubriker:

x-ms-version: 2013-08-15  
x-ms-date: Wed, 23 Oct 2013 04:28:19 GMT  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.queue.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>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> 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>  
</StorageServiceProperties>

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

HTTP/1.1 202 Accepted  
Connection: Keep-Alive  
Transfer-Encoding: chunked  
Date: Wed, 23 Oct 2013 04:28:20 GMT  
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2013-08-15

Se även

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