Skip to content

ezgh obs datasets create

Create a dataset for an environment, before it sends data.

Updated View as Markdown
ezgh obs datasets create <environment> [--name n] [--retention-class c] [--placement hot|cold] [--allow-cold-ingest] [flags]

Create the dataset for an environment. Ingest creates it anyway the first time the environment sends a record (with the default retention class, 7d-30d, and hot placement); creating it first lets you choose those before data arrives. The environment is lowercased and trimmed, as ingest does with ezgh.metadata.environment, and can’t change later. An environment that already has a dataset is refused (environment_taken).

Part of ezgh obs datasets.

Examples

ezgh obs datasets create production --retention-class 14d-365d
ezgh obs datasets create archive --retention-class cold-365d --placement cold --allow-cold-ingest

Flags

Flag Type Default Description
--allow-cold-ingest boolean let senders write straight to cold storage (x-ezgh-placement: cold)
--name string a display name (default: the environment)
--placement string where records go unless a sender asks otherwise: hot (searched fastest) or cold (default: hot)
--retention-class string how long data is kept; see ezgh obs retention-classes list (default: 7d-30d)

This command also takes the global flags.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close