Festlegen von Warteschlangendiensteigenschaften

Der Set Queue Service Properties Vorgang legt Eigenschaften für den Warteschlangendienstendpunkt eines Speicherkontos fest, einschließlich Eigenschaften für Storage Analytics und CORS-Regeln (Cross-Origin Resource Sharing). Weitere Informationen zu CORS-Regeln finden Sie unter CORS-Unterstützung für die Speicherdienste .

Anforderung

Sie können die Set Queue Service Properties Anforderung wie folgt angeben. Es wird empfohlen, HTTPS zu verwenden. Ersetzen Sie account-name durch den Namen Ihres Speicherkontos:

URI-Parameter

Anforderungsheader

Die erforderlichen und optionalen Anforderungsheader werden in der folgenden Tabelle beschrieben:

Anforderungstext

Bei Version 2012-02-12 und früheren Versionen weist der Anforderungstext folgendes Format auf:

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

Bei Version 2013-08-15 und höheren Versionen weist der Anforderungstext folgendes Format auf:

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

Ab Version 2013-08-15 können Sie mit mindestens einem Stammelement aufrufen Set Queue Service Properties , das im Anforderungstext angegeben ist. Die Stammelemente umfassen:

• Logging
• HourMetrics
• MinuteMetrics
• Cors

Es ist nicht mehr erforderlich, jedes Stammelement in der Anforderung anzugeben. Wenn Sie ein Stammelement weglassen, werden die vorhandenen Diensteinstellungen für die jeweiligen Funktionen beibehalten. Wenn Sie jedoch ein angegebenes Stammelement angeben, müssen Sie jedes untergeordnete Element für dieses Element angeben.

Die Elemente des Anforderungstexts werden in der folgenden Tabelle beschrieben:

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Statuscode

Ein erfolgreicher Vorgang gibt den Statuscode 202 (Akzeptiert) zurück.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antworttext

Keine.

Authorization

Dieser Vorgang kann nur vom Kontobesitzer aufgerufen werden.

Hinweise

Für CORS-Regeln im Azure-Speicher gelten die folgenden Einschränkungen:

• Es können maximal fünf Regeln gespeichert werden.

• Die maximale Größe aller CORS-Regeleinstellungen für die Anforderung (mit Ausnahme von XML-Tags) sollte 2 KiB nicht überschreiten.

• Die Länge eines zulässigen Headers oder Ursprungs bzw. eines verfügbar gemachten Headers sollte maximal 256 Zeichen betragen.

• Zulässige Header und verfügbar gemachte Header können eine der folgenden Sein:

  • Literale Header, bei denen der genaue Headername angegeben ist, z. B. x-ms-meta-processed. In der Anforderung können maximal 64 literale Header angegeben werden.

  • Header mit Präfix, bei denen ein Präfix des Headers angegeben ist, z. B. x-ms-meta-data*. Die Angabe eines Präfixes auf diese Weise ermöglicht oder macht jeden Header verfügbar, der mit dem angegebenen Präfix beginnt. In der Anforderung können maximal zwei Header mit Präfix angegeben werden.

• Die im AllowedMethods -Element angegebenen Methoden (oder HTTP-Verben) müssen den Methoden entsprechen, die von den Azure Storage-Dienst-APIs unterstützt werden. Unterstützte Methoden sind DELETE, GET, HEAD, MERGEPOST, OPTIONS, und PUT.

Optional können CORS-Regeln für die Anforderung angegeben werden. Wenn Sie aufrufen Set Queue Service Properties , ohne das Cors-Element im Anforderungstext anzugeben, werden alle vorhandenen CORS-Regeln beibehalten.

Um CORS zu deaktivieren, rufen Sie Set Queue Service Properties mit leeren CORS-Regeleinstellungen (d. h. *</Cors>) und ohne interne CORS-Regeln auf. Dieser Aufruf löscht alle vorhandenen Regeln und deaktiviert CORS für den Warteschlangendienst.

Alle CORS-Regelelemente sind erforderlich, wenn das CorsRule-Element angegeben wird. Die Anforderung schlägt mit dem Fehlercode 400 (Bad Request) fehl, wenn ein Element fehlt.

Ab Version 2013-08-15 sind XML-Einstellungselemente optional, sodass Sie ein bestimmtes Element aktualisieren können, indem Sie eine XML senden, die nur das aktualisierte Element enthält. Andere Einstellungen sind nicht betroffen.

Ausführliche Informationen zu CORS-Regeln und der Auswertungslogik finden Sie unter CORS-Unterstützung für die Azure Storage-Dienste.

Beispielanforderung und -antwort

Der folgende Beispiel-URI sendet eine Anforderung, um die Eigenschaften des Warteschlangendiensts für ein fiktives Speicherkonto namens myaccount zu ändern:

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

Die Anforderung wird mit den folgenden Headern gesendet;

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  

Die Anforderung wird mit dem folgenden XML-Text gesendet:

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

Nachdem die Anforderung gesendet wurde, wird die folgende Antwort zurückgegeben:

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  
  

Weitere Informationen

CORS-Unterstützung für die Azure Storage-Dienste
CORS HTTP-Spezifikation