Táblaszolgáltatás tulajdonságainak lekérése
A Get Table Service Properties
művelet lekéri egy Azure Table 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.
További információ a CORS-szabályokról és a kiértékelési logikáról: CORS-támogatás az Azure Storage-szolgáltatásokhoz.
Kérés
A Get Table 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>.table.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
URI-paraméter | Description |
---|---|
restype=service&comp=properties |
Kötelező. Mindkét lekérdezési sztringre szükség van a Table Storage tulajdonságainak lekéréséhez. |
timeout |
Választható. A timeout paraméter másodpercben van kifejezve. |
Kérésfejlécek
A szükséges és nem kötelező kérésfejléceket az alábbi táblázatban ismertetjük:
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 Storage Analytics 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 Table 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 végrehajtott kérést. |
x-ms-version |
A művelet válaszhoz használt 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 hozzájuk tartozó 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 | Leírás |
---|---|
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 a kérelmek statisztikáinak összegzését tartalmazzák, API szerint csoportosítva, a táblák óránkénti összesítésében. |
HourMetrics | A Storage Analytics HourMetrics beállításainak csoportosítása. A HourMetrics beállításai a kérelmek statisztikáinak összegzését tartalmazzák, API szerint csoportosítva, a táblák óránkénti összesítésében. |
MinuteMetrics | A Storage Analytics MinuteMetrics beállításainak csoportosítása. A MinuteMetrics beállításai kérésstatisztikát biztosítanak a táblák egyes perceihez. |
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 engedélyezve vannak-e a metrikák a Table 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ációjá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 | A metrikák vagy naplózási adatok megőrzésének napjai. Az ennél régebbi adatok törlődnek. |
Cors | Az összes CORS-szabály csoportosítása. |
CorsRule | A CORS-szabály beállításainak csoportosítása. |
AllowedOrigins | A CORS-on keresztül engedélyezett forrástartományok vesszővel tagolt listája, vagy csillag (*), ha az összes tartomány engedélyezett. |
ExposedHeaders | A CORS-ügyfelek számára közzéteendő válaszfejlécek vesszővel tagolt listája. |
MaxAgeInSeconds | Az ügyfélnek vagy a böngészőnek az előzetes válasz gyorsítótárazásának másodpercben megadott száma. |
AllowedHeaders | Azoknak a fejléceknek a vesszővel tagolt listája, amelyek részt vehetnek a forrásközi kérésben. |
AllowedMethods | A forrás által végrehajtható HTTP-metódusok vesszővel tagolt listája. Az Azure Storage esetében az engedélyezett módszerek a KÖVETKEZŐK: DELETE, GET, HEAD, MERGE, POST, OPTIONS vagy 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 egy myaccount nevű fiktív tárfiók Table Storage-tulajdonságainak lekérésére:
GET https://myaccount.table.core.windows.net/?restype=service&comp=properties HTTP/1.1
A kérés a következő fejlécekkel lesz elküldve:
x-ms-version: 2013-08-15
x-ms-date: Wed, 23 Oct 2013 04:49:03 GMT
Authorization: SharedKey
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=
Host: myaccount.table.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-Table/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ó