Get Details of Specified Control

Get details of the specified control using the Control ID.

GET/sdr/api/custom/controls/get/{cID}

Input ParametersInput Parameters

Pass the custom control ID in the API request.

Sample - Get Details of Specified ControlSample - Get Details of Specified Control

API Request

curl --location '<qualys_base_url>/sdr/api/custom/controls/get/{cId}'
--header 'Content-Type: application/json' \

Response

{
    "cid": "xxxxx",
    "name": "Ensure that 'Max PIN attempts' setting is configured in '1 to 6' range for the iOS device app protection policy",
    "criticality": "Low",
    "criticalityNo": 3,
    "description": "This setting in an iOS device app protection policy specifies the maximum number of times a user can attempt to enter their PIN to access a protected app before the app is locked and requires administrative intervention to unlock.",
    "connectorType": "OFFICE365",
    "entityType": "IOS Managed App Protection Policy",
    "entityIdParam": "displayName",
    "predicate": "$.[?(@.maximumPinRetries >= 1 && @.maximumPinRetries <= 6)]",
    "evidences": [
        {
            "evidenceKey": "Max PIN attempts",
            "evidenceSuccess": "$.maximumPinRetries",
            "evidenceFail": "$.maximumPinRetries"
        }
    ],
    "scope": "API",
    "xpath": "$.value"
}