Akamai in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie Akamai in Google Security Operations (Google SecOps) einbinden.

Integrationsparameter

Für die Akamai-Integration sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Host

Erforderlich.

Der Hostname der Akamai-Instanz.
Client Token

Erforderlich.

Ihr Akamai-Client-Token.
Client Secret

Erforderlich.

Ihr Akamai-Clientschlüssel.
Access Token

Erforderlich.

Ihr Akamai-Zugriffstoken.
Verify SSL

Erforderlich.

Validiert das SSL-Zertifikat beim Herstellen einer Verbindung zu Akamai.

Standardmäßig ausgewählt.

Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Bei Bedarf können Sie später Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Ausstehende Aktionen in „Mein Arbeitsbereich“ beantworten und Manuelle Aktion ausführen.

Client-Liste aktivieren

Mit der Aktion Client List aktivieren können Sie eine bestimmte Clientliste in Ihrer Akamai-Umgebung aktivieren.

Aktionseingaben

Für die Aktion Clientliste aktivieren sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Client List Name

Optional.

Der Name der zu aktualisierenden Kundenliste.

Wenn Client List Name und Client List ID angegeben sind, wird Client List ID priorisiert.
Client List ID

Optional.

Die eindeutige Kennung der Clientliste, die aktualisiert werden soll.

Wenn Client List Name und Client List ID angegeben sind, wird Client List ID priorisiert.
Environment

Optional.

Die Zielnetzwerkumgebung für die Aktivierung.

Folgende Werte sind möglich:

  • Production
  • Staging

Der Standardwert ist Production.
Comment

Optional.

Eine kurze Beschreibung oder Begründung für den Aktivierungsvorgang.
Notification Recipients

Optional.

Eine durch Kommas getrennte Liste von E‑Mail-Adressen, an die eine Benachrichtigung über die Aktivierung der Kundenliste gesendet wird

Aktionsausgaben

Die Aktion Clientliste aktivieren bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die bei Verwendung der Aktion Client-Listen aktivieren empfangen wird:

{
    "action": "ACTIVATE",
    "activations": {
        "STAGING": {
            "activationId": 3797405,
            "activationStatus": "PENDING_ACTIVATION"
        }
    },
    "comments": "Activating 235466",
    "createDate": "2026-02-12T15:12:07.952+00:00",
    "createdBy": "4wksaj3wyt23jt2i",
    "listId": "235466_GOOGLESECOPSCLIENTLIST1",
    "notificationRecipients": [
        "12345@email.com"
    ],
    "version": 14
}
Ausgabenachrichten

Die Aktion Clientliste aktivieren gibt die folgenden Ausgabemeldungen aus:

Ausgabemeldung Nachrichtenbeschreibung
Successfully activated the client list in Akamai. Die Aktion wurde ausgeführt.

Error executing action "Activate Client List". Reason: ERROR_REASON

 Die Aktion ist fehlgeschlagen.
Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Activate Client List (Kundenliste aktivieren) beschrieben:

Name des Scriptergebnisses Wert
is_success true oder false

Netzwerkliste aktivieren

Mit der Aktion Activate Network List (Netzwerkliste aktivieren) können Sie Elemente aus der Netzwerkliste in Akamai entfernen.

Aktionseingaben

Für die Aktion Netzwerkliste aktivieren sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Network List Name

Optional.

Der Name der Netzwerkliste, die aktualisiert werden soll.

Wenn Network List Name und Network List ID angegeben sind, wird für die Aktion die ID
Network List ID

Optional.

Die ID der zu aktualisierenden Netzwerkliste.

Wenn Network List Name und Network List ID angegeben sind, wird für die Aktion die ID
Environment

Optional.

Die Zielumgebung für die Aktivierung.

Folgende Werte sind möglich:
  • Production
  • Staging
Comment

Optional.

Ein Kommentar, der den Zweck der Aktivierung beschreibt.
Notification Recipients

Optional.

Eine durch Kommas getrennte Liste von E-Mail-Adressen, die über die Aktivierung der Netzwerkliste benachrichtigt werden sollen.

