Extend a list of domains in Cyber Shield Block List.
Example Request:
POST /api/v1/cybershield/block-list-add-domains
{
"domainAndComments": [
{ "domain": "sample.domain.com", "comment": "Added by CVE-YYYY-NNNN."}
]
}
This request adds or updates an entry in the Cyber Shield Block List for the domain sample.domain.com, including the comment # Added by CVE-YYYY-NNNN. - The latest entry overwrites duplicate entries. - Existing domains in the Block List are replaced with those provided in the request.
Parameters:
domainAndComments(Type: List, Mandatory) - A list of domains and optional comments to add.Maximum of 1,000 items.
domain(Type: String, Mandatory) - The fully qualified domain name (FQDN) to be added.Must be unique in the list.
The last occurrence of a domain in the list overwrites previous entries.
Combined length of the domain and comment must not exceed 150 characters.
comment(Type: String, Optional) - Free-form text associated with the domain, added as a comment.Used for additional details or notes.
Combined length of the
domainandcommentmust not exceed 150 characters.
Body parameter
{
"domainAndComments": [
{
"domain": "string",
"comment": "string"
}
]
}
Parameters
Name | In | Type | Required | Description |
|---|---|---|---|---|
body | body | true | none | |
» domainAndComments | body | false | none | |
»» domain | body | string | false | none |
»» comment | body | string | false | none |
Responses
Status | Meaning | Description | Schema |
|---|---|---|---|
200 | OK | None | |
400 | Bad Request | ||
401 | Unauthorized | None | |
429 | Too Many Requests | None | |
500 | Internal Server Error |
{
"errorDetails": {
"property1": [
{
"errorCode": "string",
"message": "string",
"params": {
"property1": {},
"property2": {}
}
}
],
"property2": [
{
"errorCode": "string",
"message": "string",
"params": {
"property1": {},
"property2": {}
}
}
]
},
"errorMessage": "string",
"statusError": "string"
}
Response Schema
To perform this operation, you must be authenticated by means of one of the following methods: oauth