Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Filterversion festlegen

In diesem Dokument wird beschrieben, wie Model Armor-Filterversionen funktionieren und wie Sie Model Armor anweisen, eine bestimmte Filterversion oder einen bestimmten Filterversionsalias in Vorgängen zu verwenden.

Model Armor verwendet Filter, um schädliche Inhalte, sensible Daten, schädliche URLs, Darstellungen des sexuellen Missbrauchs von Kindern und Prompt-Injection-Angriffe in LLM-Prompts und -Antworten zu erkennen und zu blockieren. Weitere Informationen finden Sie unter Model Armor-Filter.

Model Armor-Filterversionen bieten Stabilität für Produktionsarbeitslasten und Zugriff auf die neuesten Modelle zur Bedrohungserkennung. Sie konfigurieren eine einzelne Filterversion auf Vorlagenebene. Sie können keine unterschiedlichen Versionen für einzelne Filter angeben.

Wann Filterversionen und Aliasse konfiguriert werden sollten

Im Folgenden sind einige gängige Anwendungsfälle aufgeführt:

Deterministisches Filterverhalten sperren: Legen Sie Vorlagen auf eine bestimmte Filterversion fest, um Änderungen an der Logik zur Bedrohungserkennung in geschäftskritischen Systemen zu verhindern.
Automatische Sicherheitsupdates erhalten: Verwenden Sie den Alias Stable, um aktualisierte Modelle zur Bedrohungserkennung automatisch zu übernehmen, sobald sie die Validierung bestanden haben.
Anstehende Erkennungsfunktionen testen: Verwenden Sie den Alias Latest in Vorproduktionsumgebungen, um neue Filterregeln anhand von realen Traffic-Mustern zu bewerten.
Vorhersehbare Roll-out-Zyklen aktivieren: Validieren Sie Arbeitslasten anhand neu veröffentlichter Filterversionen, bevor Sie Produktionsvorlagen manuell aktualisieren.

Versionsaliasse

In einer Model Armor-Vorlage können Sie einen Alias verwenden, um die gewünschte Filterversion anzugeben. Ein Alias stellt eine Phase im Versionslebenszyklus dar. Jeder Alias wird im Laufe des Lebenszyklus auf die entsprechende Version festgelegt.

Wenn Sie einen Alias auswählen, wird in der Vorlage die Version verwendet, auf die der Alias festgelegt ist. Wenn die zugrunde liegende Version für diesen Alias aktualisiert wird (z. B. wenn eine neue Version auf Stable hochgestuft wird), verwenden Vorlagen, die den Alias verwenden, automatisch die neue Version. Wenn Sie nicht möchten, dass sich die Filterversion ändert, verweisen Sie in der Vorlage auf eine bestimmte Filterversion.

Sie können aus den folgenden Aliasen auswählen:

Latest: Der Alias mit den neuesten Modellen und Schutzmaßnahmen, der regelmäßig aktualisiert wird, um auf neue Bedrohungen zu reagieren. Dieser Alias bietet Standard-Service-Level-Ziele (SLOs), die Stabilität kann jedoch von Version zu Version variieren. Sie eignet sich für Tests, Staging und Arbeitslasten, bei denen aktuelle Erkennungsmodelle Vorrang vor konsistentem Filterverhalten haben.
Stable: Der Standardalias für Versionen mit verfügbaren Vorlagen. Dieser Alias bietet eine zuverlässige, unveränderliche Erkennungslogik und eignet sich für Produktionsumgebungen und Arbeitslasten, die ein unverändertes Filterverhalten erfordern. Wenn eine neue Version zu Stable wird, wird die vorherige Stable-Version zu Legacy.
Legacy: Der Alias für eine frühere Stable-Version, die nach der Veröffentlichung einer neuen Stable-Version noch 90 Tage lang verfügbar ist. Sie können Ihre Produktionssysteme jederzeit während dieses Zeitraums zur neuen Stable-Version migrieren. Sie können keine neuen Vorlagen mit einer Legacy-Version erstellen.
Retired: Der Alias für eine Version, die den 90-tägigen Legacy-Zeitraum überschritten hat und nicht mehr verfügbar ist. Model Armor verwendet die Version Stable, um Aufrufe von Vorlagen zu bereinigen, die noch eine Retired-Version verwenden.

