/policyengine/v1/policies/<policy_name> -d '<Daten>': PUT

Aktualisiert eine Richtlinie.

Der Endpunkt /policyengine/v1/policies/<policy_id> -d '<data>': PUT aktualisiert eine vorhandene Richtlinie mit den Attributwerten, die in den Anforderungsdaten angegeben sind. Attribute, die nicht aktualisiert werden, behalten dieselben Werte wie vor der Aktualisierung. Die folgenden Attribute können aktualisiert werden: action_parameters, schedule, pol_filterund pol_state. Das Attribut action_id kann nicht aktualisiert werden. Sie können jedoch eine vorhandene Richtlinie löschen und dann eine neue mit demselben Namen und denselben Attributen wie die gelöschte Richtlinie, aber mit einem anderen action_iderstellen. Weitere Informationen zu den Attributen in den Anforderungsdaten finden Sie unter Endpunkte für die Arbeit mit der Richtlinienverwaltung.

Hinweis: Sie können eine Richtlinie nicht aktualisieren, während sie ausgeführt wird.
Die folgende Tabelle zeigt, welche Rollen auf diesen REST-API-Endpunkt zugreifen können:
Tabelle 1 Zugriff nach Rolle
Datenverwaltung Datenbenutzer Administrator von Sammlung Benutzer von Sammlung Administrator Service
✓1, 2 X X Χ Χ
1Der Befehl lässt den Zugriff nur zu, wenn das Attribut schedule auf NOWgesetzt ist.
2Der Befehl wendet die Richtlinie nur in Sammlungen an, in denen der Benutzer die Rolle datauser hat.

Überblick über den Antrag URL

curl -k -H 'Authorization: Bearer <token>' https://<data_cataloging_host>/policyengine/v1/policies/<policy_name> -d '<data>' -X PUT -H "Content-Type: application/json"

Unterstützte Anforderungstypen und Antwortformate

Unterstützte Anforderungstypen:
  • PUT
Unterstützte Antwortformate:
  • JSON

Beispiele

  1. Im folgenden Beispiel wird eine Richtlinie mit dem Namen pol2: aktualisiert:
    1. Geben Sie die folgende Anforderung in einer Zeile aus:
      curl -k -H 'Authorization: Bearer \<token>' 
      https://<data_cataloging_host>
      /policyengine/v1/policies/<policy_name>
      -d '{
         "pol_filter": "user='research1'",
         "pol_state": "active"
         "action_params": {"tags": {"tag4":"val4", "tag5":"val5"}},
         "schedule":"NOW"
      }'
       -X POST -H "Content-Type: application/json"
    2. Die folgende Antwort wird zurückgegeben:
      Policy 'pol2' updated
    Um zu überprüfen, ob die Richtlinie erstellt wurde, geben Sie eine GET-Anforderung aus, um die Informationen zur angegebenen Richtlinie oder zu allen Richtlinien im System aufzulisten. Weitere Informationen finden Sie unter /policyengine/v1/policies: GET und /policyengine/v1/policies/<policy_name>: GET.