Eigenschappen van wachtrijservice instellen

Artikel
08/05/2023

Met Set Queue Service Properties de bewerking worden eigenschappen ingesteld voor het queue-service-eindpunt van een opslagaccount, inclusief eigenschappen voor Opslaganalyse- en CORS-regels (Cross-Origin Resource Sharing). Zie CORS-ondersteuning voor de opslagservices voor meer informatie over CORS-regels.

Aanvraag

U kunt de Set Queue Service Properties aanvraag als volgt opgeven. U wordt aangeraden HTTPS te gebruiken. Vervang accountnaam door de naam van uw opslagaccount:

Methode	Aanvraag-URI	HTTP-versie
PUT	`https://account-name.queue.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Notitie

De URI moet altijd een slash (/) bevatten om de hostnaam te scheiden van het pad en de querygedeelten van de URI. In deze bewerking is het padgedeelte van de URI leeg.

URI-parameters

Parameter	Beschrijving
`restype=service&comp=properties`	Vereist. De combinatie van beide queryreeksen is vereist om de eigenschappen van de Azure Storage-service in te stellen.
`timeout`	Optioneel. De `timeout` parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor wachtrijservicebewerkingen voor meer informatie.

Aanvraagheaders

De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabel:

Aanvraagheader	Beschrijving
`Authorization`	Vereist. Hiermee geeft u het autorisatieschema, de naam van het opslagaccount en de handtekening op. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
`Date` of `x-ms-date`	Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
`x-ms-version`	Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
`x-ms-client-request-id`	Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Queue Storage bewaken voor meer informatie.

Aanvraagbody

Voor versie 2012-02-12 en eerder is de indeling van de aanvraagbody als volgt:

<?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>

Voor versie 2013-08-15 en hoger is de indeling van de aanvraagbody als volgt:

<?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>

Vanaf versie 2013-08-15 kunt u aanroepen Set Queue Service Properties met een of meer hoofdelementen die zijn opgegeven in de hoofdtekst van de aanvraag. De hoofdelementen zijn onder andere:

Logboekregistratie
HourMetrics
MinuteMetrics
Cors

Het is niet langer nodig om elk hoofdelement in de aanvraag op te geven. Als u een hoofdelement weglaat, blijven de bestaande instellingen voor de service voor die functionaliteit behouden. Als u echter een opgegeven hoofdelement opgeeft, moet u elk onderliggend element voor dat element opgeven.

De elementen van de aanvraagbody worden beschreven in de volgende tabel:

Elementnaam	Beschrijving
Logboekregistratie	Optioneel vanaf versie 2013-08-15. Vereist voor eerdere versies. Groepeert de Opslaganalyse instellingen voor logboekregistratie.
Metrische gegevens	Vereist voor versie 2012-02-12 en eerder. Niet van toepassing op versie 2013-08-15 en hoger. Hiermee worden de instellingen voor metrische gegevens Opslaganalyse gegroepeerd. De instellingen voor metrische gegevens bieden een overzicht van aanvraagstatistieken gegroepeerd per API in aggregaties per uur voor wachtrijen.
HourMetrics	Optioneel voor versie 2013-08-15 en hoger. Niet van toepassing op eerdere versies. Groepeert de instellingen Opslaganalyse HourMetrics. De HourMetrics-instellingen bieden een overzicht van aanvraagstatistieken gegroepeerd per API in aggregaties per uur voor wachtrijen.
MinuteMetrics	Optioneel voor versie 2013-08-15 en hoger. Niet van toepassing op eerdere versies. Groepeert de instellingen Opslaganalyse MinuteMetrics. De MinuteMetrics-instellingen bieden aanvraagstatistieken voor elke minuut voor wachtrijen. Voor versies ouder dan 2013-08-15 is MinuteMetrics niet opgenomen in de antwoordtekst.
Versie	Vereist als instellingen voor logboekregistratie, metrische gegevens, uurmetrie of minuutmetrische gegevens zijn opgegeven. De versie van Opslaganalyse die u wilt configureren.
Verwijderen	Vereist als instellingen voor logboekregistratie, metrische gegevens, uurmetrie of minuutmetrische gegevens zijn opgegeven. Is alleen van toepassing op de configuratie van logboekregistratie. Hiermee wordt aangegeven of alle verwijderingsaanvragen moeten worden geregistreerd.
Lezen	Vereist als instellingen voor logboekregistratie, metrische gegevens, uurmetrie of minuutmetrische gegevens zijn opgegeven. Is alleen van toepassing op de configuratie van logboekregistratie. Hiermee wordt aangegeven of alle leesaanvragen moeten worden geregistreerd.
Schrijven	Vereist als instellingen voor logboekregistratie, metrische gegevens, uurmetrie of minuutmetrische gegevens zijn opgegeven. Is alleen van toepassing op de configuratie van logboekregistratie. Hiermee wordt aangegeven of alle schrijfaanvragen moeten worden geregistreerd.
Ingeschakeld	Vereist. Hiermee wordt aangegeven of metrische gegevens zijn ingeschakeld voor de Queue-service. Als geografisch redundante replicatie met leestoegang is ingeschakeld, worden zowel primaire als secundaire metrische gegevens verzameld. Als geografisch redundante replicatie met leestoegang niet is ingeschakeld, worden alleen primaire metrische gegevens verzameld.
IncludeAPIs	Alleen vereist als metrische gegevens zijn ingeschakeld. Is alleen van toepassing op de configuratie van metrische gegevens. Geeft aan of metrische gegevens samenvattingsstatistieken moeten genereren voor aangeroepen API-bewerkingen.
RetentionPolicy/Ingeschakeld	Vereist. Hiermee wordt aangegeven of een bewaarbeleid is ingeschakeld voor de opslagservice.
RetentionPolicy/dagen	Alleen vereist als een bewaarbeleid is ingeschakeld. Geeft het aantal dagen aan dat metrische gegevens of logboekgegevens moeten worden bewaard. Alle gegevens die ouder zijn dan deze waarde, worden verwijderd. De minimumwaarde die u kunt opgeven is `1`, en de maximumwaarde is `365` (één jaar).
Cors	Optioneel. Het Cors-element wordt ondersteund voor versie 2013-08-15 en hoger. Alle CORS-regels groepeert. Als u deze elementgroep weglaat, worden bestaande CORS-instellingen niet overschreven.
CorsRule	Optioneel. Hiermee geeft u een CORS-regel voor de Queue-service. U kunt maximaal vijf CorsRule-elementen in de aanvraag opnemen. Als er geen CorsRule-elementen zijn opgenomen in de aanvraagbody, worden alle CORS-regels verwijderd en wordt CORS uitgeschakeld voor de Queue-service.
AllowedOrigins	Vereist als het element CorsRule aanwezig is. Een door komma's gescheiden lijst met oorspronkelijke domeinen die zijn toegestaan via CORS, of '*' om alle domeinen toe te staan. Een oorspronkelijk domein kan ook een jokerteken bevatten in het subdomein om aanvragen via CORS toe te laten voor alle subdomeinen van een domein. Beperkt tot 64 oorsprongsdomeinen. Elke toegestane oorsprong mag maximaal 256 tekens bevatten.
ExposedHeaders	Vereist als het element CorsRule aanwezig is. Een door komma's gescheiden lijst met antwoordheaders om beschikbaar te maken voor CORS-clients. Beperkt tot 64 gedefinieerde headers en twee voorvoegselheaders. Elke koptekst mag maximaal 256 tekens bevatten.
MaxAgeInSeconds	Vereist als het element CorsRule aanwezig is. Het aantal seconden dat de client/browser een voorbereidend antwoord in de cache moet opslaan.
AllowedHeaders	Vereist als het element CorsRule bestaat. Een door komma's gescheiden lijst met kopteksten die deel mogen uitmaken van de aanvraag voor meerdere oorsprongen. Beperkt tot 64 gedefinieerde headers en 2 voorvoegsels. Elke koptekst mag maximaal 256 tekens bevatten.
AllowedMethods	Vereist als het element CorsRule bestaat. Een door komma's gescheiden lijst met HTTP-methoden die door de oorsprong mogen worden uitgevoerd. Voor Azure Storage zijn `DELETE`toegestane methoden , `GET`, `HEAD`, `MERGE`, `POST`, , `OPTIONS`of `PUT`.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 202 (Geaccepteerd).

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader	Beschrijving
`x-ms-request-id`	Identificeert op unieke wijze een aanvraag die is ingediend bij de service.
`x-ms-version`	Hiermee geeft u de versie van de bewerking op die is gebruikt voor het antwoord. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
`x-ms-client-request-id`	Kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de `x-ms-client-request-id` header als deze aanwezig is in de aanvraag en de waarde niet meer dan 1024 zichtbare ASCII-tekens bevat. Als de `x-ms-client-request-id` header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord.

Hoofdtekst van de reactie

Geen.

Autorisatie

Alleen de accounteigenaar kan deze bewerking aanroepen.

Opmerkingen

De volgende beperkingen en beperkingen zijn van toepassing op CORS-regels in Azure Storage:

Er kunnen maximaal vijf regels worden opgeslagen.
De maximale grootte van alle CORS-regels voor de aanvraag, met uitzondering van XML-tags, mag niet groter zijn dan 2 KiB.
De lengte van een toegestane koptekst, weergegeven koptekst of toegestane oorsprong mag niet langer zijn dan 256 tekens.
Toegestane headers en weergegeven headers kunnen een van de volgende zijn:
- Letterlijke headers, waarbij de exacte headernaam wordt opgegeven, zoals x-ms-meta-processed. Er kunnen maximaal 64 letterlijke headers worden opgegeven voor de aanvraag.
- Kopteksten met voorvoegsel, waarbij een voorvoegsel van de koptekst wordt opgegeven, zoals x-ms-meta-data*. Als u op deze manier een voorvoegsel opgeeft, wordt elke koptekst die begint met het opgegeven voorvoegsel, toegestaan of weergegeven. Er kunnen maximaal twee voorvoegsels worden opgegeven voor de aanvraag.
De methoden (of HTTP-woorden) die in het AllowedMethods element zijn opgegeven, moeten voldoen aan de methoden die worden ondersteund door de Azure Storage-service-API's. Ondersteunde methoden zijn DELETE, GET, HEAD, MERGE, POST, , OPTIONSen PUT.

Het opgeven van CORS-regels voor de aanvraag is optioneel. Als u aanroept Set Queue Service Properties zonder het Cors-element in de aanvraagbody op te geven, blijven alle bestaande CORS-regels behouden.

Als u CORS wilt uitschakelen, roept Set Queue Service Properties u aan met een lege CORS-regelinstellingen (dat wil gezegd, *</Cors>) en geen interne CORS-regels. Met deze aanroep worden alle bestaande regels verwijderd en CORS voor de Queue-service uitgeschakeld.

Alle CORS-regelelementen zijn vereist als het element CorsRule is opgegeven. De aanvraag mislukt met foutcode 400 (Bad Request) als er een element ontbreekt.

Vanaf versie 2013-08-15 zijn XML-instellingen optioneel, dus u kunt een specifiek element bijwerken door een XML te verzenden die alleen het bijgewerkte element bevat. Andere instellingen worden niet beïnvloed.

Zie CORS-ondersteuning voor de Azure Storage-services voor gedetailleerde informatie over CORS-regels en evaluatielogica.

Voorbeeld van aanvraag en antwoord

Met de volgende voorbeeld-URI wordt een aanvraag ingediend om de eigenschappen van de Queue-service te wijzigen voor een fictief opslagaccount met de naam myaccount:

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

De aanvraag wordt verzonden met de volgende headers:

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

De aanvraag wordt verzonden met de volgende XML-hoofdtekst:

<?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>

Nadat de aanvraag is verzonden, wordt het volgende antwoord geretourneerd:

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

Zie ook

CORS-ondersteuning voor de Azure Storage-services
CORS HTTP-specificatie

Delen via