Aktionsausgaben

Die Aktion Netzwerkliste aktivieren bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die bei Verwendung der Aktion Netzwerklisten aktivieren empfangen wird:

{
   "activationId": 12345,
   "activationComments": "Allow IPs of new employees who joined this week",
   "activationStatus": "PENDING_ACTIVATION",
   "syncPoint": 5,
   "uniqueId": "25614_GENERALLIST",
   "fast": false,
   "dispatchCount": 1,
   "links": {
     "appendItems": {
       "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
       "method": "POST"
     },
     "retrieve": {
       "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
     },
     "statusInProduction": {
       "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
     },
     "statusInStaging": {
       "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
     },
     "syncPointHistory": {
       "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
     },
     "update": {
       "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
       "method": "PUT"
     },
     "activationDetails": {
       "href": "/network-list/v2/network-lists/activations/12345/"
     }
   }
 }
Ausgabenachrichten

Die Aktion Netzwerkliste aktivieren gibt die folgenden Ausgabemeldungen aus:

Ausgabemeldung Nachrichtenbeschreibung
Successfully activated the network list in Akamai. Aktion erfolgreich.

Error executing action "Activate Network List". Reason: {0}''.format(error.Stacktrace)

Error executing action "Activate Network List". Reason: "{network name or id}" network list wasn't found in Akamai.

Error executing action "Activate Network List". Reason: provide a value in "Network List Name" or "Network List ID" parameter.

 Aktion fehlgeschlagen.
Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Activate Network List (Netzwerkliste aktivieren) beschrieben:

Name des Scriptergebnisses Wert
is_success True oder False

Artikel zur Kundenliste hinzufügen

Mit der Aktion Add Items To Client List (Elemente zur Kundenliste hinzufügen) können Sie der Kundenliste in Akamai Elemente hinzufügen.

Aktionseingaben

Für die Aktion Add Items To Client List (Artikel zur Kundenliste hinzufügen) sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Client List Name

Optional.

Der Name der zu aktualisierenden Kundenliste.

Hinweis: Wenn Client List Name und Client List ID angegeben sind, wird die ID für die Aktion verwendet.
Client List ID

Optional.

Die ID der zu aktualisierenden Kundenliste.

Hinweis: Wenn Client List Name und Client List ID angegeben sind, wird die ID für die Aktion verwendet.
Item Value

Erforderlich.

Eine durch Kommas getrennte Liste der Elemente, die der Kundenliste hinzugefügt werden sollen.
Item Description

Optional.

Eine Beschreibung der Elemente, die der Kundenliste hinzugefügt wurden.
Item Expiration Date

Optional.

Ein Ablaufdatum für die hinzugefügten Artikel im ISO 8601-Format.
Item Tags

Optional.

Eine durch Kommas getrennte Liste von Tags, die den hinzugefügten Elementen zugewiesen werden sollen.

Aktionsausgaben

Die Aktion Add Items To Client List (Elemente zur Kundenliste hinzufügen) bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die bei Verwendung der Aktion Add Items To Client List (Elemente zur Kundenliste hinzufügen) empfangen wird:

[
  {
    "createDate": "2026-03-20T09:54:11.410+00:00",
    "createdBy": "4wksaj3wyt23jt2i",
    "description": "Testtinhbhjbjbjb",
    "expirationDate": "2026-04-05T19:29:02.320+00:00",
    "tags": [],
    "type": "IP",
    "updateDate": "2026-03-20T09:54:11.410+00:00",
    "updatedBy": "4wksaj3wyt23jt2i",
    "value": "127.0.0.1",
    "status": "added"
  },
  {
    "value": "127.0.0.3",
    "status": "duplicated"
  },
  {
    "value": "127.0.0.TT",
    "status": "failed",
    "error: "Validation failed: delete[0].value: Item of type IP has an invalid value 127.0.0.4E"
  },
]
Ausgabenachrichten

Mit der Aktion Add Items To Client List (Elemente zur Kundenliste hinzufügen) werden die folgenden Ausgabemeldungen bereitgestellt:

