Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Migrieren gespeicherter Objekte von Dashboards zur Benutzeroberfläche OpenSearch OpenSearch
<a name="application-migration"></a>

Wenn Sie bereits Dashboards, Visualisierungen, Indexmuster und andere gespeicherte Objekte in OpenSearch Dashboards haben, können Sie diese in der Benutzeroberfläche migrieren und wiederverwenden. OpenSearch 

Vorteile der Migration zur Benutzeroberfläche: OpenSearch 
+ **Hohe Verfügbarkeit** — Die OpenSearch Benutzeroberfläche wird in der gehostet AWS Cloud und bleibt während Domain-Upgrades und Wartungsarbeiten verfügbar, während OpenSearch Dashboards innerhalb der Domain gehostet werden und vorübergehend nicht verfügbar sein werden.
+ **Mehrere Datenquellen** — Die OpenSearch Benutzeroberfläche kann eine konsolidierte zentrale Oberfläche für mehrere Datenquellen bereitstellen, einschließlich OpenSearch Domains, serverloser Sammlungen und Datenverbindungen mit Amazon S3 und Amazon CloudWatch. Jedes OpenSearch Dashboard kann jedoch nur mit einer Domain oder Sammlung funktionieren.
+ Zusätzliche Funktionen wie AI Assistant und Workspaces sind auf der Benutzeroberfläche verfügbar. OpenSearch Erfahre mehr:[Verwenden der OpenSearch Benutzeroberfläche in Amazon OpenSearch Service](application.md).

