Table szolgáltatás tulajdonságainak beállításaSet Table Service Properties

A Set Table Service Properties művelet beállítja a Storage-fiók Table Service végpontjának tulajdonságait, beleértve a Storage Analytics és a CORS (több eredetű erőforrás-megosztási) szabályok tulajdonságait is.The Set Table Service Properties operation sets properties for a storage account’s Table service endpoint, including properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules. A CORS-szabályokkal kapcsolatos további információkért lásd: CORS-támogatás a Storage Serviceshez .See CORS Support for the Storage Services for more information on CORS rules.

KérésRequest

A Set Table Service Properties kérést a következőképpen lehet megadni.The Set Table Service Properties request may be specified as follows. A HTTPS használata javasolt.HTTPS is recommended. Cserélje le a <account-name> kifejezést a tárfiókja nevére.Replace <account-name> with the name of your storage account.

MetódusMethod Kérés URI-jaRequest URI HTTP-verzióHTTP Version
PUTPUT https://<account-name>.table.core.windows.net/?restype=service&comp=properties HTTP/1.1HTTP/1.1

Vegye figyelembe, hogy az URI-nak mindig tartalmaznia kell a továbbítási perjelet (/), hogy a gazdagép nevét az URI elérési útjának és lekérdezési részeitől válassza el.Note that the URI must always include the forward slash (/) to separate the host name from the path and query portions of the URI. A művelet esetében az URI elérési útjának része üres.In the case of this operation, the path portion of the URI is empty.

URI-paraméterekURI Parameters

URI-paraméterURI Parameter DescriptionDescription
restype=service&comp=properties Kötelező.Required. A tárolási szolgáltatás tulajdonságainak beállításához mindkét lekérdezési karakterlánc kombinációja szükséges.The combination of both query strings is required to set the storage service properties.
timeout Választható.Optional. A timeout paraméter másodpercben van megadva.The timeout parameter is expressed in seconds.

KérelemfejlécekRequest Headers

A következő táblázat ismerteti a kötelező és választható kérelmek fejléceit.The following table describes required and optional request headers.

Kérelem fejléceRequest Header DescriptionDescription
Authorization Kötelező.Required. Megadja az engedélyezési sémát, a Storage-fiók nevét és az aláírást.Specifies the authorization scheme, storage account name, and signature. További információ: kérelmek engedélyezése az Azure Storage-ba.For more information, see Authorize requests to Azure Storage.
Date vagy x-ms-dateDate or x-ms-date Kötelező.Required. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját.Specifies the Coordinated Universal Time (UTC) for the request. További információ: kérelmek engedélyezése az Azure Storage-ba.For more information, see Authorize requests to Azure Storage.
x-ms-version Minden jóváhagyott kérelemhez szükséges.Required for all authorized requests. Megadja a kérelemhez használni kívánt művelet verzióját.Specifies the version of the operation to use for this request. További információ: verziószámozás az Azure Storage Services szolgáltatásban.For more information, see Versioning for the Azure Storage Services.
x-ms-client-request-id Választható.Optional. Egy ügyfél által generált, átlátszatlan értéket biztosít, amely 1 KiB karakteres korláttal rendelkezik, amely az elemzési naplókban van rögzítve, ha engedélyezve van a Storage Analytics naplózása.Provides a client-generated, opaque value with a 1 KiB character limit that is recorded in the analytics logs when storage analytics logging is enabled. A fejléc használata erősen ajánlott az ügyféloldali tevékenységek és a kiszolgáló által kapott kérések összevetéséhez.Using this header is highly recommended for correlating client-side activities with requests received by the server. További információ: tudnivalók a Storage Analytics naplózásáról és az Azure-naplózásról: a tárolási kérelmek nyomon követésére szolgáló naplók használata.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.

Kérelem törzseRequest Body

A 2012-02-12-es és korábbi verziók esetében a kérelem törzsének formátuma a következő:For version 2012-02-12 and earlier, the format of the request body is as follows:

<?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-es és újabb verziók esetében a kérelem törzsének formátuma a következő:For version 2013-08-15 and later, the format of the request body is as follows:

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

A 2013-08-15-es verziótól kezdődően Set Table Service Properties a kérelem törzsében megadott egy vagy több gyökérelem is meghívható.Beginning with version 2013-08-15, you can call Set Table Service Properties with one or more root elements specified in the request body. A legfelső szintű elemek a következők:The root elements include:

  • NaplózásLogging

  • HourMetricsHourMetrics

  • MinuteMetricsMinuteMetrics

  • CORSCors

A kérelemben már nem szükséges minden gyökérelem megadnia.It is no longer necessary to specify every root element on the request. Ha kihagyja a gyökérelem elemet, a szolgáltatáshoz tartozó meglévő beállítások megmaradnak.If you omit a root element, the existing settings for the service for that functionality are preserved. Ha azonban megad egy adott gyökérszintű elemet, meg kell adnia minden gyermek elemet az adott elemhez.However, if you do specify a given root element, you must specify every child element for that element.

Az alábbi táblázat a kérelem törzsének elemeit ismerteti:The following table describes the elements of the request body:

Elem neveElement Name DescriptionDescription
NaplózásLogging Nem kötelező a 2013-08-15-es verziótól kezdődően.Optional beginning with version 2013-08-15. A korábbi verziókhoz szükséges.Required for earlier versions. Csoportosítja az Azure Analytics naplózási beállításait.Groups the Azure Analytics Logging settings.
MetrikákMetrics A 2012-02-12-es és korábbi verziókhoz szükséges.Required for version 2012-02-12 and earlier. Nem alkalmazható a 2013-08-15-es vagy újabb verzióra.Not applicable for version 2013-08-15 or later. Csoportosítja az Azure Analytics mérőszámok beállításait.Groups the Azure Analytics Metrics settings. A metrikák beállításai összefoglalják a kérelmek statisztikáit az API szerint csoportosítva, a táblák óránkénti összesítése alapján.The Metrics settings provide a summary of request statistics grouped by API in hourly aggregates for tables.
HourMetricsHourMetrics Nem kötelező a 2013-08-15-es vagy újabb verzióhoz; a korábbi verziók esetében nem alkalmazható.Optional for version 2013-08-15 or later; not applicable for earlier versions. Csoportosítja az Azure Analytics HourMetrics beállításait.Groups the Azure Analytics HourMetrics settings. A HourMetrics beállítások összefoglalják az API-k szerint csoportosított kérelmek statisztikáit a táblák óránkénti összesítésével.The HourMetrics settings provide a summary of request statistics grouped by API in hourly aggregates for tables.
MinuteMetricsMinuteMetrics Nem kötelező a 2013-08-15-es vagy újabb verzióhoz; a korábbi verziók esetében nem alkalmazható.Optional for version 2013-08-15 or later; not applicable for earlier versions. Csoportosítja az Azure Analytics MinuteMetrics beállításait.Groups the Azure Analytics MinuteMetrics settings. A MinuteMetrics -beállítások a táblákhoz tartozó percenkénti kérelmek statisztikáját adják meg.The MinuteMetrics settings provide request statistics for each minute for tables. Az 2013-08-15-nál korábbi verziók esetében a MinuteMetrics nem szerepel a válasz törzsében.For versions earlier than 2013-08-15, MinuteMetrics is not included in the response body.
VerzióVersion Kötelező.Required. A konfigurálandó Storage Analytics verziója.The version of Storage Analytics to configure.
SzabályzatDelete Kötelező.Required. Csak a naplózási konfigurációra vonatkozik.Applies only to logging configuration. Azt jelzi, hogy naplózni kell-e az összes törlési kérelmet.Indicates whether all delete requests should be logged.
OlvasásRead Kötelező.Required. Csak a naplózási konfigurációra vonatkozik.Applies only to logging configuration. Azt jelzi, hogy naplózni kell-e az összes olvasási kérelmet.Indicates whether all read requests should be logged.
ÍrásWrite Kötelező.Required. Csak a naplózási konfigurációra vonatkozik.Applies only to logging configuration. Azt jelzi, hogy a rendszer naplózza-e az írási kérelmeket.Indicates whether all write requests should be logged.
EngedélyezveEnabled Kötelező.Required. Azt jelzi, hogy engedélyezve vannak-e a metrikák a tárolási szolgáltatáshoz.Indicates whether metrics is enabled for the storage service.

