Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Descriptor

Value

HTTP Method

GET

Description

Gets the status of a policy even if the policy is not attached to the application.

Required Permission

Read Access (Any Role)

Version Introduced2.6
Changes in 2.8Added additional request parameter "type".


Request Header Parameters

Parameter

Value

Required

Description

Accept

String

Yes

A value of ‘application/json’ must be provided.


Request GET Parameters

Parameter

Value

Required

Description

policyId

String

No*

Evaluate the status of the policy with this id.

policyNameStringNo*

Evaluate the status of the policy with this name. Parameter "type" is needed when using policyName.

typeStringNo*

The type of the policy being evaluated. Accepted values are "filter" or "remediation".

*Required when using parameter policyName.

*Either 'policyId' or 'policyName' parameter must be provided.


Sample Call (using policyId):

Code Block
themeEclipse
curl -X GET 'http://localhost:8080/threadfix/rest/Latest/applications/1/policy/eval?policyId=1' -H 'Authorization: APIKEY {apiKey}'

Sample Call (using policyName):

Code Block
themeEclipse
curl -X GET 'http://localhost:8080/threadfix/rest/Latest/applications/1/policy/eval?policyName=TTR-Policy-1&type=remediation' -H 'Authorization: APIKEY {apiKey}'

...