Megosztás létrehozása

A Create Share művelet létrehoz egy új Azure Files megosztást a megadott fiók alatt. Bár ez az API teljes mértékben támogatott, ez egy örökölt felügyeleti API. Javasoljuk, hogy ehelyett használja a Fájlmegosztások – Létrehozás lehetőséget, amelyet az Azure Storage erőforrás-szolgáltató (Microsoft.Storage) biztosít. Ha többet szeretne megtudni arról, hogyan használhatja FileShare programozott módon az erőforrásokat az Azure Storage-erőforrás-szolgáltató használatával, tekintse meg a FileShares-műveletek című témakört.

Ha már létezik ugyanazzal a névvel rendelkező megosztás, a művelet sikertelen lesz. A megosztási erőforrás az adott megosztás metaadatait és tulajdonságait tartalmazza. Nem tartalmazza a megosztásban található fájlok listáját.

Protokoll rendelkezésre állása

Engedélyezett fájlmegosztási protokoll	Elérhető
Kiszolgálói üzenetblokk (SMB)
Hálózati fájlrendszer (NFS)

Kérés

A kérést az Create Share itt látható módon hozhatja létre. Javasoljuk, hogy HTTPS-t használjon.

Metódus	Kérés URI-ja	HTTP-verzió
PUT	https://myaccount.file.core.windows.net/myshare?restype=share	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. A név csak kisbetűket tartalmazhat.

Az elérésiút-elnevezési korlátozásokkal kapcsolatos további információkért lásd: Név- és hivatkozásmegosztások, címtárak, fájlok és metaadatok.

URI-paraméterek

A kérelem URI-ján a következő további paramétereket adhatja meg:

Paraméter	Leírás
timeout	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 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 fióknevet és az aláírást. További információ: Kérések engedélyezése az Azure Storage-ba.
Date vagy x-ms-date	Kötelező. A kérelem koordinált egyetemes idő (UTC) idejét adja meg. 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. További információ: Verziószámozás az Azure Storage-szolgáltatásokhoz.
x-ms-meta-name:value	Választható. Egy név-érték pár, amely metaadatként társítja a megosztást. A metaadatok nevének meg kell felelnie a C#-azonosítók elnevezési szabályainak.
x-ms-share-quota	Választható. A 2015-02-21-es és újabb verziókban támogatott. A megosztás maximális méretét adja meg gibibájtban (GiB).
x-ms-access-tier	Választható. A 2019-12-12-es és újabb verziókban támogatott. Meghatározza a megosztás hozzáférési szintjét. Az érvényes értékek a következők: TransactionOptimized, Hotés Cool. A fájlmegosztási szintekkel kapcsolatos részletes információkért lásd: Azure Files tárolási szintek.
x-ms-enabled-protocols: <SMB \| NFS>	Választható. A 2019-07-07-es és újabb verziókban támogatott. Megadja a megosztáson engedélyezett protokollokat. Ha nincsenek megadva, az alapértelmezett érték az SMB. - SMB: A megosztást az SMBv3.0, az SMBv2.1 és a REST érheti el. - NFS: A megosztást az NFSv4.1 érheti el. Ehhez a beállításhoz prémium fiók szükséges.
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash>	Választható. Csak NFS. A 2019-07-07-es és újabb verziókban támogatott. Az NFS engedélyezésekor megadja a megosztás gyökérszintű összecsukási viselkedését. Ha nincs megadva, az alapértelmezett érték a NoRootSquash. - NoRootSquash: Kapcsolja ki a gyökérpréselést. - RootSquash: Az uid/gid 0 kéréseinek leképezése a névtelen uid/gid azonosítóra. - AllSquash: Az összes uid és gid leképezése a névtelen felhasználóhoz.
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 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

Nincsenek.

Mintakérés

PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10  
x-ms-date: <date>  
x-ms-meta-Name: StorageSample  
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=  

Reagálás

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

Állapotkód

A sikeres művelet a 201-ben létrehozott állapotkódot adja vissza.

További információ: Á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ás verzióját idézőjelek közé zárt érték tartalmazza.
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ó: Dátum-/időértékek ábrázolása fejlécekben. Minden olyan művelet, amely módosítja a megosztást, illetve annak tulajdonságait vagy metaadatait, frissíti az utolsó módosítás időpontját. A fájlokon végzett műveletek nincsenek hatással a megosztás utolsó módosításának időpontjára.
x-ms-request-id	Egyedileg azonosítja a kérést, és segítségével elháríthatja a kérést. 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ót jelzi.
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-client-request-id	A kérések és a megfelelő 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

Nincsenek.

Mintaválasz

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: <date>  
ETag: "0x8CB14C3E29B7E82"  
Last-Modified: <date>  
x-ms-version: 2020-02-10  
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ások azonnal létrejönnek a tárfiókon belül. Az egyik megosztást nem lehet egymásba ágyazni.

A megosztások metaadatait létrehozhatja úgy, hogy egy vagy több metaadatfejlécet is beszed a kérelembe. A metaadat-fejléc formátuma a következő x-ms-meta-name:value: .

Ha egy azonos nevű megosztást töröl a híváskor Create Share, a kiszolgáló a 409 -os állapotkódot (Ütközés) adja vissza, és további hibainformációk azt jelzik, hogy a megosztás törölve van.

A megosztás méretkvótája segítségével korlátozhatja a megosztáson tárolt fájlok méretét. A kvóta nem korlátozza a pillanatképek méretét. A fájlokhoz társított és a tárfiók számlázási méretének kiszámításához használt többletterhelés nem szerepel a kvótában.

Ha a megosztáson lévő fájlok méretének összege meghaladja a megosztáson beállított kvótát, a fájl méretének növelésére tett kísérletek sikertelenek lesznek, és az új nem üres fájlok (REST-en keresztüli) létrehozása sikertelen lesz. Továbbra is létrehozhat üres fájlokat.

A kvóta módosítása vagy beállítása nincs hatással a számlázásra. Továbbra is a fájlok méretéért és a többletterhelésért kell fizetnie.

Lásd még

Műveletek Azure Files megosztásokon