Override Unscoped Policy Configuration Properties

If a policy referenced in a policy set contains unscoped overridable properties, you can override the existing value of the property for that policy set using the Policy Set REST API.

The cURL command examples use the URL structure:
http(s)://host:port/wsm-pmrest/v2/policyset/{name}/configoverride

The following use case shows you how to:

  • Add unscoped configuration overrides

  • View unscoped configuration overrides

  • Delete unscoped configuration overrides

To manage the policy set:

  1. Specify the headers on the cURL command line:
    -H Accept:application/json
  2. Add two overriding configuration properties keystore.sig.csf.key and keystore.enc.csf.key keystores to myPolicySet1 policy set by running the following command:
    curl -i -X POST -u username:password -H Content-type:application/json http://host:port/wsm-pmrest/v2/policyset/{name}/configoverride

    Example

    curl -i -X POST -u Smith:Password -H Content-type:application/json http://myhost:7001/wsm-pmrest/v2/policyset/myPolicySet1/configoverride

    See Set Unscoped ConfigOverride(s).

    The following shows an example of the request body.

    [
      {
        "name": "keystore.sig.csf.key",
        "value": "myKey1"
      },
      {
        "name": "keystore.enc.csf.key",
        "value": "myKey2"
      }
    ]

    The following shows an example of the response indicating the request succeeded.

    {
      "STATUSCODE": "20021",
      "MESSAGE": "Configoverride [keystore.enc.csf.key, keystore.sig.csf.key] are successfully added."
    }
  3. View the configuration properties for a policy set by running the following command:
    curl -i -X GET -u username:password -H Content-type:application/json http://host:port/wsm-pmrest/v2/policyset/{name}/configoverride

    Example

    curl -i -X GET -u Smith:Password -H Content-type:application/json http://myhost:7001/wsm-pmrest/v2/policyset/myPolicySet1/configoverride

    See Get all Unscoped ConfigOverride(s).

    The following shows an example of the response body:

    [
      {
        "name": "keystore.sig.csf.key",
        "value": "myKey1"
      },
      {
        "name": "keystore.enc.csf.key",
        "value": "myKey2"
      }
    ]
  4. Optionally, delete a specific configuration override from the policy set myPolicySet1 by running the following command:
    curl -i -X DELETE -u username:password -H Content-type:application/json http://host:port/wsm-pmrest/v2/policyset/{name}/configoverride/{propname}

    Example

    curl -i -X DELETE -u Smith:Password -H Content-type:application/json http://myhost:7001/wsm-pmrest/v2/myPolicySet1/keystore.enc.csf.key

    See Delete one Unscoped ConfigOverride.

    The following shows an example of the response indicating the request succeeded.

    {
      "STATUSCODE": "20024",
      "MESSAGE": "Configoverride [keystore.enc.csf.key] are successfully deleted."
    }
  5. Optionally, delete all the configuration override properties for policy set myPolicySet1 by running the following command:
    curl -i -X DELETE -u username:password -H Content-type:application/json http://host:port/wsm-pmrest/v2/policyset/{name}/configoverride

    Example

    curl -i -X DELETE -u Smith:Password -H Content-type:application/json http://myhost:7001/wsm-pmrest/v2/policyset/myPolicySet1/configoverride

    See Delete all Unscoped ConfigOverride(s).

    The following shows an example of the response indicating the request succeeded.

    {
      "STATUSCODE": "20024",
      "MESSAGE": "Configoverride [keystore.sig.csf.key, keystore.enc.csf.key] are successfully deleted."
    }