Filter, die keine Filterversionen verwenden

Die Einstellung für Filterversionen hat keine Auswirkungen auf Sensitive Data Protection und Filter für schädliche URLs.

Lebenszyklus von Versionen

Google Cloud stellt in jeder Sanitize API-Antwort Benachrichtigungen zu Änderungen am Versionslebenszyklus bereit, einschließlich des Zeitpunkts, zu dem eine Version Legacy wird, und des bevorstehenden Ausmusterungsdatums. Sie müssen alle Vorlagen, die eine Legacy-Version verwenden, innerhalb von 90 Tagen zu Stable oder Latest migrieren.

Im folgenden Beispiel wird der Lebenszyklus einer Version beschrieben:

Release (Latest): Google veröffentlicht eine neue Filterversion (v2) als Latest.
Hochstufung (Latest zu Stable): Wenn Google die Latest-Version zu Stable hochstuft (v2 wird zu Stable), geschieht Folgendes:
1. Google verschiebt die vorherige Stable-Version (v1) nach Legacy.
2. Eine neue Version (v3) wird zum neuen Latest. Google stuft eine Version hoch, nachdem sie strengen Tests unterzogen wurde, eine konsistente tägliche Nutzung aufweist und nur minimale Kundenprobleme verursacht oder wenn ein kritischer Bedrohungsschutz erforderlich wird.
Einstellung (Legacy bis Retired): Nachdem eine Filterversion 90 Tage lang im Status Legacy verbleibt, wird sie von Google eingestellt und ist nicht mehr verfügbar.

Zeitplan für die Veröffentlichung von Versionen

In der folgenden Tabelle finden Sie Details zu Filterversionen, einschließlich Aliasen, Veröffentlichungsdaten, Ausmusterungsdaten und unterstützten Regionen.

Version	Alias	Releasedatum	Ausmusterungsdatum	Unterstützte Region
`v1`	`Legacy` (`Stable` in `asia-northeast3`; `Legacy` ab dem 25. September 2026 in `australia-southeast2`)	2025-01-30	2026-12-17	`asia-northeast1` `asia-northeast3` (`Stable`) `asia-south1` `asia-southeast1` `australia-southeast2` (`Legacy` ab dem 25. September 2026) `europe-southwest1` `europe-west9` `northamerica-northeast2` `us` `us-central1` `us-east4` `us-west1`
`v2`	`Legacy`	2025-06-19	2026-12-17	`eu` `europe-west1` `europe-west2` `europe-west3` `europe-west4` `us-east1`
`v3`	`Stable` (`Stable` ab dem 25. September 2026 in `australia-southeast2`)	2026-05-25	–	`asia-northeast1` `asia-south1` `asia-southeast1` `australia-southeast2` (`Stable` ab dem 25. September 2026) `eu` `europe-southwest1` `europe-west1` `europe-west2` `europe-west3` `europe-west4` `europe-west9` `northamerica-northeast2` `southamerica-east1` `us` `us-central1` `us-east1` `us-east4` `us-west1`
`v4`	`Latest`	2026-09-18	–	`asia-northeast1` `asia-south1` `asia-southeast1` `eu` `europe-southwest1` `europe-west1` `europe-west2` `europe-west3` `europe-west4` `europe-west9` `northamerica-northeast2` `southamerica-east1` `us` `us-central1` `us-east1` `us-east4` `us-west1`

Informationen zu den Änderungen in den einzelnen Versionen finden Sie im Versionsverlauf für Filter.

Vorlagenverhalten

Das Verhalten der Vorlage hängt von der verwendeten Filterversion ab und weist die folgenden Merkmale auf:

