Fájlszolgáltatás tulajdonságainak lekérése

Cikk
08/05/2023

A Get File Service Properties művelet a FileREST API használatával lekéri az FileService erőforrás tulajdonságait. Bár ez az API teljes mértékben támogatott, ez egy örökölt felügyeleti API. Javasoljuk, hogy ehelyett a Fájlszolgáltatások – Szolgáltatástulajdonságok lekérése lehetőséget használja, amelyet a tárolási erőforrás-szolgáltató (Microsoft.Storage) biztosít. Az erőforrással a tárolási erőforrás-szolgáltató használatával végzett programozott interakcióval FileService kapcsolatos további információkért lásd : Műveletek a FileService erőforráson.

Protokoll rendelkezésre állása

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

Kérés

A Get File Service Properties kérelem az alábbiak szerint adható meg. Javasoljuk, hogy HTTPS-t használjon. Cserélje le <account-name> a elemet a tárfiók nevére:

Metódus	Kérés URI-ja	HTTP-verzió
GET	`https://<account-name>.file.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Megjegyzés

Az URI-nak mindig tartalmaznia kell perjel karaktert (/), hogy elkülönítse az állomásnevet 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ója szükséges.
`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

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

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érelmek 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érelmek engedélyezése az Azure Storage-ba.
`x-ms-version`	Minden engedélyezett kéréshez szükséges. A kérelemhez használandó 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 metrikatulajdonságainak lekéré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 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít az Azure Storage Analytics naplóiban. 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ó: Azure Files figyelése.

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 -os állapotkódot adja vissza (OK).

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ásra irányuló kérést.
`x-ms-version`	A válaszhoz használt 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`	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` kérelemben szereplő fejléc értékével, é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, akkor az nem szerepel a válaszban.

Választörzs

A válasz törzsének formátuma a 2020-02-10-es verzióhoz 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>

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

Név	Leírás
`HourMetrics`	Csoportosítja a Storage Analytics `HourMetrics` beállításait. A `HourMetrics` beállítások a kérelemstatisztikák összegzését biztosítják, API-k szerint csoportosítva óránkénti összesítésekben.
`MinuteMetrics`	Csoportosítja a Storage Analytics `MinuteMetrics` beállításait. A `MinuteMetrics` beállítások az egyes percekre vonatkozó kérelemstatisztikákat adják meg.
`Version`	A jelenleg használatban lévő Storage Analytics verziója.
`Enabled`	Azt jelzi, hogy engedélyezve vannak-e a metrikák a Fájlszolgáltatásban.
`IncludeAPIs`	Azt jelzi, hogy a metrikák létrehoznak-e összegző statisztikákat az úgynevezett API-műveletekhez.
`RetentionPolicy/Enabled`	Azt jelzi, hogy engedélyezve van-e adatmegőrzési szabályzat a Fájlszolgáltatáshoz.
`RetentionPolicy/Days`	Azt jelzi, hogy hány napig őrzi meg a rendszer a metrikák adatait. Az ennél az értéknél régebbi adatok a lehető legjobb erőfeszítéssel törlődnek.
`Cors`	Csoportosítja az összes eltérő eredetű erőforrás-megosztási (CORS-) szabályt.
`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, illetve "*", 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. A Azure Files esetében az engedélyezett módszerek a KÖVETKEZŐK: DELETE, GET, HEAD, MERGE, POST, OPTIONS és PUT.
`ShareDeleteRetentionPolicy`	A tárfiókban található Azure-fájlmegosztások helyreállítható törlési tulajdonságai.
`Days`	Azt jelzi, hogy hány napig kell megőrizni az Azure-fájlmegosztást (helyreállíthatóan törölve). A minimálisan megadott érték 1, a maximális érték pedig 365.
`Enabled`	Azt jelzi, hogy a tárfiókon engedélyezve van-e a helyreállítható törlés Azure Files.
`ProtocolSettings`	A fájlrendszerprotokollok beállításait csoportosítja.
`SMB`	A Kiszolgálói üzenetblokk (SMB) beállításainak csoportosítása.
`Multichannel`	A többcsatornás SMB beállításait tartalmazza. Ez a beállítás egy tulajdonsággal rendelkezik: engedélyezve/letiltva.
`Version`	A 2020-04-08-as verziótól érhető el. Az engedélyezett SMB-verziók vesszővel tagolt listája. Lehetséges értékek: `SMB2.1`, `SMB3.0`és `SMB3.1.1`. Ha `Version` nincs megadva, az alapértelmezett beállítás az, hogy minden verzió engedélyezve van. Az SMB 2.1 azonban csak akkor érhető el, ha a tárfiók tulajdonsága `require secure transit` le van tiltva, mert az SMB 2.1 nem támogatja a titkosítást.
`AuthenticationMethods`	A 2020-04-08-as verziótól érhető el. Az engedélyezett hitelesítési módszerek vesszővel tagolt listája. Lehetséges értékek: `NTLMv2`, `Kerberos`. Ha `AuthenticationMethods` nincs megadva, az alapértelmezett beállítás az, hogy minden hitelesítési módszer engedélyezve van.
`KerberosTicketEncryption`	A 2020-04-08-as verziótól érhető el. Az engedélyezett Kerberos-jegytitkosítási algoritmusok vesszővel tagolt listája. Lehetséges értékek: `RC4-HMAC` és `AES-256`. Ha `KerberosTicketEncryption` nincs megadva, az alapértelmezett beállítás az, hogy minden Kerberos-jegytitkosítási algoritmus támogatott.
`ChannelEncryption`	A 2020-04-08-as verziótól érhető el. Az engedélyezett SMB-csatornatitkosítási protokollok vesszővel tagolt listája. Lehetséges értékek: `AES-128-CCM`, `AES-128-GCM`és `AES-256-GCM`. Ha `ChannelEncryption` nincs megadva, az alapértelmezett érték az, hogy minden csatornatitkosítási érték támogatott. Ha a tárfiók tulajdonsága `require secure transit` le van tiltva, a titkosítatlan SMB-hozzáférés is engedélyezett.

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 a myaccount nevű tárfiók Fájlszolgáltatás-tulajdonságainak lekérésére:

Metódus	URL-cím	Protokoll
GET	`https://myaccount.file.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: 2020-02-10  
x-ms-date: <date>  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.file.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: <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

A válasz a következő XML-törzset tartalmazza:

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

Megjegyzések

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 az Azure Storage-szolgáltatásokhoz.

További információiért tekintse meg a Storage Analyticset bemutató cikket.

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