# eb-catalog

Part of **EB**

# EventBridge Event Processing Console Guide

## Operations Overview

| Operation | Console Entry | Prerequisites | Description |
|----------|---------------|---------------|-------------|
| Create Catalog | Console > Events Warehouse > Data Catalog | Log on to the EventBridge console | Create a new top-level catalog container for organizing event data |
| Edit Catalog Description | Console > Events Warehouse > Data Catalog > [Catalog Name] | Catalog already exists | Update the descriptive text for an existing catalog |
| Delete Catalog | Console > Events Warehouse > Data Catalog > [Catalog Name] | All namespaces and event tables in the catalog must be deleted first | Remove an empty catalog from the system |
| Create Namespace | Console > Events Warehouse > Data Catalog > [Catalog Name] | Catalog already exists | Create a namespace within a catalog to group related event tables |
| Edit Namespace Description | Console > Events Warehouse > Data Catalog > [Catalog Name] > [Namespace Name] | Namespace already exists | Update the descriptive text for an existing namespace |
| Delete Namespace | Console > Events Warehouse > Data Catalog > [Catalog Name] > [Namespace Name] | All event tables in the namespace must be deleted first | Remove an empty namespace from its parent catalog |
| Create Event Table | Console > Events Warehouse > Data Catalog > [Catalog Name] > [Namespace Name] | Namespace already exists | Define a new event table with storage, retention, and schema settings |
| Delete Event Table | Console > Events Warehouse > Data Catalog > [Catalog Name] > [Namespace Name] | Event table exists in the list | Permanently remove an event table and its stored data |

## Operation Steps

### Create Catalog

**Navigation**: Console > Events Warehouse > Data Catalog

**Prerequisites**:
- Log on to the EventBridge console

1. Click **Create Catalog**  
   - Element: **Create Catalog** (button) — located at the top of the Data Catalog page  
   - Notes: A dialog box titled "Create Catalog" appears

2. Configure the **Name** and **Description** parameters  
   - Element: **Name** (text_input) — in the Create Catalog dialog box  
   - Notes: Name must be 1–64 characters, start with a letter, and support letters, numbers, and underscores (_)

3. Click **OK** to create the catalog  
   - Element: **OK** (button) — at the bottom of the dialog box  
   - Notes: The catalog appears in the left navigation tree after creation

### Edit Catalog Description

**Navigation**: Console > Events Warehouse > Data Catalog > [Catalog Name]

**Prerequisites**:
- Catalog already exists

1. Click the target catalog to open its details page  
   - Element: **target catalog** (link) — in the left navigation tree  

2. Click **Edit Description**  
   - Element: **Edit Description** (button) — in the Description section  

3. Modify the description and save changes  
   - Element: **Save** (button) — at the bottom of the edit form  

### Delete Catalog

**Navigation**: Console > Events Warehouse > Data Catalog > [Catalog Name]

**Prerequisites**:
- All namespaces and event tables within the catalog must be deleted first

1. Click **Delete**  
   - Element: **Delete** (button) — in the upper-right corner of the catalog details page  
   - Notes: A confirmation dialog appears; deletion is irreversible

### Create Namespace

**Navigation**: Console > Events Warehouse > Data Catalog > [Catalog Name]

**Prerequisites**:
- Catalog already exists

1. Click the target catalog to open its details page  
   - Element: **target catalog** (link) — in the left navigation tree  

2. Click **Create Namespace**  
   - Element: **Create Namespace** (button) — at the top of the catalog details page  
   - Notes: A dialog box titled "Create Namespace" appears

3. Configure the **Namespace Name** and **Description**  
   - Element: **Namespace Name** (text_input) — in the Create Namespace dialog box  
   - Notes: Name must be 1–64 characters, start with a letter, and support letters, numbers, and underscores (_)

4. Click **OK** to create the namespace  
   - Element: **OK** (button) — at the bottom of the dialog box  

### Edit Namespace Description

**Navigation**: Console > Events Warehouse > Data Catalog > [Catalog Name] > [Namespace Name]

**Prerequisites**:
- Namespace already exists

1. Click the target namespace to open its details page  
   - Element: **target namespace** (link) — in the left navigation tree  

2. Click **Edit Description**  
   - Element: **Edit Description** (button) — in the Description section  

3. Modify the description and save changes  
   - Element: **Save** (button) — at the bottom of the edit form  

### Delete Namespace

**Navigation**: Console > Events Warehouse > Data Catalog > [Catalog Name] > [Namespace Name]

**Prerequisites**:
- All event tables within the namespace must be deleted first

