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: