帮你快速理解、总结文档立即下载
文档中心>API 中心>全球加速2.0>全球加速相关接口>创建访问日志

创建访问日志

最近更新时间：2026-07-22 02:07:12

我的收藏

本页目录：

1. 接口描述

接口请求域名： ga2.tencentcloudapi.com 。

创建GA访问日志

默认接口请求频率限制：20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：CreateGlobalAcceleratorAccessLog。
Version 是 String 公共参数，本接口取值：2025-01-15。
Region 否 String 公共参数，此参数为可选参数。
GlobalAcceleratorId 是 String

GA示例唯一Id


示例值：ga-8sreohed
ListenerId 是 String

监听器Id


示例值：lsr-4afw0c06
EndpointGroupId 是 String

终端节点组Id


示例值：epg-du8oqpy5
CloudRegion 是 String

日志集所在地域


示例值：ap-guangzhou
CloudLogId 是 String

日志主题Id


示例值：61f7ee4c-4704-4669-82fe-2c191f8f200b
CloudLogSetId 是 String

日志集Id


示例值：81217ea2-f578-451a-946e-f31e2131a9ac
FieldKeys.N 否 Array of String

指定采集字段

枚举值：

  • session_time： 四层，会话持续时间
  • upstream_bytes_received： 四层、七层，从终端节点接收的字节数
  • upstream_bytes_sent： 四层、七层，发送给终端节点的字节数
  • request_method： 七层，GET/POST
  • scheme： 七层，http/https
  • request_uri： 七层，客户端原始请求的URI
  • uri： 七层，当前请求的URI
  • host： 七层，客户端访问域名（七层）
  • remote_user： 七层，基本认证时的用户名（未认证时为"-"）
  • http_user_agent： 七层，客户端浏览器标识
  • http_referer： 七层，请求来源URL（直接从地址栏访问时为"-"）
  • http_x_forwarded_for： 七层，记录客户端原始IP及经过的代理服务器IP链
  • content_type： 七层，content_type
  • body_bytes_sent： 七层，发送给客户端的http body大小，不包含header
  • request_time： 七层，从接收到客户端请求的第一个字节到发送完响应最后一个字节之间的总时间（单位：秒）
  • sent_http_content_type： 七层，响应内容类型
  • upstream_header_time： 七层，终端节点的响应头到达时间
  • upstream_response_length： 七层，终端节点返回的响应体长度
  • upstream_response_time： 七层，终端节点完整响应时间
  • upstream_status： 七层，终端节点返回的HTTP状态码

示例值：["request_method"]
FlowLogDescription 否 String

日志描述


示例值：ga_log_test_http

3. 输出参数

参数名称 类型 描述
LogPushTaskId String

日志任务唯一Id


示例值：galog-gv9duwet
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 创建访问日志示例

输入示例

POST / HTTP/1.1
Host: ga2.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateGlobalAcceleratorAccessLog
<公共请求参数>

{
    "GlobalAcceleratorId": "ga-8sreohed",
    "ListenerId": "lsr-4afw0c06",
    "EndpointGroupId": "epg-du8oqpy5",
    "CloudRegion": "ap-guangzhou",
    "CloudLogId": "61f7ee4c-4704-4669-82fe-2c191f8f200b",
    "CloudLogSetId": "81217ea2-f578-451a-946e-f31e2131a9ac",
    "FieldKeys": [
        "request_method"
    ],
    "FlowLogDescription": "ga_log_test_http"
}

输出示例

{
    "Response": {
        "LogPushTaskId": "galog-gv9duwet",
        "RequestId": "383fea40-a621-4bb6-8695-ad35e26515c2"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。

错误码 描述
InvalidParameterValue.InstanceMismatch 实例对象 %(value)s 关系不匹配。
InvalidParameterValue.LogTaskLocatedError 参数%(value)s日志主题所在地域与终端节点地域%(region)s未正确对应。
InvalidParameterValue.LogsetNotExist 日志集主题%(value)s不存在
InvalidParameterValue.Range 参数 %(parameter)s 值 %(value)s 必须在 %(value_range)s 范围内。
UnsupportedOperation.AccessLog 当前账号不支持配置访问日志。
UnsupportedOperation.ExistAccessLog 存在访问日志，不支持当前操作。
UnsupportedOperation.InstanceNotRunning 实例不是运行状态，不支持当前操作。
UnsupportedOperation.NotAuthorization 暂不支持，请先授权开启日志任务。
中国站