Erforderliche Berechtigung

Um diese Aufgabe abzuschließen, müssen Sie Administrator des Projekts (Namespace) sein, in dem Sie das IBM Knowledge Catalog Service.

Vorbereitende Schritte

• Alle Artefakte, Benutzer, Benutzergruppen, Benutzerrollen und Assets, die in Regeln verwendet werden, müssen ordnungsgemäß in das Zielsystem importiert werden, bevor die exportierten Regeln importiert werden.

• Um Fehler und Änderungen am Durchsetzungsverhalten zu vermeiden, müssen Sie überprüfen, ob die Regeleinstellungen verwalten zwischen Quell- und Zielsystem gleich konfiguriert sind.

• Bevor Sie eine Regel importieren, überprüfen Sie, ob Sie benutzerdefinierte Prädikate in den exportierten Regeln. Wenn ja, müssen Sie diese benutzerdefinierten Prädikate im Zielsystem erstellen, bevor Sie importieren können.

Einschränkungen

Die nicht maskierten Originaldaten können in den folgenden Szenarios im temporären Speicher bestehen bleiben:

• Ein Cache mit Daten, die im Abschnitt Beispieldaten angezeigt wird, wenn eine Datenschutzregel erstellt oder bearbeitet wird.
• Eine maskierte Kopie der Daten in Cloud Object Storage zum schnellen Abrufen der maskierten Daten.
• Profildaten speichern möglicherweise nicht die gesamten Daten, sondern eine Aggregation der Daten, die Werte enthalten kann, die in den Daten gefunden werden.

Exportieren

Um aus einer Installation in eine andere zu exportieren, setzen Sie external_export auf true , indem Sie die folgende API ausführen:

curl -k -X GET -H 'Content-Type: application/json' -H "Authorization:Bearer $token" '$url/v3/enforcement/rules/export?external_export=true'

Es wird eine exported_file.json -Datei generiert, die für den Import verwendet wird.

Importieren

1. Bevor Sie zwischen verschiedenen Installationen importieren, generieren Sie einen Bericht über alle Regeln, die erfolgreich sind oder nicht mit IDs im Zielsystem übereinstimmen. Durch Ausführen der folgenden API, die den Parameter commit auf falsesetzt:

curl -k -X POST -H 'Content-Type: application/octet-stream' -H "Authorization:Bearer $token" '$url/v3/enforcement/rules/import?external_import=true&commit=false' -d "@./exported_file.json"

Bevor Sie die Regeln festschreiben, verwenden Sie den folgenden Bericht, um alle Regeln zu ermitteln, die nicht mit IDs im Zielsystem übereinstimmen. Wenn Sie den Import mit external_import auf truesetzen, werden keine Regeln erstellt und festgeschrieben, wenn der Parameter commit auf falsegesetzt ist:

{
  "failedList": [
    {
      "name": "export name4",
      "index": 4,
      "ruleGuidInRequest": "abcd123e-123b-1ab2-a123-ab123456c7d1",
      "reason": "WDPPS9040E: Import rules failed to match export component ids: [id=123a4b56-1a23-1234-a1bc-12a3b45cd6ef_123a4b56-1a23-1a23-1a23-12ab345cd67e]"
    }
  ],
  "matchedList": [
    {
      "name": "export name1",
      "index": 1,
      "ruleGuidInRequest": "12abc456-1234-12a3-a1bc-a1abc2345abc"
    },
    {
      "name": "export name2",
      "index": 2,
      "ruleGuidInRequest": "123456a7-1abc-1a2b-a1bc-ab1cd234ef56"
    },
    {
      "name": "export name3",
      "index": 3,
      "ruleGuidInRequest": "a123bcd4-a1b2-1234-1234-a1234567b123"
    }
  ]
}

2. Führen Sie die folgende API aus, um den Parameter commit auf truezu setzen, sodass alle oder keine Regeln festgeschrieben werden können. Wenn eine der Regeln fehlschlägt, schlägt der gesamte Import fehl:

curl -k -X POST -H 'Content-Type: application/octet-stream' -H "Authorization:Bearer $token" '$url/v3/enforcement/rules/import?external_import=true&commit=true' -d "@./exported_file.json"

Eine Beispielantwort beim erfolgreichen Import des Exportpakets (exported_file.json -Datei):

SUCCEEDED
{
  "importedList": [
    {
      "name": "export name1",
      "index": 1,
      "guid": "a1b2cd3e-4567-8f90-gh12-345i6jklm78n",
      "ruleGuidInRequest": "12abc345-6789-01d2-e3fg-h4ijk5678lmn"
    },
    {
      "name": "export name2",
      "index": 2,
      "guid": "12a234b5-c678-90d1-ef2g-34567h8i9012",
      "ruleGuidInRequest": "123456a7-8bcd-9e0f-g1hi-jk2lm345no67"
    },
    {
      "name": "export name3",
      "index": 3,
      "guid": "1a234b5c-d6e7-89f0-1234-5g6hi7j8901k",
      "ruleGuidInRequest": "aa123bcd4-e5f6-7890-1234-g5678901h234"
    },
    {
      "name": "export name4",
      "index": 4,
      "guid": "12a345bc-6789-0d12-3ef4-g5h6ijk789lm",
      "ruleGuidInRequest": "abcd123e-456f-7gh8-i901-jk234567l8m9"
    }
  ]
}

Eine Beispielantwort beim Importieren des Exportpakets (exported_file.json -Datei) schlägt fehl:

FAILED
{
  "trace": "a1bc2d3e4fg5h6ijklmn7o9pq",
  "errors": [
    {
      "code": "WDPPS9043E",
      "message": "WDPPS9043E: Import rules failed: {\"failedList\":[{\"name\":\"export name4\",\"index\":4,\"ruleGuidInRequest\":\"abcd123e-123b-1ab2-a123-ab123456c7d1\",\"reason\":\"WDPPS9040E: Import rules failed to match export component ids: [id=123a4b56-7c89-0123-d4ef-56g7h89ij0kl_123m4n56-7o89-0p12-3q45-67rs890tu12v]\"}]}"
    }
  ]
}

Übergeordnetes Thema: Verwaltung IBM Knowledge Catalog