Path - Get Properties

Referensi

Service:: Storage Services

API Version:: 2023-08-03

Dapatkan Properti | Dapatkan Status | Dapatkan Daftar Access Control | Periksa Akses
Dapatkan Properti mengembalikan semua sistem dan properti yang ditentukan pengguna untuk jalur. Dapatkan Status mengembalikan semua properti yang ditentukan sistem untuk jalur. Dapatkan Daftar Access Control mengembalikan daftar kontrol akses untuk jalur. Operasi ini mendukung permintaan HTTP kondisional. Untuk informasi selengkapnya, lihat Menentukan Header Kondisional untuk Operasi Blob Service.

HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}

With optional parameters:

HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&upn={upn}&fsAction={fsAction}&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.
action	query		PathGetPropertiesAction	Pilihan. Jika nilainya adalah "getStatus" hanya properti yang ditentukan sistem untuk jalur yang dikembalikan. Jika nilainya adalah "getAccessControl" daftar kontrol akses dikembalikan di header respons (Namespace Hierarkis harus diaktifkan untuk akun), jika tidak, properti dikembalikan.
fsAction	query		string	Diperlukan hanya untuk memeriksa tindakan akses. Hanya berlaku saat Namespace Hierarki diaktifkan untuk akun tersebut. Operasi sistem file baca/tulis/jalankan dalam bentuk string, cocok dengan pola regex '[rwx-]{3}'
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.
upn	query		boolean	Opsional. Hanya berlaku saat Namespace Hierarki diaktifkan untuk akun tersebut. Jika "true", nilai identitas pengguna yang dikembalikan di header respons x-ms-owner, x-ms-group, dan x-ms-acl akan diubah dari ID Objek Azure Active Directory menjadi Nama Utama Pengguna. Jika "false", nilai akan dikembalikan sebagai ID Objek Azure Active Directory. Nilai defaultnya adalah false. Perhatikan bahwa ID Objek grup dan aplikasi tidak diterjemahkan karena tidak memiliki nama ramah yang unik.

Header Permintaan

Nama	Jenis	Deskripsi
x-ms-lease-id	string	Opsional. Jika header ini ditentukan, operasi akan dilakukan hanya jika kedua kondisi berikut terpenuhi: i) sewa jalur saat ini aktif dan ii) ID sewa yang ditentukan dalam permintaan cocok dengan jalur. Regex pattern: `^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$`
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-encryption-key	string	Pilihan. Kunci enkripsi AES-256 yang dikodekan Base64.
x-ms-encryption-key-sha256	string	Opsional. Hash SHA256 yang dikodekan Base64 dari kunci enkripsi.
x-ms-encryption-algorithm: AES256	string	Opsional. Menentukan algoritma yang akan digunakan untuk enkripsi. Nilai header ini harus AES256.
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
200 OK		Mengembalikan semua properti untuk file atau direktori. Headers Accept-Ranges: string Cache-Control: string Content-Disposition: string Content-Encoding: string Content-Language: string Content-Length: integer Content-Range: string Content-Type: string Content-MD5: string Date: string ETag: string Last-Modified: string x-ms-request-id: string x-ms-version: string x-ms-resource-type: string x-ms-properties: string x-ms-owner: string x-ms-group: string x-ms-permissions: string x-ms-acl: string x-ms-lease-duration: string x-ms-lease-state: string x-ms-lease-status: string x-ms-server-encrypted: true/false: boolean x-ms-encryption-key-sha256: string x-ms-encryption-context: string x-ms-encryption-scope: string x-ms-creation-time: string x-ms-expiry-time: 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

Nama

Jenis

Deskripsi

200 OK

Mengembalikan semua properti untuk file atau direktori.

Headers

Accept-Ranges: string
Cache-Control: string
Content-Disposition: string
Content-Encoding: string
Content-Language: string
Content-Length: integer
Content-Range: string
Content-Type: string
Content-MD5: string
Date: string
ETag: string
Last-Modified: string
x-ms-request-id: string
x-ms-version: string
x-ms-resource-type: string
x-ms-properties: string
x-ms-owner: string
x-ms-group: string
x-ms-permissions: string
x-ms-acl: string
x-ms-lease-duration: string
x-ms-lease-state: string
x-ms-lease-status: string
x-ms-server-encrypted: true/false: boolean
x-ms-encryption-key-sha256: string
x-ms-encryption-context: string
x-ms-encryption-scope: string
x-ms-creation-time: string
x-ms-expiry-time: 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.
PathGetPropertiesAction	Pilihan. Jika nilainya adalah "getStatus" hanya properti yang ditentukan sistem untuk jalur yang dikembalikan. Jika nilainya adalah "getAccessControl" daftar kontrol akses dikembalikan di header respons (Namespace Hierarkis harus diaktifkan untuk akun), jika tidak, properti dikembalikan.

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.