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 |