更新时间:2026-01-05 GMT+08:00

新建跨账号日志接入

功能介绍

新建跨账号日志接入

URI

POST /v2.0/{project_id}/lts/createAgencyAccess

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方式请参见:获取项目ID,获取账号ID,日志组ID、日志流ID

最小长度:1

最大长度:64

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

从IAM服务获取的用户Token,获取方式请参见:获取用户Token

最小长度:1

最大长度:10000

Content-Type

String

该字段填为:application/json;charset=utf8。

最小长度:30

最大长度:30

表3 请求Body参数

参数

是否必选

参数类型

描述

preview_agency_list

Array of PreviewAgencyLogAccessReqBody objects

预览代理列表

表4 PreviewAgencyLogAccessReqBody

参数

是否必选

参数类型

描述

agency_access_type

String

日志接入类型,AGENCYACCESS

agency_log_access

String

跨账号日志接入配置名称,不可重复

  • 只支持输入英文、数字、中文、中划线、下划线及小数点,且不能以小数点、下划线开头或以小数点结尾

  • 长度不超过64

log_agencyStream_name

String

委托日志流名称

log_agencyStream_id

String

委托日志流id

log_agencyGroup_name

String

委托日志组名称

log_agencyGroup_id

String

委托日志组id

log_beAgencystream_name

String

被委托日志流名称

log_beAgencystream_id

String

被委托日志流id

log_beAgencygroup_name

String

被委托日志组名称

log_beAgencygroup_id

String

被委托日志组id

be_agency_project_id

String

被委托项目id

agency_project_id

String

委托项目id

agency_domain_name

String

委托账号名称

agency_name

String

委托名称

响应参数

状态码:201

表5 响应Body参数

参数

参数类型

描述

LTSAgencyAccessConfigInfoList

Array of LTSAccessConfigInfoRespon200 objects

跨账号创建日志接入配置响应列表

表6 LTSAccessConfigInfoRespon200

参数

参数类型

描述

access_config_id

String

跨账号日志接入id

project_id

String

项目ID

access_config_name

String

跨账号日志接入名称

access_config_type

Object

跨账号日志接入类型

group_id

String

日志组ID

log_group_name

String

日志组名称

log_stream_id

String

日志流ID

log_stream_name

String

日志流名称

create_time

Long

创建时间

agency_log_access

PreviewAgencyLogAccessReqBody object

委托接入信息

表7 PreviewAgencyLogAccessReqBody

参数

参数类型

描述

agency_access_type

String

日志接入类型,AGENCYACCESS

agency_log_access

String

跨账号日志接入配置名称,不可重复

  • 只支持输入英文、数字、中文、中划线、下划线及小数点,且不能以小数点、下划线开头或以小数点结尾

  • 长度不超过64

log_agencyStream_name

String

委托日志流名称

log_agencyStream_id

String

委托日志流id

log_agencyGroup_name

String

委托日志组名称

log_agencyGroup_id

String

委托日志组id

log_beAgencystream_name

String

被委托日志流名称

log_beAgencystream_id

String

被委托日志流id

log_beAgencygroup_name

String

被委托日志组名称

log_beAgencygroup_id

String

被委托日志组id

be_agency_project_id

String

被委托项目id

agency_project_id

String

委托项目id

agency_domain_name

String

委托账号名称

agency_name

String

委托名称

状态码:400

表8 响应Body参数

参数

参数类型

描述

-

String

状态码:500

表9 响应Body参数

参数

参数类型

描述

message

ErrorMessagebody object

错误信息body体

表10 ErrorMessagebody

参数

参数类型

描述

code

String

错误码

details

String

错误描述

请求示例

新建跨账号日志接入

POST https://{endpoint}/v2.0/{project_id}/lts/createAgencyAccess

