手動で生成したテーブルをインポートする

移行センターでは、提供されたテンプレートを使用して手動で入力するデータのテーブルをアップロードできます。これは、インフラストラクチャのアセット数が少なく、データを手動で作成する場合に便利です。

手動で入力したテーブルをインポートするには、次の手順を行います。

利用可能なテンプレートのリストからテンプレートをダウンロードします。
テーブルに手動でインフラストラクチャのデータを入力します。
移行センターにテーブルをアップロードします。

制限事項

ファイルアップロードの最大サイズは 100 MB です。

利用可能なデータテンプレート

次の表に、インフラストラクチャデータを移行センターにアップロードする際に使用できるファイルテンプレートを示します。テンプレートには、テーブルの入力方法に関する提案としてサンプルデータが含まれています。必要なデータ形式の詳細については、インポートファイルの仕様をご覧ください。

File name	データの種類	Description
vmInfo.csv	マシンの情報	このテンプレートは、CPU、メモリなどの個々のアセットの情報や、その他の構成パラメータを提供する場合に使用します。このテーブルは、新しいインポートを作成するたびに必要です。
perfInfo.csv	パフォーマンスデータ	省略可: アセットのパフォーマンスデータを時系列形式で提供する場合に使用します。
diskInfo.csv	ディスクデータ	省略可: ディスクとその使用率に関する情報を提供する場合に使用します。
tagInfo.csv	システムタグ	省略可: アセットにラベルを割り当てるには、このテンプレートを使用します。ラベルは、Google Cloud のラベルの要件に従う必要があります。

各ファイルの仕様の詳細については、ファイル仕様をインポートするをご覧ください。

テーブルをアップロードする

ファイルをアップロードする手順は次のとおりです。

コンソール

[データインポート] ページに移動します。

[データインポート] に移動
[Add Data] をクリックします。新しいページが開きます。
[ファイルをアップロード] を選択し、[ファイルのアップロードを設定] でファイルアップロードの名前を入力します。
リストから [手動で入力した CSV テンプレート] を選択します。
[アップロードするファイルを選択] をクリックし、アップロードするすべてのファイルを選択します。
ファイルを確認してアップロードを開始するには、[ファイルをアップロード] をクリックします。
ファイルが正しく検証された場合、ファイルからアセットを作成するには、[データをインポート] をクリックしてから [確認] をクリックします。

API

インポートジョブを作成します。
```
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID

{
  "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID"
}
```
以下を置き換えます。
- PROJECT_ID: インポートジョブを作成するプロジェクトの ID。
- REGION: インポートジョブを作成するリージョン。
- IMPORT_JOB_ID: 新しいインポートジョブの ID。
- SOURCE_ID: インポートジョブに関連付ける既存のソースの ID。
省略可: インポートジョブが正しく作成されたことを確認するには、インポートジョブを取得します。
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```
インポートジョブに添付されるインポートデータファイルを作成します。
```
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID

