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 |