Ausgabemeldung Nachrichtenbeschreibung
Successfully returned client lists from Akamai. Aktion erfolgreich.

Error executing action "Add Items To Client List". Reason: {0}''.format (error.Stacktrace)

Error executing action "Add Items To Client List". Reason: provide a value in "Client List Name" or "Client List ID" parameter.

Error executing action "Add Items To Client List". Reason: "{client list name or id}" client list wasn't found in Akamai.

 Aktion fehlgeschlagen.
Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Add Items To Client List beschrieben:

Name des Scriptergebnisses Wert
is_success True oder False

Der Netzwerkliste Elemente hinzufügen

Mit der Aktion Add Items To Network List (Elemente zur Netzwerkliste hinzufügen) können Sie Elemente zur Netzwerkliste in Akamai hinzufügen.

Aktionseingaben

Für die Aktion Add Items To Network List sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Network List Name

Optional.

Der Name der Netzwerkliste, die aktualisiert werden soll.

Wenn Network List Name und Network List ID angegeben sind, wird die ID für die Aktion verwendet.
Network List ID

Optional.

Die ID der zu aktualisierenden Netzwerkliste.

Wenn Network List Name und Network List ID angegeben sind, wird die ID für die Aktion verwendet.
Items

Erforderlich.

Eine durch Kommas getrennte Liste mit Elementen, die der Netzwerkliste hinzugefügt werden sollen.

Aktionsausgaben

Die Aktion Add Items To Network List (Elemente zur Netzwerkliste hinzufügen) bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel beschreibt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Add Items To Network Lists (Elemente zu Netzwerklisten hinzufügen) empfangen wird:

     {
       "networkListType": "networkListResponse",
       "accessControlGroup": "KSD\nwith ION 3-13H1234",
       "name": "General List",
       "elementCount": 3011,
       "readOnly": false,
       "shared": false,
       "syncPoint": 22,
       "type": "IP",
       "uniqueId": "25614_GENERALLIST",
       "links": {
         "activateInProduction": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
           "method": "POST"
         },
         "activateInStaging": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
           "method": "POST"
         },
         "appendItems": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST",
           "method": "POST"
         },
         "retrieve": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST"
         },
         "statusInProduction": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
         },
         "statusInStaging": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
         },
         "update": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST",
           "method": "PUT"
         }
       }
     }
Ausgabenachrichten

Die Aktion Add Items To Network List (Elemente zur Netzwerkliste hinzufügen) gibt die folgenden Ausgabemeldungen aus:

Ausgabemeldung Nachrichtenbeschreibung
Successfully updated network list in Akamai. Aktion erfolgreich.

Error executing action "Add Items To Network List". Reason: {0}''.format (error.Stacktrace)

Error executing action "Add Items To Network List". Reason: "{network name or id}" network list wasn't found in Akamai.

Error executing action "Add Items To Network List". Reason: provide a value in "Network List Name" or "Network List ID" parameter.

 Aktion fehlgeschlagen.
Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Add Items To Network List (Elemente zur Netzwerkliste hinzufügen) beschrieben:

Name des Scriptergebnisses Wert
is_success True oder False

Kundenlisten abrufen

Mit der Aktion Get Client Lists (Clientlisten abrufen) können Sie Informationen zu Clientlisten in Akamai abrufen.

Aktionseingaben

Für die Aktion Client-Listen abrufen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Client List Name

Optional.

Eine durch Kommas getrennte Liste der Namen von Kundenlisten, nach denen gesucht werden soll.
Client List ID

Optional.

Eine durch Kommas getrennte Liste der Clientlisten-IDs, nach denen gesucht werden soll.
Include Items

Optional.

Gibt Informationen zu den Elementen in der Clientliste zurück.

Der Standardwert ist False.

Hinweis: Diese Informationen werden nur zurückgegeben, wenn Client List Name oder Client List ID angegeben wird.
Type

Optional.

Der Typ der Clientliste, in der gesucht werden soll.

