diff --git a/site/content/in-dev/unreleased/policy.md b/site/content/in-dev/unreleased/policy.md index bf53a63bf7e..19d5c915785 100644 --- a/site/content/in-dev/unreleased/policy.md +++ b/site/content/in-dev/unreleased/policy.md @@ -86,8 +86,7 @@ The inheritance follows an override mechanism: 2. Namespace-level policies override parent namespace and catalog policies {{< alert important >}} -Because an override completely replaces the same policy type at higher levels, -**only one instance of a given policy type can be attached to (and therefore affect) a resource**. +A resource can have at most one directly attached policy of each inheritable type. {{< /alert >}} ## Working with Policies @@ -164,35 +163,35 @@ Here is an example to find all policies that apply to a specific resource (inclu GET /polaris/v1/catalog/applicable-policies?namespace=finance%1Fquarterly&target-name=transactions ``` +The `namespace` field identifies where each policy is defined. Both policies are defined in `finance`. +The table inherits the snapshot expiry policy from that namespace and the compaction policy from the catalog. +The `content` field contains a JSON string. + **Sample response:** ```json { - "policies": [ + "applicable-policies": [ { "name": "snapshot-expiry-policy", - "type": "system.snapshot-expiry", - "appliedAt": "namespace", - "content": { - "version": "2025-02-03", - "enable": true, - "config": { - "min_snapshot_to_keep": 1, - "max_snapshot_age_days": 2, - "max_ref_age_days": 3 - } - } + "policy-type": "system.snapshot-expiry", + "version": 0, + "inheritable": true, + "inherited": true, + "namespace": [ + "finance" + ], + "content": "{\"version\":\"2025-02-03\",\"enable\":true,\"config\":{\"min_snapshot_to_keep\":1,\"max_snapshot_age_days\":2,\"max_ref_age_days\":3}}" }, { "name": "compaction-policy", - "type": "system.data-compaction", - "appliedAt": "catalog", - "content": { - "version": "2025-02-03", - "enable": true, - "config": { - "target_file_size_bytes": 134217728 - } - } + "policy-type": "system.data-compaction", + "version": 0, + "inheritable": true, + "inherited": true, + "namespace": [ + "finance" + ], + "content": "{\"version\":\"2025-02-03\",\"enable\":true,\"config\":{\"target_file_size_bytes\":134217728}}" } ] }