Ha az olvasási hozzáférés geo-redundáns replikációja engedélyezve van, az elsődleges és a másodlagos metrikákat is gyűjti a rendszer.If read-access geo-redundant replication is enabled, both primary and secondary metrics are collected. Ha az olvasási hozzáférés geo-redundáns replikációja nincs engedélyezve, csak az elsődleges metrikák lesznek összegyűjtve.If read-access geo-redundant replication is not enabled, only primary metrics are collected.
IncludeAPIsIncludeAPIs Csak akkor szükséges, ha a metrikák engedélyezve vannak.Required only if metrics are enabled. Csak a metrikák konfigurációra vonatkozik.Applies only to metrics configuration. Azt jelzi, hogy a metrikák előállítanak-e összesítő statisztikát az API-műveletekhez.Indicates whether metrics should generate summary statistics for called API operations.
RetentionPolicy/engedélyezveRetentionPolicy/Enabled Kötelező.Required. Azt jelzi, hogy engedélyezve van-e a tárolási szolgáltatás adatmegőrzési szabályzata.Indicates whether a retention policy is enabled for the storage service.
RetentionPolicy/napRetentionPolicy/Days Csak akkor szükséges, ha egy adatmegőrzési szabály engedélyezve van.Required only if a retention policy is enabled. Azt jelzi, hogy hány nap elteltével kell megőrizni a mérőszámokat vagy a naplózási adatokat.Indicates the number of days that metrics or logging data should be retained. Az ennél az értéknél régebbi összes érték törlődni fog.All data older than this value will be deleted. A minimálisan megadható érték a 1 ; a legnagyobb érték 365 (egy év).The minimum value you can specify is 1; the largest value is 365 (one year).
CORSCors Választható.Optional. A CORS elem a 2013-08-15-es vagy újabb verzióban támogatott.The Cors element is supported for version 2013-08-15 or later. Csoportosítja az összes CORS szabályt.Groups all CORS rules.

Az Element csoport kihagyása nem írja felül a meglévő CORS-beállításokat.Omitting this element group will not overwrite existing CORS settings.
CorsRuleCorsRule Választható.Optional. Meghatározza a Table service CORS szabályát.Specifies a CORS rule for the Table service. A kérelemben akár öt CorsRule elemet is megadhat.You can include up to five CorsRule elements in the request. Ha a kérelem törzsében nem szerepelnek CorsRule elemek, a rendszer az összes CORS-szabályt törli, és a CORS le lesz tiltva a Table Service.If no CorsRule elements are included in the request body, all CORS rules will be deleted, and CORS will be disabled for the Table service.
AllowedOriginsAllowedOrigins Kötelező, ha CorsRule elem van jelen.Required if CorsRule element is present. A CORS-n keresztül engedélyezett forrás-tartományok vesszővel tagolt listája, vagy "*" az összes tartomány engedélyezéséhez.A comma-separated list of origin domains that will be allowed via CORS, or "*" to allow all domains. Legfeljebb 64 forrás tartományra korlátozható.Limited to 64 origin domains. Minden engedélyezett forrás legfeljebb 256 karakterből állhat.Each allowed origin can have up to 256 characters.
ExposedHeadersExposedHeaders Kötelező, ha CorsRule elem van jelen.Required if CorsRule element is present. A CORS-ügyfelek számára elérhető válasz-fejlécek vesszővel tagolt listája.A comma-separated list of response headers to expose to CORS clients. Legfeljebb 64 definiált fejlécre és két előre rögzített fejlécre korlátozódik.Limited to 64 defined headers and two prefixed headers. Minden fejléc legfeljebb 256 karakter hosszú lehet.Each header can be up to 256 characters.
MaxAgeInSecondsMaxAgeInSeconds Kötelező, ha CorsRule elem van jelen.Required if CorsRule element is present. Azon másodpercek száma, ameddig az ügyfélnek/böngészőnek gyorsítótárba kell helyeznie egy elővizsgálati választ.The number of seconds that the client/browser should cache a preflight response.
AllowedHeadersAllowedHeaders Kötelező, ha a CorsRule elem létezik.Required if CorsRule element exists. Az eltérő eredetű kérelmek részét képező fejlécek vesszővel tagolt listája.A comma-separated list of headers allowed to be part of the cross-origin request. Legfeljebb 64 definiált fejlécre és 2 előre rögzített fejlécre korlátozódik.Limited to 64 defined headers and 2 prefixed headers. Minden fejléc legfeljebb 256 karakter hosszú lehet.Each header can be up to 256 characters.
AllowedMethodsAllowedMethods Kötelező, ha a CorsRule elem létezik.Required if CorsRule element exists. A forrás által végrehajtható HTTP-metódusok vesszővel tagolt listája.A comma-separated list of HTTP methods that are allowed to be executed by the origin. Az Azure Storage esetében az engedélyezett módszerek a következők: törlés, beolvasás, fej, EGYESÍTÉS, közzététel, beállítások vagy PUT.For Azure Storage, permitted methods are DELETE, GET, HEAD, MERGE, POST, OPTIONS or PUT.

