A file Service tulajdonságainak beállításaSet File Service Properties

A Set File Service Properties művelet beállítja a Storage-fiók file Service-végpontjának tulajdonságait.The Set File Service Properties operation sets properties for a storage account’s File service endpoint. A 2015-02-21-es és újabb verziókban a használatával Set File Service Properties beállíthatja a CORS (több eredetű erőforrás-megosztási) szabályokat.In version 2015-02-21 and later, you can use Set File Service Properties to set CORS (Cross-Origin Resource Sharing) rules. A 2015-04-05-es és újabb verziókban a használatával Set File Service Properties engedélyezheti a fájlszolgáltatások Storage Analytics metrikáit.In version 2015-04-05 and later, you can use Set File Service Properties to enable Storage Analytics metrics for the File service.

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.

További információ a Storage Analyticsről: Storage Analytics.For additional information about Storage Analytics, see Storage Analytics.

KérésRequest

A Set File Service Properties kérést a következőképpen lehet megadni.The Set File Service Properties request may be specified as follows. A HTTPS használata javasolt.HTTPS is recommended. Cserélje le a Storage-fiókjának nevére:Replace with the name of your storage account:

MetódusMethod Kérés URI-jaRequest URI HTTP-verzióHTTP Version
PUTPUT https://<account-name>.file.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. További információ: időtúllépések beállítása a Fájlszolgáltatások műveleteihez.For more information, see Setting Timeouts for File Service Operations.

KÉRÉSEK FEJLÉCEIREQUEST 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 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. Ez a művelet csak a 2015-02-21-es és újabb verziókban érhető el.This operation is available only in versions 2015-02-21 and later. A file Service metrikáinak engedélyezéséhez meg kell adnia a 2015-04-05-es vagy újabb verziót.To enable metrics for the File service, you must specify version 2015-04-05 or later.

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.

KÉRELEM TÖRZSEREQUEST BODY

A 2015-04-05-es verzióra vonatkozó kérelem törzsének formátuma a következő:The format of the request body for version 2015-04-05 is as follows:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <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 kérelemben szereplő összes gyökérelem megadására nincs szükség.It is not 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. A legfelső szintű elemek a következők:The root elements include:

  • HourMetrics

  • MinuteMetrics

  • Cors

A 2015-02-21-es verzióra vonatkozó kérelem törzsének formátuma a következő:The format of the request body for version 2015-02-21 is as follows:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <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>  

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
Cors Választható.Optional. Az Cors elem a 2015-02-21-es vagy újabb verzióban támogatott.The Cors element is supported for version 2015-02-21 or later. Csoportosítja az összes CORS szabályt. Az Element csoport kihagyása nem írja felül a meglévő CORS-beállításokat.Groups all CORS rules.Omitting this element group will not overwrite existing CORS settings.
CorsRule Választható.Optional. Megad egy CORS szabályt a fájl szolgáltatáshoz.Specifies a CORS rule for the File service. Egy kérés legfeljebb öt CorsRule elemet tartalmazhat.You can include up to five CorsRule elements in the request. Ha CorsRule a kérelem törzse nem tartalmaz elemeket, az összes CORS-szabályt törli a rendszer, és a CORS le lesz tiltva.If no CorsRule elements are included in the request body, all CORS rules will be deleted, and CORS will be disabled for the File service.
AllowedOrigins Kötelező CorsRule , ha az elem megtalálható.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.
ExposedHeaders Kötelező CorsRule , ha az elem megtalálható.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.
MaxAgeInSeconds Kötelező CorsRule , ha az elem megtalálható.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.
AllowedHeaders Kötelező, ha az 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.
AllowedMethods Kötelező, ha az 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.
HourMetrics Nem kötelező a 2015-04-05-es vagy újabb verzióhoz; a korábbi verziók esetében nem alkalmazható.Optional for version 2015-04-05 or later; not applicable for earlier versions. Csoportosítja a Storage Analytics HourMetrics beállításait.Groups the Storage Analytics HourMetrics settings. A HourMetrics Beállítások összefoglalják az API-k által az óránként összesítve csoportosított kérések statisztikáit.The HourMetrics settings provide a summary of request statistics grouped by API in hourly aggregates.
MinuteMetrics Nem kötelező a 2015-04-05-es vagy újabb verzióhoz; a korábbi verziók esetében nem alkalmazható.Optional for version 2015-04-05 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 minden percnél megadják a kérelmek statisztikáit.The MinuteMetrics settings provide request statistics for each minute.
VerzióVersion Kötelező, ha a metrikák engedélyezve vannak.Required if metrics are enabled. A konfigurálandó Storage Analytics verziója.The version of Storage Analytics to configure. Ehhez az értékhez használja az "1,0" értéket.Use "1.0" for this value.
EngedélyezveEnabled Kötelező.Required. Azt jelzi, hogy engedélyezve vannak-e a metrikák a Fájlszolgáltatások számára.Indicates whether metrics are enabled for the File service.
IncludeAPIsIncludeAPIs Csak akkor szükséges, ha a metrikák engedélyezve vannak.Required only if metrics are enabled. 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 az adatmegőrzési szabályzat a Fájlszolgáltatások számára.Indicates whether a retention policy is enabled for the File service. Hamis érték esetén a rendszer megőrzi a metrikák adatait, és a felhasználó felelős a törlésért.If false, metrics data is retained, and the user is responsible for deleting it.
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 metrikák adatait.Indicates the number of days that metrics 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). A metrikák adatait a megőrzési időszak lejárta után a legjobb erőfeszítést követően törli a rendszer.Metrics data is deleted on a best-effort basis after the retention period expires.

VálaszResponse

A válasz tartalmazza a HTTP-állapotkódot és a válasz fejlécek egy készletét.The response includes an HTTP status code and a set of response headers.

ÁLLAPOTKÓDSTATUS CODE

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

VÁLASZ FEJLÉCEIRESPONSE 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.

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.

  • Az elemben megadott metódusoknak (vagy HTTP-műveleteknek) AllowedMethods 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 File 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 File 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 File 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 File 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 CORS a Fájlszolgáltatások számára.This call deletes any existing rules, disabling CORS for the File 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 (hibás kérés), ha valamelyik elem hiányzik.The request will fail with error code 400 (Bad Request) if any element is missing.

A CORS-szabályokkal és az értékelési logikával kapcsolatos részletes információkért lásd: Az Azure Storage-hoz készült több eredetű erőforrás-megosztás (CORS) támogatása.For detailed information about CORS rules and evaluation logic, see Cross-Origin Resource Sharing (CORS) support for Azure Storage.

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

A következő minta URI a MyAccountnevű Storage-fiókhoz tartozó Fájlszolgáltatások tulajdonságainak módosítására irányuló kérést tesz lehetővé:The following sample URI makes a request to change the File service properties for a storage account named myaccount:

PUT https://myaccount.file.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: 2015-04-05  
x-ms-date: <date>  
Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.file.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>  
    <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: <date>  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2015-04-05