Vorlagen ohne Version: Vorlagen ohne angegebene Version, ob neu oder vorhanden, werden standardmäßig auf die Version Stable gesetzt.
Vorlagen mit den Aliasen Latest oder Stable: Diese Vorlagen verwenden automatisch die Version, die diesen Aliasen zugewiesen ist. Wenn beispielsweise eine neue Filterversion zur Stable-Version wird, werden Vorlagen, die den Alias Stable verwenden, auf die neue Version umgestellt, ohne dass Änderungen an den Vorlagen erforderlich sind.

Hinweis: Sie können die Filterversion in einer Vorlage nicht auf Legacy oder Retired festlegen.
Vorlagen, die eine bestimmte Version verwenden:
- Wenn die Version einer Latest- oder Stable-Version entspricht, verhält sich die Vorlage wie erwartet.
- Wenn die Version einer Legacy-Version entspricht, verhält sich die Vorlage wie erwartet, wenn sie 90 Tage lang für Bereinigungsvorgänge verwendet wird. Nach 90 Tagen wechselt die Version in die Phase Retired. In dieser Phase müssen Sie Ihre Vorlagen entweder zur Version Latest oder Stable migrieren.

Standardfilterversion für Mindestpreiseinstellungen überschreiben

Bei den Mindesteinstellungen verwendet die Gemini Enterprise Agent Platform-Integration standardmäßig die Filterversion Stable. Wenn Sie diese Einstellung überschreiben möchten, geben Sie im generateContent-Aufruf an das Gemini-Modell eine Vorlage an. Erstellen Sie dazu eine Vorlage mit einer bestimmten Filterversion oder einem Alias in der Region, in der Sie die Gemini-Anfrage senden möchten.

gcloud

gcloud model-armor templates create TEMPLATE_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --pi-and-jailbreak-filter-settings-enforcement=enabled \
    --filter-version-selector-alias=FILTER_VERSION_ALIAS

Ersetzen Sie Folgendes:

TEMPLATE_ID: die ID der zu erstellenden Vorlage.
PROJECT_ID: die ID des Projekts, zu dem die Vorlage gehört.
LOCATION: die Region, in der die Model Armor-Vorlage gespeichert werden soll. Diese Region muss mit der Region übereinstimmen, in die Sie die Gemini-Anfrage senden möchten. Andernfalls erhält die Agent Platform den Fehler Template not found. Eine Liste der Regionen, die für diese Integration unterstützt werden, finden Sie unter Integration in die Gemini Enterprise Agent Platform.
FILTER_VERSION_ALIAS: Ihr bevorzugter Alias für die Filterversion. Verwenden Sie entweder filter-version-alias-stable oder filter-version-alias-latest.

REST

export TEMPLATE_CONFIG='{
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "alias": "FILTER_VERSION_ALIAS"
    }
  }
}'

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d "$TEMPLATE_CONFIG" \
    "https://modelarmor.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/templates?template_id=TEMPLATE_ID"

Ersetzen Sie Folgendes:

FILTER_VERSION_ALIAS: Ihr bevorzugter Filterversionsalias. Verwenden Sie entweder FILTER_VERSION_ALIAS_STABLE oder FILTER_VERSION_ALIAS_LATEST.
PROJECT_ID: die ID des Projekts, zu dem die Vorlage gehört.
TEMPLATE_ID: die ID der zu erstellenden Vorlage.
LOCATION: die Region, in der die Model Armor-Vorlage gespeichert werden soll. Diese Region muss mit der Region übereinstimmen, in die Sie die Gemini-Anfrage senden möchten. Andernfalls erhält die Agent Platform den Fehler Template not found. Eine Liste der Regionen, die für diese Integration unterstützt werden, finden Sie unter Integration in die Gemini Enterprise Agent Platform.

Geben Sie die Vorlagen-ID im model_armor_config-Objekt in Ihrem Gemini-Aufruf an. Die in der Vorlage angegebene Filterkonfiguration wird anstelle der Mindesteinstellung auf Projektebene angewendet.

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/gemini-2.5-flash:generateContent" \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Your prompt here"
        }
      ]
    }
  ],
  "model_armor_config": {
    "prompt_template_name": "projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID",
    "response_template_name": "projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID"
  }
}'

