Connector Release 2.20 API
August 21, 2026
Before understanding the API release highlights, learn more about the API server URL to be used in your API requests by referring to the Know Your Qualys API Server URL section. In these API Release Notes, <qualys_gateway_url> is used in the sample API requests.
Create and Update OCI Connector API: Support for CPS (VM Module) Activation
Applicable for:
| New or Updated API | Updated |
| API Endpoint | /qps/rest/3.0/create/am/ociassetdataconnector /qps/rest/3.0/update/am/ociassetdataconnector/{id} |
| Method | POST |
| DTD or XSD changes | Not Applicable |
The Create OCI Connector and Update OCI Connector APIs now let you activate the Vulnerability Management (VM) module, enabling Cloud Perimeter Scanning (CPS), for your Oracle Cloud Infrastructure (OCI) asset data connectors.
To activate CPS for an OCI connector, include VM along with PA in the ActivationModule parameter of the activation element when you create or update the connector.
API request
curl --location --request POST '<qualys_base_url>/qps/rest/3.0/create/am/ociassetdataconnector' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic xxxxxxxxxxx' \
--data-raw '{
"ServiceRequest": {
"data": {
"OciAssetDataConnector": {
"homeRegion": "us-ashburn-1",
"runFrequency": 240,
"name": "OCI Connector with API",
"description": "Created via Public API",
"disabled": false,
"activation": {
"set": {
"ActivationModule": [
"PC",
"VM"
]
}
},
"authRecord": {
"tenantId": "ocid1.tenancy.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"userId": "ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"fingerprint": "xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx",
"privateKey": "-----BEGIN PRIVATE KEY-----\nxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n-----END PRIVATE KEY-----"
},
"connectorAppInfos": {
"set": {
"ConnectorAppInfoQList": [
{
"set": {
"ConnectorAppInfo": {
"name": "AI",
"identifier": "ocid1.tenancy.oc1..xxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
]
}
}
}
}
}
}'
Response (JSON)
{
"ServiceResponse": {
"data": [
{
"OciAssetDataConnector": {
"activation": {
"ActivationModule": [
"PC",
"VM"
]
},
"connectorAppInfos": {
"list": [
{
"ConnectorAppInfoQList": {
"list": [
{
"ConnectorAppInfo": {
"name": "AI",
"identifier": "ocid1.tenancy.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
]
}
}
]
},
"lastSync": "2026-08-12T11:52:54Z",
"isDeleted": "false",
"authRecord": {
"tenantId": "ocid1.tenancy.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"disabled": "false",
"description": "Created via Public API",
"id": 3970605,
"name": "OCI Connector with API"
}
}
],
"count": 1,
"responseCode": "SUCCESS"
}
}
API request
curl --location --request POST '<qualys_base_url>/qps/rest/3.0/update/am/ociassetdataconnector/3970605' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic xxxxxxxxxxx' \
--data-raw '{
"ServiceRequest": {
"data": {
"OciAssetDataConnector": {
"runFrequency": 720,
"description": "Updated using Public API",
"activation": {
"set": {
"ActivationModule": [
"PC",
"VM"
]
}
}
}
}
}
}'
Response (JSON)
{
"ServiceResponse": {
"data": [
{
"OciAssetDataConnector": {
"activation": {
"ActivationModule": [
"PC",
"VM"
]
},
"connectorAppInfos": {
"list": [
{
"ConnectorAppInfoQList": {
"list": [
{
"ConnectorAppInfo": {
"name": "AI",
"identifier": "ocid1.tenancy.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
]
}
}
]
},
"lastSync": "2026-08-12T11:53:23Z",
"isDeleted": "false",
"authRecord": {
"tenantId": "ocid1.tenancy.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"disabled": "false",
"description": "Updated using Public API",
"id": 3970605,
"name": "OCI Connector with API"
}
}
],
"count": 1,
"responseCode": "SUCCESS"
}
}