Path - Create
Fájl létrehozása | Címtár létrehozása | Fájl átnevezése | Címtár átnevezése
Fájl vagy könyvtár létrehozása vagy átnevezése. Alapértelmezés szerint a cél felülíródik, és ha a cél már létezik, és van egy bérlete, a bérlet megszakad. Vegye figyelembe, hogy egy fájl vagy könyvtár kényszerített tárolótitkosítási szabályzattal rendelkező tárolóba történő átnevezése csak akkor engedélyezett, ha a forrástárolóhoz egy olyan kényszerített tárolótitkosítási szabályzat is tartozik, amely megfelel. Ez a művelet támogatja a feltételes HTTP-kéréseket. További információ: Feltételes fejlécek megadása a Blob Service Operations. Ha a célhely már létezik, a "*" feltétellel rendelkező feltételes kéréssel meghiúsulhat.
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&timeout={timeout}
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
account
|
path | True |
string |
Az Azure Storage-fiók neve. |
dns
|
path | True |
string |
Az Azure Data Lake Storage-végpont DNS-utótagja. |
filesystem
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$ |
A fájlrendszer azonosítója. |
path
|
path | True |
string |
A fájl vagy könyvtár elérési útja. |
continuation
|
query |
string |
Szabadon választható. Címtár átnevezésekor az egyes hívásokkal átnevezett útvonalak száma korlátozott. Ha az átnevezni kívánt útvonalak száma meghaladja ezt a korlátot, a válaszfejléc egy folytatási jogkivonatot ad vissza. Ha egy folytatási jogkivonatot ad vissza a válaszban, azt az átnevezési művelet későbbi meghívásában kell megadni a címtár átnevezésének folytatásához. |
|
mode
|
query |
Szabadon választható. Csak akkor érvényes, ha a névtér engedélyezve van. Ez a paraméter határozza meg az átnevezési művelet viselkedését. Az értéknek "örökölt" vagy "posix" értékűnek kell lennie, az alapértelmezett érték pedig a "posix" lesz. |
||
resource
|
query |
Csak a Fájl létrehozása és a Címtár létrehozása esetén szükséges. Az értéknek "fájlnak" vagy "könyvtárnak" kell lennie. |
||
timeout
|
query |
integer (int32) minimum: 1 |
Nem kötelező művelet időtúllépési értéke másodpercben. Az időszak akkor kezdődik, amikor a kérést a szolgáltatás megkapja. Ha az időtúllépési érték a művelet befejeződése előtt eltelik, a művelet meghiúsul. |
Kérelem fejléce
Media Types: "application/octet-stream"
Name | Kötelező | Típus | Description |
---|---|---|---|
Cache-Control |
string |
Szabadon választható. A szolgáltatás tárolja ezt az értéket, és tartalmazza azt a "Fájl olvasása" műveletek "Fájl olvasása" művelet "Cache-Control" válaszfejlécében. |
|
Content-Encoding |
string |
Szabadon választható. Megadja, hogy mely tartalomkódolások lettek alkalmazva a fájlra. Ezt az értéket a rendszer a "Fájl olvasása" művelet végrehajtásakor adja vissza az ügyfélnek. |
|
Content-Language |
string |
Szabadon választható. Megadja a fájl célközönsége által használt természetes nyelvet. |
|
Content-Disposition |
string |
Szabadon választható. A szolgáltatás tárolja ezt az értéket, és belefoglalja a "Fájl olvasása" műveletek "Content-Disposition" válaszfejlécére. |
|
x-ms-cache-control |
string |
Szabadon választható. A szolgáltatás tárolja ezt az értéket, és a "Fájl olvasása" műveletek "Cache-Control" válaszfejlécében tárolja. |
|
x-ms-content-type |
string |
Szabadon választható. A szolgáltatás tárolja ezt az értéket, és tartalmazza a "Fájl olvasása" műveletek "Content-Type" válaszfejlécében. |
|
x-ms-content-encoding |
string |
Szabadon választható. A szolgáltatás tárolja ezt az értéket, és a "Fájl olvasása" műveletek "Content-Encoding" válaszfejlécében tárolja. |
|
x-ms-content-language |
string |
Szabadon választható. A szolgáltatás tárolja ezt az értéket, és tartalmazza a "Fájl olvasása" műveletek "Content-Language" válaszfejlécében. |
|
x-ms-content-disposition |
string |
Szabadon választható. A szolgáltatás tárolja ezt az értéket, és belefoglalja a "Fájl olvasása" műveletek "Content-Disposition" válaszfejlécére. |
|
x-ms-rename-source |
string |
Nem kötelező fájl vagy könyvtár átnevezése. Az értéknek a következő formátummal kell rendelkeznie: "/{filesystem}/{path}" vagy "/{filesystem}/{path}?sastoken" SAS-jogkivonat használatakor. Ha "x-ms-properties" van megadva, a tulajdonságok felülírják a meglévő tulajdonságokat; ellenkező esetben a meglévő tulajdonságok megmaradnak. Ennek az értéknek url-cím százalékban kódolt sztringnek kell lennie. Vegye figyelembe, hogy a sztring csak ASCII-karaktereket tartalmazhat az ISO-8859-1 karakterkészletben. |
|
x-ms-lease-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Szabadon választható. Az URI-ban megadott elérési út bérletazonosítója. A felülírandó elérési útnak aktív bérletet kell tartalmaznia, és a bérlet azonosítójának meg kell egyeznie. |
|
x-ms-source-lease-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Az átnevezési műveletek nem kötelezőek. A forrásútvonal bérletazonosítója. A forrásútvonalnak aktív bérletet kell tartalmaznia, és a bérlet azonosítójának meg kell egyeznie. |
|
x-ms-properties |
string |
Szabadon választható. A fájllal vagy könyvtárral tárolandó, felhasználó által definiált tulajdonságok az "n1=v1, n2=v2, ..."" név- és értékpárok vesszővel tagolt listájának formátumában, ahol minden érték egy base64 kódolású sztring. Vegye figyelembe, hogy a sztring csak ASCII-karaktereket tartalmazhat az ISO-8859-1 karakterkészletben. |
|
x-ms-permissions |
string |
Nem kötelező és csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz. POSIX-hozzáférési engedélyeket állít be a fájltulajdonos, a fájltulajdonosi csoport és mások számára. Minden osztály kaphat olvasási (4), írási (2) vagy végrehajtási (1) engedélyt. Mind a szimbolikus (rwxrw-rw-) és a négyjegyű oktális jelölés (pl. 0766) támogatott. A ragacsos bit is támogatott, és szimbolikus jelölésben t vagy T betű jelöli az utolsó karakterhelyen attól függően, hogy a többi kategória végrehajtási bitje be van-e állítva, vagy nincs-e megadva (például rwxrw-rw- ragacsos bittel rwxrw-rwT. A ragadós bittel rendelkező rwx rwx rwx rwx-rwt, a t vagy a T hiánya azt jelzi, hogy a ragadós bit nincs beállítva. A négyjegyű oktális jelölésben az 1. számjegy (például 1766 az rwxrw-rw- ragacsos bitet, a 0766 pedig az rwxrw-rw-t jelöli ragadós bit nélkül). Az x-ms-acl fájllal együtt érvénytelen. |
|
x-ms-umask |
string |
Nem kötelező és csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz. Ha fájlt vagy könyvtárat hoz létre, és a szülőmappa nem rendelkezik alapértelmezett ACL-sel, az umask korlátozza a létrehozandó fájl vagy könyvtár engedélyeit. Az eredményként kapott engedélyt p & ^u adja meg, ahol p az engedély, ön pedig az umaszk. Ha például p 0777, és ön 0057, akkor az eredményként kapott engedély 0720. Az alapértelmezett engedély egy könyvtárhoz 0777, a fájlhoz pedig a 0666. Az alapértelmezett umask a 0027. Az umaszkot négyjegyű oktális jelölésben kell megadni (pl. 0766). |
|
x-ms-owner |
string |
Nem kötelező és csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz. Beállítja a fájl vagy könyvtár tulajdonosát. |
|
x-ms-group |
string |
Nem kötelező és csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz. Beállítja a fájl vagy könyvtár tulajdonoscsoportját. |
|
x-ms-acl |
string |
Nem kötelező és csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz. A POSIX hozzáférés-vezérlési jogosultságainak beállítása fájlokon és könyvtárakon. Minden hozzáférés-vezérlési bejegyzés (ACE) egy hatókörből, típusból, felhasználó- vagy csoportazonosítóból és "[hatókör:][típus]:[id]:[engedélyek]" formátumú engedélyekből áll. A hatókörnek "alapértelmezettnek" kell lennie, hogy jelezze, hogy az ACE a címtár alapértelmezett ACL-éhez tartozik; ellenkező esetben a hatókör implicit, és az ACE a hozzáférési ACL-hez tartozik. Négy ACE-típus létezik: a "felhasználó" jogokat ad a tulajdonosnak vagy egy elnevezett felhasználónak, a "csoport" a tulajdonoscsoportnak vagy egy elnevezett csoportnak, a "maszk" korlátozza a megnevezett felhasználók és a csoportok tagjai számára biztosított jogokat, az "egyéb" pedig a többi bejegyzésben nem szereplő összes felhasználónak biztosít jogosultságokat. A felhasználó- vagy csoportazonosító nem szerepel a "maszk" és az "egyéb" típusú bejegyzéseknél. A tulajdonos és a tulajdonoscsoport felhasználó- vagy csoportazonosítója is hiányzik. Az engedélymező egy 3 karakterből álló sorozat, amelyben az első karakter "r" az olvasási hozzáférés biztosításához, a második karakter a "w" az írási hozzáférés megadásához, a harmadik karakter pedig az "x" a végrehajtási engedély megadásához. Ha a hozzáférés nincs megadva, a "-" karakter azt jelzi, hogy az engedély megtagadva van. A következő ACL például olvasási, írási és végrehajtási jogokat biztosít a fájltulajdonosnak és a john.doe@contoso, a tulajdonoscsoport olvasási jogának, és semmi másnak: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Az x-ms-engedélyekkel együtt érvénytelen. |
|
x-ms-proposed-lease-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Szabadon választható. Adjon meg egy javasolt bérletazonosítót, ha egy fájl vagy könyvtár létrehozása során szeretne bérletet szerezni. Ha a létrehozás sikeres, a rendszer ezzel a bérletazonosítóval szerez be egy bérletet. |
|
x-ms-expiry-option |
string |
Nem kötelező és csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz, és csak fájlokon támogatott. Adja meg az alábbi lejárati beállítások egyikét, ha a létrehozás során meg szeretné adni a fájl lejárati idejét. "RelativeToNow" Állítsa be a lejárati időt az aktuális időponthoz viszonyítva. A felhasználó átadja a mostantól eltelt ezredmásodpercek számát. "Abszolút" Abszolút idő RFC 1123 formátumban. "Neverexpire" Állítsa be a fájlt úgy, hogy soha ne járjon le, a lejárati időt nem kell megadni ezzel a beállítással. |
|
x-ms-expiry-time |
string |
Nem kötelező és csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz, és csak fájlokon támogatott. Adja meg a fájl lejárati idejét. RFC 1123 HTTP-idő sztringként vagy ezredmásodpercként megadva a lejárati beállításnak megfelelően. |
|
If-Match |
string |
Szabadon választható. ETag-érték. Adja meg ezt a fejlécet a művelet végrehajtásához, ha az erőforrás ETagje megegyezik a megadott értékkel. Az ETaget idézőjelekben kell megadni. |
|
If-None-Match |
string |
Szabadon választható. ETag-érték vagy speciális helyettesítő ("*") érték. Adja meg ezt a fejlécet, hogy csak akkor hajtsa végre a műveletet, ha az erőforrás ETagje nem felel meg a megadott értéknek. Az ETaget idézőjelekben kell megadni. |
|
If-Modified-Since |
string |
Szabadon választható. Dátum- és időérték. Adja meg ezt a fejlécet a művelet végrehajtásához, ha az erőforrás a megadott dátum és idő óta módosult. |
|
If-Unmodified-Since |
string |
Szabadon választható. Dátum- és időérték. Adja meg ezt a fejlécet a művelet végrehajtásához, ha az erőforrás nem lett módosítva a megadott dátum és idő óta. |
|
x-ms-source-if-match |
string |
Szabadon választható. ETag-érték. Adja meg ezt a fejlécet az átnevezési művelet végrehajtásához, ha a forrás ETagje megegyezik a megadott értékkel. Az ETaget idézőjelekben kell megadni. |
|
x-ms-source-if-none-match |
string |
Szabadon választható. ETag-érték vagy speciális helyettesítő ("*") érték. Adja meg ezt a fejlécet az átnevezési művelet végrehajtásához, ha a forrás ETagje nem felel meg a megadott értéknek. Az ETaget idézőjelekben kell megadni. |
|
x-ms-source-if-modified-since |
string |
Szabadon választható. Dátum- és időérték. Adja meg ezt a fejlécet az átnevezési művelet végrehajtásához, ha a forrás a megadott dátum és idő óta módosult. |
|
x-ms-source-if-unmodified-since |
string |
Szabadon választható. Dátum- és időérték. Adja meg ezt a fejlécet az átnevezési művelet végrehajtásához, ha a forrás nem lett módosítva a megadott dátum és idő óta. |
|
x-ms-encryption-key |
string |
Szabadon választható. A Base64 kódolású AES-256 titkosítási kulcs. |
|
x-ms-encryption-key-sha256 |
string |
Szabadon választható. A titkosítási kulcs Base64 kódolású SHA256 kivonata. |
|
x-ms-encryption-algorithm: AES256 |
string |
Szabadon választható. Megadja a titkosításhoz használni kívánt algoritmust. A fejléc értékének AES256-nak kell lennie. |
|
x-ms-encryption-context |
string |
Szabadon választható. Az alapértelmezett érték az "Üres". Ha az érték be van állítva, akkor a blob/ fájlrendszer metaadatait állítja be. Maximális hossz- 1024. Csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz. |
|
x-ms-client-transaction-id |
string |
Szabadon választható. Az alapértelmezett érték az "Üres". Ha az érték be van állítva, a blob metaadatait a fájl létrehozásakor vagy átnevezéskor állítja be. Ha a kérés túllépi az ügyfélre vonatkozó időtúllépést, ez az érték lekérhető a Tulajdonságok lekérése hívással annak ellenőrzésére, hogy az időtúllépési kérés sikeres volt-e vagy sem a szolgáltatás végén. Maximális hossz- 36. Csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz. |
|
x-ms-client-request-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Az elemzési naplókban rögzített UUID a hibaelhárításhoz és a korrelációhoz. |
|
x-ms-date |
string |
A kérelem koordinált egyetemes idejét (UTC) adja meg. Ez a megosztott kulcsok engedélyezéséhez szükséges. |
|
x-ms-version |
string |
A kérelem feldolgozásához használt REST protokoll verzióját adja meg. Ez a megosztott kulcsok engedélyezéséhez szükséges. |
Válaszok
Name | Típus | Description |
---|---|---|
201 Created |
A fájl vagy könyvtár létrejött. Fejlécek
|
|
Other Status Codes |
Hiba történt. A lehetséges HTTP-állapotok, kód- és üzenetsztringek az alábbiak:
Fejlécek
|
Definíciók
Name | Description |
---|---|
Data |
|
Error |
A szolgáltatáshiba-válasz objektum. |
Path |
Szabadon választható. Csak akkor érvényes, ha a névtér engedélyezve van. Ez a paraméter határozza meg az átnevezési művelet viselkedését. Az értéknek "örökölt" vagy "posix" értékűnek kell lennie, az alapértelmezett érték pedig a "posix" lesz. |
Path |
Csak a Fájl létrehozása és a Címtár létrehozása esetén szükséges. Az értéknek "fájlnak" vagy "könyvtárnak" kell lennie. |
DataLakeStorageError
Name | Típus | Description |
---|---|---|
error |
A szolgáltatáshiba-válasz objektum. |
Error
A szolgáltatáshiba-válasz objektum.
Name | Típus | Description |
---|---|---|
code |
string |
A szolgáltatás hibakódja. |
message |
string |
A szolgáltatás hibaüzenete. |
PathRenameMode
Szabadon választható. Csak akkor érvényes, ha a névtér engedélyezve van. Ez a paraméter határozza meg az átnevezési művelet viselkedését. Az értéknek "örökölt" vagy "posix" értékűnek kell lennie, az alapértelmezett érték pedig a "posix" lesz.
Érték | Description |
---|---|
legacy | |
posix |
PathResourceType
Csak a Fájl létrehozása és a Címtár létrehozása esetén szükséges. Az értéknek "fájlnak" vagy "könyvtárnak" kell lennie.
Érték | Description |
---|---|
directory | |
file |