Folgende Werte sind möglich:
  • IP
  • GEO
  • ASN
  • TLS
  • Fingerprint
  • File Hash

    • Hinweis: Wenn Select One angegeben ist, wird in allen Kundenlisten gesucht.

    Max Client Lists To Return

    Erforderlich.

    Die maximale Anzahl der zurückzugebenden Kundenlisten.

    Der Standard- und der Höchstwert ist 100.
    Max Client List Items To Return

    Erforderlich.

    Die maximale Anzahl der Elemente, die pro Kundenliste zurückgegeben werden sollen.

    Der Standard- und der Höchstwert ist 100.

    Aktionsausgaben

    Die Aktion Client-Listen abrufen gibt die folgenden Ausgaben zurück:

    Ausgabetyp der Aktion Verfügbarkeit
    Anhang im Fall-Repository Nicht verfügbar
    Link zum Fall‑Repository Nicht verfügbar
    Tabelle „Fall-Repository“ Nicht verfügbar
    Anreicherungstabelle Nicht verfügbar
    JSON-Ergebnis Verfügbar
    Scriptergebnis Verfügbar
    JSON-Ergebnis

    Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die bei Verwendung der Aktion Client-Listen abrufen empfangen wird:

    [
{
   "contractId": "K-0N7RAK71",
   "createDate": "2023-04-05T18:20:42.090+00:00",
   "createdBy": "jsmith",
   "deprecated": false,
   "groupId": 32145,
   "groupName": "Acme IT Group",
   "items": [
     {
       "createDate": "2023-04-05T18:20:42.892+00:00",
       "createdBy": "jkowalski",
       "description": "Canada - North America",
       "expirationDate": "2023-12-31T23:59:19.700+00:00",
       "productionStatus": "INACTIVE",
       "stagingStatus": "INACTIVE",
       "tags": [
         "allowlist1"
       ],
       "type": "GEO",
       "updateDate": "2023-04-05T18:20:42.892+00:00",
       "updatedBy": "mrossi",
       "value": "CA"
     }
   ],
   "itemsCount": 3,
   "listId": "1234_NORTHAMERICAGEOALLOWLIST",
   "listType": "CL",
   "name": "NorthAmericaGeoAllowlist",
   "notes": "GEO code allowlist",
   "productionActivationStatus": "INACTIVE",
   "readOnly": false,
   "shared": false,
   "stagingActivationStatus": "INACTIVE",
   "tags": [
     "allowlist2"
   ],
   "type": "GEO",
   "updateDate": "2023-04-05T18:20:42.090+00:00",
   "updatedBy": "jdupont",
   "version": 1
 }
]
    Ausgabenachrichten

    Die Aktion Client-Listen abrufen gibt die folgenden Ausgabemeldungen aus:

    Ausgabemeldung Nachrichtenbeschreibung

    Successfully returned client lists from Akamai.

    No clients lists were found for the provided criteria in Akamai.

    		 Aktion erfolgreich.
    Error executing action "Get Client Lists". Reason: {0}''.format (error.Stacktrace) Aktion fehlgeschlagen.
    Scriptergebnis

    In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Client Lists (Kundenlisten abrufen) beschrieben:

    Name des Scriptergebnisses Wert
    is_success True oder False

    Netzwerklisten abrufen

    Mit der Aktion Get Network Lists (Netzwerklisten abrufen) können Sie Informationen zu den Listen eines Netzwerks in Akamai abrufen.

    Aktionseingaben

    Für die Aktion Get Network Lists (Netzwerklisten abrufen) sind die folgenden Parameter erforderlich:

    Parameter Beschreibung
    Network List Name

    Optional.

    Eine durch Kommas getrennte Liste mit Namen von Netzwerklisten, nach denen gesucht werden soll.
    Network List ID

    Optional.

    Eine durch Kommas getrennte Liste von Netzwerklisten-IDs, nach denen gesucht werden soll.
    Include Items

    Optional.

    Gibt Informationen zu den Elementen in den Netzwerklisten zurück.

    Der Standardwert ist False.
    Include Activation Status

    Optional.

    Gibt den Aktivierungsstatus für jede Netzwerkliste zurück.

    Der Standardwert ist False.

    Hinweis: Diese Informationen werden nur zurückgegeben, wenn Network List Name oder Network List ID angegeben wird.
    Activation Environment

    Optional.

    Die Umgebung, für die der Aktivierungsstatus zurückgegeben wird.

    Folgende Werte sind möglich:
    • Production
    • Staging

    Hinweis: Diese Informationen werden nur zurückgegeben, wenn Network List Name oder Network List ID angegeben wird.
    Max Network Lists To Return

    Erforderlich.

    Die maximale Anzahl der zurückzugebenden Netzwerklisten.

    Der Standard- und der Höchstwert ist 100.
    Max Network List Items To Return

    Erforderlich.

    Die maximale Anzahl der Elemente, die pro Netzwerkliste zurückgegeben werden sollen.

    Der Standard- und der Höchstwert ist 100.

    Aktionsausgaben

    Die Aktion Get Network Lists (Netzwerklisten abrufen) gibt die folgenden Ausgaben zurück:

    Ausgabetyp der Aktion Verfügbarkeit
    Anhang im Fall-Repository Nicht verfügbar
    Link zum Fall‑Repository Nicht verfügbar
    Tabelle „Fall-Repository“ Nicht verfügbar
    Anreicherungstabelle Nicht verfügbar
    JSON-Ergebnis Verfügbar
    Scriptergebnis Verfügbar
    JSON-Ergebnis

    Das folgende Beispiel beschreibt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Get Network Lists (Netzwerklisten abrufen) empfangen wird:

    [
   {
       "networkListType": "networkListResponse",
       "accessControlGroup": "KSD\nwith ION 3-13H1234",
       "name": "General List",
       "elementCount": 3011,
       "readOnly": false,
       "shared": false,
       "syncPoint": 22,
       "type": "IP",
       "uniqueId": "25614_GENERALLIST",
       "links": {
           "activateInProduction": {
               "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
               "method": "POST"
           },
           "activateInStaging": {
               "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
               "method": "POST"
           },
           "appendItems": {
               "href": "/network-list/v2/network-lists/25614_GENERALLIST",
               "method": "POST"
           },
           "retrieve": {
               "href": "/network-list/v2/network-lists/25614_GENERALLIST"
           },
           "statusInProduction": {
               "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
           },
           "statusInStaging": {
               "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
           },
           "update": {
               "href": "/network-list/v2/network-lists/25614_GENERALLIST",
               "method": "PUT"
           }
       },
       "Activation_STAGING": {
           "activationId": 12345,
           "activationComments": "Allow IPs of new employees who joined this week",
           "activationStatus": "PENDING_ACTIVATION",
           "syncPoint": 5,
           "uniqueId": "25614_GENERALLIST",
           "fast": false,
           "dispatchCount": 1,
           "links": {
               "appendItems": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
                   "method": "POST"
               },
               "retrieve": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
               },
               "statusInProduction": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
               },
               "statusInStaging": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
               },
               "syncPointHistory": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
               },
               "update": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
                   "method": "PUT"
               },
               "activationDetails": {
                   "href": "/network-list/v2/network-lists/activations/12345/"
               }
           }
       },
       "Activation_PRODUCTION": {
           "activationId": 12345,
           "activationComments": "Allow IPs of new employees who joined this week",
           "activationStatus": "PENDING_ACTIVATION",
           "syncPoint": 5,
           "uniqueId": "25614_GENERALLIST",
           "fast": false,
           "dispatchCount": 1,
           "links": {
               "appendItems": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/append",
                   "method": "POST"
               },
               "retrieve": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST"
               },
               "statusInProduction": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
               },
               "statusInStaging": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
               },
               "syncPointHistory": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST/sync-points/5/history"
               },
               "update": {
                   "href": "/networklist-api/rest/v2/network-lists/25614_GENERALLIST",
                   "method": "PUT"
               },
               "activationDetails": {
                   "href": "/network-list/v2/network-lists/activations/12345/"
               }
           }
       }
   }
]
    Ausgabenachrichten

    Die Aktion Get Network Lists (Netzwerklisten abrufen) gibt die folgenden Ausgabenachrichten zurück:

    Ausgabemeldung Nachrichtenbeschreibung

    Successfully returned network lists from Akamai.

    No network lists were found for the provided criteria in Akamai.

    		 Aktion erfolgreich.
    Error executing action "Get Network Lists". Reason: {0}''.format (error.Stacktrace) Aktion fehlgeschlagen.
    Scriptergebnis

    In der folgenden Tabelle werden die Werte für die Skriptergebnis-Ausgabe bei Verwendung der Aktion Get Network Lists beschrieben:

    Name des Scriptergebnisses Wert
    is_success True oder False

    Ping

    Verwenden Sie die Aktion Ping, um die Verbindung zu Akamai zu testen.

    Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt und hat keine Eingabeparameter.

    Aktionsausgaben

    Die Aktion Ping bietet die folgenden Ausgaben:

    Ausgabetyp der Aktion Verfügbarkeit
    Anhang im Fall-Repository Nicht verfügbar
    Link zum Fall‑Repository Nicht verfügbar
    Tabelle „Fall-Repository“ Nicht verfügbar
    Anreicherungstabelle Nicht verfügbar
    JSON-Ergebnis Nicht verfügbar
    Scriptergebnis Verfügbar
    Ausgabenachrichten

    Die Aktion Ping gibt die folgenden Ausgabenachrichten aus:

    Ausgabemeldung Nachrichtenbeschreibung
    Successfully connected to the Akamai server with the provided connection parameters! Aktion erfolgreich.
    Failed to connect to the Akamai server! Error is {0}".format(exception.stacktrace) Aktion fehlgeschlagen.
    Scriptergebnis

    In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Ping beschrieben:

    Name des Scriptergebnisses Wert
    is_success True oder False

    Elemente aus der Kundenliste entfernen

    Mit der Aktion Remove Items From Client List (Elemente aus der Clientliste entfernen) können Sie Elemente aus der Clientliste in Akamai entfernen.

    Aktionseingaben

    Für die Aktion Remove Items From Client List sind die folgenden Parameter erforderlich:

    Parameter Beschreibung
    Client List Name

    Optional.

    Der Name der zu aktualisierenden Kundenliste.

    Hinweis: Wenn Client List Name und Client List ID angegeben sind, wird die ID für die Aktion verwendet.
    Client List ID

    Optional.

    Die ID der zu aktualisierenden Kundenliste.

    Hinweis: Wenn Client List Name und Client List ID angegeben sind, wird die ID für die Aktion verwendet.
    Item Value

    Erforderlich.

    Eine durch Kommas getrennte Liste der Elemente, die aus der Clientliste entfernt werden sollen.

    Aktionsausgaben

    Die Aktion Remove Items From Client List (Elemente aus Kundenliste entfernen) bietet die folgenden Ausgaben:

    Ausgabetyp der Aktion Verfügbarkeit
    Anhang im Fall-Repository Nicht verfügbar
    Link zum Fall‑Repository Nicht verfügbar
    Tabelle „Fall-Repository“ Nicht verfügbar
    Anreicherungstabelle Nicht verfügbar
    JSON-Ergebnis Verfügbar
    Scriptergebnis Verfügbar
    JSON-Ergebnis

    Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die bei Verwendung der Aktion Remove Items From Client List (Elemente aus der Kundenliste entfernen) empfangen wird:

    [
  {
    "value": "127.0.0.1",
    "status": "doesn't exist"
  },
  {
    "value": "127.0.0.4",
    "status": "removed"
  },
  {
    "value": "127.0.0.4E",
    "status": "failed",
    "error": "Validation failed: delete[0].value: Item of type IP has an invalid value 127.0.0.4E"
  }
]
    Ausgabenachrichten

    Die Aktion Remove Items From Client List (Elemente aus Kundenliste entfernen) gibt die folgenden Ausgabemeldungen aus:

    Ausgabemeldung Nachrichtenbeschreibung

    Successfully updated client list in Akamai.

    None of the provided items were found in the client list in Akamai.

    		 Aktion erfolgreich.

    Error executing action "Remove Items From Client List". Reason: {0}''.format(error.Stacktrace)

    Error executing action "Remove Items From Client List". Reason: provide a value in "Client List Name" or "Client List ID" parameter.

    Error executing action "Remove Items From Client List". Reason: "{client list name or id}" client list wasn't found in Akamai.

    		 Aktion fehlgeschlagen.
    Scriptergebnis

    In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Remove Items From Client List (Elemente aus der Kundenliste entfernen) beschrieben:

    Name des Scriptergebnisses Wert
    is_success True oder False

    Elemente aus der Netzwerkliste entfernen

    Mit der Aktion Remove Items From Network List (Elemente aus der Netzwerkliste entfernen) können Sie Elemente aus der Netzwerkliste in Akamai entfernen.

    Aktionseingaben

    Für die Aktion Remove Items From Network List sind die folgenden Parameter erforderlich:

    Parameter Beschreibung
    Network List Name

    Optional.

    Der Name der Netzwerkliste, die aktualisiert werden soll.

    Wenn Network List Name und Network List ID angegeben sind, wird für die Aktion die ID
    Network List ID

    Optional.

    Die ID der zu aktualisierenden Netzwerkliste.

    Wenn Network List Name und Network List ID angegeben sind, wird für die Aktion die ID
    Items

    Erforderlich.

    Eine durch Kommas getrennte Liste der Elemente, die aus der Netzwerkliste entfernt werden sollen.

    Aktionsausgaben

    Die Aktion Remove Items From Network List (Elemente aus der Netzwerkliste entfernen) bietet die folgenden Ausgaben:

    Ausgabetyp der Aktion Verfügbarkeit
    Anhang im Fall-Repository Nicht verfügbar
    Link zum Fall‑Repository Nicht verfügbar
    Tabelle „Fall-Repository“ Nicht verfügbar
    Anreicherungstabelle Nicht verfügbar
    JSON-Ergebnis Verfügbar
    Scriptergebnis Verfügbar
    JSON-Ergebnis

    Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die bei Verwendung der Aktion Remove Items From Network Lists (Elemente aus Netzwerklisten entfernen) empfangen wird:

    {
       "networkListType": "networkListResponse",
       "accessControlGroup": "KSD\nwith ION 3-13H1234",
       "name": "General List",
       "elementCount": 3011,
       "readOnly": false,
       "shared": false,
       "syncPoint": 22,
       "type": "IP",
       "uniqueId": "25614_GENERALLIST",
       "links": {
         "activateInProduction": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/activate",
           "method": "POST"
         },
         "activateInStaging": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/activate",
           "method": "POST"
         },
         "appendItems": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST",
           "method": "POST"
         },
         "retrieve": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST"
         },
         "statusInProduction": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/PRODUCTION/status"
         },
         "statusInStaging": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST/environments/STAGING/status"
         },
         "update": {
           "href": "/network-list/v2/network-lists/25614_GENERALLIST",
           "method": "PUT"
         }
       }
     }
    Ausgabenachrichten

    Die Aktion Remove Items From Network List (Elemente aus der Netzwerkliste entfernen) gibt die folgenden Ausgabemeldungen zurück:

    Ausgabemeldung Nachrichtenbeschreibung

    Successfully updated network list in Akamai.

    None of the provided items were found in the network list in Akamai.

    		 Aktion erfolgreich.

    Error executing action "Remove Items From Network List". Reason: {0}''.format (error.Stacktrace)

    Error executing action "Remove Items From Network List". Reason: "{network name or id}" network list wasn't found in Akamai.

    Error executing action "Remove Items From Network List". Reason: provide a value in "Network List Name" or "Network List ID" parameter.

    		 Aktion fehlgeschlagen.
    Scriptergebnis

    In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Remove Items From Network List (Elemente aus der Netzwerkliste entfernen) beschrieben:

    Name des Scriptergebnisses Wert
    is_success True oder False

    Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten