Panggil operasi PutUserDefinedLogFieldsConfig untuk menyesuaikan field log - Object Storage Service

Menyesuaikan field dalam elemen user_defined_log_fields untuk logging bucket guna mencatat header permintaan dan parameter kueri.

Catatan penggunaan

Izin oss:PutUserDefinedLogFieldsConfig diperlukan untuk menyesuaikan field user_defined_log_fields dalam log real-time dengan memanggil operasi PutUserDefinedLogFieldsConfig. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.
Informasi konfigurasi logging Anda dienkripsi dan disimpan dalam field user_defined_log_fields. Nilai dari field user_defined_log_fields adalah data JSON yang dienkripsi Base64. Data JSON mencakup field "truncated" yang menunjukkan apakah data dipotong, field "headers" yang berisi header permintaan yang ditentukan, dan field "querys" yang berisi parameter kueri yang ditentukan.
Anda dapat menentukan total enam header permintaan kustom dan parameter kueri dalam konfigurasi logging.
Total panjang kunci dan nilai semua field kustom untuk header permintaan dan parameter kueri dalam konfigurasi logging dibatasi hingga 1.024 byte. Karakter tambahan di luar batas panjang akan dipotong.
Kunci field kustom untuk header permintaan dapat berisi tanda hubung (-) tetapi tidak boleh mengandung garis bawah (_). Kunci field kustom untuk parameter kueri dapat berisi garis bawah (_).
Kunci field kustom untuk header permintaan harus sesuai dengan protokol HTTP dan hanya dapat berisi karakter ASCII yang dapat dicetak (dari 33 hingga 126), kecuali garis bawah (_) dan titik dua (:).

Sintaks permintaan

PUT /?userDefinedLogFieldsConfig HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<UserDefinedLogFieldsConfiguration>
	<HeaderSet>
		<header>header1</header>
		<header>header2</header>
		<header>header3</header>
	</HeaderSet>
	<ParamSet>
		<parameter>param1</parameter>
		<parameter>param2</parameter>
	</ParamSet>
</UserDefinedLogFieldsConfiguration>

Header permintaan

Semua header dalam permintaan PutUserDefinedLogFieldsConfig adalah header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Elemen permintaan

Elemen	Tipe	Diperlukan	Contoh	Deskripsi
UserDefinedLogFieldsConfiguration	Container	Ya	N/A	Wadah untuk konfigurasi logging yang ditentukan pengguna. Elemen anak: HeaderSet dan ParamSet Elemen induk: tidak ada
HeaderSet	Container	Tidak	N/A	Wadah untuk header permintaan kustom. Elemen anak: header Elemen induk: UserDefinedLogFieldsConfiguration
header	String	Tidak	header1	Header permintaan kustom. Elemen anak: tidak ada Elemen induk: HeaderSet
ParamSet	Container	Tidak	N/A	Wadah untuk parameter kueri kustom. Elemen anak: parameter Elemen induk: UserDefinedLogFieldsConfiguration
parameter	String	Tidak	param1	Parameter kueri kustom. Elemen anak: tidak ada Elemen induk: ParamSet

Header respons

Semua header dalam respons terhadap permintaan PutUserDefinedLogFieldsConfig adalah header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Contoh

Permintaan Contoh

PUT /?userDefinedLogFieldsConfig HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue

<?xml version="1.0" encoding="UTF-8"?>
<UserDefinedLogFieldsConfiguration>
	<HeaderSet>
		<header>header1</header>
		<header>header2</header>
		<header>header3</header>
	</HeaderSet>
	<ParamSet>
		<parameter>param1</parameter>
		<parameter>param2</parameter>
	</ParamSet>
</UserDefinedLogFieldsConfiguration>

Respons Contoh

HTTP/1.1 200 OK
x-oss-request-id: 534B371674125A4D8906008B
Date: Date
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

OSS SDK

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut untuk memanggil operasi PutUserDefinedLogFieldsConfig: