Associating an Instance with an LTS Log Stream

API Description

After you have associated an instance with a Log Tank Service (LTS) log stream, logs of the instance are automatically uploaded to the associated LTS log stream. You will be billed for log reporting. For details, see LTS pricing details. After a specific log stream is selected, the system creates a structuring rule of the required log type for it.

Restrictions

This operation cannot be performed on instances in the creating, deleted, or frozen state.
A maximum of 100 data records are supported.

URI

URI format
POST https://{Endpoint}/v3/{project_id}/instances/logs/lts-configs

URI example

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID of a tenant in a region. To obtain the project ID, see Obtaining a Project ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token

**Table 3** Request body parameters
Parameter	Type	Mandatory	Description
lts_configs	Array of Table 4 objects	Yes	Each item indicates an LTS configuration for the instance.

**Table 4** lts_configs
Parameter	Type	Mandatory	Description
instance_id	String	Yes	Instance ID, which can be obtained by calling the API for querying instances and details. If there are no instances available, create one by calling the API used for creating an instance.
log_type	String	Yes	LTS log type. This parameter cannot be left empty. The options are as follows: audit_log Enumerated values: audit_log
lts_group_id	String	Yes	LTS log group ID. You can obtain the value using the LTS API for querying all log groups under an account.
lts_stream_id	String	Yes	LTS log stream ID. You can obtain the value using the LTS API for querying all log streams in a specified log group.

Example request

Enabling audit log reporting to LTS for a DB instance

POST https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/logs/lts-configs

{ 
  "lts_configs" : [ { 
    "instance_id" : "520c58ba00a3497e97ce0b9604874dd6in02", 
    "log_type" : "audit_log", 
    "lts_group_id" : "ec6dc499-1a63-4229-a0c2-a2afa8bcfc95", 
    "lts_stream_id" : "cae69d2e-378b-41dd-b3c9-3ca1cd5335bc" 
  } ] 
}