GetUserDefinedLogFieldsConfig接口用于获取存储空间(Bucket)实时日志中user_defined_log_fields字段的个性化配置。
注意事项
如需调用GetUserDefinedLogFieldsConfig接口获取存储空间(Bucket)实时日志中user_defined_log_fields字段的个性化配置,您必须拥有oss:GetUserDefinedLogFieldsConfig权限。具体操作,请参见为RAM用户授予自定义的权限策略。
请求语法
GET /?userDefinedLogFieldsConfig HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue当您在OSS ON云盒中调用该接口时,您需要将Host替换为云盒Endpoint。更多信息,请参见云盒Endpoint。
请求头
此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。
响应头
此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)。
响应元素
| 名称 | 类型 | 是否必需 | 示例值 | 描述 | 
| UserDefinedLogFieldsConfiguration | 容器 | 是 | 不涉及 | 用户自定义日志配置信息的容器。 子元素:HeaderSet、ParamSet 父元素:无 | 
| HeaderSet | 容器 | 否 | 不涉及 | 自定义请求头配置信息的容器。 子元素:header 父元素:无UserDefinedLogFieldsConfiguration | 
| header | 字符串 | 否 | header1 | 自定义请求头信息。 子元素:无 父元素:HeaderSet | 
| ParamSet | 容器 | 否 | 不涉及 | 自定义查询参数配置信息的容器。 子元素:parameter 父元素:无UserDefinedLogFieldsConfiguration | 
| parameter | 字符串 | 否 | param1 | 自定义查询参数信息。 子元素:无 父元素:ParamSet | 
示例
请求示例
GET /?userDefinedLogFieldsConfig HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue响应示例
HTTP/1.1 200 OK
x-oss-request-id: 534B371674125A4D8906008B
Date: Date
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
<?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>SDK
此接口所对应的各语言SDK如下:
命令行工具ossutil
GetUserDefinedLogFieldsConfig接口所对应的ossutil命令,请参见get-user-defined-log-fields-config。