{
  "preview_agency_list" : [ {
    "agency_log_access" : "rule_lb30",
    "agency_access_type" : "AGENCYACCESS",
    "agency_name" : "wenshufeng",
    "agency_domain_name" : "paas_aom_z00418070_01",
    "agency_project_id" : "a0a12b069ab4491185d7cf26c3e86ada",
    "be_agency_project_id" : "2a473356cca5487f8373be891bffc1cf",
    "log_agencyStream_name" : "lts-topic-bug",
    "log_agencyStream_id" : "beb169ff-e6e9-4bea-8e77-50afdec74071",
    "log_agencyGroup_name" : "lts-group-sgq",
    "log_agencyGroup_id" : "f06cbfa0-7243-4031-9380-ae0465bd3997",
    "log_beAgencystream_name" : "lts-topic-ECS",
    "log_beAgencystream_id" : "36ce06b0-c6bf-436d-9abe-39de86da28bb",
    "log_beAgencygroup_name" : "lts-group-sgqECS",
    "log_beAgencygroup_id" : "1e749063-d9f5-474f-a537-00cad4e9a108"
  } ]
}

响应示例

状态码:201

跨账号日志接入成功

[ {
  "access_config_id" : "dc5dceef-b0f0-4601-bc70-31fded87277c",
  "access_config_name" : "rule_x881",
  "access_config_type" : "AGENCYACCESS",
  "agency_log_access" : {
    "agency_accessConfig_id" : "dc5dceef-b0f0-4601-bc70-31fded87277c",
    "agency_access_type" : "AGENCYACCESS",
    "agency_domain_name" : "hyy-c30030940",
    "agency_log_access" : "rule_x881",
    "agency_name" : "lts-qff",
    "agency_project_id" : "f9786af2c4824786b6875dc68b238959",
    "be_agency_project_id" : "4a4eb741b4fe4409b3cb67a7095a6614",
    "log_agencyGroup_id" : "47d08f95-8cf5-4584-9ad2-ed71f6f10dbf",
    "log_agencyGroup_name" : "lts-group-qff-m",
    "log_agencyStream_id" : "e74317cb-e4c4-43e6-9fd3-aacadc05b1f5",
    "log_agencyStream_name" : "lts-topic-8",
    "log_beAgencygroup_id" : "18c45b02-d493-4f74-b0d3-778d05ef3c7f",
    "log_beAgencygroup_name" : "lts-group-qff-530",
    "log_beAgencystream_id" : "cc0bd880-2167-45a3-97ec-1bcd466ded7d",
    "log_beAgencystream_name" : "lts-topic-raojie"
  },
  "binary_collect" : false,
  "create_time" : 1749797479366,
  "encoding_format" : "UTF-8",
  "group_id" : "18c45b02-d493-4f74-b0d3-778d05ef3c7f",
  "hostGroupNum" : 0,
  "hostNum" : 0,
  "host_group_info_list" : [ ],
  "host_rule_info" : {
    "black_paths" : [ ],
    "combine_stdout" : false,
    "excludeEnvsLogical" : "or",
    "excludeK8sLabelsLogical" : "or",
    "excludeLabelsLogical" : "or",
    "includeEnvsLogical" : "or",
    "includeK8sLabelsLogical" : "or",
    "includeLabelsLogical" : "or",
    "pathType" : "host_file",
    "paths" : [ ],
    "repeat_collect" : true,
    "stderr" : false,
    "stdout" : false
  },
  "id" : "",
  "incremental_collect" : true,
  "indexId" : "",
  "key" : "",
  "log_group_name" : "lts-group-qff-530",
  "log_split" : false,
  "log_split_size" : 500,
  "log_stream_id" : "cc0bd880-2167-45a3-97ec-1bcd466ded7d",
  "log_stream_name" : "lts-topic-raojie",
  "pathNum" : 0,
  "project_id" : "4a4eb741b4fe4409b3cb67a7095a6614",
  "recursive_depth" : 5,
  "state" : true,
  "tag_list" : [ ]
} ]

状态码:400

跨账号日志接入创建失败

Failed to validate the log_agencyStream_id
或
Failed to validate the log_agencyGroup_id
或
Failed to validate the AgencyProjectId
或
Failed to validate the agency_access_type
或
agency_log_access format error

状态码:500

服务内部错误

{
  "message" : {
    "code" : "LTS.0010",
    "details" : "The system encountered an internal error"
  }
}

状态码

状态码

描述

201

跨账号日志接入成功

400

跨账号日志接入创建失败

500

服务内部错误

错误码

请参见错误码