Megosztási tulajdonságok lekérése
A Get Share Properties kérés a megadott megosztási vagy megosztási pillanatkép tulajdonságait adja vissza.
Bár ez az API teljes mértékben támogatott, ez egy örökölt felügyeleti API. Ezért javasoljuk, hogy inkább Fájlmegosztások –lekérése lehetőséget használja, amelyet a tárerőforrás-szolgáltató (Microsoft.Storage) biztosít.
A FileShare-erőforrások tárolási erőforrás-szolgáltatóval való programozott használatáról további információt a FileSharesműveletek című témakörben talál.
Protokoll rendelkezésre állása
| Engedélyezett fájlmegosztási protokoll | Beszerezhető |
|---|---|
| SMB |
|
| NFS |
|
Kérés
A Get Share Properties kérelem a következőképpen hozható létre. Javasoljuk, hogy HTTPS-t használjon.
| Módszer | URI kérése | HTTP-verzió |
|---|---|---|
GET/HEAD |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
GET/HEAD |
https://myaccount.file.core.windows.net/myshare?restype=share&sharesnapshot=<DateTime> |
HTTP/1.1 |
Cserélje le a kérelem URI-jában látható elérésiút-összetevőket a sajátjára az alábbiak szerint:
| Elérésiút-összetevő | Leírás |
|---|---|
myaccount |
A tárfiók neve. |
myshare |
A fájlmegosztás neve. |
Az útvonalelnevezési korlátozásokról további információt a Név- és hivatkozásmegosztások, könyvtárak, fájlok és metaadatokcímű témakörben talál.
URI-paraméterek
A kérelem URI-jában a következő további paraméterek adhatók meg:
| Paraméter | Leírás |
|---|---|
sharesnapshot |
Szabadon választható. 2017-04-17-es és újabb verzió. A sharesnapshot paraméter egy átlátszatlan dátum/idő érték, amely jelen esetben megadja a lekérdezendő megosztási pillanatképet a tulajdonságok lekéréséhez. |
timeout |
Szabadon választható. Az időtúllépési paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása az Azure Files-műveletekhez. |
Kérelemfejlécek
A szükséges és nem kötelező fejléceket az alábbi táblázat ismerteti:
| Kérelem fejléce | Leírás |
|---|---|
Authorization |
Szükséges. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-. |
Date vagy x-ms-date |
Szükséges. A kérelem koordinált egyetemes idejét (UTC) adja meg. További információ: Kérelmek engedélyezése az Azure Storage-. |
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. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-client-request-id |
Szabadon 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 a 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ó: Monitor Azure Files. |
x-ms-lease-id:<ID> |
Szabadon választható. 2020-02-10-es és újabb verzió. Ha a fejléc meg van adva, a művelet csak akkor lesz végrehajtva, ha a fájlmegosztás bérlete jelenleg aktív, és a kérelemben megadott bérletazonosító megegyezik a fájlmegosztás bérletazonosítójával. Ha nincs egyezés, a művelet a 412-s állapotkóddal hiúsul meg (az előkondicionálás sikertelen). |
Kérelem törzse
Egyik sem.
Válasz
A válasz tartalmaz egy HTTP-állapotkódot és válaszfejléceket.
Állapotkód
A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza.
További információ az állapotkódokról: Állapot- és hibakódok.
Válaszfejlécek
A művelet válasza 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 | Leírás |
|---|---|
Last-Modified |
A megosztás utolsó módosításának dátumát és időpontját adja vissza. A dátumformátum az RFC 1123-at követi. További információ: Date-Time Értékek megjelenítése fejlécekben. Minden olyan művelet, amely módosítja a megosztást vagy annak tulajdonságait, frissíti az utolsó módosítás időpontját. A fájlokon végzett műveletek nem befolyásolják a megosztás utolsó módosításának időpontját. |
x-ms-meta-name:value |
Név-érték párok készlete, amelyek a megosztás felhasználó által definiált metaadatait tartalmazzák. |
ETag |
Olyan értéket tartalmaz, amellyel feltételesen hajthat végre műveleteket. Az érték idézőjelek közé van zárva. |
x-ms-request-id |
Egyedileg azonosítja a kérést, amely a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása. |
x-ms-version |
A kérés végrehajtásához használt Azure Files-verzió. |
Date |
A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. |
x-ms-share-quota |
2015-02-21-es és újabb verzió. Az aktuális megosztási kvótát adja vissza gibibyte-ben (GiB). |
x-ms-share-provisioned-iops |
2019-07-07-es és újabb verzió. Csak prémium szintű fájlmegosztásokhoz (a FileStorage tárfióktípuson belüli fájlmegosztásokhoz) ad vissza. A prémium szintű megosztáshoz kiosztott bemeneti/kimeneti műveletek másodpercenkénti számát (IOPS) adja vissza. |
x-ms-share-provisioned-ingress-mbps |
2019-07-07-es és újabb verzió. Csak prémium szintű fájlmegosztásokhoz (a FileStorage tárfióktípuson belüli fájlmegosztásokhoz) ad vissza. A prémium megosztáshoz kiosztott mebibyte/s (MiB/s) bejövő forgalmat adja vissza. |
x-ms-share-provisioned-egress-mbps |
2019-07-07-es és újabb verzió. Csak prémium szintű fájlmegosztásokhoz (a FileStorage tárfióktípuson belüli fájlmegosztásokhoz) ad vissza. A mib/s kimenő forgalmat adja vissza a prémium részvényhez kiosztott módon. |
x-ms-share-provisioned-bandwidth-mibps |
2021-02-12-es és újabb verzió. Csak prémium szintű fájlmegosztásokhoz (a FileStorage tárfióktípuson belüli fájlmegosztásokhoz) ad vissza. A mib/s kombinált (bejövő és kimenő) sávszélességét adja vissza a prémium szintű megosztáshoz kiosztott módon. |
x-ms-share-next-allowed-quota-downgrade-time |
2019-07-07-es és újabb verzió. Csak prémium szintű fájlmegosztásokhoz (a FileStorage tárfióktípuson belüli fájlmegosztásokhoz) ad vissza. Dátum/idő érték, amely meghatározza, hogy a prémium szintű fájlmegosztás kvótája mikor csökkenthető. A dátumformátum az RFC 1123-at követi. |
x-ms-access-tier |
2019-12-12-es és újabb verzió. A megosztás aktuális hozzáférési szintjét adja vissza. A 2. verziójú (GPv2)-tárfiókok esetében a TransationOptimized a megosztás alapértelmezett szintje. A FileStorage storage-fióktípusokban Premium a megosztás alapértelmezett szintje. |
x-ms-access-tier-change-time |
2019-12-12-es és újabb verzió. Azt a dátumot és időpontot adja vissza, amikor a megosztás hozzáférési szintje utoljára módosult. |
x-ms-access-tier-transition-state |
2019-12-12-es és újabb verzió. Ha a megosztás szintváltáson megy keresztül, ez a fejléc azt a szintet jelzi, amelyről áttér. |
x-ms-lease-duration:<fixed,infinite> |
2020-02-10-es és újabb verzió. Megadja, hogy egy részvény bérlete végtelen vagy rögzített időtartamú-e. |
x-ms-lease-state: <available;leased;expired;breaking;broken> |
2020-02-10-es és újabb verzió. Ha egy megosztást bérletbe ad, ez a fejléc határozza meg a megosztás bérletállapotát. |
x-ms-lease-status: <locked;unlocked> |
2020-02-10-es és újabb verzió. Megosztás bérlete esetén ez a fejléc adja meg a megosztás bérletének állapotát. |
x-ms-enabled-protocols: <SMB;NFS> |
A 2019-07-07-es és újabb verzió aktuális megosztásbarát protokolljait adja vissza. - SMB: A megosztást az SMBv3.0, az SMBv2.1 és a REST érheti el.- NFS: A megosztást az NFSv4.1 érheti el. |
x-ms-root-squash: <NoRootSquash;RootSquash;AllSquash> |
A 2019-07-07-es és újabb verzió aktuális megosztásgyökér-összenyomási viselkedését adja vissza. Csak NFS. - NoRootSquash: A gyökér összenyomása ki van kapcsolva.- RootSquash: A UID/GID 0 kérései a névtelen UID/GID-re vannak leképezve.- AllSquash: A rendszer minden felhasználói azonosítót és GID-t leképez a névtelen felhasználóhoz.Ez az élőfej csak megosztásokhoz lesz visszaadva, pillanatképekhez nem. |
x-ms-enable-snapshot-virtual-directory-access: <true;false> |
2024-08-04-es és újabb verzió. Megadja, hogy a pillanatkép virtuális könyvtárának elérhetőnek kell-e lennie a megosztás csatlakoztatási pontjának gyökerénél, amikor az NFS engedélyezve van. Ez az élőfej csak megosztásokhoz lesz visszaadva, pillanatképekhez nem. |
x-ms-client-request-id |
A kérések és a megfelelő válaszok hibaelhárítására használható. Ennek az élőfejnek az é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. |
x-ms-share-paid-bursting-enabled: <true;false> |
2024-11-04-es és újabb verzió. Csak prémium szintű fájlmegosztásokhoz (a FileStorage tárfióktípuson belüli fájlmegosztásokhoz) ad vissza. Megadja, hogy engedélyezve van-e a fizetős kipukkadás. Ez az élőfej csak megosztásokhoz lesz visszaadva, pillanatképekhez nem. |
x-ms-share-paid-bursting-max-iops |
2024-11-04-es és újabb verzió. Csak prémium szintű fájlmegosztásokhoz ad vissza. A részvényre engedélyezett maximális fizetett IOPS-t adja eredményül. Csak akkor adja vissza, ha x-ms-share-paid-bursting-enabled igaz.Ez az élőfej csak megosztásokhoz lesz visszaadva, pillanatképekhez nem. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
2024-11-04-es és újabb verzió. Csak prémium szintű fájlmegosztásokhoz ad vissza. A részvényre engedélyezett maximálisan fizetett kipukkanó MiB/s értéket adja vissza. Csak akkor adja vissza, ha x-ms-share-paid-bursting-enabled igaz.Ez az élőfej csak megosztásokhoz lesz visszaadva, pillanatképekhez nem. |
Válasz törzse
Egyik sem.
Mintaválasz
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
x-ms-meta-name: some_metadata
Date: <date>
ETag: "0x8CB171DBEAD6A6B"
Last-Modified: <date>
x-ms-share-quota: 1024
x-ms-access-tier: Premium
x-ms-version: 2020-02-10
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Felhatalmazás
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
Egyik sem.