翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 保存されたオブジェクトを OpenSearch Dashboards から OpenSearch UI に移行する
<a name="application-migration"></a>

OpenSearch Dashboards に既存のダッシュボード、ビジュアライゼーション、インデックスパターン、およびその他の保存されたオブジェクトがある場合は、OpenSearch UI でそれらを移行して再利用できます。

OpenSearch UI に移行するメリット:
+ **高可用性** — OpenSearch UI は でホスト AWS クラウド され、ドメインのアップグレードとメンテナンス中は引き続き使用できますが、OpenSearch Dashboards はドメイン内でホストされ、一時的に使用できなくなります。
+ **複数のデータソース** – OpenSearch UI は、OpenSearch ドメイン、サーバーレスコレクション、Amazon OpenSearch S3 および Amazon CloudWatch とのデータ接続など、複数のデータソースにまたがる統合された単一ペインを提供できますが、各 OpenSearch Dashboards は 1 つのドメインまたはコレクションでのみ使用できます。 Amazon S3 
+ AI Assistant や WorkSpaces などの追加機能は、OpenSearch UI で利用できます。詳細については、「」を参照してください[Amazon OpenSearch Service での OpenSearch UI の使用](application.md)。

**Topics**
+ [移行の概要](#application-migrate-saved-objects-overview)
+ [前提条件](#application-migrate-saved-objects-prerequisites)
+ [ステップ 1: OpenSearch Dashboards から保存されたオブジェクトをエクスポートする](#application-migrate-saved-objects-export)
+ [ステップ 2: 保存したオブジェクトを OpenSearch UI にインポートする](#application-migrate-saved-objects-import)

## 移行の概要
<a name="application-migrate-saved-objects-overview"></a>

移行プロセスは、以下の大まかなステップで構成されます。

1. **OpenSearch Dashboards から保存済みオブジェクトをエクスポート** – OpenSearch Dashboards の保存済みオブジェクト管理 UI またはエクスポート API を使用して、ダッシュボード、視覚化、インデックスパターン、およびその他のオブジェクトを改行区切り JSON (NDJSON) ファイルとしてダウンロードします。

1. **OpenSearch UI アプリケーションとワークスペースを作成する** – まだ作成していない場合は、OpenSearch UI アプリケーションとワークスペースを作成して、インポートされたオブジェクトを受信します。

1. **OpenSearch UI にデータソースを登録する** – OpenSearch ドメインを OpenSearch UI アプリケーションに関連付け、ワークスペース内のデータソースとして登録します。インポートされたオブジェクトのインデックスパターンは、このデータソースを参照します。

1. **OpenSearch UI への保存済みオブジェクトのインポート** – OpenSearch UI の保存済みオブジェクト管理 UI またはインポート API を使用して、NDJSON ファイルをターゲットワークスペースにアップロードします。

1. **インポートされたオブジェクトを検証する** – OpenSearch UI でダッシュボードとビジュアライゼーションを開き、それらが正しく表示され、関連するドメインまたはコレクションからデータが流れていることを確認します。

## 前提条件
<a name="application-migrate-saved-objects-prerequisites"></a>

移行する前に、次の前提条件を確認してください。
+ Amazon OpenSearch Service および OpenSearch APIs を呼び出すために必要な OpenSearch IAM アクセス許可があります。詳細については、「[Amazon OpenSearch Service アプリケーションを作成するために必要なアクセス許可](application-getting-started.md#application-prerequisite-permissions)」を参照してください。
+ ドメインまたはコレクション、および移行する OpenSearch Dashboards にアクセスできます。
+ OpenSearch UI アプリケーションを作成しました。アプリケーションとワークスペースの作成については、「」を参照してください[Amazon OpenSearch Service における OpenSearch ユーザーインターフェースの開始方法](application-getting-started.md)。
+ 同じドメインまたはコレクションを OpenSearch UI アプリケーションに関連付けています。データソースの関連付けについては、「」を参照してください[データソースの関連付けと Virtual Private Cloud アクセス許可の管理](application-data-sources-and-vpc.md)。

**注記**  
OpenSearch UI は OpenSearch バージョン 1.3 以降のみをサポートしています。保存したオブジェクトを移行する前に、OpenSearch ドメインがバージョン 1.3 以降を実行していることを確認します。

## ステップ 1: OpenSearch Dashboards から保存されたオブジェクトをエクスポートする
<a name="application-migrate-saved-objects-export"></a>

管理 UI またはエクスポート API を使用して、保存されたオブジェクトを OpenSearch Dashboards からエクスポートします。エクスポートでは、選択したすべての保存済みオブジェクトタイプとその依存関係を含む改行区切りの JSON (NDJSON) ファイルが生成されます。

**Topics**
+ [OpenSearch Dashboards で手動でエクスポートする](#application-migrate-export-console)
+ [API を使用したエクスポート](#application-migrate-export-api)

### OpenSearch Dashboards で手動でエクスポートする
<a name="application-migrate-export-console"></a>

**OpenSearch Dashboards 管理 UI を使用して保存済みオブジェクトをエクスポートするには**

1. OpenSearch Dashboards インスタンスを開きます。

1. 左側のナビゲーションパネルで、**管理**を選択します。

1. **ダッシュボード管理**で、**保存済みオブジェクト**を選択します。

1. エクスポートする保存済みオブジェクトを選択します。特定のタイプのすべてのオブジェクトをエクスポートするには、検索バーを使用してタイプでフィルタリングします。すべてのオブジェクトをエクスポートするには、テーブルヘッダーのチェックボックスをオンにします。

1. **[エクスポート]** を選択します。

1. 保存**済みオブジェクトのエクスポート**ダイアログボックスで、**関連するオブジェクトを含める**が選択されていることを確認します。このオプションには、ビジュアライゼーションによって参照されるインデックスパターンなど、選択した保存済みオブジェクトが依存するすべてのオブジェクトが含まれます。このオプションは、依存関係を手動で管理する場合にのみクリアします。

1. **エクスポート** を選択して、`.ndjson`ファイルをローカルマシンにダウンロードします。

**ヒント**  
**関連オブジェクトを含める**を選択すると、エクスポートされた NDJSON ファイルには、依存するインデックスパターン、ビジュアライゼーション、検索オブジェクトなど、選択したダッシュボードとビジュアライゼーションのレンダリングに必要なすべての保存済みオブジェクトが含まれます。これにより、インポートステップが簡素化され、参照エラーの欠落を回避できます。

### API を使用したエクスポート
<a name="application-migrate-export-api"></a>

OpenSearch Dashboards の保存済みオブジェクトのエクスポート API を使用して、保存済みオブジェクトをプログラムでエクスポートできます。これは、移行を自動化したり、エクスポートステップを CI/CD パイプラインに統合したりするのに役立ちます。

**注記**  
OpenSearch ドメインで[きめ細かなアクセスコントロール](fgac.md)が有効になっている場合は、エクスポートリクエストで認証情報を指定する必要があります。ユーザー名とパスワードで `-u`フラグを追加して、HTTP 基本認証を使用します。認証オプションの詳細については、「[Amazon OpenSearch Service のきめ細かなアクセスコントロール](fgac.md)」を参照してください。

次の の例では、関連するオブジェクトを含むすべてのダッシュボードをエクスポートします。*プレースホルダー値*を、ユーザー自身の情報に置き換えます。

```
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
```

ドメインできめ細かなアクセスコントロールが有効になっていない場合は、 `-u`フラグを省略できます。

特定の保存済みオブジェクトを ID でエクスポートするには、 の代わりに `objects`パラメータを使用します`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
```

**注記**  
保存済みオブジェクト IDs を検索するには、保存済みオブジェクト API を使用して、特定のタイプのすべてのオブジェクトを一覧表示します。次の の例では、すべてのダッシュボードを一覧表示します。  

```
curl -X GET \
    "https://dashboards-endpoint/_dashboards/api/saved_objects/_find?type=dashboard" \
    -u 'master-username:master-password'
```
レスポンスには、保存された各オブジェクトの ID が含まれます。OpenSearch Dashboards でオブジェクトを表示するときに、ブラウザ URL で ID を見つけることもできます。

## ステップ 2: 保存したオブジェクトを OpenSearch UI にインポートする
<a name="application-migrate-saved-objects-import"></a>

保存したオブジェクトをエクスポートした後、NDJSON ファイルを OpenSearch UI に手動でインポートするか、API 経由でインポートできます。

**Topics**
+ [OpenSearch UI に手動でインポートする](#application-migrate-import-console)
+ [API 経由でのインポート](#application-migrate-import-api)

### OpenSearch UI に手動でインポートする
<a name="application-migrate-import-console"></a>

**OpenSearch UI 管理 UI を使用して保存済みオブジェクトをインポートするには**

1. OpenSearch UI アプリケーションを開き、ターゲットワークスペースに移動します。

1. ワークスペースで、上部のナビゲーションから**アセット**を選択するか、ワークスペースアセットページに移動します。

1. **Import** を選択して、**Import assets** ダイアログを開きます。

1. **ファイルの選択** を選択し、OpenSearch Dashboards からエクスポートした`.ndjson`ファイルを選択します。

1. **競合管理**では、次のいずれかを選択します。
   + **一意の IDs を使用して新しいアセットを作成する** (デフォルト) – インポートされたすべてのオブジェクトに新しい IDs を生成し、既存のアセットとの競合を回避します。
   + **既存のアセットをチェックする** – 既存のオブジェクトとの競合をチェックします。選択したら、次のいずれかのサブオプションを選択します。
     + **競合を自動的に上書き**する – 同じ ID を持つ既存のアセットは自動的に置き換えられます。
     + **競合に対するアクションのリクエスト** – 各競合を個別に解決するように求められます。

1. [**インポート**] を選択します。

1. インポートの概要を確認します。

### API 経由でのインポート
<a name="application-migrate-import-api"></a>

 AWS 署名バージョン 4 認証で API を使用して保存済みオブジェクトをインポートするには、まずデータソース ID を取得し、インポートリクエストで使用する必要があります。*プレースホルダー値*を、ユーザー自身の情報に置き換えます。

ステップ 1: ワークスペースのデータソース ID を取得する:

```
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"
```

**注記**  
レスポンスにはデータソース ID が含まれます。OpenSearch UI でデータソースを表示するときに、ブラウザ URL でデータソース ID を確認することもできます。

ステップ 2: ステップ 1 のデータソース ID を使用して保存されたオブジェクトをインポートします。

```
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"
```

**注記**  
これらの例では、curl の組み込み`--aws-sigv4`オプション (curl 7.75 以降で利用可能) を使用してリクエストに署名します。コマンドを実行する前に、認証情報を環境変数として設定します AWS 。`AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、および `AWS_SESSION_TOKEN` (一時的な認証情報を使用している場合）。