Skip to main content

Update cloud scan

POST https://daas.digicert.com/apicontroller/v1/scan/updateCloudScan

Use this endpoint to update or modify the cloud scan settings.

Related topic

For more information on cloud scan, see Discovery cloud scan service.

Example requests and responses

Example 1. cURL
curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/scan/updateCloudScan' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cloudScanSurveyConfigDTO": {
        "ipInclusionList": "yahoo.com",
        "ipExclusionList": "",
        "isExtraTlsProtocolsScan": false,
        "includedPorts": [
            "443"
        ]
    },
    "accountId": 1419609,
    "divisionId": 304778,
    "action": "saveAndRunNow"
}'

Request parameters

Name

Req/Opt

Type

Description

cloudScanSurveyConfigDTO

required

object

Object container for cloud scan configuration details.

.. ipInclusionList

required

string

IPs to include in the cloud scan. This can be a comma-separated list.

Supported formats are individual IPs, IP range, CIDR, and FQDNs.

Example for IP format: 104.20.67.46

Example for FQDN format: digicert.com

Note: Loopback IP "127.0.0.1" is not allowed to scan.

.. ipExclusionList

required

string

IPs to exclude in the cloud scan. This can be a comma-separated list.

Supported formats are individual IPs, IP range, CIDR, and FQDNs.

Example for IP format: 104.20.67.46

Example for FQDN format: digicert.com

Note: Loopback IP "127.0.0.1" is not allowed to scan.

.. isExtraTlsProtocolsScan

optional

boolean

If true, the protocols scan will be enabled for SSLv2, SSLv3 and TLSv1.1. If false, default protocols scan will be enabled.

Default protocols scan are TLSv1.3, TLSv1.2 and TLSv1.

.. includedPorts

required

array

Ports to include in the cloud scan. It can be individual ports or port range.

accountId

required

string

Account ID.

divisionId

required

integer

Division ID.

action

optional

string

Action performed to update the cloud scan.

Response parameters

Name

Type

Description

error

object

Includes the error code, if any.

data

string

Message for cloud scan updated with the next scheduled run.

In this section: