--- title: Namespaces --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [R2 Data Catalog](https://developers.cloudflare.com/api/python/resources/r2_data_catalog) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Namespaces ##### [List namespaces in catalog](https://developers.cloudflare.com/api/python/resources/r2_data_catalog/subresources/namespaces/methods/list) Deprecated r2\_data\_catalog.namespaces.list(strbucket\_name, NamespaceListParams\*\*kwargs) -> [NamespaceListResponse]() GET/accounts/{account\_id}/r2-catalog/{bucket\_name}/namespaces ##### ModelsExpand Collapse
class NamespaceListResponse: … Contains the list of namespaces with optional pagination. namespaces: List\[List\[str]] Lists namespaces in the catalog. Link to this property
details: Optional\[List\[Detail]] Contains detailed metadata for each namespace when return\_details is true. Each object includes the namespace, UUID, and timestamps. namespace: List\[str] Specifies the hierarchical namespace parts as an array of strings. For example, \[“bronze”, “analytics”] represents the namespace “bronze.analytics”. Link to this property namespace\_uuid: str Contains the UUID that persists across renames. formatuuid Link to this property created\_at: Optional\[datetime] Indicates the creation timestamp in ISO 8601 format. formatdate-time Link to this property updated\_at: Optional\[datetime] Shows the last update timestamp in ISO 8601 format. Null if never updated. formatdate-time Link to this property
Link to this property namespace\_uuids: Optional\[List\[str]] Contains UUIDs for each namespace when return\_uuids is true. The order corresponds to the namespaces array. Link to this property next\_page\_token: Optional\[str] Use this opaque token to fetch the next page of results. A null or absent value indicates the last page. Link to this property
[Link to this property](<#(resource)%20r2_data_catalog.namespaces%20%3E%20(model)%20namespace_list_response%20%3E%20(schema)>) #### NamespacesTables ##### [List tables in namespace](https://developers.cloudflare.com/api/python/resources/r2_data_catalog/subresources/namespaces/subresources/tables/methods/list) Deprecated r2\_data\_catalog.namespaces.tables.list(strnamespace, TableListParams\*\*kwargs) -> [TableListResponse]() GET/accounts/{account\_id}/r2-catalog/{bucket\_name}/namespaces/{namespace}/tables ##### ModelsExpand Collapse
class TableListResponse: … Contains the list of tables with optional pagination.
identifiers: List\[Identifier] Lists tables in the namespace. name: str Specifies the table name. Link to this property namespace: List\[str] Specifies the hierarchical namespace parts as an array of strings. For example, \[“bronze”, “analytics”] represents the namespace “bronze.analytics”. Link to this property
Link to this property
details: Optional\[List\[Detail]] Contains detailed metadata for each table when return\_details is true. Each object includes identifier, UUID, timestamps, and locations.
identifier: DetailIdentifier Specifies a unique table identifier within a catalog. name: str Specifies the table name. Link to this property namespace: List\[str] Specifies the hierarchical namespace parts as an array of strings. For example, \[“bronze”, “analytics”] represents the namespace “bronze.analytics”. Link to this property
Link to this property table\_uuid: str Contains the UUID that persists across renames. formatuuid Link to this property created\_at: Optional\[datetime] Indicates the creation timestamp in ISO 8601 format. formatdate-time Link to this property location: Optional\[str] Specifies the base S3 URI for table storage location. Link to this property metadata\_location: Optional\[str] Contains the S3 URI to table metadata file. Null for staged tables. Link to this property updated\_at: Optional\[datetime] Shows the last update timestamp in ISO 8601 format. Null if never updated. formatdate-time Link to this property
Link to this property next\_page\_token: Optional\[str] Use this opaque token to fetch the next page of results. A null or absent value indicates the last page. Link to this property table\_uuids: Optional\[List\[str]] Contains UUIDs for each table when return\_uuids is true. The order corresponds to the identifiers array. Link to this property
[Link to this property](<#(resource)%20r2_data_catalog.namespaces.tables%20%3E%20(model)%20table_list_response%20%3E%20(schema)>) #### NamespacesTablesMaintenance Configs ##### [Get table maintenance configuration](https://developers.cloudflare.com/api/python/resources/r2_data_catalog/subresources/namespaces/subresources/tables/subresources/maintenance_configs/methods/get) Deprecated r2\_data\_catalog.namespaces.tables.maintenance\_configs.get(strtable\_name, MaintenanceConfigGetParams\*\*kwargs) -> [MaintenanceConfigGetResponse]() GET/accounts/{account\_id}/r2-catalog/{bucket\_name}/namespaces/{namespace}/tables/{table\_name}/maintenance-configs ##### [Update table maintenance configuration](https://developers.cloudflare.com/api/python/resources/r2_data_catalog/subresources/namespaces/subresources/tables/subresources/maintenance_configs/methods/update) Deprecated r2\_data\_catalog.namespaces.tables.maintenance\_configs.update(strtable\_name, MaintenanceConfigUpdateParams\*\*kwargs) -> [MaintenanceConfigUpdateResponse]() POST/accounts/{account\_id}/r2-catalog/{bucket\_name}/namespaces/{namespace}/tables/{table\_name}/maintenance-configs ##### ModelsExpand Collapse
class MaintenanceConfigGetResponse: … Contains table maintenance configuration.
maintenance\_config: MaintenanceConfig Configures maintenance for the table.
compaction: Optional\[MaintenanceConfigCompaction] Configures compaction settings for table optimization.
state: Literal\["enabled", "disabled"] Specifies the state of maintenance operations. One of the following: "enabled" Link to this property "disabled" Link to this property
Link to this property
target\_size\_mb: Literal\["64", "128", "256", "512"] Sets the target file size for compaction in megabytes. Defaults to “128”. One of the following: "64" Link to this property "128" Link to this property "256" Link to this property "512" Link to this property
Link to this property next\_eligible\_at: Optional\[datetime] Earliest time when the scheduler can claim this operation. Null when disabled. formatdate-time Link to this property
Link to this property interval: Optional\[str] Scheduling interval between normal table maintenance runs. Link to this property
snapshot\_expiration: Optional\[MaintenanceConfigSnapshotExpiration] max\_snapshot\_age: str Specifies the maximum age for snapshots. Link to this property min\_snapshots\_to\_keep: int Specifies the minimum number of snapshots to retain. Defaults to 100. formatint64 minimum1 Link to this property
state: Literal\["enabled", "disabled"] Specifies the state of maintenance operations. One of the following: "enabled" Link to this property "disabled" Link to this property
Link to this property next\_eligible\_at: Optional\[datetime] Earliest time when the scheduler can claim this operation. Null when disabled. formatdate-time Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20r2_data_catalog.namespaces.tables.maintenance_configs%20%3E%20(model)%20maintenance_config_get_response%20%3E%20(schema)>)
class MaintenanceConfigUpdateResponse: … Configures maintenance for the table.
compaction: Optional\[Compaction] Configures compaction settings for table optimization.
state: Literal\["enabled", "disabled"] Specifies the state of maintenance operations. One of the following: "enabled" Link to this property "disabled" Link to this property
Link to this property
target\_size\_mb: Literal\["64", "128", "256", "512"] Sets the target file size for compaction in megabytes. Defaults to “128”. One of the following: "64" Link to this property "128" Link to this property "256" Link to this property "512" Link to this property
Link to this property next\_eligible\_at: Optional\[datetime] Earliest time when the scheduler can claim this operation. Null when disabled. formatdate-time Link to this property
Link to this property interval: Optional\[str] Scheduling interval between normal table maintenance runs. Link to this property
snapshot\_expiration: Optional\[SnapshotExpiration] max\_snapshot\_age: str Specifies the maximum age for snapshots. Link to this property min\_snapshots\_to\_keep: int Specifies the minimum number of snapshots to retain. Defaults to 100. formatint64 minimum1 Link to this property
state: Literal\["enabled", "disabled"] Specifies the state of maintenance operations. One of the following: "enabled" Link to this property "disabled" Link to this property
Link to this property next\_eligible\_at: Optional\[datetime] Earliest time when the scheduler can claim this operation. Null when disabled. formatdate-time Link to this property
Link to this property
[Link to this property](<#(resource)%20r2_data_catalog.namespaces.tables.maintenance_configs%20%3E%20(model)%20maintenance_config_update_response%20%3E%20(schema)>)