Ruft alle gesperrten Absender, URLs, SHA-1- und SHA-256-Hash-Werte ab, die der Administrator über diese API in Cloud App Security konfiguriert hat, um Exchange Online-E-Mail-Nachrichten in die Quarantäne zu verschieben.
HTTPS-Anforderung
GET https://<serviceURL>/v1/remediation/mails
Beispiel anfordern
GET https://api.tmcas.trendmicro.com/v1/remediation/mails Authorization: Bearer 1de231142eef3f83928da98dc251fbebb6cafe77
Antwort
Bei Erfolg sendet der Dienst eine HTTP 200-Antwort zurück und gibt einen Antworttext im JSON-Format zurück; andernfalls sendet der Dienst eine Fehlermeldung im JSON-Format mit Fehlerdetails zurück. Weitere Informationen zu Fehlern finden Sie unter API-Antworten.
Antwortbeispiel
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" ] } }
Antwortfelder
In der folgenden Tabelle werden die verfügbaren Felder für den Antworttext beschrieben.
Feld |
Datentyp |
Beschreibung |
---|---|---|
code |
Ganzzahl |
Ergebniscode der Anforderung. Bei einer HTTP-200-Antwort ist der Wert auf 0 festgelegt |
message |
Zeichenfolge |
Zeichenfolge, die den Ergebniscode beschreibt. Bei einer HTTP 200-Antwort lautet der Wert Get Rules successfully. |
rules |
JSON-Objekt |
Listen der konfigurierten gesperrten Absender, URLs, SHA-1- und SHA-256-Hash-Werte |
senders |
JSON-Array |
Eine Liste der konfigurierten gesperrten Absender |
urls |
JSON-Array |
Eine Liste der konfigurierten gesperrten URLs |
filehashes |
JSON-Array |
Eine Liste der konfigurierten gesperrten SHA-1-Hash-Werte |
file256hashes |
JSON-Array |
Eine Liste der konfigurierten gesperrten SHA-256-Hash-Werte |