Extend a list of domains in Cyber Shield Allow List.
For example:
POST /api/v1/cybershield/allow-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 Allow 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 Allow 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
andcomment
must not exceed 150 characters.
comment
(Type: String, Mandatory) - Free-form text associated with the domain, added as a comment.Used for additional details or notes.
Combined length of the domain and comment must 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