Call the PutUserDefinedLogFieldsConfig operation to customize log fields - Object Storage Service

Analiz amacıyla belirli istek üstbilgilerini ve sorgu parametrelerini yakalamak üzere paket gerçek zamanlı günlüklerinin user_defined_log_fields öğesindeki özel alanları yapılandırın.

Kullanım notları

PutUserDefinedLogFieldsConfig işlemini çağırmak için oss:PutUserDefinedLogFieldsConfig iznine sahip olmanız gerekir. Daha fazla bilgi için bkz. Özel ilke atama.
Günlüğe kaydedilen veriler, user_defined_log_fields alanında Base64 kodlu JSON olarak depolanır. JSON üç anahtar içerir: "truncated" (verilerin kırpılıp kırpılmadığı), "headers" (istek üstbilgileri) ve "querys" (sorgu parametreleri).
Bir günlük yapılandırması toplamda en fazla altı özel istek üstbilgisini ve sorgu parametresini destekler.
Bir günlük yapılandırmasındaki tüm özel istek üstbilgisi ve sorgu parametresi alanlarının birleşik anahtar ve değer uzunluğu 1.024 baytı aşamaz. Bu sınırı aşan karakterler kırpılır.
İstek üstbilgisi anahtarları tire (-) içerebilir ancak alt çizgi (_) içeremez. Sorgu parametresi anahtarları alt çizgi (_) içerebilir.
İstek üstbilgisi anahtarları yalnızca ASCII yazdırılabilir karakterleri (33–126) içermeli ve alt çizgi (_) ile iki nokta üst üste (:) karakterlerini içermemelidir.

İstek sözdizimi

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>

İstek üstbilgileri

PutUserDefinedLogFieldsConfig isteği yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

İstek öğeleri

Öğe	Tür	Gerekli	Örnek	Açıklama
UserDefinedLogFieldsConfiguration	Container	Evet	Yok	Kullanıcı tanımlı günlük yapılandırması için kapsayıcı. Alt öğeler: HeaderSet ve ParamSet Üst öğeler: yok
HeaderSet	Container	Hayır	Yok	Özel istek üstbilgileri için kapsayıcı. Alt öğeler: header Üst öğeler: UserDefinedLogFieldsConfiguration
header	String	Hayır	header1	Özel istek üstbilgisi. Alt öğeler: yok Üst öğeler: HeaderSet
ParamSet	Container	Hayır	Yok	Özel sorgu parametreleri için kapsayıcı. Alt öğeler: parameter Üst öğeler: UserDefinedLogFieldsConfiguration
parameter	String	Hayır	param1	Özel sorgu parametresi. Alt öğeler: yok Üst öğeler: ParamSet

Yanıt üstbilgileri

PutUserDefinedLogFieldsConfig isteğine verilen yanıt yalnızca ortak yanıt üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Örnekler

Örnek istek

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>

Örnek yanıt

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

OSS SDK'ları

PutUserDefinedLogFieldsConfig işlemini çağırmak için aşağıdaki programlama dillerine yönelik OSS SDK'larını kullanabilirsiniz: