Path - Create
Buat File | Buat Direktori | Ganti Nama File | Ganti Nama Direktori
Membuat atau mengganti nama file atau direktori. Secara default, tujuan ditimpa dan jika tujuan sudah ada dan sewa sewa rusak. Harap dicatat bahwa mengganti nama file atau direktori menjadi kontainer dengan kebijakan enkripsi kontainer yang diberlakukan tidak diizinkan kecuali kontainer sumber juga memiliki kebijakan enkripsi kontainer yang diberlakukan yang cocok. Operasi ini mendukung permintaan HTTP kondisional. Untuk informasi selengkapnya, lihat Menentukan Header Kondisional untuk Operasi Blob Service. Untuk gagal jika tujuan sudah ada, gunakan permintaan kondisional dengan If-None-Match: "*".
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&timeout={timeout}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
account
|
path | True |
string |
Nama akun Azure Storage. |
dns
|
path | True |
string |
Akhiran DNS untuk titik akhir Azure Data Lake Storage. |
filesystem
|
path | True |
string |
Pengidentifikasi sistem file. Pola regex: |
path
|
path | True |
string |
Jalur file atau direktori. |
continuation
|
query |
string |
Pilihan. Saat mengganti nama direktori, jumlah jalur yang diganti namanya dengan setiap pemanggilan dibatasi. Jika jumlah jalur yang akan diganti namanya melebihi batas ini, token kelanjutan dikembalikan di header respons ini. Ketika token kelanjutan dikembalikan dalam respons, token tersebut harus ditentukan dalam pemanggilan operasi ganti nama berikutnya untuk terus mengganti nama direktori. |
|
mode
|
query |
Pilihan. Hanya berlaku saat namespace diaktifkan. Parameter ini menentukan perilaku operasi ganti nama. Nilainya harus "warisan" atau "posix", dan nilai defaultnya adalah "posix". |
||
resource
|
query |
Diperlukan hanya untuk Buat File dan Buat Direktori. Nilainya harus "file" atau "direktori". |
||
timeout
|
query |
integer int32 |
Nilai batas waktu operasi opsional dalam hitung detik. Periode dimulai ketika permintaan diterima oleh layanan. Jika nilai batas waktu berlalu sebelum operasi selesai, operasi gagal. |
Header Permintaan
Media Types: "application/octet-stream"
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
Cache-Control |
string |
Pilihan. Layanan menyimpan nilai ini dan menyertakannya di header respons "Cache-Control" untuk operasi "Baca File" untuk operasi "Baca File". |
|
Content-Encoding |
string |
Pilihan. Menentukan pengodean isi mana yang telah diterapkan ke file. Nilai ini dikembalikan ke klien ketika operasi "Baca File" dilakukan. |
|
Content-Language |
string |
Pilihan. Menentukan bahasa alami yang digunakan oleh audiens yang dimaksudkan untuk file. |
|
Content-Disposition |
string |
Pilihan. Layanan menyimpan nilai ini dan menyertakannya di header respons "Content-Disposition" untuk operasi "Baca File". |
|
x-ms-cache-control |
string |
Pilihan. Layanan menyimpan nilai ini dan menyertakannya di header respons "Cache-Control" untuk operasi "Baca File". |
|
x-ms-content-type |
string |
Pilihan. Layanan menyimpan nilai ini dan menyertakannya di header respons "Content-Type" untuk operasi "Baca File". |
|
x-ms-content-encoding |
string |
Pilihan. Layanan menyimpan nilai ini dan menyertakannya di header respons "Pengodean Konten" untuk operasi "Baca File". |
|
x-ms-content-language |
string |
Pilihan. Layanan menyimpan nilai ini dan menyertakannya di header respons "Content-Language" untuk operasi "Baca File". |
|
x-ms-content-disposition |
string |
Pilihan. Layanan menyimpan nilai ini dan menyertakannya di header respons "Content-Disposition" untuk operasi "Baca File". |
|
x-ms-rename-source |
string |
File atau direktori opsional yang akan diganti namanya. Nilai harus memiliki format berikut: "/{filesystem}/{path}", atau "/{filesystem}/{path}?sastoken" saat menggunakan token SAS. Jika "x-ms-properties" ditentukan, properti akan menimpa properti yang ada; jika tidak, properti yang ada akan dipertahankan. Nilai ini harus berupa string yang dikodekan url persen. Perhatikan bahwa string hanya boleh berisi karakter ASCII dalam kumpulan karakter ISO-8859-1. |
|
x-ms-lease-id |
string |
Pilihan. ID sewa untuk jalur yang ditentukan dalam URI. Jalur yang akan ditimpa harus memiliki sewa aktif dan ID sewa harus cocok. Pola regex: |
|
x-ms-source-lease-id |
string |
Opsional untuk mengganti nama operasi. ID sewa untuk jalur sumber. Jalur sumber harus memiliki sewa aktif dan ID sewa harus cocok. Pola regex: |
|
x-ms-properties |
string |
Pilihan. Properti yang ditentukan pengguna untuk disimpan dengan file atau direktori, dalam format daftar pasangan nama dan nilai yang dipisahkan koma "n1=v1, n2=v2, ...", di mana setiap nilai adalah string yang dikodekan base64. Perhatikan bahwa string hanya boleh berisi karakter ASCII dalam kumpulan karakter ISO-8859-1. |
|
x-ms-permissions |
string |
Opsional dan hanya valid jika Namespace Hierarki diaktifkan untuk akun tersebut. Mengatur izin akses POSIX untuk pemilik file, grup pemilik file, dan lainnya. Setiap kelas dapat diberikan izin baca (4), tulis (2), atau jalankan (1). Baik simbolis (rwxrw-rw-) dan notasi oktal 4 digit (misalnya 0766) didukung. Bit lengket juga didukung dan dalam notasi simbolis, diwakili baik oleh huruf t atau T di tempat karakter akhir tergantung pada apakah bit eksekusi untuk kategori lain diatur atau tidak diatur masing-masing (misalnya rwxrw-rw- dengan bit lengket direpresentasikan sebagai rwxrw-rwT. Rwxrw-rwx dengan bit lengket direpresentasikan sebagai rwxrw-rwt), tidak adanya t atau T menunjukkan bit lengket tidak diatur. Dalam notasi oktal 4 digit, diwakili oleh digit ke-1 (misalnya 1766 mewakili rwxrw-rw- dengan bit lengket dan 0766 mewakili rwxrw-rw- tanpa bit lengket). Tidak valid bersama dengan x-ms-acl. |
|
x-ms-umask |
string |
Opsional dan hanya valid jika Namespace Hierarki diaktifkan untuk akun tersebut. Saat membuat file atau direktori dan folder induk tidak memiliki ACL default, umask membatasi izin file atau direktori yang akan dibuat. Izin yang dihasilkan diberikan oleh p & ^u, di mana p adalah izin dan Anda adalah umask. Misalnya, jika p adalah 0777 dan Anda adalah 0057, maka izin yang dihasilkan adalah 0720. Izin default adalah 0777 untuk direktori dan 0666 untuk file. Umask default adalah 0027. Umask harus ditentukan dalam notasi oktal 4 digit (misalnya 0766). |
|
x-ms-owner |
string |
Opsional dan hanya valid jika Namespace Hierarki diaktifkan untuk akun tersebut. Mengatur pemilik file atau direktori. |
|
x-ms-group |
string |
Opsional dan hanya valid jika Namespace Hierarki diaktifkan untuk akun tersebut. Mengatur grup pemilik file atau direktori. |
|
x-ms-acl |
string |
Opsional dan hanya valid jika Namespace Hierarki diaktifkan untuk akun tersebut. Mengatur hak kontrol akses POSIX pada file dan direktori. Setiap entri kontrol akses (ACE) terdiri dari cakupan, jenis, pengidentifikasi pengguna atau grup, dan izin dalam format "[scope:][type]:[id]:[permissions]". Cakupan harus "default" untuk menunjukkan ACE milik ACL default untuk direktori; jika tidak, cakupan bersifat implisit dan ACE milik ACL akses. Ada empat jenis ACE: "pengguna" memberikan hak kepada pemilik atau pengguna bernama, "grup" memberikan hak kepada grup pemilik atau grup bernama, "mask" membatasi hak yang diberikan kepada pengguna bernama dan anggota grup, dan "lainnya" memberikan hak untuk semua pengguna yang tidak ditemukan dalam entri lain. Pengidentifikasi pengguna atau grup dihilangkan untuk entri jenis "masker" dan "lainnya". Pengidentifikasi pengguna atau grup juga dihilangkan untuk pemilik dan grup pemilik. Bidang izin adalah urutan 3 karakter di mana karakter pertama adalah 'r' untuk memberikan akses baca, karakter kedua adalah 'w' untuk memberikan akses tulis, dan karakter ketiga adalah 'x' untuk memberikan izin eksekusi. Jika akses tidak diberikan, karakter '-' digunakan untuk menunjukkan bahwa izin ditolak. Misalnya, ACL berikut memberikan hak baca, tulis, dan eksekusi kepada pemilik file dan john.doe@contoso, hak baca untuk grup pemilik, dan tidak ada untuk orang lain: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Tidak valid bersama dengan x-ms-permissions. |
|
x-ms-proposed-lease-id |
string |
Pilihan. Tentukan id sewa yang diusulkan jika Anda ingin memperoleh sewa selama pembuatan file atau direktori. Sewa akan diperoleh dengan ID sewa ini jika pembuatan berhasil. Pola regex: |
|
x-ms-expiry-option |
string |
Opsional dan hanya valid jika Namespace Hierarki diaktifkan untuk akun dan hanya didukung pada file. Tentukan salah satu opsi kedaluwarsa berikut jika Anda ingin mengatur waktu kedaluwarsa pada file saat pembuatan. "RelativeToNow" Atur kedaluwarsa relatif terhadap waktu saat ini. Pengguna akan melewati jumlah milidetik yang berlalu dari sekarang. Waktu absolut "Absolut" dalam Format RFC 1123. "Neverexpire" Atur file agar tidak pernah kedaluwarsa, waktu kedaluwarsa tidak perlu ditentukan dengan opsi ini. |
|
x-ms-expiry-time |
string |
Opsional dan hanya valid jika Namespace Hierarki diaktifkan untuk akun dan hanya didukung pada file. Tentukan waktu kedaluwarsa kapan kedaluwarsa file. Diberikan sebagai RFC 1123 HTTP Time String atau jumlah milidetik sesuai dengan opsi kedaluwarsa. |
|
If-Match |
string |
Pilihan. Nilai ETag. Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya cocok dengan nilai yang ditentukan. ETag harus ditentukan dalam tanda kutip. |
|
If-None-Match |
string |
Pilihan. Nilai ETag atau nilai wildcard khusus ("*"). Tentukan header ini untuk melakukan operasi hanya jika ETag sumber daya tidak cocok dengan nilai yang ditentukan. ETag harus ditentukan dalam tanda kutip. |
|
If-Modified-Since |
string |
Pilihan. Nilai tanggal dan waktu. Tentukan header ini untuk melakukan operasi hanya jika sumber daya telah dimodifikasi sejak tanggal dan waktu yang ditentukan. |
|
If-Unmodified-Since |
string |
Pilihan. Nilai tanggal dan waktu. Tentukan header ini untuk melakukan operasi hanya jika sumber daya belum dimodifikasi sejak tanggal dan waktu yang ditentukan. |
|
x-ms-source-if-match |
string |
Pilihan. Nilai ETag. Tentukan header ini untuk melakukan operasi ganti nama hanya jika ETag sumber cocok dengan nilai yang ditentukan. ETag harus ditentukan dalam tanda kutip. |
|
x-ms-source-if-none-match |
string |
Pilihan. Nilai ETag atau nilai wildcard khusus ("*"). Tentukan header ini untuk melakukan operasi ganti nama hanya jika ETag sumber tidak cocok dengan nilai yang ditentukan. ETag harus ditentukan dalam tanda kutip. |
|
x-ms-source-if-modified-since |
string |
Pilihan. Nilai tanggal dan waktu. Tentukan header ini untuk melakukan operasi ganti nama hanya jika sumber telah dimodifikasi sejak tanggal dan waktu yang ditentukan. |
|
x-ms-source-if-unmodified-since |
string |
Pilihan. Nilai tanggal dan waktu. Tentukan header ini untuk melakukan operasi ganti nama hanya jika sumber belum dimodifikasi sejak tanggal dan waktu yang ditentukan. |
|
x-ms-encryption-key |
string |
Pilihan. Kunci enkripsi AES-256 yang dikodekan Base64. |
|
x-ms-encryption-key-sha256 |
string |
Pilihan. Hash SHA256 yang dikodekan Base64 dari kunci enkripsi. |
|
x-ms-encryption-algorithm: AES256 |
string |
Pilihan. Menentukan algoritma yang akan digunakan untuk enkripsi. Nilai header ini harus AES256. |
|
x-ms-encryption-context |
string |
Pilihan. Defaultnya adalah "Kosong". Jika nilai diatur, itu akan mengatur metadata sistem Blob / File. Panjang maksimum- 1024. Hanya berlaku saat Namespace Hierarki diaktifkan untuk akun tersebut. |
|
x-ms-client-request-id |
string |
UUID yang dicatat dalam log analitik untuk pemecahan masalah dan korelasi. Pola regex: |
|
x-ms-date |
string |
Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Ini diperlukan saat menggunakan otorisasi kunci bersama. |
|
x-ms-version |
string |
Menentukan versi protokol REST yang digunakan untuk memproses permintaan. Ini diperlukan saat menggunakan otorisasi kunci bersama. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
201 Created |
File atau direktori dibuat. Header
|
|
Other Status Codes |
Terjadi kesalahan. Kemungkinan status HTTP, kode, dan string pesan tercantum di bawah ini:
Header
|
Definisi
Nama | Deskripsi |
---|---|
Data |
|
Error |
Objek respons kesalahan layanan. |
Path |
Pilihan. Valid hanya ketika namespace diaktifkan. Parameter ini menentukan perilaku operasi ganti nama. Nilainya harus "warisan" atau "posix", dan nilai defaultnya adalah "posix". |
Path |
Diperlukan hanya untuk Buat File dan Buat Direktori. Nilainya harus "file" atau "direktori". |
DataLakeStorageError
Nama | Jenis | Deskripsi |
---|---|---|
error |
Objek respons kesalahan layanan. |
Error
Objek respons kesalahan layanan.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Kode kesalahan layanan. |
message |
string |
Pesan kesalahan layanan. |
PathRenameMode
Pilihan. Valid hanya ketika namespace diaktifkan. Parameter ini menentukan perilaku operasi ganti nama. Nilainya harus "warisan" atau "posix", dan nilai defaultnya adalah "posix".
Nama | Jenis | Deskripsi |
---|---|---|
legacy |
string |
|
posix |
string |
PathResourceType
Diperlukan hanya untuk Buat File dan Buat Direktori. Nilainya harus "file" atau "direktori".
Nama | Jenis | Deskripsi |
---|---|---|
directory |
string |
|
file |
string |