Fájl létrehozása
A Create File
művelet létrehoz egy új fájlt, vagy lecserél egy fájlt. A híváskor Create File
csak a fájlt inicializálja. Ha tartalmat szeretne hozzáadni egy fájlhoz, hívja meg a Put Range
műveletet.
Protokoll rendelkezésre állása
Engedélyezett fájlmegosztási protokoll | Elérhető |
---|---|
SMB | |
NFS |
Kérés
A kérést Create File
az alábbi 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/mydirectorypath/myfile |
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ábbi táblázatban leírtak szerint:
Elérésiút-összetevő | Description |
---|---|
myaccount |
A tárfiók neve. |
myshare |
A fájlmegosztás neve. |
mydirectorypath |
Választható. Annak a könyvtárnak az elérési útja, ahol a fájlt létre szeretné hozni. Ha a könyvtár elérési útja nincs megadva, a fájl a megadott megosztáson belül jön létre. Ha a könyvtár meg van adva, a fájl létrehozása előtt már léteznie kell a megosztáson belül. |
myfile |
A létrehozandó fájl neve. |
Az elérésiút-elnevezési korlátozásokkal kapcsolatos információkért lásd: Név- és hivatkozásmegosztások, könyvtá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ó. 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 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ó: Az Azure Storage-szolgáltatások verziószámozása. |
Content-Length |
Választható. Ha jelen van, nulla értékűnek kell lennie. |
x-ms-content-length: byte value |
Kötelező. Ez a fejléc a fájl maximális méretét adja meg, legfeljebb 4 terabájtig (TiB). |
Content-Type vagy x-ms-content-type |
Választható. A fájl MIME-tartalomtípusa. Az alapértelmezett típus a .application/octet-stream |
Content-Encoding vagy x-ms-content-encoding |
Választható. Meghatározza, hogy mely tartalomkódolások lettek alkalmazva a fájlra. Ez az érték akkor lesz visszaadva az ügyfélnek, ha a Fájl lekérése műveletet hajtja végre a fájlerőforráson, és a használatával dekódolhatja a fájl tartalmát. |
Content-Language vagy x-ms-content-language |
Választható. Meghatározza az erőforrás által használt természetes nyelveket. |
Cache-Control vagy x-ms-cache-control |
Választható. Azure Files tárolja ezt az értéket, de nem használja vagy módosítja. |
x-ms-content-md5 |
Választható. Beállítja a fájl MD5 kivonatát. |
x-ms-content-disposition |
Választható. Beállítja a fájl fejlécét Content-Disposition . |
x-ms-type: file |
Kötelező. Állítsa ezt a fejlécet a következőre: file . |
x-ms-meta-name:value |
Választható. A fájlhoz metaadatként társított név-érték párok. A metaadatok nevének meg kell felelnie a C#-azonosítók elnevezési szabályainak. Megjegyzés: A Azure Files által megadott fájl metaadatai nem érhetők el kiszolgálói üzenetblokkoló (SMB) ügyfélprogramból. |
x-ms-file-permission: { inherit ¦ <SDDL> } |
A 2019-02-02-2021-04-10 verzióban ez a fejléc szükséges, ha x-ms-file-permission-key nincs megadva. A 2021-06-08-as verziótól mindkét fejléc nem kötelező. Ez az engedély a biztonsági leíró definíciós nyelvében (SDDL) megadott fájl biztonsági leírója. Ezt a fejlécet akkor használhatja, ha az engedélyek mérete 8 kibibájt (KiB) vagy annál kisebb. Ellenkező esetben használhatja a következőt x-ms-file-permission-key : . Ha megadja a fejlécet, tulajdonosi, csoport - és diszkréciós hozzáférés-vezérlési listával (DACL) kell rendelkeznie. A szülőkönyvtárból örökölhető értéket inherit adhat át. |
x-ms-file-permission-key: <PermissionKey> |
A 2019-02-02-2021-04-10 verzióban ez a fejléc szükséges, ha x-ms-file-permission nincs megadva. A 2021-06-08-as verziótól mindkét fejléc nem kötelező. Ha egyik fejléc sincs megadva, a rendszer az alapértelmezett értéket inherit használja a x-ms-file-permission fejléchez.A kulcsot az API meghívásával Create Permission hozhatja létre. |
x-ms-file-attributes |
Kötelező: 2019-02-02-2021-04-10-es verzió. Nem kötelező: 2021-06-08-es és újabb verzió. Ez a fejléc tartalmazza a fájlon beállítani kívánt fájlrendszerattribútumokat. További információt az elérhető attribútumok listájában talál. Az alapértelmezett érték None . |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Kötelező: 2019-02-02-2021-04-10-es verzió. Nem kötelező: 2021-06-08-es és újabb verzió. A fájl koordinált univerzális idő (UTC) létrehozási ideje tulajdonsága. A kérelem időpontjának jelzésére egy érték now használható. Az alapértelmezett érték now . |
x-ms-file-last-write-time: { now ¦ <DateTime> } |
Kötelező: 2019-02-02-2021-04-10-es verzió. Nem kötelező: 2021-06-08-es és újabb verzió. A fájl utolsó írási tulajdonsága a koordinált egyetemes idő (UTC). A kérés időpontját egy érték now használatával jelezheti. Az alapértelmezett érték now . |
x-ms-lease-id: <ID> |
Akkor szükséges, ha a fájl aktív bérletet kapott. A 2019-02-02-es és újabb verzióhoz érhető el. |
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. |
x-ms-file-change-time: { now ¦ <DateTime> } |
Választható. 2021-06-08-es és újabb verzió. Az egyezményes világidő (UTC) módosítja a fájl időtulajdonságát ISO 8601 formátumban. A kérés időpontját egy érték now használatával jelezheti. Az alapértelmezett érték now . |
x-ms-file-request-intent |
Kötelező, ha Authorization a fejléc OAuth-jogkivonatot ad meg. Elfogadható érték: backup . Ez a fejléc azt határozza meg, hogy a Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action vagy Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action meg kell adni, ha szerepelnek a fejléc használatával Authorization engedélyezett identitáshoz rendelt RBAC-szabályzatban. A 2022-11-02-es és újabb verziókhoz érhető el. |
x-ms-allow-trailing-dot: { <Boolean> } |
Választható. 2022-11-02-es és újabb verzió. A logikai érték azt határozza meg, hogy a kérelem URL-címében található záró pont legyen-e levágva vagy sem. További információ: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása. |
A kérés törzse
Nincsenek.
Mintakérés
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/myfile HTTP/1.1
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: Mon, 27 Jan 2014 22:41:55 GMT
Content-Type: text/plain; charset=UTF-8
x-ms-content-length: 1024
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=
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.
Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.
Válaszfejlécek
A műveletre adott válasz tartalmazza az alábbi táblázatban ismertetett fejléceket. 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 |
Az ETag egy olyan értéket tartalmaz, amely a fájl verzióját jelöli. Az érték idézőjelek közé kerül. |
Last-Modified |
A fájl 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 könyvtárat vagy annak tulajdonságait, az utolsó módosítás időpontját frissíti. A fájlokon végzett műveletek nem befolyásolják a címtár utolsó módosításának időpontját. |
x-ms-request-id |
Egyedileg azonosítja a végrehajtott kérést, és 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ó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-request-server-encrypted: true/false |
2017-04-17-es és újabb verzió. Ennek a fejlécnek az értéke akkor van beállítva true , ha sikeresen titkosította a kérés tartalmát a megadott algoritmus használatával. Ha a titkosítás sikertelen, az érték .false |
x-ms-file-permission-key |
A fájl engedélyének kulcsa. |
x-ms-file-attributes |
A fájl fájlrendszerattribútumai. További információt az elérhető attribútumok listájában talál. |
x-ms-file-creation-time |
A fájl létrehozási idő tulajdonságát képviselő UTC dátum/idő érték. |
x-ms-file-last-write-time |
Az UTC dátum/idő értéke, amely a fájl utolsó írási idejének tulajdonságát jelöli. |
x-ms-file-change-time |
A fájl változási idő tulajdonságát képviselő UTC dátum/idő. |
x-ms-file-file-id |
A fájl fájlazonosítója. |
x-ms-file-parent-id |
A fájl szülőfájl-azonosítója. |
x-ms-client-request-id |
A kérések és a hozzájuk tartozó válaszok hibaelhárítására szolgál. 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, akkor nem jelenik meg a válaszban. |
Választörzs
Nincsenek.
Mintaválasz
Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Date: Mon, 27 Jan 2014 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT
x-ms-version: 2014-02-14
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Fájlrendszerattribútumok
Attribútum | Win32 fájlattribútum | Definíció |
---|---|---|
ReadOnly | FILE_ATTRIBUTE_READONLY | Egy írásvédett fájl. Az alkalmazások beolvashatják a fájlt, de nem tudnak írni vagy törölni. |
Rejtett | FILE_ATTRIBUTE_HIDDEN | A fájl rejtett. Ez nem szerepel egy szokásos könyvtárlistán. |
Rendszer | FILE_ATTRIBUTE_SYSTEM | Olyan fájl, amelyet az operációs rendszer részben vagy kizárólag használ. |
None | FILE_ATTRIBUTE_NORMAL | Olyan fájl, amely nem rendelkezik más attribútumokkal. Ez az attribútum csak akkor érvényes, ha egyedül használja. |
Archívum | FILE_ATTRIBUTE_ARCHIVE | Egy archív fájl. Az alkalmazások általában ezt az attribútumot használják a fájlok biztonsági mentéshez vagy eltávolításhoz való megjelöléséhez. |
Ideiglenes | FILE_ATTRIBUTE_TEMPORARY | Ideiglenes tároláshoz használt fájl. |
Offline | FILE_ATTRIBUTE_OFFLINE | Egy fájl adatai nem érhetők el azonnal. Ez a fájlrendszerattribútum elsősorban a Windowssal való kompatibilitás érdekében jelenik meg. Azure Files nem támogatja az offline tárolási lehetőségekkel. |
NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | A fájlt nem kell indexelnie a tartalomindexelő szolgáltatásnak. |
NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | A felhasználói adatfolyam, amelyet a háttéradat-integritás-ellenőrző nem olvas be. Ez a fájlrendszerattribútum elsősorban a Windowssal való kompatibilitás érdekében jelenik meg. |
Megjegyzések
Új fájl létrehozásához először inicializálja azt a hívással Create File
, majd adja meg a maximális méretét, legfeljebb 4 TiB-ot. A művelet végrehajtásakor ne tartalmazzon tartalmat a kérelem törzsében. Miután létrehozta a fájlt, hívja Put Range
meg, hogy adjon hozzá tartalmat a fájlhoz, vagy módosítsa.
A fájl méretét a meghívásával Set File Properties
módosíthatja.
Ha a megosztás vagy a szülőkönyvtár nem létezik, akkor a művelet a 412-s állapotkóddal hiúsul meg (az előfeltétel sikertelen).
Megjegyzés
A , content-type
, content-md5
, content-encoding
és content-language
fájltulajdonságok cache-control
elkülönülnek az SMB-ügyfelek számára elérhető fájlrendszer-tulajdonságoktól. Az SMB-ügyfelek nem tudják olvasni, írni vagy módosítani ezeket a tulajdonságértékeket.
A fájl létrehozásához, ha a meglévő fájl rendelkezik aktív bérletmel, az ügyfélnek érvényes bérletazonosítót kell megadnia a kérelemben. Ha az ügyfél nem ad meg bérletazonosítót, vagy érvénytelen bérletazonosítót ad meg, Azure Files a 412-ös állapotkódot adja vissza (az előfeltétel sikertelen). Ha az ügyfél bérletazonosítót ad meg, de a fájlnak nincs aktív bérlete, Azure Files ebben a példányban is visszaadja a 412-s állapotkódot (az előfeltétel sikertelen). Ha az ügyfél olyan fájl bérletazonosítóját adja meg, amely még nem létezik, Azure Files a 412-es állapotkódot adja vissza (az előfeltétel sikertelen) a 2019-02-02-es és újabb verziójú kérelmekhez.
Ha egy aktív bérlettel rendelkező meglévő fájlt felülír egy Create File
művelet, a bérlet a frissített fájlon marad, amíg ki nem adja.
Create File
A megosztás pillanatképe nem támogatott, amely egy megosztás írásvédett példánya. A művelet megosztási pillanatképen való végrehajtására tett kísérlet a 400-as állapotkóddal (InvalidQueryParameterValue) meghiúsul.