Fájlszolgáltatás tulajdonságainak beállítása

Cikk
08/05/2023

A Set File Service Properties művelet a FileREST API használatával állítja be a Fájlszolgáltatás-erőforrás tulajdonságait. Bár ez az API teljes mértékben támogatott, örökölt felügyeleti API. Javasoljuk, hogy ehelyett a Fájlszolgáltatások – Szolgáltatástulajdonságok beállítása lehetőséget használja, amelyet az Azure Storage-erőforrás-szolgáltató (Microsoft.Storage) biztosít. Ha többet szeretne megtudni arról, hogyan használhatja programozott módon a Fájlszolgáltatás erőforrását az Azure Storage-erőforrás-szolgáltató használatával, olvassa el a Fájlszolgáltatás műveletei című témakört.

Protokoll rendelkezésre állása

Engedélyezett fájlmegosztási protokoll	Elérhető
SMB
NFS

Kérés

A kérést a Set File Service Properties következőképpen adhatja 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ó
PUT	`https://account-name.file.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ő. A tárolási szolgáltatás tulajdonságainak beállításához mindkét lekérdezési sztring kombinációjára szükség van.
`timeout`	Választható. A `timeout` paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása fájlszolgáltatás-műveletekhez.

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 or 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. Ez a művelet csak a 2015-02-21-es és újabb verziókban érhető el. A Fájlszolgáltatás metrikáinak engedélyezéséhez meg kell adnia a 2015-04-05-ös vagy újabb verziót. 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ó: Monitorozási Azure Files.

A kérés törzse

A 2020-02-10-es verzió kérelemtörzsének formátuma a következő:

<?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>    
    <ShareDeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>integer-value</Days>
    </ShareDeleteRetentionPolicy>
    <ProtocolSettings>
        <SMB>
            <Multichannel>
                <Enabled>true|false</Enabled>
            </Multichannel>
            <Versions>comma-separated-list-of-smb-versions</Versions>
            <AuthenticationMethods>comma-separated-list-of-auth-methods</AuthenticationMethod>
            <KerberosTicketEncryption>csv-of-kerb-encryption-algorithms</KerberosTicketEncryption>
            <ChannelEncryption>csv-of-smb-encryption-algorithms</ChannelEncryption>
        </SMB>
    </ProtocolSettings>
</StorageServiceProperties>

Nem szükséges megadni a kérés összes gyökérelemét. Ha kihagy egy gyökérelemet, a szolgáltatás meglévő beállításai megmaradnak az adott funkcióhoz. Ha azonban megad egy bizonyos gyökérelemet, meg kell adnia az elem minden gyermekelemét. A gyökérelemek a következők:

HourMetrics
MinuteMetrics
Cors
ProtocolSettings

A kérelem törzsének elemeit a következő táblázat ismerteti:

Név	Leírás
`HourMetrics`	Nem kötelező a 2015-04-05-ös és újabb verziókhoz. A korábbi verziókra nem alkalmazható. Csoportosítja a Storage Analytics `HourMetrics` beállításokat, amelyek az API-k szerint csoportosított kérelemstatisztikák összegzését adják meg óránkénti összesítésekben.
`MinuteMetrics`	Nem kötelező a 2015-04-05-ös és újabb verziókhoz. A korábbi verziókra nem alkalmazható. Csoportosítja a Storage Analytics `MinuteMetrics` beállításokat, amelyek az egyes percekre vonatkozó kérésstatisztikákat adják meg.
`Version`	Kötelező, ha a metrikák engedélyezve vannak. A konfigurálni kívánt Storage Analytics verziója. Használja `1.0` ezt az értéket.
`Enabled`	Kötelező. Azt jelzi, hogy engedélyezve vannak-e a metrikák a Fájlszolgáltatásban.
`IncludeAPIs`	Csak akkor szükséges, ha a metrikák engedélyezve vannak. Azt jelzi, hogy a metrikáknak létre kell-e hozniuk az úgynevezett API-műveletek összefoglaló statisztikáit.
`RetentionPolicy/Enabled`	Kötelező. Azt jelzi, hogy engedélyezve van-e adatmegőrzési szabályzat a Fájlszolgáltatáshoz. Ha hamis, a metrikák adatai megmaradnak, és a felhasználó felelős az adatok törléséért.
`RetentionPolicy/Days`	Csak akkor szükséges, ha engedélyezve van egy adatmegőrzési szabályzat. Azt jelzi, hogy hány napig kell megőrizni a metrikák adatait. Az ennél az értéknél régebbi adatok törlődnek. A megadható minimális érték a `1`, a maximális érték `365` pedig (egy év). A metrikák adatai a megőrzési időszak lejárta után a lehető legjobb erőfeszítéssel törlődnek.
`Cors`	Választható. Az `Cors` elem a 2015-02-21-es és újabb verziókban támogatott. Csoportosítja az összes forrásközi erőforrás-megosztási (CORS-) szabályt. Ha kihagyja ezt az elemcsoportot, az nem írja felül a meglévő CORS-beállításokat.
`CorsRule`	Választható. Cors-szabályt ad meg a Fájlszolgáltatáshoz. Egy kérés legfeljebb öt `CorsRule` elemet tartalmazhat. Ha a kérelemtörzs nem `CorsRule` tartalmaz elemeket, az összes CORS-szabály törlődik, és a CORS le van tiltva a Fájlszolgáltatásban.
`AllowedOrigins`	Kötelező, ha az `CorsRule` elem jelen van. A CORS-on keresztül engedélyezett forrástartományok vesszővel tagolt listája, vagy "*" az összes tartomány engedélyezéséhez. A forrástartományok helyettesítő karaktert is tartalmazhatnak az altartományban, amely lehetővé teszi a CORS-on keresztüli kérelmeket a tartomány összes altartományára vonatkozóan. Legfeljebb 64 forrástartományra korlátozva. Minden engedélyezett forrás legfeljebb 256 karakterből állhat.
`ExposedHeaders`	Kötelező, ha az `CorsRule` elem jelen van. A CORS-ügyfelek számára közzéteendő válaszfejlécek vesszővel tagolt listája. Legfeljebb 64 definiált fejléc és két előtagú fejléc. Minden fejléc legfeljebb 256 karakterből állhat.
`MaxAgeInSeconds`	Kötelező, ha az `CorsRule` elem jelen van. Azon másodpercek száma, amikor az ügyfélnek/böngészőnek gyorsítótáraznia kell az elővizsgálati választ.
`AllowedHeaders`	Kötelező, ha az `CorsRule` elem létezik. Olyan fejlécek vesszővel tagolt listája, amelyek részt vehetnek a forrásközi kérésben. Legfeljebb 64 definiált fejléc és 2 előtagú fejléc lehet. Minden fejléc legfeljebb 256 karakterből állhat.
`AllowedMethods`	Kötelező, ha `CorsRule` az elem létezik. A forrás által végrehajtható HTTP-metódusok vesszővel tagolt listája. A Azure Files esetében a megengedett módszerek a következők`DELETE`: , `GET`, `HEAD`, `MERGE`, `POSTOPTIONS`és `PUT`.
`ShareDeleteRetentionPolicy`	Választható. A tárfiókban található Azure-fájlmegosztások helyreállítható törlési tulajdonságai.
`Days`	Választható. Azt jelzi, hogy hány napig kell megőrizni az Azure-fájlmegosztást (helyreállíthatóan törölve). A megadható minimális érték a `1`, a maximális érték `365` pedig (egy év).
`Enabled`	Választható. Azt jelzi, hogy a tárfiókban engedélyezve van-e a helyreállítható törlés Azure Files.
`ProtocolSettings`	Választható. A fájlrendszerprotokollok beállításainak csoportosítása.
`SMB`	Választható. Az SMB beállításainak csoportosítása.
`Multichannel`	Választható. A többcsatornás SMB beállításait tartalmazza. A többcsatornás SMB tartalmazza a `Enabled` logikai tulajdonságot, amely az SMB többcsatornás állapotát váltja ki.
`Version`	A 2020-04-08-as verziótól nem kötelező. Az engedélyezett SMB-verziók vesszővel tagolt listája. Az engedélyezett értékek a következők: `SMB2.1`, `SMB3.0`és `SMB3.1.1`.
`AuthenticationMethods`	A 2020-04-08-as verziótól nem kötelező. Az engedélyezett hitelesítési módszerek vesszővel tagolt listája. Az engedélyezett értékek a és `Kerberos`a.`NTLMv2`
`KerberosTicketEncryption`	A 2020-04-08-as verziótól nem kötelező. Az engedélyezett Kerberos-jegytitkosítási algoritmusok vesszővel tagolt listája. Az engedélyezett értékek a és `AES-256`a.`RC4-HMAC`
`ChannelEncryption`	A 2020-04-08-as verziótól nem kötelező. Az engedélyezett SMB-csatorna titkosítási protokolljainak vesszővel tagolt listája. Az engedélyezett értékek a következők: `AES-128-CCM`, `AES-128-GCM`és `AES-256-GCM`.

Reagálás

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

Állapotkód

A sikeres művelet a 202-s állapotkódot adja vissza (Elfogadva).

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`	Egy érték, amely egyedileg azonosítja a szolgáltatással szemben végrehajtott kéréseket.
`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 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

Nincsenek.

Engedélyezés

Ezt a műveletet csak a fióktulajdonos hívhatja meg.

Megjegyzések

Az alábbi korlátozások és korlátozások vonatkoznak a CORS-szabályokra Azure Files:

Legfeljebb öt szabály tárolható.
A kérelem cors-szabálybeállításainak maximális mérete – az XML-címkék kivételével – nem haladhatja meg a 2 kib-ot.
Az engedélyezett fejléc, a közzétett fejléc vagy az engedélyezett forrás hossza nem haladhatja meg a 256 karaktert.
Az engedélyezett fejlécek és a közzétett fejlécek a következők lehetnek:
- Literális fejlécek, ahol meg van adva a fejléc pontos neve, például x-ms-meta-processed: . A kérelemben legfeljebb 64 literális fejléc adható meg.
- Előtaggal rendelkező fejlécek, ahol meg van adva a fejléc előtagja, például x-ms-meta-data*: . Az előtag ilyen módon történő megadása lehetővé teszi vagy elérhetővé teszi az ezzel az előtaggal kezdődő fejléceket. A kérelemben legfeljebb két előtagú fejléc adható meg.
Az elemben AllowedMethods megadott metódusoknak (vagy HTTP-parancsoknak) meg kell felelniük az Azure Storage szolgáltatás API-jai által támogatott metódusoknak. A támogatott módszerek a következők DELETE: , GET, HEAD, MERGE, POST, OPTIONSés PUT.

A CORS-szabályok megadása a kérelemben nem kötelező. Ha a kérés törzsében a CORS elem megadása nélkül hív Set File Service Properties , a meglévő CORS-szabályok megmaradnak.

A CORS letiltásához hívjon Set File Service Properties üres CORS-szabályokkal (azaz </Cors>) és belső CORS-szabályok nélkül. Ez a hívás törli a meglévő szabályokat, és letiltja a CORS-t a Fájlszolgáltatásban.

Ha az elem meg van adva, minden CorsRule CORS-szabályelemre szükség van. Ha valamelyik elem hiányzik, a kérés a 400-ás hibakóddal (hibás kérelem) meghiúsul.

További információ a CORS-szabályokról és a kiértékelési logikáról: Forrásközi erőforrásmegosztás támogatása az Azure Storage-szolgáltatásokhoz.

Mintakérés és válasz

Az alábbi URI-minta kérést küld a myaccount nevű tárfiók Fájlszolgáltatás-tulajdonságainak módosítására:

PUT https://myaccount.file.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: 2020-02-10  
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:

<?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>
    <ShareDeleteRetentionPolicy>
        <Enabled>true</Enabled>
        <Days>7</Days>
    </ShareDeleteRetentionPolicy>
    <ProtocolSettings>
        <SMB>
            <Multichannel>
                <Enabled>true</Enabled>
            </Multichannel>
            <Versions>SMB3.1.1</Versions>
            <AuthenticationMethods>Kerberos</AuthenticationMethods>
            <KerberosTicketEncryption>AES-256</KerberosTicketEncryption>
            <ChannelEncryption>AES-256-GCM</ChannelEncryption>
        </SMB>
    </ProtocolSettings>
</StorageServiceProperties>

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

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

Lásd még