VálaszResponse

A válasz tartalmazza a HTTP-állapotkódot, a válasz fejléceit és a válasz törzsét.The response includes an HTTP status code, a set of response headers, and a response body.

ÁllapotkódStatus Code

Egy sikeres művelet A 202-as állapotkódot (elfogadva) adja vissza.A successful operation returns status code 202 (Accepted).

VálaszfejlécekResponse Headers

A műveletre adott válasz a következő fejléceket tartalmazza.The response for this operation includes the following headers. A válasz további szabványos HTTP-fejléceket is tartalmazhat.The response may also include additional standard HTTP headers. Minden szabványos fejléc megfelel a http/1.1 protokoll specifikációjának.All standard headers conform to the HTTP/1.1 protocol specification.

VálaszfejlécResponse Header DescriptionDescription
x-ms-request-id Egy érték, amely egyedileg azonosítja a szolgáltatásra irányuló kérelmet.A value that uniquely identifies a request made against the service.
x-ms-version A válaszhoz használt művelet verziószámát adja meg.Specifies the version of the operation used for the response. További információ: verziószámozás az Azure Storage Services szolgáltatásban.For more information, see Versioning for the Azure Storage Services.
x-ms-client-request-id Ez a fejléc a kérelmek és a hozzájuk tartozó válaszok megoldásához használható.This header can be used to troubleshoot requests and corresponding responses. A fejléc értéke megegyezik a fejléc értékével, ha az szerepel x-ms-client-request-id a kérelemben, és az érték legfeljebb 1024 látható ASCII-karakterből áll.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, ez a fejléc nem jelenik meg a válaszban.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

Válasz törzseResponse Body

Nincsenek.None.

EngedélyezésAuthorization

Ezt a műveletet csak a fiók tulajdonosa hívhatja fel.Only the account owner may call this operation.

MegjegyzésekRemarks

