Retrieves all blocked senders, URLs, SHA-1 hash values, and SHA-256 hash values that the administrator has configured through this API on Cloud App Security to quarantine Exchange Online email messages.
HTTPS Request
GET https://<serviceURL>/v1/remediation/mails
Request Example
GET https://api.tmcas.trendmicro.com/v1/remediation/mails Authorization: Bearer 1de231142eef3f83928da98dc251fbebb6cafe77
Response
On success, the service sends back an HTTP 200 response and returns a response body in JSON format; otherwise, the service sends back an error message in JSON format with error details. For more information about errors, see API Responses.
Response Example
HTTP/1.1 200
Content-Type: application/json
{
"code": 0,
"message": "Get rules successfully.",
"rules": {
"senders": ["user@example.com"],
"urls": ["test.example.com"],
"filehashes": [
"d6cdddb37f6a933d6a256bd98b4bc703a448c677",
"c14bffeecbaf61516893d766e1b525bd920da077",
"e2cdddb37f6a933d6a256bd98b4bc703a448c677"
],
"file256hashes": [
"2eb49162d4977bd96d6918a7602b5451adfd2c498c44592574b5741b3b585fc6",
"233dac1fdc6a5d0347b4da75a112759501abe908c75b8436769fc3c846c40767"
]
}
}
Response Fields
The following table describes the available fields for the response body.
|
Field |
Data Type |
Description |
|---|---|---|
|
code |
Integer |
Result code of the request. For an HTTP 200 response, the value is fixed to 0 |
|
message |
String |
String describing the result code. For an HTTP 200 response, the value is Get rules successfully. |
|
rules |
JSON object |
Blocked sender, URL, SHA-1 hash value, and SHA-256 hash value lists configured |
|
senders |
JSON array |
A list of blocked senders configured |
|
urls |
JSON array |
A list of blocked URLs configured |
|
filehashes |
JSON array |
A list of blocked SHA-1 hash values configured |
|
file256hashes |
JSON array |
A list of blocked SHA-256 hash values configured |
