Üzenetsor-szolgáltatás tulajdonságainak lekérése

Cikk
08/05/2023

A Get Queue Service Properties művelet lekéri egy Azure Queue Storage-fiók tulajdonságait, beleértve a Storage Analytics és a forrásközi erőforrás-megosztási (CORS-) szabályok tulajdonságait.

A forrásközi erőforrás-megosztási (CORS) szabályokkal és a kiértékelési logikával kapcsolatos további információkért lásd: CORS-támogatás az Azure Storage-szolgáltatásokhoz.

Kérés

A Get Queue Service Properties kérés a következőképpen adható meg. Javasoljuk, hogy HTTPS-t használjon. Cserélje le <a fióknevet> a tárfiók nevére:

Metódus	Kérés URI-ja	HTTP-verzió
GET	`https://<account-name>.queue.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Megjegyzés

Az URI-nak mindig tartalmaznia kell egy perjel karaktert (/), amely elválasztja a gazdagépnevet az URI elérési útjától és lekérdezési részeitől. Ebben a műveletben az URI elérési útja üres.

URI-paraméterek

A kérelem URI-ja a következő további paramétereket határozhatja meg:

Paraméter	Leírás
`restype=service&comp=properties`	Kötelező. A tárolási szolgáltatás tulajdonságainak lekéréséhez mindkét lekérdezési sztring kombinációja szükséges.
`timeout`	Választható. A `timeout` paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása az Azure Queue Storage-műveletekhez.

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

Kérelem fejléce	Leírás
`Authorization`	Kötelező. Megadja az engedélyezési sémát, a tárfiók nevét és az aláírást. További információ: Kérések engedélyezése az Azure Storage-ba.
`Date` vagy `x-ms-date`	Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérések engedélyezése az Azure Storage-ba.
`x-ms-version`	Minden engedélyezett kéréshez szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
`x-ms-client-request-id`	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kib-os (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Az Azure Queue Storage monitorozása.

A kérés törzse

Nincsenek.

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy választörzset.

Állapotkód

A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza.

Válaszfejlécek

A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc	Description
`x-ms-request-id`	Egyedileg azonosítja a szolgáltatással szemben küldött kérést.
`x-ms-version`	A válaszhoz használt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
`x-ms-client-request-id`	A kérések és a kapcsolódó válaszok hibaelhárítására használható. A fejléc értéke megegyezik a `x-ms-client-request-id` fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a `x-ms-client-request-id` fejléc nem szerepel a kérelemben, az nem jelenik meg a válaszban.

Választörzs

A 2012-02-12-es és korábbi verziók esetében a válasz törzsének formátuma a következő:

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

A 2013-08-15-ös verziótól a válasz törzsének formátuma a következő:

<?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-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders> comma-separated-list-of-request-headers </AllowedHeaders>  
        </CorsRule>  
    </Cors>  
</StorageServiceProperties>

A választörzs elemeit a következő táblázat ismerteti:

Elem neve	Description
Logging	A Storage Analytics naplózási beállításainak csoportosítása.
Metrikák	A Storage Analytics Metrikák beállításainak csoportosítása. A Metrikák beállításai az API-k szerint csoportosított kérésstatisztikák összegzését biztosítják óránkénti összesítésekben az üzenetsorokhoz.
HourMetrics	A Storage Analytics HourMetrics beállításainak csoportosítása. A HourMetrics beállításai az API-k szerint csoportosított kérésstatisztikák összegzését biztosítják az üzenetsorok óránkénti összesítésében.
MinuteMetrics	Csoportosítja a Storage Analytics MinuteMetrics* beállításait. A MinuteMetrics beállításai kérésstatisztikát biztosítanak az egyes percekhez az üzenetsorokhoz.
Verzió	A jelenleg használatban lévő Storage Analytics verziója.
Törlés	Csak a naplózási konfigurációra vonatkozik. Azt jelzi, hogy a rendszer naplózza-e a törlési kérelmeket.
Olvasás	Csak a naplózási konfigurációra vonatkozik. Azt jelzi, hogy az olvasási kérelmek naplózása folyamatban van-e.
Írni	Csak a naplózási konfigurációra vonatkozik. Azt jelzi, hogy az írási kérelmek naplózása folyamatban van-e.
Engedélyezve	Azt jelzi, hogy a metrikák engedélyezve vannak-e az Azure Queue Storage-hoz. Ha az olvasási hozzáférés georedundáns replikációja engedélyezve van, az elsődleges és a másodlagos metrikákat is összegyűjti a rendszer. Ha az olvasási hozzáférés georedundáns replikációja nincs engedélyezve, csak az elsődleges metrikák lesznek összegyűjtve.
IncludeAPI-k	Csak a metrikák konfigurálására vonatkozik. Azt jelzi, hogy a metrikák létrehoznak-e összefoglaló statisztikákat az úgynevezett API-műveletekhez.
RetentionPolicy/Enabled	Azt jelzi, hogy engedélyezve van-e adatmegőrzési szabályzat a tárolási szolgáltatáshoz.
RetentionPolicy/Days	Azt jelzi, hogy hány napig őrzi meg a metrikákat vagy a naplózási adatokat. Az ennél az értéknél régebbi adatok törlődnek.
Cors	Az összes CORS-szabály csoportosítása.
CorsRule	CORS-szabály beállításainak csoportosítása.
Engedélyezettorigins	A CORS-on keresztül engedélyezett forrástartományok vesszővel tagolt listája, vagy csillag (*), ha minden tartomány engedélyezve van.
ExposedHeaders	A CORS-ügyfelek számára közzéteendő válaszfejlécek vesszővel tagolt listája.
MaxAgeInSeconds	Az a másodpercszám, ahányszor az ügyfélnek vagy a böngészőnek gyorsítótáraznia kell az elővizsgálati választ.
AllowedHeaders	Olyan fejlécek vesszővel tagolt listája, amelyek részt vehetnek a forrásközi kérésben.
Engedélyezettmethodok	A forrás által végrehajtható HTTP-metódusok vesszővel tagolt listája. Az Azure Storage esetében a megengedett módszerek a DELETE, a GET, a HEAD, a MERGE, a POST, a OPTIONS vagy a PUT.

Engedélyezés

Ezt a műveletet csak a tárfiók tulajdonosa hívhatja meg.

Mintakérés és válasz

Az alábbi URI-minta kérést küld a myaccount nevű fiktív tárfiók Queue-szolgáltatás tulajdonságainak lekérésére:

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

A kérést a rendszer a következő fejlécekkel küldi el:

x-ms-version: 2013-08-15  
x-ms-date: Wed, 23 Oct 2013 04:49:03 GMT  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.queue.core.windows.net

A kérés elküldése után a rendszer a következő választ adja vissza:

HTTP/1.1 200 OK  
Content-Length: 1020  
Content-Type: application/xml  
Date: Wed, 23 Oct 2013 04:49:04 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

A választörzs a következőhöz hasonló:

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

Lásd még

Storage Analytics
CORS-támogatás az Azure Storage-szolgáltatásokhoz
CORS HTTP-specifikáció