7.1

Import a Package
You can import a package by using the Orchestrator REST API.
Depending on the library of your REST client application, you can use custom code that denes the
properties of the package.
By default, if you import an Orchestrator package with a duplicate name, the existing package is not
overwrien. You can specify whether to overwrite existing packages by using a parameter in the request.
By default, Orchestrator packages are imported with the aribute values of conguration elements. You can
import a package without aribute values by using a parameter in the request.
By default, tags contained in Orchestrator packages are imported, but if the same tags already exist on the
Orchestrator server, the values of existing tags are preserved. You can specify whether existing tag values
are preserved by using parameters in the request.
Prerequisites
The package binary content should be available as multi-part content. For details, see RFC 2387.
Procedure
1 In a REST client application, add request headers to dene the properties of the package that you want
to import.
2 Make a POST request at the URL of the package objects:
POST http://{orchestrator_host}:{port}/vco/api/packages/
3 (Optional) To import a package and overwrite an existing package with the same name, use the
overwrite parameter in the POST request:
POST http://{orchestrator_host}:{port}/vco/api/packages/?overwrite=true
4 (Optional) To import a package without the aribute values of the conguration elements from the
package, use the importConfigurationAttributeValues parameter in the POST request:
POST http://{orchestrator_host}:{port}/vco/api/packages/?
importConfigurationAttributeValues=false
5 (Optional) To import a package without the tags that it contains, use the tagImportMode parameter in the
POST request:
POST http://{orchestrator_host}:{port}/vco/api/packages/?tagImportMode=DoNotImport
6 (Optional) To import a package with the tags that it contains and overwrite existing tag values, use the
tagImportMode parameter in the POST request:
POST http://{orchestrator_host}:{port}/vco/api/packages/?
tagImportMode=ImportAndOverwriteExistingValue
If the POST request is successful, you receive the status code 202.
Export a Package
You can export a package by using the Orchestrator REST API and download the package as a le.
By default, Orchestrator packages are exported with aribute values of conguration elements and global
tags. You can export a package without aribute values or global tags by using parameters in the request.
You can also specify a custom name for the package le that you download.
Developing a Web Services Client for VMware vRealize Orchestrator
36 VMware, Inc.