Importer un module

Vous pouvez importer un module à l'aide de l'API REST d'Orchestrator.

Selon la bibliothèque de votre application client REST, vous pouvez utiliser un code personnalisé qui définit les propriétés du module.

Par défaut, si vous importez un module Orchestrator avec un nom dupliqué, le module existant n'est pas remplacé. Vous pouvez indiquer s'il est nécessaire de remplacer les modules existants à l'aide d'un paramètre dans la demande.

Par défaut, les modules Orchestrator sont importés avec les valeurs d'attributs des éléments de configuration. Vous pouvez importer un module sans valeur d'attribut en utilisant un paramètre dans la demande.

Par défaut, les balises des modules Orchestrator sont importées. Toutefois, si les mêmes balises existent déjà sur le serveur Orchestrator, les valeurs des balises existantes sont préservées. Vous pouvez indiquer si les valeurs des balises existantes doivent être préservées en utilisant des paramètres dans la demande.

Conditions préalables

Le contenu binaire du module doit être disponible en tant que contenu en plusieurs parties. Pour des informations détaillées, reportez-vous à RFC 2387.

Procédure

Dans l'application client REST, ajoutez des en-têtes de demande afin de définir les propriétés du module que vous souhaitez importer.
Soumettez une demande POST au niveau de l'URL des objets du module :
```
POST http://{orchestrator_host}:{port}/vco/api/packages/
```
(Facultatif) Pour importer un module et remplacer un module existant qui possède le même nom, utilisez le paramètre overwrite dans la demande POST :
```
POST http://{orchestrator_host}:{port}/vco/api/packages/?overwrite=true
```
(Facultatif) Pour importer un module sans les valeurs d'attributs de ses éléments de configuration, utilisez le paramètre importConfigurationAttributeValues de la demande POST :
```
POST http://{orchestrator_host}:{port}/vco/api/packages/?importConfigurationAttributeValues=false
```
(Facultatif) Pour importer un module sans ses balises, utilisez le paramètre tagImportMode de la demande POST :
```
POST http://{orchestrator_host}:{port}/vco/api/packages/?tagImportMode=DoNotImport
```
(Facultatif) Pour importer un module avec ses balises et remplacer les valeurs existantes, utilisez le paramètre tagImportMode de la demande POST :
```
POST http://{orchestrator_host}:{port}/vco/api/packages/?tagImportMode=ImportAndOverwriteExistingValue
```

Résultats

Si la demande POST aboutit, vous obtenez le code d'état 202.