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 bérlete, a bérlet megszakadt. Vegye figyelembe, hogy egy fájl vagy könyvtár kényszerített tárolótitkosítási szabályzattal rendelkező tárolóba való átnevezése nem engedélyezett, kivéve, ha a forrástároló rendelkezik egy olyan kényszerített tárolótitkosítási szabályzattal is, 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 Blob Service-műveletekhez. Ha a célhely már létezik, a sikertelenséghez használjon feltételes kérést a "*" if-None-Match paranccsal.
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 |
A Azure Data Lake Storage végpont DNS-utótagja. |
filesystem
|
path | True |
string |
A fájlrendszer azonosítója. Regex pattern: |
path
|
path | True |
string |
A fájl vagy könyvtár elérési útja. |
continuation
|
query |
string |
Választható. Címtár átnevezésekor az egyes hívásokkal átnevezett elérési utak száma korlátozott. Ha az átnevezendő elérési utak száma meghaladja ezt a korlátot, a rendszer egy folytatási jogkivonatot ad vissza ebben a válaszfejlécben. 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 |
Választható. Csak akkor érvényes, ha engedélyezve van a névtér. 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". |
||
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 |
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 |
Választható. A szolgáltatás tárolja ezt az értéket, és a "Fájl olvasása" műveletek "Fájl olvasása" művelet "Fájl olvasása" művelet "Gyorsítótár-vezérlés" válaszfejlécében tartalmazza. |
|
Content-Encoding |
string |
Választható. Meghatározza, 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 |
Választható. Meghatározza a fájl célközönsége által használt természetes nyelvet. |
|
Content-Disposition |
string |
Választható. A szolgáltatás tárolja ezt az értéket, és tartalmazza azt a "Fájl olvasása" műveletek "Content-Disposition" válaszfejlécében. |
|
x-ms-cache-control |
string |
Választható. A szolgáltatás tárolja ezt az értéket, és a "Fájl olvasása" műveletek "Gyorsítótár-vezérlés" válaszfejlécében tárolja. |
|
x-ms-content-type |
string |
Választható. A szolgáltatás tárolja ezt az értéket, és tartalmazza azt a "Fájl olvasása" műveletek "Content-Type" válaszfejlécében. |
|
x-ms-content-encoding |
string |
Választható. A szolgáltatás tárolja ezt az értéket, és tartalmazza azt a "Fájl olvasása" műveletek "Content-Encoding" válaszfejlécében. |
|
x-ms-content-language |
string |
Választható. A szolgáltatás tárolja ezt az értéket, és tartalmazza azt a "Fájl olvasása" műveletek "Content-Language" válaszfejlécében. |
|
x-ms-content-disposition |
string |
Választható. A szolgáltatás tárolja ezt az értéket, és tartalmazza azt a "Fájl olvasása" műveletek "Content-Disposition" válaszfejlécében. |
|
x-ms-rename-source |
string |
Egy nem kötelezően átnevezendő fájl vagy könyvtár. SAS-jogkivonat használatakor az értéknek a következő formátummal kell rendelkeznie: "/{filesystem}/{path}", vagy "/{filesystem}/{path}?sastoken". 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 egy 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 |
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érletnek kell lennie, és a bérletazonosítónak meg kell egyeznie. Regex pattern: |
|
x-ms-source-lease-id |
string |
Az átnevezési műveletek nem kötelezőek. A forrásútvonal bérletazonosítója. A forrásútvonalnak aktív bérletnek kell lennie, és a bérletazonosítónak meg kell egyeznie. Regex pattern: |
|
x-ms-properties |
string |
Választható. A fájllal vagy könyvtárral együtt 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. BEÁLLÍTJA a POSIX hozzáférési engedélyeit a fájl tulajdonosának, a fájltulajdonos csoportnak és másoknak. Minden osztály kaphat olvasási (4), írási (2) vagy végrehajtási (1) engedélyt. A szimbolikus (rwxrw-rw-) és a négyjegyű oktális jelölés (pl. 0766) egyaránt támogatott. A ragadós bit is támogatott, és szimbolikus jelöléssel is rendelkezik, amelyet a t betű vagy a T betű jelöl a végső karakterhelyen attól függően, hogy a többi kategória végrehajtási bitje be van állítva vagy nincs megadva (pl. rwxrw-rw- a cetrbittel rwxrw-rwT. A ragadós bittel rendelkező rwxrw-rwx rwt rwxrw-rwt), a t vagy a T hiánya azt jelzi, hogy a ragadós bit nincs beállítva. A 4 jegyű oktális jelölésben az 1. számjegyet jelöli (például az 1766 az rwxrw-rw-t jelöli ragadós bittel, a 0766 pedig az rwxrw-rw-t, 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 így kapott engedélyt a p & ^u adja meg, ahol p az engedély, ön pedig az umask. 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 a 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. Beállítja a POSIX hozzáférés-vezérlési jogosultságokat a fájlokon és könyvtárakon. Minden hozzáférés-vezérlési bejegyzés (ACE) egy hatókörből, egy típusból, egy felhasználó- vagy csoportazonosítóból és "[scope:][type]:[id]:[permissions]" 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-jéhez tartozik; ellenkező esetben a hatókör implicit, az ACE pedig a hozzáférési ACL-hez tartozik. Négy ACE-típus létezik: a "felhasználó" jogokat ad a tulajdonosnak vagy egy megnevezett felhasználónak, a "csoport" a tulajdonoscsoportnak vagy egy megnevezett csoportnak biztosít jogosultságokat, a "maszk" a megnevezett felhasználók és a csoportok tagjai számára biztosított jogokat korlátozza, az "egyéb" pedig a többi bejegyzésben nem szereplő összes felhasználónak biztosít jogosultságokat. A "maszk" és az "egyéb" típusú bejegyzéseknél a felhasználó vagy csoport azonosítója nincs megadva. A felhasználó vagy csoport azonosítóját a tulajdonos és a tulajdonos csoport sem adja meg. Az engedélymező egy 3 karakterből álló sorozat, amelyben az első karakter az "r" az olvasási hozzáférés megadá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 ad a fájl tulajdonosának és john.doe@contoso, az olvasási jogot a tulajdonoscsoportnak, és semmi mást: "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 |
Választható. Adjon meg egy javasolt bérletazonosítót, ha egy fájl vagy könyvtár létrehozásakor szeretne bérletet beszerezni. Ha a létrehozás sikeres, a rendszer ezzel a bérletazonosítóval szerez be egy bérletet. Regex pattern: |
|
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 egy fájl lejárati idejét szeretné beállítani. "RelativeToNow" Állítsa be a lejáratot az aktuális időponthoz képest. A felhasználó a mostantól eltelt ezredmásodpercek számát fogja megadni. "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 adva a lejárati beállításnak megfelelően. |
|
If-Match |
string |
Választható. ETag-érték. Ezt a fejlécet csak akkor adja meg 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 |
Választható. ETag-érték vagy speciális helyettesítő ("*") érték. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás ETagje nem egyezik meg a megadott értékkel. Az ETaget idézőjelekben kell megadni. |
|
If-Modified-Since |
string |
Választható. Dátum- és időérték. Ezt a fejlécet csak akkor adja meg 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 |
Választható. Dátum- és időérték. Ezt a fejlécet csak akkor adja meg 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 |
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 |
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 egyezik meg a megadott értékkel. Az ETaget idézőjelekben kell megadni. |
|
x-ms-source-if-modified-since |
string |
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őpont óta módosult. |
|
x-ms-source-if-unmodified-since |
string |
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 |
Választható. A Base64 kódolású AES-256 titkosítási kulcs. |
|
x-ms-encryption-key-sha256 |
string |
Választható. A titkosítási kulcs Base64 kódolású SHA256 kivonata. |
|
x-ms-encryption-algorithm: AES256 |
string |
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 |
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-request-id |
string |
A hibaelhárítás és a korreláció elemzési naplóiban rögzített UUID. Regex pattern: |
|
x-ms-date |
string |
Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. Ez megosztott kulcs engedélyezése esetén szükséges. |
|
x-ms-version |
string |
A kérelem feldolgozásához használt REST protokoll verzióját adja meg. Ez megosztott kulcs engedélyezése esetén szükséges. |
Válaszok
Name | Típus | Description |
---|---|---|
201 Created |
A fájl vagy könyvtár létrejött. Headers
|
|
Other Status Codes |
Hiba történt. A lehetséges HTTP-állapotok, kód- és üzenetsztringek az alábbiak:
Headers
|
Definíciók
Name | Description |
---|---|
Data |
|
Error |
A szolgáltatáshiba-válasz objektuma. |
Path |
Választható. Csak akkor érvényes, ha engedélyezve van a névtér. 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". |
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 objektuma. |
Error
A szolgáltatáshiba-válasz objektuma.
Name | Típus | Description |
---|---|---|
code |
string |
A szolgáltatás hibakódja. |
message |
string |
A szolgáltatás hibaüzenete. |
PathRenameMode
Választható. Csak akkor érvényes, ha engedélyezve van a névtér. 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".
Name | Típus | Description |
---|---|---|
legacy |
string |
|
posix |
string |
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.
Name | Típus | Description |
---|---|---|
directory |
string |
|
file |
string |