POST /api/packages imports a package.

curl Command

The following command imports a .zip file. This example uses the DukesBankApp.zip file which is provided on the vRealize Automation virtual appliance. You can copy the file from /usr/lib/vcac/tools/initial-config/sample-oob-content/DukesBankApp.zip using WinSCP (Windows) or scp (Mac).

$curl --insecure -s -H "Content-Type: multipart/form-data" -H "Authorization: Bearer $token" https://$vRA/content-management-service/api/packages -F "file=@DukesBankApp.zip"

To verify success of a package import, use vRealize Automation to view the imported items on the target system.

JSON Output

The following JSON output is returned on the command input.

{
  "contentImportStatus": "SUCCESS",
  "contentImportResults": [
    {
      "contentId": "Apache_LB",
      "contentName": "Apache_LB",
      "contentTypeId": "software-component",
      "contentImportStatus": "SUCCESS",
      "contentImportErrors": null
    },
    {
      "contentId": "MySql",
      "contentName": "MySql",
      "contentTypeId": "software-component",
      "contentImportStatus": "SUCCESS",
      "contentImportErrors": null
    },
    {
      "contentId": "JBossAppServer",
      "contentName": "JBossAppServer",
      "contentTypeId": "software-component",
      "contentImportStatus": "SUCCESS",
      "contentImportErrors": null
    },
    {
      "contentId": "Dukes-Bank-DB-setup",
      "contentName": "Dukes-Bank-DB-setup",
      "contentTypeId": "software-component",
      "contentImportStatus": "SUCCESS",
      "contentImportErrors": null
    },
    {
      "contentId": "Dukes_Bank_App",
      "contentName": "Dukes_Bank_App",
      "contentTypeId": "software-component",
      "contentImportStatus": "SUCCESS",
      "contentImportErrors": null
    },
    {
      "contentId": "DukesBankApplication",
      "contentName": "DukesBankApplication",
      "contentTypeId": "composite-blueprint",
      "contentImportStatus": "SUCCESS",
      "contentImportErrors": null
    }
  ]
}

Output

The command output contains property names and values based on the command input parameters.

Table 1. Import and Export Response Body Parameters

Parameter

Description

contentImportStatus

Over all status of the import/validation operation, one failure in import/validation result guarantees failed status. Values are as follows:

  • Success - Denotes the successful import or validation status at a particular component or package level.

  • Failed - Denotes an import or validation failure at a particular component package level.

  • Warning - Denotes a scenario that warrants a system level warning. Alerts the user about a possible error condition that the proposed action may create.

contentImportResults

Set of collected content import/validation results populated by the provider. The Content import operation result collection is the set of content that passed or failed. If failed the errors are populated in ContentImportError. Properties are as follows:

  • contentId - (string) Unique content ID within the file system.

  • contentName - (anyType) Name of the content being imported.

  • contentTypeId - (string) The ID for the content type being exported. This matches the folder structure in the exported zip.

  • contentImportStatus - Track the failed or succeeded status of an entity.

  • messages - Information returned by the provider.

  • contentImportErrors - Set of errors returned by the provider.