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: oci

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.

Sample: Create an OCI Connector with PA and VM (CPS) ActivationSample: Create an OCI Connector with PA and VM (CPS) Activation

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"
    }
}

Sample: Update an OCI Connector to Add VM (CPS) ActivationSample: Update an OCI Connector to Add VM (CPS) Activation

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"
    }
}