Skip to main content

Update Host Compliance Policy

PUT 
/api/v33.02/policies/compliance/host
x-prisma-cloud-target-env: {"permission":"policyHosts"}

Updates the compliance policy for hosts protected by Defender. All rules in the policy are updated in a single shot.

This endpoint maps to the policy table in Defend > Compliance > Hosts > Running hosts in the Console UI.

To construct an effective rule for this policy, specify at least one "check" and one effect value. See How to Construct a Compliance Policy for more info.

For a full list of checks, go to Defend > Compliance > Hosts > Running Hosts in the Console UI and create a new rule. All prebuilt checks and their IDs are shown under Compliance actions.

cURL Request​

Refer tp the following example cURL command that overwrites all rules in your current policy with a new policy that has a single rule:

$ curl 'https://<CONSOLE>/api/v<VERSION>/policies/compliance/host' \
  -k \
  -X PUT \
  -u <USER> \
  -H 'Content-Type: application/json' \
  -d \
'{
   "rules":[
      {
         "name":"my-rule",
         "effect":"alert",
         "collections":[
            {
               "name":"All"
            }
         ],
         "condition":{
            "vulnerabilities":[
               {
                  "id":6151,
                  "block":false
               }
            ]
         }
      }
   ],
   "policyType":"hostCompliance"
}'

Note: No response will be returned upon successful execution.

Request​

Responses​

OK