Software AG Products 10.5 | Using API Gateway | Export and Import Assets and Configurations | Importing Asset and Configuration Archives
 
Importing Asset and Configuration Archives
You can import archives of assets that you have exported and re-create them in API Gateway.
Note:
You need to import the authorization servers before you import the assets (such as applications) that depend on these authorization servers.
*To import the exported files
1. Expand the menu options icon , in the title bar, and select Import.
2. Provide the following information:
Parameter
Description
Select archive file
Click Browse to select a file or ZIP format file.
Overwrite
Select an overwrite option:
*None: If you do not want to overwrite matching objects that exist on the server. Import will fail for the object in the archive if a matching object/asset already exists on the server.
*All: If you want to overwrite any matching asset that exists on the server. If a match is not found, then a new asset is created.
*Custom: If you want to select the specific types of assets that will be overwritten on the server if a match is found. If a matching asset exists on the server for an asset type that is not selected in the Custom overwrite list, the import operation will fail.
Note:
If a duplicate asset is found for any asset type that is not selected in the Custom overwrite list, the import will fail.
Note:
Some types of assets have dependencies on other asset types. For example, APIs have a dependency on policies, aliases, and applications. Some of the dependencies are required, while others are optional. The required dependencies are always included in the archive when you export the asset. You should consider your requirements and select the assets that need to be overwritten in the Custom list. For more information, see Overview.
API version history
Select the option Fix missing versions to fix the API version history.
On selecting this option, the API versions are newly linked according to the system version of the APIs.
Note:
API Gateway supports backward compatibility for API Gateway 10.1 version or higher when importing the archives of APIs. If you want to use the archives of API Gateway 10.2 in versions 10.3 and higher, you must export them from API Gateway 10.2 fix 3 or higher.
3. Click Import.
The Import report displays the following information:
Parameter
Description
Type
The asset type.
Successful
The number of successful imports for each artifact type.
Unsuccessful
The number of unsuccessful imports for each artifact type.
Replaced
The number of instances replaced for each artifact type.
Warning
The number of warnings displayed during the import of each artifact type. API Gateway displays warning messages when the import is successful but some additional information is required.
4. Click Download the detail report here > to download the detail report.
The detail report displays the following information about the imported artifact:
Parameter
Description
Name
The name of the artifact imported.
Type
The artifact type.
Status
The status of the imported artifact. The available values are:
*Success
*Replaced
*Warning
*Failure
Explanation
The reason if the import fails or if a warning occurs.
If you want to take a backup of an API that you want to overwrite during import, you can set the parameter enableImportBackup as true under Administration > General > Extended Settings section. For more information about this extended setting, see Configuring Extended Settings.
If an API import fails, one of the reasons might be that a configuration that is required by the API is not set up correctly on API Gateway. If something happens unexpectedly while the import is in progress, API Gateway discontinues the import and restores the existing API. This is necessary as parts of the existing API such as policies may already have been overwritten.