Ersetzen Sie Folgendes:

PROJECT_ID: die Projekt-ID von Google Cloud .
REGION: die Google Cloud -Region des Gemini-Endpunkts.
LOCATION: die Region, in der die Model Armor-Vorlage gespeichert ist. Dies muss dieselbe Region sein, die für REGION angegeben wurde.
TEMPLATE_ID: die ID der Model Armor-Vorlage.

Filterversion für eine Vorlage konfigurieren

Sie können die Filterversion für eine Vorlage auf zwei Arten konfigurieren:

Alias verwenden: Verwenden Sie dynamische Aliase wie Stable oder Latest, damit die Vorlage automatisch eine Versionsnummer verwendet, die Ihrem bevorzugten Alias entspricht. Dadurch sind keine manuellen Updates mehr erforderlich, wenn sich die zugrunde liegende Version ändert.
Mit einer Versionsnummer: Verwenden Sie eine Versionsnummer wie v3 oder v4, um sicherzustellen, dass eine Vorlage auf eine bestimmte Version festgelegt ist. So wird ein festes, unverändertes Verhalten gewährleistet, auch wenn Aliase aktualisiert werden.

Vorlage mit einem Versionsalias erstellen

Führen Sie den folgenden Befehl aus, um eine Vorlage mit einem bestimmten Versionsalias zu erstellen:

gcloud

gcloud model-armor templates create TEMPLATE_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --pi-and-jailbreak-filter-settings-enforcement=enabled \
    --filter-version-selector-alias=FILTER_VERSION_ALIAS

Ersetzen Sie Folgendes:

TEMPLATE_ID: die ID der zu erstellenden Vorlage.
PROJECT_ID: die ID des Projekts, zu dem die Vorlage gehört.
LOCATION: der Standort der Vorlage.
FILTER_VERSION_ALIAS: Ihr bevorzugter Alias für die Filterversion. Verwenden Sie entweder filter-version-alias-stable oder filter-version-alias-latest.

REST

export TEMPLATE_CONFIG='{
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "alias": "FILTER_VERSION_ALIAS"
    }
  }
}'

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d "$TEMPLATE_CONFIG" \
    "https://modelarmor.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/templates?template_id=TEMPLATE_ID"

Ersetzen Sie Folgendes:

FILTER_VERSION_ALIAS: Ihr bevorzugter Filterversionsalias. Verwenden Sie entweder FILTER_VERSION_ALIAS_STABLE oder FILTER_VERSION_ALIAS_LATEST.
PROJECT_ID: die ID des Projekts, zu dem die Vorlage gehört.
TEMPLATE_ID: die ID der zu erstellenden Vorlage.
LOCATION: der Standort der Vorlage.

Das Ergebnis sieht etwa so aus:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID",
  "createTime": "2026-04-05T17:57:46.976854398Z",
  "updateTime": "2026-04-05T17:57:46.976854398Z",
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "alias": "FILTER_VERSION_ALIAS"
    }
  }
}

Vorlage mit einer bestimmten Filterversion erstellen

Wenn Sie die Unveränderlichkeit von Filtern benötigen, können Sie eine Vorlage erstellen, die einer bestimmten Version entspricht. Führen Sie hierzu den folgenden Befehl aus:

gcloud

gcloud model-armor templates create TEMPLATE_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --pi-and-jailbreak-filter-settings-enforcement=enabled \
    --filter-version-selector=FILTER_VERSION_NUMBER

Ersetzen Sie Folgendes:

TEMPLATE_ID: die ID der zu erstellenden Vorlage.
PROJECT_ID: die ID des Projekts, zu dem die Vorlage gehört.
LOCATION: der Standort der Vorlage.
FILTER_VERSION_NUMBER: Ihre bevorzugte Filterversionsnummer, z. B. v3 oder v4.

REST

export TEMPLATE_CONFIG='{
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "version": "FILTER_VERSION_NUMBER"
    }
  }
}'

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d "$TEMPLATE_CONFIG" \
    "https://modelarmor.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/templates?template_id=TEMPLATE_ID"

Ersetzen Sie Folgendes:

FILTER_VERSION_NUMBER: Ihre bevorzugte Filterversionsnummer, z. B. v3 oder v4.
PROJECT_ID: die ID des Projekts, zu dem die Vorlage gehört.
TEMPLATE_ID: die ID der zu erstellenden Vorlage.
LOCATION: der Standort der Vorlage.

Das Ergebnis sieht etwa so aus:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID",
  "createTime": "2026-04-05T18:03:29.134974974Z",
  "updateTime": "2026-04-05T18:03:29.134974974Z",
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "version": "FILTER_VERSION_NUMBER"
    }
  }
}

Filterversion einer Vorlage aktualisieren

Sie können eine vorhandene Vorlage aktualisieren, um einen Filterversions-Alias oder eine bestimmte Filterversionsnummer zu verwenden:

gcloud

Führen Sie den folgenden Befehl aus, um eine Vorlage für die Verwendung eines Filterversions-Alias zu aktualisieren:

gcloud model-armor templates update TEMPLATE_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --filter-version-selector-alias=FILTER_VERSION_ALIAS

Führen Sie den folgenden Befehl aus, um eine Vorlage so zu aktualisieren, dass eine bestimmte Filterversionsnummer verwendet wird:

gcloud model-armor templates update TEMPLATE_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --filter-version-selector=FILTER_VERSION_NUMBER

Ersetzen Sie Folgendes:

TEMPLATE_ID: die ID der zu aktualisierenden Vorlage.
PROJECT_ID: die ID des Projekts, zu dem die Vorlage gehört.
LOCATION: der Standort der Vorlage.
FILTER_VERSION_ALIAS: Ihr bevorzugter Alias für die Filterversion. Verwenden Sie entweder filter-version-alias-stable oder filter-version-alias-latest.
FILTER_VERSION_NUMBER: Ihre bevorzugte Filterversionsnummer, z. B. v3 oder v4.

REST

Führen Sie den folgenden Befehl aus, um eine Vorlage für die Verwendung eines Filterversions-Alias zu aktualisieren:

export TEMPLATE_CONFIG='{
  "templateMetadata": {
    "filterVersionSelector": {
      "alias": "FILTER_VERSION_ALIAS"
    }
  }
}'

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d "$TEMPLATE_CONFIG" \
    "https://modelarmor.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID?updateMask=templateMetadata.filterVersionSelector"

Führen Sie den folgenden Befehl aus, um eine Vorlage so zu aktualisieren, dass eine bestimmte Filterversionsnummer verwendet wird:

export TEMPLATE_CONFIG='{
  "templateMetadata": {
    "filterVersionSelector": {
      "version": "FILTER_VERSION_NUMBER"
    }
  }
}'

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d "$TEMPLATE_CONFIG" \
    "https://modelarmor.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID?updateMask=templateMetadata.filterVersionSelector"

Ersetzen Sie Folgendes:

FILTER_VERSION_ALIAS: Ihr bevorzugter Alias für die Filterversion. Verwenden Sie entweder FILTER_VERSION_ALIAS_STABLE oder FILTER_VERSION_ALIAS_LATEST.
FILTER_VERSION_NUMBER: Ihre bevorzugte Filterversionsnummer, z. B. v3 oder v4.
PROJECT_ID: die ID des Projekts, zu dem die Vorlage gehört.
TEMPLATE_ID: die ID der zu aktualisierenden Vorlage.
LOCATION: der Standort der Vorlage.