Az Azure Storage-ban a következő korlátozások és korlátozások érvényesek az CORS-szabályokra:The following restrictions and limitations apply to CORS rules in Azure Storage:

  • Legfeljebb öt szabályt lehet tárolni.A maximum of five rules can be stored.

  • A kérelemben szereplő összes CORS-szabály beállításainak maximális mérete (az XML-címkék kivételével) nem haladhatja meg a 2 KiB értéket.The maximum size of all CORS rules settings on the request, excluding XML tags, should not exceed 2 KiB.

  • Az engedélyezett fejlécek, a megjelenített fejlécek és a megengedett forrás hossza nem haladhatja meg a 256 karaktert.The length of an allowed header, exposed header, or allowed origin should not exceed 256 characters.

  • Az engedélyezett fejlécek és az elérhető fejlécek a következők lehetnek:Allowed headers and exposed headers may be either:

    • Literális fejlécek, ahol a pontos fejléc neve van megadva, például x-MS-meta-Processed.Literal headers, where the exact header name is provided, such as x-ms-meta-processed. A kérelemben legfeljebb 64 literál fejléc adható meg.A maximum of 64 literal headers may be specified on the request.

    • Előre meghatározott fejlécek, ahol a fejléc egy előtagját megadja, például az x-MS-meta-- * adatforrásokat.Prefixed headers, where a prefix of the header is provided, such as x-ms-meta-data*. Egy előtag ily módon történő megadásával engedélyezheti vagy közzéteheti az adott előtaggal kezdődő fejléceket.Specifying a prefix in this manner allows or exposes any header that begins with the given prefix. A kérelemben legfeljebb két előre rögzített fejléc adható meg.A maximum of two prefixed headers may be specified on the request.

  • A AllowedMethods elemben megadott metódusoknak (vagy http-műveleteknek) meg kell felelniük az Azure Storage szolgáltatás API-jai által támogatott módszereknek.The methods (or HTTP verbs) specified in the AllowedMethods element must conform to the methods supported by Azure storage service APIs. A támogatott módszerek a következők: törlés, beolvasás, fej, EGYESÍTÉS, közzététel, beállítások és PUT.Supported methods are DELETE, GET, HEAD, MERGE, POST, OPTIONS and PUT.

A kérelemre vonatkozó CORS-szabályok megadása nem kötelező.Specifying CORS rules on the request is optional. Ha a Set Table Service Properties kérés törzsében a CORS elem meghatározása nélkül hívja meg, a rendszer megőrzi a meglévő CORS-szabályokat.If you call Set Table Service Properties without specifying the Cors element in the request body, any existing CORS rules are maintained.

A CORS letiltásához hívja meg az Set Table Service Properties üres CORS szabályok beállításait (például: </Cors> ), és ne legyen belső CORS-szabály.To disable CORS, call Set Table Service Properties with an empty CORS rules settings (i.e.,</Cors>) and no inner CORS rules. Ez a hívás törli a meglévő szabályokat, és letiltja a Table service CORS.This call deletes any existing rules, disabling CORS for the Table service.

Ha a CorsRule elem meg van adva, az összes CORS szabály elemének megadása kötelező.All CORS rule elements are required if the CorsRule element is specified. A kérelem sikertelen lesz, hibakód: 400 ( Bad Request ), ha valamelyik elem hiányzik.The request will fail with error code 400 (Bad Request) if any element is missing.

Az 2013-08-15-es verziótól kezdődően az XML-beállítások elemei nem kötelezőek, ezért egy adott elem frissítése egy olyan XML-fájl elküldésével végezhető el, amely csak a frissített elemet tartalmazza, és a többi beállítás nem lesz hatással.Beginning with version 2013-08-15, XML settings elements will be optional so updating a specific element can be done by sending an XML that only contains the updated element and other settings will not be affected.

A CORS-szabályokkal és a kiértékelési logikával kapcsolatos részletes információkért lásd: CORS-támogatás a tárolási szolgáltatásokhoz.For detailed information about CORS rules and evaluation logic, see CORS Support for the Storage Services.

Példa a kérelemre és a válaszraSample Request and Response

A következő minta URI a MyAccountnevű fiktív Storage-fiók Table Service tulajdonságainak módosítására irányuló kérelmet küld:The following sample URI makes a request to change the Table service properties for the fictional storage account named myaccount:

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

A rendszer a következő fejlécekkel küldi el a kérelmet:The request is sent with the following headers:

x-ms-version: 2013-08-15  
x-ms-date: Mon, 21 Oct 2013 04:38:23 GMT  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.table.core.windows.net  

A kérést a rendszer a következő XML-törzstel küldi el:The request is sent with the following XML body:

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

A kérelem elküldése után a következő válasz érkezik:After the request has been sent, the following response is returned:

HTTP/1.1 202 Accepted  
Connection: Keep-Alive  
Transfer-Encoding: chunked  
Date: Mon, 21 Oct 2013 04:38:24 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  
  

Lásd még:See Also