Extend a list of domains in Cyber Shield Block List
Description
An endpoint to add domains to the Block List of Cyber Shield. For example:
POST /api/beta/cybershield/block-list-add-domains
{ "domainAndComments": [ { "domain": "sample.domain.com", "comment": "Added by CVE-YYYY-NNNN."} ] }
This request is going to add or replace the existing entry in the Cyber Shield Block List with the domain sample.domain.com
and add a comment # Added by CVE-YYYY-NNNN
, resulting in the following line: sample.domain.com # Added by CVE-YYYY-NNNN
.
Duplicates are going to be overwritten by the last entry. Already existing domains are going to be overwritten by the received ones.
domainAndComments
(Type: List) - A list of domains with comments to add. Max 1000 items. (mandatory).
domain
- An FQDN domain name. Unique in the list. The last domain entry overwrites the previous domains. domain and comment joined max length is 150 symbols. (mandatory)
comment
- A free-form text string with details for a domain. Is added as a comment after the domain. domain and comment joined max length is 150 symbols. (optional)
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | object | true | body |
{ "domainAndComments": [ { "comment": "string", "domain": "string" } ] }
Responses
Status | Meaning | Description |
---|---|---|
200 | OK | |
201 | Entity created | |
400 | Bad Request | |
401 | Unauthorized | |
403 | Access Forbidden | |
404 | Not Found | |
406 | Not Acceptable | |
429 | Too Many Requests | |
500 | Internal Server Error |
To perform this operation, you must be authenticated by means of one of the following methods: OAuth_authorization