Path - Create

  • Referensi
Service:
Storage Services
API Version:
2023-08-03

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}
With optional parameters: 
PUT https://{accountName}.{dnsSuffix}/{filesystem}/{path}?resource={resource}&continuation={continuation}&mode={mode}&timeout={timeout}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
accountName
 path True

string

Nama akun Azure Storage.
dnsSuffix
 path True

string

Akhiran DNS untuk titik akhir Azure Data Lake Storage.
filesystem
 path True

string

Pengidentifikasi sistem file.

Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
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

PathRenameMode

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

PathResourceType

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.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
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.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
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.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
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.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
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.

Headers

  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-continuation: string
  • Content-Length: integer
  • x-ms-request-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-scope: string
Other Status Codes

DataLakeStorageError

Terjadi kesalahan. Kemungkinan status HTTP, kode, dan string pesan tercantum di bawah ini:

  • 400 Permintaan Buruk, ContentLengthMustBeZero, "Header permintaan Panjang Konten harus nol."
  • 400 Permintaan Buruk, InvalidAuthenticationInfo, "Informasi autentikasi tidak diberikan dalam format yang benar. Periksa nilai header Otorisasi."
  • 400 Permintaan Buruk, InvalidFlushPosition, "Data yang diunggah tidak berdekatan atau nilai parameter kueri posisi tidak sama dengan panjang file setelah menambahkan data yang diunggah."
  • 400 Permintaan Buruk, InvalidHeaderValue, "Nilai untuk salah satu header HTTP tidak dalam format yang benar."
  • 400 Permintaan Buruk, InvalidHttpVerb, "Kata kerja HTTP yang ditentukan tidak valid - tidak dikenali oleh server."
  • 400 Permintaan Buruk, InvalidInput, "Salah satu input permintaan tidak valid."
  • 400 Permintaan Buruk, InvalidPropertyName, "Nama properti tidak boleh kosong."
  • 400 Permintaan Buruk, InvalidPropertyName, "Nama properti berisi karakter yang tidak valid."
  • 400 Permintaan Buruk, InvalidQueryParameterValue, "Nilai untuk salah satu parameter kueri yang ditentukan dalam permintaan URI tidak valid."
  • 400 Permintaan Buruk, InvalidResourceName, "Nama sumber daya yang ditentukan berisi karakter yang tidak valid."
  • 400 Permintaan Buruk, InvalidSourceUri, "URI sumber tidak valid."
  • 400 Permintaan Buruk, InvalidUri, "URI permintaan tidak valid."
  • 400 Permintaan Buruk, MissingRequiredHeader, "Header HTTP yang wajib untuk permintaan ini tidak ditentukan."
  • 400 Permintaan Buruk, MissingRequiredQueryParameter, "Parameter kueri yang wajib untuk permintaan ini tidak ditentukan."
  • 400 Permintaan Buruk, MultipleConditionHeadersNotSupported, "Beberapa header kondisi tidak didukung."
  • 400 Permintaan Buruk, OutOfRangeInput, "Salah satu input permintaan berada di luar jangkauan."
  • 400 Permintaan Buruk, OutOfRangeQueryParameterValue, "Salah satu parameter kueri yang ditentukan dalam URI permintaan berada di luar rentang yang diizinkan."
  • 400 Permintaan Buruk, UnsupportedHeader, "Salah satu header yang ditentukan dalam permintaan tidak didukung."
  • 400 Permintaan Buruk, UnsupportedQueryParameter, "Salah satu parameter kueri yang ditentukan dalam permintaan URI tidak didukung."
  • 400 Permintaan Buruk, UnsupportedRestVersion, "Versi Rest yang ditentukan Tidak Didukung."
  • 403 Forbidden, AccountIsDisabled, "Akun yang ditentukan dinonaktifkan."
  • 403 Terlarang, AuthorizationFailure, "Permintaan ini tidak diizinkan untuk melakukan operasi ini."
  • 403 Terlarang, InsufficientAccountPermissions, "Akun yang diakses tidak memiliki izin yang memadai untuk menjalankan operasi ini."
  • 404 Tidak Ditemukan, FilesystemNotFound, "Sistem file yang ditentukan tidak ada."
  • 404 Tidak Ditemukan, PathNotFound, "Jalur yang ditentukan tidak ada."
  • 404 Tidak Ditemukan, Ganti NamaDestinationParentPathNotFound, "Direktori induk jalur tujuan tidak ada."
  • 404 Tidak Ditemukan, ResourceNotFound, "Sumber daya yang ditentukan tidak ada."
  • 404 Tidak Ditemukan, SourcePathNotFound, "Jalur sumber untuk operasi penggantian nama tidak ada."
  • Metode 405 Tidak Diizinkan, Tidak DidukungHttpVerb, "Sumber daya tidak mendukung kata kerja HTTP yang ditentukan."
  • 409 Konflik, DestinationPathIsBeingDeleted, "Jalur tujuan yang ditentukan ditandai untuk dihapus."
  • 409 Konflik, DirectoryNotEmpty, "Nilai parameter kueri rekursif harus benar untuk menghapus direktori yang tidak kosong."
  • Konflik 409, FilesystemAlreadyExists, "Sistem file yang ditentukan sudah ada."
  • 409 Konflik, FilesystemBeingDeleted, "Sistem file yang ditentukan sedang dihapus."
  • 409 Konflik, InvalidDestinationPath, "Jalur yang ditentukan, atau elemen jalur, ada dan jenis sumber dayanya tidak valid untuk operasi ini." * 409 Konflik, InvalidFlushOperation, "Sumber daya dibuat atau dimodifikasi oleh API Blob Service dan tidak dapat ditulis oleh Data Lake Storage Service API."
  • 409 Conflict, InvalidRenameSourcePath, "Direktori sumber tidak boleh sama dengan direktori tujuan, juga tidak dapat menjadi subdirektori dari direktori sumber."
  • 409 Konflik, InvalidSourceOrDestinationResourceType, "Jenis sumber daya sumber dan tujuan harus identik."
  • 409 Konflik, LeaseAlreadyPresent, "Sudah ada sewa yang ada."
  • 409 Konflik, LeaseIdMismatchWithLeaseOperation, "ID sewa yang ditentukan tidak cocok dengan ID sewa untuk sumber daya dengan operasi sewa yang ditentukan."
  • 409 Konflik, LeaseIsAlreadyBroken, "Sewa sudah rusak dan tidak dapat dipecah lagi."
  • 409 Konflik, LeaseIsBreakingAndCannotBeAcquired, "ID sewa cocok, tetapi sewa saat ini dalam keadaan rusak dan tidak dapat diperoleh sampai rusak."
  • 409 Konflik, LeaseIsBreakingAndCannotBeChanged, "ID sewa cocok, tetapi sewa saat ini dalam status rusak dan tidak dapat diubah."
  • 409 Konflik, LeaseIsBrokenAndCannotBeRenewed, "ID sewa cocok, tetapi sewa telah rusak secara eksplisit dan tidak dapat diperbarui."
  • 409 Conflict, LeaseNameMismatch, "Nama sewa yang ditentukan tidak cocok dengan nama sewa yang ada."
  • Konflik 409, LeaseNotPresentWithLeaseOperation, "ID sewa tidak ada dengan operasi sewa yang ditentukan."
  • Konflik 409, PathAlreadyExists, "Jalur yang ditentukan sudah ada."
  • 409 Conflict, PathConflict, "Jalur yang ditentukan, atau elemen jalur, ada dan jenis sumber dayanya tidak valid untuk operasi ini."
  • 409 Konflik, SourcePathIsBeingDeleted, "Jalur sumber yang ditentukan ditandai untuk dihapus."
  • 409 Conflict, ResourceTypeMismatch, "Jenis sumber daya yang ditentukan dalam permintaan tidak cocok dengan jenis sumber daya."
  • 412 Prasyarat Gagal, ConditionNotMet, "Kondisi yang ditentukan menggunakan header bersyarat HTTP tidak terpenuhi."
  • Prasyarat 412 Gagal, LeaseIdMismatch, "ID sewa yang ditentukan tidak cocok dengan ID sewa untuk sumber daya."
  • 412 Prasyarat Gagal, LeaseIdMissing, "Saat ini ada sewa pada sumber daya dan tidak ada ID sewa yang ditentukan dalam permintaan."
  • 412 Prasyarat Gagal, LeaseNotPresent, "Saat ini tidak ada sewa pada sumber daya."
  • 412 Prasyarat Gagal, LeaseLost, "ID sewa ditentukan, tetapi sewa untuk sumber daya telah kedaluwarsa."
  • 412 Prasyarat Gagal, SourceConditionNotMet, "Kondisi sumber yang ditentukan menggunakan header kondisional HTTP tidak terpenuhi."
  • 413 Entitas Permintaan Terlalu Besar, RequestBodyTooLarge, "Isi permintaan terlalu besar dan melebihi batas maksimum yang diizinkan."
  • 416 Rentang yang Diminta Tidak Terpenuhi, InvalidRange, "Rentang yang ditentukan tidak valid untuk ukuran sumber daya saat ini."
  • 500 Kesalahan Server Internal, InternalError, "Server mengalami kesalahan internal. Silakan coba lagi permintaannya."
  • 500 Kesalahan Server Internal, OperationTimedOut, "Operasi tidak dapat diselesaikan dalam waktu yang diizinkan."
  • 503 Layanan Tidak Tersedia, ServerBusy, "Egress melebihi batas akun."
  • 503 Layanan Tidak Tersedia, ServerBusy, "Ingress melebihi batas akun."
  • 503 Layanan Tidak Tersedia, ServerBusy, "Operasi per detik melebihi batas akun."
  • 503 Layanan Tidak Tersedia, ServerBusy, "Server saat ini tidak dapat menerima permintaan. Silakan coba ulang permintaan Anda."

Headers

  • x-ms-request-id: string
  • x-ms-version: string

Definisi

Nama Deskripsi
DataLakeStorageError
Error

Objek respons 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".
PathResourceType

Diperlukan hanya untuk Buat File dan Buat Direktori. Nilainya harus "file" atau "direktori".

DataLakeStorageError

Nama Jenis Deskripsi
error

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