Importer des données RVTools

Si vous ne souhaitez pas installer ni exécuter de collecte automatique de données avec le client de découverte dans votre infrastructure, vous pouvez importer manuellement vos données d'infrastructure dans le centre de migration.

Tout d'abord, utilisez RVTools pour collecter des données système et des données de performances à partir de vos éléments VMware. Importez ensuite la table générée par RVTools directement dans le centre de migration pour ajouter vos éléments.

Limites

Pour importer des données, créez une table avec RVTools version 4.3.1 ou ultérieure. Les versions précédentes de RVTools ne sont pas compatibles.
Les tables générées avec l'option --DBColumnNames ne sont pas acceptées.

Importer des données depuis RVTools

Pour importer manuellement une table générée avec RVTools, procédez comme suit:

Console

Accédez à la page Importation de données.

Accéder à "Importation de données"
Cliquez sur Add Data (Ajouter des données). Une nouvelle page s'ouvre.
Sélectionnez Importer des fichiers, puis sous Configurer l'importation de fichiers, saisissez le nom du fichier importé.
Dans la liste, sélectionnez Excel exportés depuis RVTools ou CSV exporté depuis RVTools.
Cliquez sur Sélectionner les fichiers à importer, puis sélectionnez tous les fichiers que vous souhaitez importer.
Pour confirmer et commencer à importer les fichiers, cliquez sur Importer des fichiers.
Si les fichiers sont correctement validés, cliquez sur Import data (Importer des données), puis sur Confirm (Confirmer) pour créer les éléments à partir des fichiers.

API

Créez un job d'importation.
```
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"
}
```
Remplacez les éléments suivants :
- PROJECT_ID: ID du projet pour créer la tâche d'importation.
- REGION: région dans laquelle créer le job d'importation.
- IMPORT_JOB_ID: ID du nouveau job d'importation.
- SOURCE_ID: ID d'une source existante à associer à la tâche d'importation.

Facultatif: Pour vérifier que le job d'importation a été créé correctement, obtenez-le.

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

Créez un fichier de données d'importation joint au job d'importation.
```
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"
}
```
Remplacez les éléments suivants :
- DATA_FILE_ID: ID du nouveau fichier de données
- IMPORT_JOB_FORMAT : IMPORT_JOB_FORMAT_RVTOOLS_CSV ou IMPORT_JOB_FORMAT_RVTOOLS_EXCEL.

Récupérez le fichier de données.

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

Copiez l'URL du champ signedUrl de la réponse.
Importez un fichier dans l'URL copiée.
```
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
```
Remplacez les éléments suivants :
- UPLOAD_FILE_PATH: chemin d'accès local du fichier importé.
- COPIED_URL: URL signée copiée à partir des étapes d'aperçu.
(Facultatif) Répétez les étapes 3 à 6 pour créer d'autres fichiers de données dans la même tâche d'importation.

(Facultatif) Récupérez tous les fichiers de données d'un job d'importation.

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

Validez le job d'importation.

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

Obtenez le job d'importation et affichez le rapport de validation. Si l'état est READY, vous pouvez passer aux étapes suivantes. Sinon, vous devez corriger la tâche ou des fichiers spécifiques. Vous devrez peut-être supprimer des fichiers ou en importer de nouveaux.
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

Exécutez le job d'importation.

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

Obtenez le job d'importation et affichez le rapport d'exécution. Si l'état est COMPLETED, la tâche a bien été exécutée. Sinon, si la tâche a échoué et se trouve à l'état final, le rapport d'exécution inclut les erreurs. Créez un job d'importation et appliquez les modifications requises.
```
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
```

Si vous rencontrez des problèmes avec l'importation de vos fichiers, découvrez comment résoudre les problèmes liés aux messages d'erreur courants.

Vérifier l'importation

Une fois les fichiers importés, le centre de migration les valide pour vérifier s'ils sont formellement corrects. Si la validation aboutit, le centre de migration traite les données pour créer des éléments ou mettre à jour les éléments existants. Vous pouvez vérifier l'état de vos jobs d'importation depuis la console Google Cloud.

Pour consulter l'état de votre job d'importation, procédez comme suit:

Accédez à la page Importation de données, puis cliquez sur Importations de fichiers.
Dans la liste des fichiers importés, sélectionnez l'importation que vous souhaitez vérifier.
Sur la page d'importation des fichiers, sous Progression de l'importation des données, vérifiez l'état des fichiers importés.

Vos fichiers sont associés à l'un des états suivants.

Liste des états

Terminé : Votre fichier a bien été importé.
Prêt : Votre fichier a été validé et est prêt à être importé.
En attente : Votre fichier est en attente de traitement d'un autre fichier.
En cours d'exécution : Votre fichier est en cours de traitement.
Validation. Votre fichier est en cours de validation.
Échec de la validation. Votre fichier contient des erreurs. Corrigez les erreurs, puis réessayez d'importer votre fichier.
Échec. Impossible d'importer votre fichier.

Examiner les détails de l'erreur

Si vous rencontrez des erreurs après l'importation de vos fichiers, vous pouvez consulter le message d'erreur directement dans la console Google Cloud.

Pour examiner les erreurs de votre job d'importation, procédez comme suit:

Accédez à la page Importation de données, puis cliquez sur Importations de fichiers.
Cliquez sur le fichier d'importation qui affiche un avertissement ou une erreur. La page d'informations sur le fichier d'importation affiche la liste complète des erreurs.

Sur la page d'informations du fichier d'importation, vous pouvez examiner les éléments et les champs de données à l'origine des erreurs, et afficher une description de l'erreur. Les erreurs liées au job d'importation de fichiers peuvent empêcher le centre de migration de créer des éléments ou de mettre à jour les éléments existants avec les nouvelles modifications. Pour corriger l'erreur, modifiez vos fichiers et créez un job d'importation de fichiers pour les réimporter.

Pour en savoir plus sur les messages d'erreur possibles, consultez la page Résoudre les erreurs d'importation de fichiers.

Étapes suivantes

Apprenez-en davantage sur les méthodes de collection du centre de migration.
Découvrez comment gérer vos importations de fichiers.