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 likename, tags.name, remediationEnabled, etc.
|
API Request
curl -X 'GET' \ 'https://<qualys_gateway_url>/connectors/v1.0/GCP/list'
--header 'Authorization: Bearer <Bearer Token>' \
--header 'Accept: application/json'
API Response
{
"currentPage": 0,
"currentPageSize": 1,
"numberOfElements": 1,
"content": [
{
"id": 1996806,
"uuid": "a8755e91-xxxx-xxxx-xxxx-8ccbe11ba90a",
"customerId": "e3711a2-xxxx-xxxx-xxxx-336224fa7e23",
"userUuid": "ac30e31-xxxx-xxxx-xxxx-c799f2ad1d10",
"username": "quays_xk12",
"name": "GCP Connector",
"description": "Test",
"qualysTagIds": null,
"defaultTagIds": null,
"state": "FINISHED_SUCCESS",
"remediationEnabled": false,
"isDisabled": false,
"isDeleted": false,
"scanUuid": "35a08f30-xxxx-xxxx-xxxx-dbefa989e17d",
"modules": [
"CLOUDVIEW"
],
"connectorAppInfos": [
{
"name": "CI",
"identifier": "my-project-1513669048551",
"tagId": 140654202,
"isTagAttachedToOrgConnector": null,
"tagMetadata": {
"tagId": 140654202,
"name": "Automation_Tag",
"icon": null,
"color": null,
"foregroundColor": null,
"backgroundColor": null
}
},
{
"name": "CSA",
"identifier": "my-project-1513669048551",
"tagId": 140654202,
"isTagAttachedToOrgConnector": null,
"tagMetadata": {
"tagId": 140654202,
"name": "Automation_Tag",
"icon": null,
"color": null,
"foregroundColor": null,
"backgroundColor": null
}
},
{
"name": "AI",
"identifier": "my-project-1513669048551",
"tagId": 140654202,
"isTagAttachedToOrgConnector": null,
"tagMetadata": {
"tagId": 140654202,
"name": "Automation_Tag",
"icon": null,
"color": null,
"foregroundColor": null,
"backgroundColor": null
}
}
],
"connectorCapabilities": [
"CSA",
"CI",
"AI"
],
"lastSuccessfulSync": "2025-10-30T07:43:51.000+00:00",
"isCPSEnabled": false,
"accountType": null,
"type": null,
"errorMessage": null,
"errored": null,
"createdBy": null,
"createdOn": null,
"lastUpdated": null,
"defaultTagIdsDisplay": null,
"activateModuleIds": null,
"activateModuleDisplay": null,
"autoActivateVM": false,
"autoActivatePC": false,
"autoActivateSCA": false,
"autoActivateCertView": false,
"currentScanProcessedCount": 0,
"currentScanErrorProcessingCount": 0,
"currentScanErrorApiExecutionCount": 0,
"currentScanExcludedCount": 0,
"currentScanAssetDiscoveredCount": 0,
"totalAssetProcessedCount": 0,
"tags": null,
"connectorTags": [
{
"tagId": 140654202,
"uuid": null,
"name": "Automation_Tag",
"icon": null,
"color": null,
"foregroundColor": null,
"backgroundColor": null,
"isAttachedToOrgConnector": false
}
],
"runFrequency": null,
"nextSync": null,
"isRemediationEnabled": null,
"isAttachedToOrgConnector": null,
"orgConnectorId": null,
"parentId": null,
"orgConnectorName": null,
"isInstantAssessmentEnabled": false,
"isSnapshotScanEnabled": false,
"isFlexScanConfigured": null,
"isScanPublicLoadBalancerEnabled": false,
"hasRegisteredServiceAccount": false,
"isSecretDetectionEnabled": false,
"isScaEnabled": false,
"isAMIScanningEnabled": false,
"cloudStatus": null,
"skipAssetScanByQualysAgent": false,
"skipAssetScanByApiScan": false,
"overrideOrgParameters": false,
"projectId": "my-project-1513669048551",
"organizationId": null,
"serviceAccountId": null,
"flexScanConfigured": false
}
],
"hasContent": true,
"hasNext": false,
"hasPrevious": false,
"scrollId": null,
"first": true,
"last": true
}