Help Center/ Relational Database Service/ API Reference/ API v3 (Recommended)/ Log Information Queries/ Querying the Configurations for Ingesting Instance Logs to LTS (RDS for MySQL)
Updated on 2025-09-24 GMT+08:00

Querying the Configurations for Ingesting Instance Logs to LTS (RDS for MySQL)

Function

This API is used to query the configurations for ingesting instance logs to LTS.

URI

  • URI format

    GET /v3/{project_id}/{engine}/instances/logs/lts-configs

  • Parameter description
    Table 1 Parameters

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Definition

    Project ID of a tenant in a region.

    To obtain the value, see Obtaining a Project ID.

    Constraints

    N/A

    Range

    N/A

    Default Value

    N/A

    engine

    Yes

    Definition

    Instance engine to be queried.

    Constraints

    Only the MySQL engine is supported.

    Range

    mysql

    Default Value

    N/A

    enterprise_project_id

    No

    Definition

    Enterprise project ID.

    Constraints

    N/A

    Range

    N/A

    Default Value

    N/A

    instance_id

    No

    Definition

    Instance ID.

    Constraints

    N/A

    Range

    N/A

    Default Value

    N/A

    instance_name

    No

    Definition

    Instance name.

    Constraints

    N/A

    Range

    N/A

    Default Value

    N/A

    sort

    No

    Definition

    Sorting.

    Constraints

    N/A

    Range

    N/A

    Default Value

    N/A

    instance_status

    No

    Definition

    Instance status.

    Constraints

    N/A

    Range

    N/A

    Default Value

    N/A

    offset

    No

    Definition

    Index offset. The query starts from the next piece of data indexed by this parameter.

    Constraints

    N/A

    Range

    The value must be a non-negative number.

    Default Value

    0: The query starts from the first data record.

    limit

    No

    Definition

    Number of records on each page.

    Constraints

    N/A

    Range

    1–100

    Default Value

    10

Request

None

Example Request

GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/mysql/instances/logs/lts-configs

Response

  • Normal response
    Table 2 Parameters

    Parameter

    Type

    Description

    instance_lts_configs

    Array of objects

    Definition

    List of LTS log configurations. For details, see Table 3.

    total_count

    int

    Definition

    Total records.

    Range

    N/A

    Table 3 instance_lts_configs field data structure description

    Parameter

    Type

    Description

    lts_configs

    Array of objects

    Definition

    LTS configurations.

    Range

    N/A

    instance

    String

    Definition

    Instance details.

    Range

    N/A

    id

    String

    Definition

    Instance ID.

    Range

    N/A

    name

    String

    Definition

    Instance name.

    Range

    N/A

    engine_name

    String

    Definition

    DB engine name.

    Range

    N/A

    engine_version

    String

    Definition

    DB engine version.

    Range

    N/A

    status

    String

    Definition

    Instance status.

    Range

    N/A

    enterprise_project_id

    String

    Definition

    Enterprise project ID.

    Range

    N/A

    actions

    Array of objects

    Definition

    Ongoing actions.

    Range

    N/A

  • Example normal response
    {
        "instance_lts_configs": [
            {
                "lts_configs": [],
                "instance": {
                    "id": "982b8d01b15640b0aa02a2b9e0f89e60in01",
                    "name": "rds-cluster-lc",
                    "engine_name": "mysql",
                    "engine_version": "5.7.43",
                    "status": "creating",
                    "enterprise_project_id": "0",
                    "actions": ["OPEN_AUDIT_LOG"]
                }
            },
            {
                "lts_configs": [],
                "instance": {
                    "id": "718c99c761cf425bb12836acee2ee96bin01",
                    "name": "AUTO-GENERATED-INSTANCE-80-HA-CLOUDSSD",
                    "engine_name": "mysql",
                    "engine_version": "8.0.28",
                    "status": "creating",
                    "enterprise_project_id": "0",
                    "actions": []
                }
            },
            {
                "lts_configs": [],
                "instance": {
                    "id": "8474c4f9180f4dc29ab031549f699c15in01",
                    "name": "rds-1464",
                    "engine_name": "mysql",
                    "engine_version": "5.6.51",
                    "status": "creating",
                    "enterprise_project_id": "0",
                    "actions": []
                }
            },
            {
                "lts_configs": [],
                "instance": {
                    "id": "11e48d5de3bc4b24977b1c786a77dffdin01",
                    "name": "mysql_57_cluster_2u4g_1_XUHjS77NByzm6i9SyAsUSu",
                    "engine_name": "mysql",
                    "engine_version": "5.7.43",
                    "status": "normal",
                    "enterprise_project_id": "0",
                    "actions": []
                }
            },
            {
                "lts_configs": [],
                "instance": {
                    "id": "1d944c00cbdb4a8a8697f8d3e9c50280in01",
                    "name": "mxk-rds-replica",
                    "engine_name": "mysql",
                    "engine_version": "5.7.43",
                    "status": "normal",
                    "enterprise_project_id": "0",
                    "actions": []
                }
            },
            {
                "lts_configs": [],
                "instance": {
                    "id": "8831ab590f7447cc81961bc74ccbe6cfin01",
                    "name": "AUTO-GENERATED-INSTANCE-57-HA-CLOUDSSD",
                    "engine_name": "mysql",
                    "engine_version": "5.7.43",
                    "status": "normal",
                    "enterprise_project_id": "0",
                    "actions": []
                }
            },
            {
                "lts_configs": [],
                "instance": {
                    "id": "8c2e52430bdd4b118b9d84bb5906cab4in01",
                    "name": "mysql_57_cluster_2u4g_1_Bv3Yzor6oxF5iyWAmag4Rk",
                    "engine_name": "mysql",
                    "engine_version": "5.7.43",
                    "status": "normal",
                    "enterprise_project_id": "0",
                    "actions": [
                        "RESIZE_FLAVOR"
                    ]
                }
            },
            {
                "lts_configs": [],
                "instance": {
                    "id": "280540a1029e43cf9c20383b6a280e4fin01",
                    "name": "AUTO-GENERATED-INSTANCE-80-HA-CLOUDSSD",
                    "engine_name": "mysql",
                    "engine_version": "8.0.28",
                    "status": "normal",
                    "enterprise_project_id": "0",
                    "actions": []
                }
            },
            {
                "lts_configs": [],
                "instance": {
                    "id": "ce44d253fb5743628a3cb2d830d2a675in01",
                    "name": "rds-d5b2",
                    "engine_name": "mysql",
                    "engine_version": "8.0.28",
                    "status": "normal",
                    "enterprise_project_id": "0",
                    "actions": []
                }
            },
            {
                "lts_configs": [],
                "instance": {
                    "id": "7ebca04957b44c04afbaff2702057d45in01",
                    "name": "rds-bb76-mdl",
                    "engine_name": "mysql",
                    "engine_version": "5.7.43",
                    "status": "normal",
                    "enterprise_project_id": "0",
                    "actions": []
                }
            }
        ],
        "total_count": 14
    }
  • Abnormal response

    For details, see Abnormal Request Results.

Status Code

Error Code

For details, see Error Codes.