--- title: Update catalog maintenance configuration --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Basin Catalog](https://developers.cloudflare.com/api/go/resources/basin_catalog) [Maintenance Configs](https://developers.cloudflare.com/api/go/resources/basin_catalog/subresources/maintenance_configs) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update catalog maintenance configuration client.BasinCatalog.MaintenanceConfigs.Update(ctx, bucketName, params) (\*[MaintenanceConfigUpdateResponse](), error) POST/accounts/{account\_id}/basin-catalog/{bucket\_name}/maintenance-configs Update the maintenance configuration for a catalog. This allows you to enable or disable compaction and adjust target file sizes for optimization. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Workers R2 Data Catalog Write` ##### ParametersExpand Collapse bucketName string Specifies the R2 bucket name. maxLength63 minLength3 [Link to this property](<#(resource)%20basin_catalog.maintenance_configs%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20bucket_name%20%3E%20(schema)>)
params MaintenanceConfigUpdateParams AccountID param.Field\[string] Path param: Use this to identify the account. Link to this property
Compaction param.Field\[MaintenanceConfigUpdateParamsCompaction]Optional Body param: Updates compaction configuration (all fields optional).
State MaintenanceConfigUpdateParamsCompactionStateOptional Specifies the state of maintenance operations. One of the following: const MaintenanceConfigUpdateParamsCompactionStateEnabled MaintenanceConfigUpdateParamsCompactionState = "enabled" Link to this property const MaintenanceConfigUpdateParamsCompactionStateDisabled MaintenanceConfigUpdateParamsCompactionState = "disabled" Link to this property
Link to this property
TargetSizeMB MaintenanceConfigUpdateParamsCompactionTargetSizeMBOptional Sets the target file size for compaction in megabytes. Defaults to “128”. One of the following: const MaintenanceConfigUpdateParamsCompactionTargetSizeMB64 MaintenanceConfigUpdateParamsCompactionTargetSizeMB = "64" Link to this property const MaintenanceConfigUpdateParamsCompactionTargetSizeMB128 MaintenanceConfigUpdateParamsCompactionTargetSizeMB = "128" Link to this property const MaintenanceConfigUpdateParamsCompactionTargetSizeMB256 MaintenanceConfigUpdateParamsCompactionTargetSizeMB = "256" Link to this property const MaintenanceConfigUpdateParamsCompactionTargetSizeMB512 MaintenanceConfigUpdateParamsCompactionTargetSizeMB = "512" Link to this property
Link to this property
Link to this property
SnapshotExpiration param.Field\[MaintenanceConfigUpdateParamsSnapshotExpiration]Optional Body param: Updates snapshot expiration configuration (all fields optional). MaxSnapshotAge stringOptional Updates the maximum age for snapshots optionally. Link to this property MinSnapshotsToKeep int64Optional Updates the minimum number of snapshots to retain optionally. formatint64 minimum1 Link to this property
State MaintenanceConfigUpdateParamsSnapshotExpirationStateOptional Specifies the state of maintenance operations. One of the following: const MaintenanceConfigUpdateParamsSnapshotExpirationStateEnabled MaintenanceConfigUpdateParamsSnapshotExpirationState = "enabled" Link to this property const MaintenanceConfigUpdateParamsSnapshotExpirationStateDisabled MaintenanceConfigUpdateParamsSnapshotExpirationState = "disabled" Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20basin_catalog.maintenance_configs%20%3E%20(method)%20update%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type MaintenanceConfigUpdateResponse struct{…} Configures maintenance for the catalog.
Compaction MaintenanceConfigUpdateResponseCompactionOptional Configures compaction for catalog maintenance.
State MaintenanceConfigUpdateResponseCompactionState Specifies the state of maintenance operations. One of the following: const MaintenanceConfigUpdateResponseCompactionStateEnabled MaintenanceConfigUpdateResponseCompactionState = "enabled" Link to this property const MaintenanceConfigUpdateResponseCompactionStateDisabled MaintenanceConfigUpdateResponseCompactionState = "disabled" Link to this property
Link to this property
TargetSizeMB MaintenanceConfigUpdateResponseCompactionTargetSizeMB Sets the target file size for compaction in megabytes. Defaults to “128”. One of the following: const MaintenanceConfigUpdateResponseCompactionTargetSizeMB64 MaintenanceConfigUpdateResponseCompactionTargetSizeMB = "64" Link to this property const MaintenanceConfigUpdateResponseCompactionTargetSizeMB128 MaintenanceConfigUpdateResponseCompactionTargetSizeMB = "128" Link to this property const MaintenanceConfigUpdateResponseCompactionTargetSizeMB256 MaintenanceConfigUpdateResponseCompactionTargetSizeMB = "256" Link to this property const MaintenanceConfigUpdateResponseCompactionTargetSizeMB512 MaintenanceConfigUpdateResponseCompactionTargetSizeMB = "512" Link to this property
Link to this property
Link to this property Interval stringOptional Scheduling interval between normal table maintenance runs. Link to this property
SnapshotExpiration MaintenanceConfigUpdateResponseSnapshotExpirationOptional Configures snapshot expiration settings. MaxSnapshotAge string Specifies the maximum age for snapshots. The system deletes snapshots older than this age. Format: where unit is d (days), h (hours), m (minutes), or s (seconds). Examples: “7d” (7 days), “48h” (48 hours), “2880m” (2,880 minutes). Defaults to “7d”. Link to this property MinSnapshotsToKeep int64 Specifies the minimum number of snapshots to retain. Defaults to 100. formatint64 minimum1 Link to this property
State MaintenanceConfigUpdateResponseSnapshotExpirationState Specifies the state of maintenance operations. One of the following: const MaintenanceConfigUpdateResponseSnapshotExpirationStateEnabled MaintenanceConfigUpdateResponseSnapshotExpirationState = "enabled" Link to this property const MaintenanceConfigUpdateResponseSnapshotExpirationStateDisabled MaintenanceConfigUpdateResponseSnapshotExpirationState = "disabled" Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20basin_catalog.maintenance_configs%20%3E%20(model)%20MaintenanceConfigUpdateResponse%20%3E%20(schema)>) ### Update catalog maintenance configuration Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/basin_catalog" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) maintenanceConfig, err := client.BasinCatalog.MaintenanceConfigs.Update( context.TODO(), "my-data-bucket", basin_catalog.MaintenanceConfigUpdateParams{ AccountID: cloudflare.F("0123456789abcdef0123456789abcdef"), Compaction: cloudflare.F(basin_catalog.MaintenanceConfigUpdateParamsCompaction{ State: cloudflare.F(basin_catalog.MaintenanceConfigUpdateParamsCompactionStateEnabled), TargetSizeMB: cloudflare.F(basin_catalog.MaintenanceConfigUpdateParamsCompactionTargetSizeMB256), }), SnapshotExpiration: cloudflare.F(basin_catalog.MaintenanceConfigUpdateParamsSnapshotExpiration{ MaxSnapshotAge: cloudflare.F("14d"), MinSnapshotsToKeep: cloudflare.F(int64(5)), State: cloudflare.F(basin_catalog.MaintenanceConfigUpdateParamsSnapshotExpirationStateEnabled), }), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", maintenanceConfig.Compaction) } ``` 200 example ``` { "errors": [], "messages": [], "result": { "compaction": { "state": "enabled", "target_size_mb": "256" }, "snapshot_expiration": { "max_snapshot_age": "14d", "min_snapshots_to_keep": 5, "state": "enabled" } }, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [], "messages": [], "result": { "compaction": { "state": "enabled", "target_size_mb": "256" }, "snapshot_expiration": { "max_snapshot_age": "14d", "min_snapshots_to_keep": 5, "state": "enabled" } }, "success": true } ```