1. Click **Delete**  
   - Element: **Delete** (button) — in the upper-right corner of the namespace details page  
   - Notes: A confirmation dialog appears; deletion is irreversible

### Create Event Table

**Navigation**: Console > Events Warehouse > Data Catalog > [Catalog Name] > [Namespace Name]

**Prerequisites**:
- Namespace already exists

1. Expand the target catalog and click the target namespace to open its details page  
   - Element: **target namespace** (link) — in the left navigation tree  

2. Click **Create Event Table**  
   - Element: **Create Event Table** (button) — at the top of the namespace details page  
   - Notes: A configuration dialog appears

3. Configure **Event Table Name** and **Description**  
   - Element: **Event Table Name** (text_input) — in the Create Event Table dialog box  
   - Notes: Name must be 1–48 characters, contain only lowercase letters, numbers, and hyphens (-), and cannot start with a hyphen

4. Set **Data Retention Period** to Limited days or Permanent retention  
   - Element: **Data Retention Period** (dropdown) — in the Storage configuration section  

5. Enable **Data tiering** if needed and configure Hot storage data retention  
   - Element: **Data tiering** (toggle) — in the Storage configuration section  
   - Notes: If enabled, set hot storage retention period; IA storage period is automatically calculated

6. Choose schema method: **Import schema** or **Custom registration**  
   - Element: **Import schema** (radio) — in the Metadata configuration section  
   - Notes: Import schema: select from existing schema group. Custom registration: manually define columns using Add Metadata button

7. Click **OK** to create the event table  
   - Element: **OK** (button) — at the bottom of the dialog box  

### Delete Event Table

**Navigation**: Console > Events Warehouse > Data Catalog > [Catalog Name] > [Namespace Name]

**Prerequisites**:
- Event table exists in the list

1. Find the target event table in the list  
   - Element: **target event table** (link) — in the event table list  

2. Click **Delete** in the Operations column  
   - Element: **Delete** (link) — in the Operations column  

3. Click **OK** in the confirmation dialog  
   - Element: **OK** (button) — in the confirmation dialog  
   - Notes: Deletion is permanent and cannot be undone

## Form Fields

| Parameter | Type | Required | Options/Values | Description |
|-----------|------|----------|----------------|-------------|
| Name | text_input | Yes | — | The name of the catalog. Must be 1–64 characters, start with a letter, and can contain letters, numbers, and underscores (_). |
| Description | text_input | No | — | The description of the catalog. |
| Namespace Name | text_input | Yes | — | The name of the namespace. Must be 1–64 characters, start with a letter, and can contain letters, numbers, and underscores (_). |
| Description | text_input | No | — | The description of the namespace. |
| Event Table Name | text_input | Yes | — | The name of the event table. Must be 1–48 characters, contain only lowercase letters, numbers, and hyphens (-), and cannot start with a hyphen. |
| Description | text_input | No | — | The description of the event table. |
| Data retention period | dropdown | Yes | Limited days, Permanent retention | The duration for which event data is stored. Select Limited days (enter specific days) or Permanent retention. |
| Data tiering | toggle | No | enabled/disabled | Switch for tiered data storage (hot + IA). Disabled by default. |
| Hot storage data retention | number_input | No | — | Number of days data is retained in hot storage before moving to IA storage. Required only if Data tiering is enabled. |

## FAQ

Q: Where do I find the Data Catalog feature in the EventBridge console?  
A: Navigate to Console > Events Warehouse > Data Catalog. Ensure you are logged into the EventBridge console first.

Q: Can I rename a catalog, namespace, or event table after creation?  
A: No. Names cannot be changed after creation. You must delete and recreate the resource with the new name (after removing child resources as needed).

Q: What happens if I try to delete a catalog that still contains namespaces?  
A: The **Delete** button will either be disabled or trigger an error message stating that all child namespaces and event tables must be deleted first.

Q: Is the schema editable after an event table is created?  
A: Based on the provided documentation, schema modification after creation is not described. It is recommended to verify schema requirements before finalizing event table creation.

Q: Do I need special permissions to manage data catalogs?  
A: Yes. You need appropriate RAM permissions for EventBridge Event Store operations, such as `eventbridge:CreateCatalog`, `eventbridge:UpdateCatalog`, and `eventbridge:DeleteCatalog`.

## Pricing & Billing

### Billing Model  
The event store is currently free during public preview. Billing will begin after the preview period ends, with advance announcements to inform users of the official billing start date.

### Billing Notes  
No specific pricing details, free tier allowances, or quota limits are documented at this time. Users should monitor official communications for updates on billing commencement.