Help Center/ Log Tank Service/ More Documents/ API Reference (Kuala Lumpur Region)/ APIs/ Log Ingestion/ Creating a Cross-Account Log Ingestion Configuration

Updated on 2025-03-27 GMT+08:00

Online Debugging

CLI Examples

View PDF

Creating a Cross-Account Log Ingestion Configuration

Function

This API is used to create a cross-account log ingestion configuration.

URI

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain a project ID, see Obtaining the Project ID, Account ID, Log Group ID, and Log Stream ID. Minimum: 1 Maximum: 64

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token obtained from IAM. For details about how to obtain a user token, see Obtaining a User Token. Minimum: 1 Maximum: 10000
Content-Type	Yes	String	Set this parameter to application/json;charset=utf8. Minimum: 30 Maximum: 30

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
preview_agency_list	Yes	Array of PreviewAgencyLogAccessReqBody objects	Preview of the proxy list.

**Table 4** PreviewAgencyLogAccessReqBody
Parameter	Mandatory	Type	Description
agency_access_type	Yes	String	Log ingestion type.
agency_log_access	Yes	String	Cross-account log ingestion configuration name.
log_agencyStream_name	Yes	String	Delegator log stream name.
log_agencyStream_id	Yes	String	Delegator log stream ID.
log_agencyGroup_name	Yes	String	Delegator log group name.
log_agencyGroup_id	Yes	String	Delegator log group ID.
log_beAgencystream_name	Yes	String	Delegatee log stream name.
log_beAgencystream_id	Yes	String	Delegatee log stream ID.
log_beAgencygroup_name	Yes	String	Delegatee log group name.
log_beAgencygroup_id	Yes	String	Delegatee log group ID.
be_agency_project_id	Yes	String	Delegatee project ID.
agency_project_id	Yes	String	Delegator project ID.
agency_domain_name	Yes	String	Delegator account name.
agency_name	Yes	String	Agency name.

Response Parameters

Status code: 201

**Table 5** Response body parameters
Parameter	Type	Description
LTSAgencyAccessConfigInfoList	Array of LTSAccessConfigInfoRespon200 objects	Response list for creating a log ingestion configuration across accounts.

**Table 6** LTSAccessConfigInfoRespon200
Parameter	Type	Description
access_config_id	String	Cross-account log ingestion ID.
project_id	String	Project ID.
access_config_name	String	Cross-account log ingestion name.
access_config_type	Object	Cross-account log ingestion type.
group_id	String	Log group ID.
log_group_name	String	Log group name.
log_stream_id	String	Log stream ID.
log_stream_name	String	Log stream name.
create_time	Long	Creation time.
agency_log_access	PreviewAgencyLogAccessReqBody object	Information of the delegated ingestion.

**Table 7** PreviewAgencyLogAccessReqBody
Parameter	Type	Description
agency_access_type	String	Log ingestion type.
agency_log_access	String	Cross-account log ingestion configuration name.
log_agencyStream_name	String	Delegator log stream name.
log_agencyStream_id	String	Delegator log stream ID.
log_agencyGroup_name	String	Delegator log group name.
log_agencyGroup_id	String	Delegator log group ID.
log_beAgencystream_name	String	Delegatee log stream name.
log_beAgencystream_id	String	Delegatee log stream ID.
log_beAgencygroup_name	String	Delegatee log group name.
log_beAgencygroup_id	String	Delegatee log group ID.
be_agency_project_id	String	Delegatee project ID.
agency_project_id	String	Delegator project ID.
agency_domain_name	String	Delegator account name.
agency_name	String	Agency name.

Status code: 400

**Table 8** Response body parameters
Parameter	Type	Description
message	ErrorMessagebody object	Error message body.

**Table 9** ErrorMessagebody
Parameter	Type	Description
code	String	Error code.
details	String	Error message.

Status code: 500

**Table 10** Response body parameters
Parameter	Type	Description
message	ErrorMessagebody object	Error message body.

**Table 11** ErrorMessagebody
Parameter	Type	Description
code	String	Error code.
details	String	Error message.

Example Requests

Creating a cross-account log ingestion configuration

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"
  } ]
}

Example Responses

Status code: 201

The cross-account log ingestion configuration is created.

[ {
  "access_config_id" : "e929f40e-d1cf-4d59-b656-a2995cbd3229",
  "access_config_name" : "rule_lb30",
  "access_config_type" : "AGENCYACCESS",
  "agency_log_access" : {
    "agency_accessConfig_id" : "e929f40e-d1cf-4d59-b656-a2995cbd3229",
    "agency_access_type" : "AGENCYACCESS",
    "agency_domain_name" : "paas_aom_z00418070_01",
    "agency_log_access" : "rule_lb30",
    "agency_name" : "wenshufeng",
    "agency_project_id" : "a0a12b069ab4491185d7cf26c3e86ada",
    "be_agency_project_id" : "2a473356cca5487f8373be891bffc1cf",
    "log_agencyGroup_id" : "f06cbfa0-7243-4031-9380-ae0465bd3997",
    "log_agencyGroup_name" : "lts-group-sgq",
    "log_agencyStream_id" : "beb169ff-e6e9-4bea-8e77-50afdec74071",
    "log_agencyStream_name" : "lts-topic-bug",
    "log_beAgencygroup_id" : "1e749063-d9f5-474f-a537-00cad4e9a108",
    "log_beAgencygroup_name" : "lts-group-sgqECS",
    "log_beAgencystream_id" : "36ce06b0-c6bf-436d-9abe-39de86da28bb",
    "log_beAgencystream_name" : "lts-topic-ECS"
  },
  "binary_collect" : false,
  "create_time" : 1694400753168,
  "group_id" : "1e749063-d9f5-474f-a537-00cad4e9a108",
  "hostGroupNum" : 0,
  "hostNum" : 0,
  "host_group_info_list" : [ ],
  "host_rule_info" : {
    "black_paths" : [ ],
    "pathType" : "host_file",
    "paths" : [ ],
    "stderr" : false,
    "stdout" : false
  },
  "id" : "",
  "indexId" : "",
  "key" : "",
  "log_group_name" : "lts-group-sgqECS",
  "log_split" : false,
  "log_stream_id" : "36ce06b0-c6bf-436d-9abe-39de86da28bb",
  "log_stream_name" : "lts-topic-ECS",
  "pathNum" : 0,
  "project_id" : "2a473356cca5487f8373be891bffc1cf",
  "tag_list" : [ ]
} ]

Status code: 400

Failed to create cross-account log ingestion configuration.

{
  "message" : {
    "code" : "LTS.0420",
    "details" : "Agency not existed, check domain name and agency name"
  }
}

Status code: 500

Internal service error

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

Status Codes

Status Code	Description
201	The cross-account log ingestion configuration is created.
400	Failed to create cross-account log ingestion configuration.
500	Internal service error

Error Codes

See Error Codes.

Parent topic: Log Ingestion

Previous topic: Log Ingestion

Next topic: Querying Log Ingestion Configurations

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot