upsert#

dpsctl policy bundle upsert Usage Guide#

Create or replace one named, typed policy bundle from a JSON or YAML file.

Usage#

dpsctl policy bundle upsert <file>

<file> must contain one policy bundle. Use - to read from standard input.

Flags#

Includes global dpsctl options.

   --input-format string  Input format: json or yaml; inferred from file extension and required for "-"
   --help, -h             show help

Examples#

Upsert a YAML Bundle#

Use the downloadable site-balanced.yaml example from Power Policies:

dpsctl policy bundle upsert site-balanced.yaml

Read a Bundle from Standard Input#

dpsctl policy bundle upsert --input-format yaml - < site-balanced.yaml

Notes#

  • The input is limited to 4 MiB.

  • File extensions .json, .yaml, and .yml are detected automatically.

  • The command rejects an attempt to replace a bundle that has bindings.

  • Upserting a bundle stores its definition. It does not select or apply the bundle. Refer to Power Policies for the selection workflow.