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