Megosztás a következőn keresztül:

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

  • Cikk

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 Igen
NFS Yes

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őkDELETE: , 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 Kerberosa.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-256a.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

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.

A Storage Analytics kapcsolatos további információkért lásd: Storage Analytics.