Das Ergebnis sieht etwa so aus:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID",
  "createTime": "2026-04-05T18:03:29.134974974Z",
  "updateTime": "2026-04-05T18:04:07.711205953Z",
  "filterConfig": {
    "piAndJailbreakFilterSettings": {
      "filterEnforcement": "ENABLED"
    }
  },
  "templateMetadata": {
    "filterVersionSelector": {
      "alias": "FILTER_VERSION_ALIAS"
    }
  }
}

In Bereinigungsvorgängen verwendete Filterversion ansehen

Die Sanitize API-Antwortmetadaten enthalten Informationen zur Filterversion, die während der Bereinigung verwendet wird. Ebenso geben die Bereinigungsbefehle der Google Cloud CLI diese Informationen in ihrer Ausgabe zurück und der Befehl gcloud model-armor templates describe zeigt die Filterversion einer Vorlage an.

30 Tage vor der Einstellung der Version erhalten Sie in der Bereinigungsantwort eine Warnung zur Einstellung.

Das folgende Beispiel zeigt eine API-Antwort, die die Filterversion enthält:

"sanitizationResult": {
    "filterMatchState": "NO_MATCH_FOUND",
    "invocationResult": "SUCCESS",
    "filterResults": {
      "csam": {
        "csamFilterFilterResult": {
          "executionState": "EXECUTION_SUCCESS",
          "matchState": "NO_MATCH_FOUND"
        }
      },
      "malicious_uris": {
        "maliciousUriFilterResult": {
          "executionState": "EXECUTION_SUCCESS",
          "matchState": "NO_MATCH_FOUND"
        }
      },
      "rai": {
        "raiFilterResult": {
          "executionState": "EXECUTION_SUCCESS",
          "matchState": "NO_MATCH_FOUND",
          "raiFilterTypeResults": {
            "sexually_explicit": {
              "matchState": "NO_MATCH_FOUND"
            },
            "hate_speech": {
              "matchState": "NO_MATCH_FOUND"
            },
            "harassment": {
              "matchState": "NO_MATCH_FOUND"
            }
          }
        }
      },
      "pi_and_jailbreak": {
        "piAndJailbreakFilterResult": {
          "executionState": "EXECUTION_SUCCESS",
          "matchState": "NO_MATCH_FOUND"
        }
      },
      "sdp": {
        "sdpFilterResult": {
          "inspectResult": {
            "executionState": "EXECUTION_SUCCESS",
            "matchState": "NO_MATCH_FOUND"
          }
        }
      }
    },
  "sanitizationMetadata": {
    "filterVersionConfig": {
      "filterVersion": "v2",
      "filterVersionAlias": "FILTER_VERSION_ALIAS_LEGACY",
      "releaseDate": {
        "year": 2025,
        "month": 6,
        "day": 19
      },
      "projectedDeprecationDate": {
        "year": 2026,
        "month": 12,
        "day": 17
      },
      "messageItems": [
        {
          "messageType": "WARNING",
          "message": "This filter version (v2) is in LEGACY state and will be
          RETIRED on 2026-12-17. Please migrate your template to the STABLE or
          LATEST version to ensure continued protection."
        }
      ]
   }
  }
}

Model Armor generiert Plattformlogs für Bereinigungsanfragen und die zugehörigen Antworten in Cloud Logging. Weitere Informationen zu den automatisch generierten Audit-Logs finden Sie unter Model Armor-Audit-Logging.

Filterversion festlegen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Wann Filterversionen und Aliasse konfiguriert werden sollten

Versionsaliasse

Filter, die keine Filterversionen verwenden

Lebenszyklus von Versionen

Zeitplan für die Veröffentlichung von Versionen

Vorlagenverhalten

Standardfilterversion für Mindestpreiseinstellungen überschreiben

gcloud

REST

Filterversion für eine Vorlage konfigurieren

Vorlage mit einem Versionsalias erstellen

gcloud

REST

Vorlage mit einer bestimmten Filterversion erstellen

gcloud

REST

Filterversion einer Vorlage aktualisieren

gcloud

REST

In Bereinigungsvorgängen verwendete Filterversion ansehen

Filterversion festlegen