Pillanatkép-megosztás
A 2017-04-17-es verziótól kezdve a Snapshot Share
művelet egy megosztás írásvédett pillanatképét hozza létre.
Protokoll rendelkezésre állása
Engedélyezett fájlmegosztási protokoll | Elérhető | Állapot |
---|---|---|
SMB | FE | |
NFS | FE |
Kérés
A kérést az Snapshot Share
alábbiak szerint hozhatja létre. A HTTPS használata ajánlott.
Metódus | Kérés URI-ja | HTTP-verzió |
---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot |
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ő | Description |
---|---|
myaccount |
A tárfiók neve. |
myshare |
A fájlmegosztás neve. |
Az elérési utak elnevezési korlátozásával kapcsolatos részletekért lásd: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása.
URI-paraméterek
A kérelem URI-ján a következő további paramétert adhatja meg.
Paraméter | Leírás |
---|---|
timeout |
Választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Azure Files 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 fióknevet é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ő. A kérelem egyezményes világidő (UTC) idejét adja meg. 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. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-meta-name:value |
Választható. Megadja a megosztási pillanatképhez társított, felhasználó által definiált név-érték párot. Ha nem ad meg név-érték párokat, a művelet az alapmegosztás metaadatait a pillanatképbe másolja. Ha egy vagy több név-érték párt ad meg, a megosztási pillanatkép a megadott metaadatokkal jön létre. Ebben az esetben a metaadatok nem lesznek átmásolva az alapmegosztásból. A metaadatok nevének meg kell felelnie a C#-azonosítók elnevezési szabályainak. |
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 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ó: Azure Blob Storage figyelése. |
A kérés törzse
Nincsenek.
Mintakérés
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot HTTP/1.1
Request Headers:
x-ms-version: 2017-04-17
x-ms-date: Mon, 10 May 2017 22:50:32 GMT
x-ms-meta-Name: StorageSample
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Reagálás
A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.
Állapotkód
A sikeres művelet a 201-et (Létrehozva) állapotkódot adja vissza. Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.
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 |
---|---|
ETag |
A megosztási pillanatkép verzióját idézőjelek között ábrázoló értéket tartalmaz. A megosztási pillanatképek nem módosíthatók, így egy ETag adott megosztási pillanatkép soha nem változik. Ha azonban új metaadatokat adott meg a Snapshot Share kéréshez, akkor a ETag megosztás pillanatképe eltér az alapmegosztásétól. Ha nem adott meg metaadatokat a kéréssel, a ETag megosztás pillanatképe megegyezik az alapmegosztás pillanatképével a megosztás pillanatképének készítésekor. |
Last-Modified |
A megosztás utolsó módosításának dátumát és időpontját adja vissza. További információ: Dátum-idő értékek ábrázolása fejlécekben. A megosztási pillanatképek nem módosíthatók, így egy adott megosztás pillanatképének utolsó módosítási időpontja soha nem változik. Ha azonban új metaadatokat adott meg a Snapshot Share kéréshez, akkor a megosztás pillanatképének utolsó módosítási időpontja eltér az alapmegosztásétól. Ha nem adott meg metaadatokat a kéréshez, a megosztás pillanatképének utolsó módosítási időpontja megegyezik az alapmegosztáséval a megosztás pillanatképének készítésekor. |
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 futtatásához használt Azure Files verzióját jelzi. |
Date vagy x-ms-date |
UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. Ezt az értéket a szolgáltatás hozza létre. |
x-ms-snapshot |
Egy DateTime érték, amely egyedileg azonosítja a megosztási pillanatképet. Ennek a fejlécnek az értékét a későbbi kérésekben használhatja a megosztási pillanatkép eléréséhez. Ez az érték nem átlátszó. |
x-ms-client-request-id |
A kérések és a megfelelő válaszok hibaelhárítására használható. Ennek a fejlécnek az értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben. Az érték legfeljebb 1024 látható ASCII-karakter lehet. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor az nem jelenik meg a válaszban. |
Választörzs
Nincsenek.
Mintaválasz
Response Status:
HTTP/1.1 201 Created
Response Headers:
Content-Length: 0
Date: Mon, 10 May 2017 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 10 May 2017 23:00:06 GMT
x-ms-version: 2017-04-17
x-ms-snapshot: 2017-05-10T17:52:33.9551861Z
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
A megosztási pillanatképek a megosztások írásvédett verzióit biztosítják. Miután létrehozott egy megosztási pillanatképet, nem módosíthatja azt. A megosztási pillanatképek kényelmes módot biztosítanak a megosztáson lévő összes fájl egységes biztonsági mentésének létrehozására.
Minden alkalommal, amikor meghívja a Snapshot Share
műveletet, létrejön egy új megosztási pillanatkép, amely egyedi DateTime
értékkel azonosítja a megosztás pillanatképét az alapmegosztáshoz képest. Ezzel az DateTime
értékkel további műveleteket hajthat végre a megosztási pillanatképen és annak tartalmán. Ezt az DateTime
értéket átlátszatlanként kell kezelnie.
Az DateTime
érték azonosítja a megosztási pillanatképet a kérelem URI-ján. Az alapmegosztáson és a pillanatképeken található fájlok például az alábbi példákhoz hasonló URI-kkal rendelkeznek:
- Fájl a megosztáson:
http://myaccount.file.core.windows.net/myshare/myfile
- Fájl a megosztás pillanatképén:
http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>
A megosztások 200 megosztási pillanatkép létrehozását támogatják. Ha több mint 200 megosztási pillanatképet próbál létrehozni, a szolgáltatás a 409-ben megadott hibakódot (Ütközés) adja vissza. Ha megosztási pillanatképet próbál létrehozni, miközben egy korábbi Snapshot Share
művelet folyamatban van, a szolgáltatás a 409-s hibakódot (Ütközés) is visszaadja.
A meglévő megosztási pillanatképek soha nem lesznek felülírva. Ezeket explicit módon kell törölni. A megosztási pillanatképek explicit törléséhez hívja meg a Megosztás törlése parancsot, és állítsa a x-ms-include-snapshots
fejlécet a sharesnapshot
lekérdezési paraméterrel együtt a megfelelő értékre.