TotalCloud Release 2.18 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.
Get GCP Resource Details
| New or Updated API | Updated |
| API Endpoint | /cloudview-api/rest/v1/resource/VM_INSTANCE/GCP |
| Method | GET |
| DTD or XSD changes | Not Applicable |
With this release, we have added support for IPv6 addresses to the API. The API response now includes publicIpv6Address and privateIpv6Address fields, which help identify instances with IPv6 addresses.
Sample - Get the list of all GCP resources by typeSample - Get the list of all GCP resources by type
API request
curl -X GET -u <username>:<password>
"https://<QualysBaseURL>/cloudview-api/rest/v1/resource/VM_INSTANCE/GCP?pageNo=0&pageSize=50"
API Response
{
"controlsFailed": 6,
"resourceId": "4XXXXXXXXXXXXXXXXX1",
"imageData": null,
"description": "",
"publicIpv6Address": "26XX:XXXX:XXXX:XXXX:X:X:X:0",
"type": null,
"uuid": "9XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX8",
"zone": "us-central1-a",
"cloudType": "GCP",
"customerId": "fXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX6",
"customers": [
"fXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX6"
],
"machineType": "e2-medium",
"connectorUuids": [
"3XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX7"
],
"kind": "compute#instance",
"created": "2025-07-08T09:10:02+0000",
"projectNumber": "4XXXXXXXXXX2",
"privateIpv6Address": "fXXX:XXX:XXXX:X:X:X:X:0",
"connectorUuid": "3XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX7",
"privateIpAddress": null,
"tags": null,
"labels": [
{
"name": "goog-ops-agent-policy",
"value": "v2-x86-template-1-4-0"
}
],
"networkInterfaces": [
{
"kind": "compute#networkInterface",
"networkIP": null,
"subnetwork": "subnet-external",
"name": "nic0",
"fingerprint": "NcBTpNJNG2I=",
"accessConfigs": null,
"network": "dual-ipv6-net"
},
{
"kind": "compute#networkInterface",
"networkIP": null,
"subnetwork": "ipv6-only-private-subnet",
"name": "nic1",
"fingerprint": "tXXXXXXXSs=",
"accessConfigs": null,
"network": "ipv6-private-vpc"
}
],
"scanUuid": "0XXXXXXX-XXXX-XXXX-XXXX-b9746f8cf9f9",
"name": "instance-ipv6only",
"externalIpAddress": null,
"qualysTags": [
{
"tagId": "146275876",
"tagName": "GcpConnTag"
}
],
"region": "us-central1",
"projectId": "my-project-1XXXXXXXXXXX1",
"updated": "2025-07-15T10:47:01+0000",
"status": "RUNNING"
}
Get OCI Resource Details
| New or Updated API | Updated |
| API Endpoint | /cloudview-api/rest/v1/resource/INSTANCE/OCI |
| Method | GET |
| DTD or XSD changes | Not Applicable |
With this release, we have added support for IPv6 addresses to this API. The API response now includes publicIpv6Address and privateIpv6Address fields, which help identify instances with IPv6 addresses.
Sample - Get the list of all OCI resources by typeSample - Get the list of all OCI resources by type
API request
curl -X GET -u <username>:<password>
"https://<QualysBaseURL>/cloudview-api/rest/v1/resource/INSTANCE/oci?pageSize=1000
API Response
{
"controlsFailed": 3,
"resourceId": "ocid1.instance.oc1.iad.aaaaaaaax2XXXX3XXXXXXXX5XXXXXXXX6XXXXXXXX6XXN7XXXXK7XXXXXXqq",
"connectorId": "fXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX1",
"tagIds": [
1XXXXXXX1
],
"uuid": "fXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXe",
"lastUpdated": "Wed Jul 16 06:09:25 GMT 2025",
"tenancyName": "oraclecengg1",
"cloudType": "OCI",
"customerId": "fXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX6",
"compartment": {
"name": "qXXXXXXXXa",
"ociId": null,
"id": "ocid1.compartment.oc1..aaaaaaaax2XXXX3XXXXXXXX5XXXXXXXX6XXXXXXXX6XXN7XXXXK7XXXXXXqq"
},
"ociId": "ocid1.instance.oc1.iad.aaaaaaaax2XXXX3XXXXXXXX5XXXXXXXX6XXXXXXXX6XXN7XXXXK7XXXXXXq",
"customers": [
"fXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX6"
],
"connectorSource": "CONNECTORS",
"lifecycleState": "Running",
"faultDomain": "FAULT-DOMAIN-1",
"connectorUuids": [
"fXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX1"
],
"imageId": "ocid1.image.oc1.iad.aaaaaaaax2XXXX3XXXXXXXX5XXXXXXXX6XXXXXXXX6XXN7XXXXK7XXXXXXa",
"availabilityDomain": "Lhkx:US-ASHBURN-AD-1",
"pvEncryptionInTransitEnabled": false,
"shape": "VM.Standard.E4.Flex",
"scanId": "8410df6f-9909-4627-9683-bd271201754a",
"cloudAccountId": "ocid1.instance.oc1.iad.aaaaaaaax2XXXX3XXXXXXXX5XXXXXXXX6XXXXXXXX6XXN7XXXXK7XXXXXXqq",
"vnicDto": [
{
"macAddress": "02:00:17:36:FE:0D",
"vlanId": null,
"displayName": "private-subnet-vnic",
"subnetDto": {
"availabilityDomain": null,
"virtualRouterIp": "10.0.1.1",
"virtualRouterMac": "00:00:17:B7:94:13",
"displayName": "private-subnet",
"cidrBlock": "10.0.1.0/28",
"dnsLabel": "privatesubnet",
"id": "ocid1.subnet.oc1.iad.aaaaaaaax2XXXX3XXXXXXXX5XXXXXXXX6XXXXXXXX6XXN7XXXXK7XXXXXXqq"
},
"privateIp": "1X.X.X.X",
"publicIp": null,
"id": "ocid1.vnic.oc1.iad.aaaaaaaax2XXXX3XXXXXXXX5XXXXXXXX6XXXXXXXX6XXN7XXXXK7XXXXXXqq",
"ipv6Addresses": [
"fXXXX::XXXX:XXXX:XXX:XXX8",
"2XXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXX4"
],
"hostNameLabel": null,
"primary": false
},
{
"macAddress": "0X:XX:XX:XX:XX:XA",
"vlanId": null,
"displayName": "instance-ipv6",
"subnetDto": {
"availabilityDomain": null,
"virtualRouterIp": "10.0.0.1",
"virtualRouterMac": "00:00:17:B7:94:13",
"displayName": "XXXXXXX-subnet",
"cidrBlock": "10.0.0.0/28",
"dnsLabel": "sXXXXXXsubnet",
"id": "ocid1.subnet.oc1.iad.aaaaaaaax2XXXX3XXXXXXXX5XXXXXXXX6XXXXXXXX6XXN7XXXXK7XXXXXXqq"
},
"privateIp": "1X.X.X.XX",
"publicIp": "1XX.XXX.XXX.X4",
"id": "ocid1.vnic.oc1.iad.abXXXXXXXXXXXXXXXXXXX347X5XXX5XXXXXXXXX2XXXXXXXXXXXXXXXq",
"ipv6Addresses": [
"26XX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXf",
"26XX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXb",
"fXXX:XXXX::XXXX:XXX:XXXX:XXX2"
],
"hostNameLabel": "instance-ipv6",
"primary": true
}
],
"creationDate": 1746426295210,
"firstDiscoveredOn": 1746449695410,
"connectorUuid": "fXXXXXXX-a1ca-43dc-9241-b69081939401",
"launchTime": null,
"scanUuids": [
"8XXXXXXX-9909-XXXX-9683-XXXXXXX1754a"
],
"secureBootEnabled": false,
"name": "instance-ipv6",
"tenantId": "ocid1.tenancy.oc1..aaaaaaaax2XXXX3XXXXXXXX5XXXXXXXX6XXXXXXXX6XXN7XXXXK7XXXXXXq",
"qualysTags": [
{
"tagId": "1XXXXXXX1",
"tagName": "OciConnTag"
}
],
"region": "us-ashburn-1",
"ociTags": [
{
"nameSpace": "Oracle-Tags",
"type": "DEFINED",
"value": "oktasso_qualys_oraclecengg1/shivani@qualys.com",
"key": "CreatedBy"
},
{
"nameSpace": "Oracle-Tags",
"type": "DEFINED",
"value": "2025-05-05T06:24:54.627Z",
"key": "CreatedOn"
}
],
"updated": 1752646165875
},