{
  "format": "IMPORT_JOB_FORMAT"
}
```
以下を置き換えます。
- DATA_FILE_ID: 新しいデータファイルの ID
- IMPORT_JOB_FORMAT: IMPORT_JOB_FORMAT_MANUAL_CSV

データファイルを取得します。

GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID

レスポンスから signedUrl フィールドの URL をコピーします。
コピーした URL にファイルをアップロードします。
```
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
```
以下を置き換えます。
- UPLOAD_FILE_PATH: アップロードするファイルのローカルパス。
- COPIED_URL: プレビュー手順からコピーされた署名付き URL。
省略可: 同じインポートジョブでデータファイルをさらに作成するには、手順 3 ～ 6 を繰り返します。

省略可: インポートジョブのすべてのデータファイルを取得します。

GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles

インポートジョブを検証します。

POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate

インポートジョブを取得して検証レポートを表示します。状態が READY の場合、次のステップに進むことができます。それ以外の場合は、ジョブまたは特定のファイルを修正する必要があります。これには、ファイルを削除するか、新しいファイルをアップロードする必要があります。
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

インポートジョブを実行します。

POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run

インポートジョブを取得して、実行レポートを表示します。状態が COMPLETED の場合、ジョブは正常に実行されています。それ以外の場合、ジョブが失敗して終了状態の場合、実行レポートにはエラーが含まれます。新しいインポートジョブを作成し、必要な変更を適用します。
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

ファイルのアップロードに問題がある場合は、一般的なエラーメッセージのトラブルシューティングをご覧ください。

アップロードを確認する

ファイルをアップロードした後、Migration Center はこれらのファイルが正式に正しいかどうかを確認します。検証に成功すると、Migration Center はデータを処理して新しいアセットを作成するか、既存のアセットを更新します。アップロードジョブのステータスは、Google Cloud コンソールから確認できます。

アップロードジョブのステータスを確認するには、次の手順を行います。

[データインポート] ページに移動し、[ファイルのアップロード] をクリックします。
ファイルインポートのリストから、確認するアップロードを選択します。
[ファイルのアップロード] ページの [データインポートの進行状況] で、アップロードしたファイルの [ステータス] を確認します。

ファイルは次のステータスで表示されます。

ステータスのリスト

完了ファイルのインポートに成功しました。
準備完了。ファイルは検証に合格し、インポートできる状態になっています。
保留中。ファイルは別のファイルの処理が完了するのを待機しています。
実行中。ファイルは処理中です。
検証中ファイルは検証中です。
検証失敗。いくつかのエラーがファイルに含まれています。エラーを修正してから、もう一度ファイルをアップロードしてみてください。
失敗。ファイルをインポートできませんでした。

エラーの詳細を確認

ファイルのインポート後にエラーが発生した場合は、Google Cloud コンソールでエラーメッセージを直接確認できます。

アップロードジョブのエラーを確認するには、次の手順に従います。

[データインポート] ページに移動し、[ファイルのアップロード] をクリックします。
[エラー] 列で [表示] をクリックします。[エラーの詳細] ページに、エラーの完全なリストが表示されます。

[エラーの詳細] ページで、エラーの原因となっているアセットとデータフィールドを確認し、エラーの説明を表示できます。ファイルインポートジョブのエラーにより、Migration Center で新しいアセットを作成したり、新しいアセットを既存のアセットで更新したりできない場合があります。このエラーを修正するには、ファイルを編集して新しいファイルインポートジョブを作成し、ファイルを再度アップロードします。

発生する可能性のあるエラーメッセージの詳細については、ファイルのインポートエラーのトラブルシューティングをご覧ください。

インポートファイルの仕様

次の表に、手動インポートに使用するテンプレートファイルの技術仕様を示します。

`vmInfo` ファイル

列	想定される型	Description
MachineId	string	仮想マシンの一意の識別子。
MachineName	string	仮想マシンの表示名。
PrimaryIPAddress	string	マシンの IP アドレス。
PrimaryMACAddress	string	マシンの MAC アドレス。これは、マシンを識別する目的でのみ使用されます。
PublicIPAddress	string	マシンのパブリック IP アドレス。
IpAddressListSemiColonDelimited	メッセージの一覧	割り当て済みまたは割り当てられたネットワークアドレスのリスト。
TotalDiskAllocatedGiB	int64	ディスクの合計容量。
TotalDiskUsedGiB	int64	ディスクの使用容量の合計。
MachineTypeLabel	string	AWS または Azure マシンタイプのラベル。
AllocatedProcessorCoreCount	int64	仮想マシンの CPU コアの数。
MemoryGiB	int32	仮想マシンのメモリ量。
HostingLocation	string	AWS または Azure 形式のマシンのロケーション。
OsType	string	マシンの OS。
OsName	string	マシンの OS。
OsVersion	string	マシンの OS のバージョン。
MachineStatus	string	マシンの電源状態。
ProvisioningState	string	プロビジョニング状態（Azure VM のみ）。
CreateDate	タイムスタンプ	マシンの作成タイムスタンプ。
IsPhysical	string	マシンが物理マシンまたは仮想マシンの場合。
ソース	クリックします。	AWS または Azure マシンのソースの詳細。

`diskInfo` ファイル

列	想定される型	Description
MachineId	string	仮想マシンの一意の識別子。
DiskLabel	string	ディスクラベル。
SizeInGib	int64	ディスクの合計容量。
UsedInGib	int64	ディスクの使用容量の合計。
StorageTypeLabel	string	ディスクラベルのタイプ（BIOS や GPT など）。

perfInfo ファイル

列	想定される型	Description
MachineId	string	仮想マシンの一意の識別子。
TimeStamp		サンプルが収集されたタイムスタンプ。
CpuUtilizationPercentage	float	使用された合計 CPU 容量の割合。0 ～ 100 の範囲内にする必要があります。
MemoryUtilizationPercentage	float	使用されているシステムメモリの割合。0 ～ 100 の範囲内にする必要があります。
UtilizedMemoryBytes	float	使用メモリの合計（バイト単位）。
DiskReadOperationsPerSec	float	短い時間枠でサンプリングされた平均 IOPS。
DiskWriteOperationsPerSec	float	短い時間枠でサンプリングされた平均 IOPS。
NetworkBytesPerSecSent	float	短い時間枠でサンプリングされた、B/s 単位の平均ネットワーク下り（外向き）。
NetworkBytesPerSecReceived	float	短いウィンドウでサンプリングされた、B/s 単位の平均ネットワーク上り（内向き）。

tagInfo ファイル

列	想定される型	Description
MachineId	string	仮想マシンの一意の識別子。
キー	string	ラベルキー。
値	string	ラベルの値。

ラベルの解析アルゴリズム

tagInfo ファイルを使用してアップロードするラベルは、Google Cloud のラベルの要件に従う必要があります。ラベルが要件を満たしていない場合、移行センターでは次の戦略を使用してラベルを変換します。

キーの場合のみ、英字ではない先頭文字をすべて削除します。
すべての大文字を小文字に置き換えます。
無効な文字はすべてアンダースコア（_）に置き換えられます。
ラベルが最大 62 文字に切り詰められます。
元の文字列に基づいて計算された _<CRC32> 接尾辞が追加されます。

ラベルが変換されるたびに警告メッセージが表示されます。

検証が失敗した場合、またはキーがすでに存在する場合は、インポートによって行がスキップされ、警告メッセージが表示されます。

次のステップ

移行センターの収集方法の詳細を確認する。
詳しくは、ファイルのアップロードを管理する方法をご覧ください。