All Products
Search
Document Center

EventBridge:GetLumaTable

Last Updated:Sep 15, 2026

Retrieves the details of a specified event table bound to a Luma Agent, including column definitions and the data retention policy. Only event tables that are already bound to the Agent can be queried.

Operation description

Retrieves the details of a specified event table bound to a Luma Agent, including column definitions and the data retention policy. Only event tables that are already bound to the Agent can be queried.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

AgentName

string

Yes

The name of the Agent.

my_agent

Catalog

string

Yes

The name of the data catalog bound to the Agent. You can call ListLumaCatalogs to obtain the catalog name.

my_catalog

Namespace

string

Yes

The name of the namespace bound to the Agent. You can call ListLumaNamespaces to obtain the namespace name.

my_namespace

Name

string

Yes

The name of the event table bound to the Agent. You can call ListLumaTables to obtain the event table name.

my_table

Response elements

Element

Type

Description

Example

object

Message

string

The message returned by the operation. The value is Operation success if the call succeeds, or a specific error description if the call fails.

Operation success

RequestId

string

The unique ID of the request. You can use this ID for troubleshooting and when you submit a ticket.

34AD682D-5B91-5773-8132-AA38C130****

Data LumaTable

The details of the event table bound to the Agent, including column definitions.

Code

string

The response code. A value of Success indicates that the call succeeds. If the call fails, a specific error code is returned.

Success

Success

boolean

Indicates whether the call is successful. A value of true indicates that the call succeeds.

true

Examples

Success response

JSON format

{
  "Message": "Operation success",
  "RequestId": "34AD682D-5B91-5773-8132-AA38C130****",
  "Data": {
    "Catalog": "my_catalog",
    "Columns": [
      {
        "Comment": "Primary key ID",
        "Name": "id",
        "Type": "bigint"
      }
    ],
    "Comment": "Test event table",
    "CreateTime": 1717948800000,
    "Name": "my_table",
    "Namespace": "my_namespace",
    "RetentionPolicy": {
      "ColdTTL": 30,
      "HotTTL": 7
    },
    "UpdateTime": 1717948800000
  },
  "Code": "Success",
  "Success": true
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter The specified parameter is invalid
403 ServiceNotEnable Service not enable
404 AgentNotFound Agent not found
404 ResourceNotFound The specified resource is not bound to the agent

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.