Connector Release 2.11 API
July 25, 2025
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. For this API Release Notes, <qualys_base_url> is mentioned in the sample API requests.
List Cloud Connectors
| New or Updated API | New |
|---|---|
| API Endpoint | /connectors/v1.0/{cloudType}/list |
| Method | GET |
| DTD or XSD changes | Not Applicable |
This API retrieves a paginated list of connectors for a specific cloud type (e.g., AWS, Azure, GCP). It supports advanced filtering on connector properties, tags, and statuses, enabling users to query and manage cloud connector configurations programmatically.
| Parameter Name | Mandatory/Optional | Data Type | Description |
|---|---|---|---|
cloudType (path param) |
Mandatory | String | Cloud type to fetch connectors for. Supported values: AWS, GCP, AZURE, OCI. |
pageNumber |
Mandatory | Integer | Index of the page to retrieve, starting from 0. |
pageSize |
Mandatory | Integer | Number of records to retrieve per page. |
query |
Optional | String | Filter expression supporting various fields like name, tags.name, remediationEnabled, etc. |
Sample Sample
API Request
curl --location '<Qualys_Base_URL>connectors/v1.0/AZURE/assignTag' --header 'Authorization: Bearer <Bearer Token>' \ --header 'Accept: application/json'
Request Body
{
"content": [
{
"id": "fc7957ea-xxxx-4d70-xxxx-2e68xxxxd15e",
"name": "GCP-Connector-Demo",
"cloudType": "GCP",
"status": "ACTIVE",
"remediationEnabled": false,
"tags": [
{ "name": "env:prod" },
{ "name": "team:security" }
],
"isAttachedToOrgConnector": false,
"application": "AssetView",
"scanType": {
"isCPSEnabled": false,
"isSnapshotScanEnabled": true
}
}
],
"pageNumber": 0,
"pageSize": 10,
"totalPages": 1,
"totalItems": 1
}