**Topics**
+ [Überblick über die Migration](#application-migrate-saved-objects-overview)
+ [Voraussetzungen](#application-migrate-saved-objects-prerequisites)
+ [Schritt 1: Exportieren Sie gespeicherte Objekte aus OpenSearch Dashboards](#application-migrate-saved-objects-export)
+ [Schritt 2: Importieren Sie gespeicherte Objekte in die Benutzeroberfläche OpenSearch](#application-migrate-saved-objects-import)

## Überblick über die Migration
<a name="application-migrate-saved-objects-overview"></a>

Der Migrationsprozess besteht aus den folgenden allgemeinen Schritten:

1. **Exportieren von gespeicherten Objekten aus OpenSearch Dashboards** — Verwenden Sie die Verwaltungsschnittstelle für gespeicherte Objekte in OpenSearch Dashboards oder die Export-API, um Ihre Dashboards, Visualisierungen, Indexmuster und andere Objekte als durch Zeilenumbrüche getrennte JSON-Datei (NDJSON) herunterzuladen.

1. **Erstellen Sie eine OpenSearch UI-Anwendung und einen Workspace** — Falls Sie dies noch nicht getan haben, erstellen Sie eine UI-Anwendung und einen OpenSearch Workspace, um die importierten Objekte zu empfangen.

1. **Registrieren Sie die Datenquelle in der OpenSearch Benutzeroberfläche** — Ordnen Sie Ihre OpenSearch Domain der OpenSearch UI-Anwendung zu und registrieren Sie sie als Datenquelle im Workspace. Indexmuster in Ihren importierten Objekten verweisen auf diese Datenquelle.

1. **Gespeicherte Objekte in die OpenSearch Benutzeroberfläche importieren** — Verwenden Sie die OpenSearch UI Saved Objects Management UI oder die Import-API, um die NDJSON-Datei in den Ziel-Workspace hochzuladen.

1. **Überprüfen Sie die importierten Objekte** — Öffnen Sie Ihre Dashboards und Visualisierungen in der OpenSearch Benutzeroberfläche, um zu überprüfen, ob sie korrekt angezeigt werden und ob Daten aus der zugehörigen Domäne oder Sammlung stammen.

## Voraussetzungen
<a name="application-migrate-saved-objects-prerequisites"></a>

Überprüfen Sie vor der Migration die folgenden Voraussetzungen:
+ Sie verfügen über die erforderlichen IAM-Berechtigungen, um den Amazon OpenSearch Service aufzurufen und OpenSearch APIs. Weitere Informationen finden Sie unter [Erforderliche Berechtigungen für die Erstellung von Amazon OpenSearch Service-Anwendungen](application-getting-started.md#application-prerequisite-permissions).
+ Sie können auf die Domain oder Sammlung und die OpenSearch Dashboards zugreifen, die Sie migrieren möchten.
+ Sie haben eine OpenSearch UI-Anwendung erstellt. Informationen zum Erstellen einer Anwendung und eines Arbeitsbereichs finden Sie unter[Erste Schritte mit der OpenSearch Benutzeroberfläche in Amazon OpenSearch Service](application-getting-started.md).
+ Sie haben dieselbe Domäne oder Sammlung mit der OpenSearch Benutzeroberflächenanwendung verknüpft. Hinweise zum Zuordnen von Datenquellen finden Sie unter[Verwaltung von Datenquellenzuordnungen und Virtual Private Cloud-Zugriffsberechtigungen](application-data-sources-and-vpc.md).

**Anmerkung**  
OpenSearch Die Benutzeroberfläche unterstützt nur OpenSearch Version 1.3 und höher. Stellen Sie sicher, dass auf Ihrer OpenSearch Domain Version 1.3 oder höher ausgeführt wird, bevor Sie versuchen, gespeicherte Objekte zu migrieren.

## Schritt 1: Exportieren Sie gespeicherte Objekte aus OpenSearch Dashboards
<a name="application-migrate-saved-objects-export"></a>

Exportieren Sie Ihre gespeicherten Objekte mithilfe der Management-Benutzeroberfläche oder der Export-API aus OpenSearch Dashboards. Beim Export wird eine durch Zeilenumbrüche getrennte JSON-Datei (NDJSON) erzeugt, die alle ausgewählten gespeicherten Objekttypen und ihre Abhängigkeiten enthält.

**Topics**
+ [OpenSearch Manueller Export auf Dashboards](#application-migrate-export-console)
+ [Über API exportieren](#application-migrate-export-api)

### OpenSearch Manueller Export auf Dashboards
<a name="application-migrate-export-console"></a>

**Um gespeicherte Objekte mithilfe der OpenSearch Dashboard-Verwaltungsschnittstelle zu exportieren**

1. Öffnen Sie Ihre OpenSearch Dashboards-Instanz.

1. Wählen Sie im linken Navigationsbereich **Management** aus.

1. Wählen Sie unter **Dashboard-Verwaltung** die Option **Gespeicherte Objekte** aus.

1. Wählen Sie die gespeicherten Objekte aus, die Sie exportieren möchten. Um alle Objekte eines bestimmten Typs zu exportieren, filtern Sie mithilfe der Suchleiste nach Typ. Um alle Objekte zu exportieren, aktivieren Sie das Kontrollkästchen in der Tabellenüberschrift.

1. Wählen Sie **Export** aus.

1. Stellen Sie sicher, dass im Dialogfeld **Gespeicherte Objekte exportieren** die Option **Verwandte Objekte einbeziehen** aktiviert ist. Diese Option umfasst alle Objekte, von denen die ausgewählten gespeicherten Objekte abhängen, z. B. Indexmuster, auf die in Visualisierungen verwiesen wird. Deaktivieren Sie diese Option nur, wenn Sie Abhängigkeiten manuell verwalten möchten.

1. Wählen Sie **Exportieren**, um die `.ndjson` Datei auf Ihren lokalen Computer herunterzuladen.

**Tipp**  
Wenn Sie „**Verwandte Objekte einbeziehen**“ wählen, enthält die exportierte NDJSON-Datei alle gespeicherten Objekte, die zum Rendern der ausgewählten Dashboards und Visualisierungen benötigt werden, einschließlich ihrer abhängigen Indexmuster, Visualisierungen und Suchobjekte. Dies vereinfacht den Importschritt und vermeidet fehlende Referenzfehler.

### Über API exportieren
<a name="application-migrate-export-api"></a>

Sie können die Export-API für gespeicherte Objekte von OpenSearch Dashboards verwenden, um gespeicherte Objekte programmgesteuert zu exportieren. Dies ist nützlich, um Migrationen zu automatisieren oder den Exportschritt in eine Pipeline zu integrieren. CI/CD 

**Anmerkung**  
Wenn für Ihre OpenSearch Domain eine [differenzierte Zugriffskontrolle](fgac.md) aktiviert ist, müssen Sie bei Ihrer Exportanfrage Anmeldeinformationen angeben. Verwenden Sie die HTTP-Basisauthentifizierung, indem Sie das `-u` Kennzeichen mit Ihrem Benutzernamen und Passwort hinzufügen. Weitere Informationen über Authentifizierungsoptionen finden Sie unter [Feinkörnige Zugriffskontrolle in Amazon Service OpenSearch](fgac.md).

Das folgende Beispiel exportiert alle Dashboards mit ihren zugehörigen Objekten. Ersetzen Sie {{placeholder values}} durch Ihre Informationen.

```
curl -X POST \
    "https://{{dashboards-endpoint}}/_dashboards/api/saved_objects/_export" \
    -u '{{master-username}}:{{master-password}}' \
    -H "Content-Type: application/json" \
    -H "osd-xsrf: true" \
    -d '{
        "type": ["dashboard", "visualization", "index-pattern", "search"],
        "includeReferencesDeep": true,
        "excludeExportDetails": false
    }' \
    -o {{saved-objects-export.ndjson}}
```

Wenn in Ihrer Domain keine detaillierte Zugriffskontrolle aktiviert ist, können Sie die Markierung weglassen. `-u`

Um bestimmte gespeicherte Objekte nach ID zu exportieren, verwenden Sie den `objects` Parameter anstelle von: `type`

```
curl -X POST \
    "https://{{dashboards-endpoint}}/_dashboards/api/saved_objects/_export" \
    -u '{{master-username}}:{{master-password}}' \
    -H "Content-Type: application/json" \
    -H "osd-xsrf: true" \
    -d '{
        "objects": [
            {"type": "dashboard", "id": "{{dashboard-id}}"},
            {"type": "visualization", "id": "{{visualization-id}}"}
        ],
        "includeReferencesDeep": true
    }' \
    -o {{saved-objects-export.ndjson}}
```

**Anmerkung**  
Um nach gespeicherten Objekten zu suchen IDs, können Sie die API für gespeicherte Objekte verwenden, um alle Objekte eines bestimmten Typs aufzulisten. Das folgende Beispiel listet alle Dashboards auf:  

```
curl -X GET \
    "https://{{dashboards-endpoint}}/_dashboards/api/saved_objects/_find?type=dashboard" \
    -u '{{master-username}}:{{master-password}}'
```
Die Antwort enthält die ID für jedes gespeicherte Objekt. Sie finden die ID auch in der Browser-URL, wenn Sie das Objekt in OpenSearch Dashboards anzeigen.

## Schritt 2: Importieren Sie gespeicherte Objekte in die Benutzeroberfläche OpenSearch
<a name="application-migrate-saved-objects-import"></a>

Nach dem Exportieren der gespeicherten Objekte können Sie die NDJSON-Datei manuell oder über die API in die OpenSearch Benutzeroberfläche importieren.

**Topics**
+ [Manuell auf der Benutzeroberfläche importieren OpenSearch](#application-migrate-import-console)
+ [Über API importieren](#application-migrate-import-api)

### Manuell auf der Benutzeroberfläche importieren OpenSearch
<a name="application-migrate-import-console"></a>

**Um gespeicherte Objekte mithilfe der OpenSearch UI Management UI zu importieren**

1. Öffnen Sie Ihre OpenSearch UI-Anwendung und navigieren Sie zum Ziel-Workspace.

1. Wähle im Workspace in der oberen Navigationsleiste **Assets** aus oder gehe zur Workspace-Asset-Seite.

1. Wählen Sie „**Importieren**“, um das Dialogfeld „**Elemente importieren**“ zu öffnen.

1. Wählen Sie **„Datei auswählen“** und wählen Sie die `.ndjson` Datei aus, die Sie aus OpenSearch Dashboards exportiert haben.

1. Wählen Sie für **Konfliktmanagement** eine der folgenden Optionen:
   + **Neue Objekte mit eindeutigen Elementen erstellen IDs** (Standard) — Generiert neue Objekte IDs für alle importierten Objekte, wodurch Konflikte mit vorhandenen Objekten vermieden werden.
   + **Nach vorhandenen Objekten suchen** — Prüft, ob Konflikte mit vorhandenen Objekten bestehen. Wenn diese Option ausgewählt ist, wählen Sie eine der folgenden Unteroptionen:
     + **Konflikte automatisch überschreiben** — Bestehende Assets mit derselben ID werden automatisch ersetzt.
     + **Bei Konflikten Maßnahmen anfordern** — Sie werden aufgefordert, jeden Konflikt einzeln zu lösen.

1. Wählen Sie **Importieren** aus.

1. Lesen Sie die Importzusammenfassung.

### Über API importieren
<a name="application-migrate-import-api"></a>

Um gespeicherte Objekte mithilfe der API mit AWS Signature Version 4-Authentifizierung zu importieren, müssen Sie zuerst die Datenquellen-ID abrufen und sie dann in der Importanforderung verwenden. Ersetzen Sie {{placeholder values}} durch Ihre Informationen.

Schritt 1: Holen Sie sich die Datenquellen-ID für Ihren Workspace:

```
curl -X GET \
    "https://{{opensearch-ui-endpoint}}/w/{{workspace-id}}/api/saved_objects/_find?type=data-source" \
    --aws-sigv4 "aws:amz:{{region}}:opensearch" \
    --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
    -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
    -H "osd-xsrf: true"
```

**Anmerkung**  
Die Antwort enthält die Datenquellen-ID. Sie können die Datenquellen-ID auch in der Browser-URL finden, wenn Sie die Datenquelle in der OpenSearch Benutzeroberfläche anzeigen.

Schritt 2: Importieren Sie die gespeicherten Objekte mithilfe der Datenquellen-ID aus Schritt 1:

```
curl -X POST \
    "https://{{opensearch-ui-endpoint}}/w/{{workspace-id}}/api/saved_objects/_import?overwrite=true&dataSourceId={{data-source-id}}" \
    --aws-sigv4 "aws:amz:{{region}}:opensearch" \
    --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
    -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
    -H "osd-xsrf: true" \
    -F "file=@{{saved-objects-export.ndjson}}"
```

**Anmerkung**  
Diese Beispiele verwenden die integrierte `--aws-sigv4` Option von Curl (verfügbar in Curl 7.75 oder höher), um die Anfragen zu signieren. Stellen Sie Ihre AWS Anmeldeinformationen als Umgebungsvariablen ein, bevor Sie die Befehle ausführen: `AWS_ACCESS_KEY_ID``AWS_SECRET_ACCESS_KEY`, und `AWS_SESSION_TOKEN` (falls Sie temporäre Anmeldeinformationen verwenden).