Object Storage Service：PutUserDefinedLogFieldsConfig

注意事項

• 如需調用PutUserDefinedLogFieldsConfig介面為儲存空間（Bucket）即時日誌中的user_defined_log_fields欄位進行個人化配置，您必須擁有oss:PutUserDefinedLogFieldsConfig許可權。具體操作，請參見為RAM使用者授予自訂的權限原則。

• 本功能將相關資訊統一編碼後填入固定欄位user_defined_log_fields中。user_defined_log_fields欄位的值是一個JSON文本Base64編碼後的值，這個JSON文本預設有一個欄位為“truncated”用於表示是否有截斷髮生，另外有兩個欄位“headers”和“querys”分別對應使用者配置的要求標頭和查詢參數資訊。

• 自訂要求標頭個數和查詢參數的個數之和不能超過6。

• 自訂要求標頭及查詢參數的key、value長度總和不能超過1024位元組，超過部分會被截斷。

• 要求標頭不支援底線（_），可以使用短劃線（-）替代。查詢參數支援底線（_）。

• 要求標頭需要遵從HTTP協議的規定。必須是可列印的ASCII字元，即字元33到字元126，支援小數點（.），不支援冒號（：）。

請求文法

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>

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

請求元素

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

樣本

請求樣本

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>

響應樣本

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

SDK

此介面所對應的各語言SDK如下：

• Java

• Python V2

• PHP V2

• Go V2

• C

• .NET

• Node.js

• Ruby

命令列工具ossutil

PutUserDefinedLogFieldsConfig介面所對應的ossutil命令，請參見put-user-defined-log-fields-config。