Note that the instructions given below are applicable only if you are a non-subscription user and your WSO2 API Manager distribution has no WUM updates.
If you have a WUM-updated pack, go to Migrating the APIs to a Different Environment
To know more about WUM updates see, Updating WSO2 API Manager.
WSO2 API Manager (WSO2 API-M) allows you to maintain multiple environments running on the same WSO2 API-M version. This feature allows you to import and export applications or APIs between your environments. For example, if you have an application or API running in the development environment, you can import it and export to the test(QA) environment. Thereby, APIs and applications do not have to be created from scratch in different environments.
Getting Started
After running the CLI tool make sure to add an environment before you start working with the import/export CLI commands, because all APIs and applications need to be imported or exported to a specific environment.
Running the CLI tool
Step 1 - Deploy the API import/export tool
Download the latest version of WSO2 API Manager from http://wso2.com/products/api-manager/.
- Start WSO2 API Manager.
Download the latest WSO2 API import/export tool (
api-import-export-2.6.0-v17.war
) from here.Note that the import/export tool attached is specific to this version of WSO2 API Manager.
Make sure to delete all previous versions of the web app (e.g.,
api-import-export-2.6.0-v17.war
), both the compressed and the extracted files, before copying over the new web app.- This version of the API Import and Export web application is compatible with the WSO2 WUM updates from July 8, 2019, onwards. For more information on updating WSO2 API Manager, see Updating WSO2 API Manager.
- The previous version of the web application which is compatible with WUM updates that are prior to the above-mentioned date can be download from here.
- Note that API update support in the targeted environment is available only with the
api-import-export-2.6.0-v14.war
version onwards.
Copy the downloaded
api-import-export-2.6.0-v17.war
file to the<API-M_HOME>/repository/deployment/server/webapps
folder.
The file is automatically deployed as hot deployment is enabled.
Step 2 - Optionally, set the proxy environment variables for CLI
You can set proxy related HTTP_PROXY
, HTTPS_PROXY
, http_proxy
, and https_proxy
standard environment variables, with or without basic authentication as shown below to send the requests initiated from CLI via a proxy server. After one of the following environment variables is set in your environment where CLI is used, all the requests will go through the proxy server specified.
export HTTP_PROXY="http://<host-name>:<port>" export HTTPS_PROXY="https://<host-name>:<port>" export http_proxy="http://<host-name>:<port>" export https_proxy="https://<host-name>:<port>"
export HTTP_PROXY="http://<username>:<password>@<host-name>:<port>" export HTTPS_PROXY="https://<username>:<password>@<host-name>:<port>" export http_proxy="http://<username>:<password>@<host-name>:<port>" export https_proxy="https://<username>:<password>@<host-name>:<port>"
export HTTP_PROXY="http://localhost:3128" export HTTPS_PROXY="https://localhost:3128" export http_proxy="http://localhost:3128" export https_proxy="https://localhost:3128"
export HTTP_PROXY="http://testuser:[email protected]:3128" export HTTPS_PROXY="https://testuser:[email protected]:3128" export http_proxy="http://testuser:[email protected]:3128" export https_proxy="https://testuser:[email protected]:3128"
In conjunction with the above proxy configurations, calls from the CLI to particular hosts that need to bypass proxies can be configured via either the NO_PROXY
or no_proxy
environment variables.
export NO_PROXY="https://<host-name>:<port>" export no_proxy="https://<host-name>:<port>"
export NO_PROXY="https://localhost:3128" export no_proxy="https://localhost:3128"
Step 3 - Run the CLI tool
Download API Controller based on your preferred platform (i.e., Mac, Windows, Linux).
- Extract the downloaded archive containing the CLI Tool to a preferred location and navigate to it from the terminal (using
cd
). - Navigate to the working directory where the executable CLI Tool resides.
Execute the following command to start the CLI tool.
./apimcli
Add the location of the extracted folder to your system's
$PATH
variable to be able to access the executable from anywhere.For further instructions execute the following command.
apimcli --help
Global flags for CLI tool
The following are some global flags that you can use with the CLI tool.
--verbose Enable verbose logs (Provides more information on execution) --insecure, -k Allow connections to SSL sites without certs --help, -h Display information and example usage of a command
Adding an environment
You can add environments by either manually editing the $HOME/.wso2apimcli/main_config.yaml
file or by running the following CLI command.
apimcli add-env
The directory structure for the configuration files ( $HOME/.wso2apimcli
) will be created upon execution of the apimcli
command.
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
Run the following CLI command to add an environment.
apimcli add-env -n <environment-name> \ --registration <registration-endpoint> \ --apim <API-Manager-endpoint> \ --token <token-endpoint> \ --import-export <endpoint-for-environment> \ --admin <admin-REST-API-endpoint> \ --api_list <API-listing-REST-API-endpoint> \ --app_list <application-listing-REST-API-endpoint>
apimcli add-env -n <environment-name> --registration <registration-endpoint> --apim <API-Manager-endpoint> --token <token-endpoint> --import-export <endpoint-for-environment> --admin <admin-REST-API-endpoint> --api_list <API-listing-REST-API-endpoint> --app_list <application-listing-REST-API-endpoint>
Flags:
- Required flags:
--name, -n
There are no short flags for the following flags.--registration
--apim
--token
--import-export
--admin
--api_list
--app_list
Example 1apimcli add-env -n production \ --registration https://localhost:9443/client-registration/v0.14/register \ --apim https://localhost:9443 \ --token https://localhost:8243/token \ --import-export https://localhost:9443/api-import-export-2.6.0-{version} \ --admin https://localhost:9443/api/am/admin/v0.14 \ --api_list https://localhost:9443/api/am/publisher/v0.14/apis \ --app_list https://localhost:9443/api/am/store/v0.14/applications
Example 2apimcli add-env -n dev \ --registration https://localhost:9444/client-registration/v0.14/register \ --apim https://localhost:9444 \ --token https://localhost:8244/token \ --import-export https://localhost:9444/api-import-export-2.6.0-{version} \ --admin https://localhost:9444/api/am/admin/v0.14 \ --api_list https://localhost:9444/api/am/publisher/v0.14/apis \ --app_list https://localhost:9444/api/am/store/v0.14/applications
Example 1apimcli add-env -n production --registration https://localhost:9443/client-registration/v0.14/register --apim https://localhost:9443 --token https://localhost:8243/token --import-export https://localhost:9443/api-import-export-2.6.0-{version} --admin https://localhost:9443/api/am/admin/v0.14 --api_list https://localhost:9443/api/am/publisher/v0.14/apis --app_list https://localhost:9443/api/am/store/v0.14/applications
Example 2./apimcli add-env -n dev --registration https://localhost:9444/client-registration/v0.14/register --apim https://localhost:9444 --token https://localhost:8244/token --import-export https://localhost:9444/api-import-export-2.6.0-{version} --admin https://localhost:9444/api/am/admin/v0.14 --api_list https://localhost:9444/api/am/publisher/v0.14/apis --app_list https://localhost:9444/api/am/store/v0.14/applications
Successfully added environment '<environment-name>'
Successfully added environment 'production'
- Required flags:
Removing an environment
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
Run the following CLI command to remove an environment.
apimcli remove-env -n <environment-name>
apimcli remove-env --name <environment-name>
Flags:
- Required flags
--name, -n
apimcli remove-env -n production
Successfully removed environment '<environment-name>' Execute 'apimcli add-env --help' to see how to add a new environment
Successfully removed environment 'uat' Execute 'apimcli add-env --help' to see how to add a new environment
- Required flags
List environments
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
Run the following CLI command to list the environments.
There are no flags for the following CLI command.apimcli list envs
Environments available in file '/Users/kim/.wso2apimcli/main_config.yaml' +------------+------------------------+-----------------------------------------------------------+------------------------------+ | NAME | PUBLISHER ENDPOINT | REGISTRATION ENDPOINT | TOKEN ENDPOINT | +------------+------------------------+-----------------------------------------------------------+------------------------------+ | dev | https://localhost:9443 | https://localhost:9443/client-registration/v0.14/register | https://localhost:8243/token | | production | https://localhost:9444 | https://localhost:9444/client-registration/v0.14/register | https://localhost:8244/token | +------------+------------------------+-----------------------------------------------------------+------------------------------+
Migrating APIs to different environments
Exporting an API
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
- Run the following CLI command to export an existing API as a
.zip
archive.
apimcli export-api -n <API-name> -v <version> -r <provider> -e <environment> -u <username> -p <password> -k
apimcli export-api --name <API-name> --version <version> --provider <provider> --environment <environment> --username <username> --password <password> --insecure
The username and password are optional flags. You will be prompted to enter your credentials if you do not provide these flags.
Flags:
- Required flags:
--name, -n
--version, -v
--provider, -r
--environment, -e
--insecure, -k : This allows connections to SSL sites without certificates
- Optional flags:
--username, -u
--password, -p
apimcli export-api -n PhoneVerification -v 1.0.0 -r admin -e dev -u admin -p admin -k
Succesfully exported API! Find the exported API at /Users/kim/.wso2apimcli/exported/apis/dev/PhoneVerification_1.0.0.zip
Importing an API
You can use the archive created in the previous section to import APIs to an API Manager instance.
Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
For Secure Endpoint Enabled APIs:
If you have enabled secure endpoints when creating the API and your username or/and password differs in the two environments, please follow the steps below before importing the API.
1. Unzip the .zip archive created in the previous section.
2. Go to the
<API-name-version>/Meta-information
directory and open theapi.json
file.
For example,PhoneVerification_1.0.0/Meta-information
directory and open theapi.json
file.3. Modify the
endpointUTPassword
with your endpoint password and save theapi.json
file.4. Compress the
PhoneVerification_1.0.0
folder to a folder namedmyExportedAPI.
Run the following CLI command to import an API.
apimcli import-api -f <environment>/<file> -e <environment> -u <username> -p <password> -k
apimcli import-api --file <environment>/<file> --environment <environment> --username <username> --password <password> --insecure
The username and password are optional flags. You will be prompted to enter your credentials if you do not provide these flags.
Flags:
- Required flags:
--file, -f : The file path of the exported API. For example, if your file path is
/Users/kim/.wso2apimcli/exported/apis/dev/PhoneVerification_1.0.0.zip.,dev/PhoneVerification_1.0.0.zip
as the value for this flag.--environment, -e : The environment to which you what to import the API to.
--insecure, -k : This a llows connections to SSL sites without certificates
- Optional flags:
--username, -u
--password, -p
apimcli import-api -f dev/PhoneVerification_1.0.0.zip -e production -u admin -p admin -k
Sample ResponseZipFilePath: /Users/kim/.wso2apimcli/exported/apis/dev/PhoneVerification_1.0.0.zip Successfully imported API 'dev/PhoneVerification_1.0.0.zip' Succesfully imported API!
You must add a parameter named
--preserve-provider
to the CLI command and set its value to false if the API is imported to a different domain than its exported one. This parameter sets the provider of the imported API to the user who is issuing the CLI command. Here's an example:apimcli import-api -k -f <environment>/<file> -e <environment> -u <username> -p <password> --preserve-provider <preserve_provider>
apimcli import-api --insecure --file <environment>/<file> --environment <environment> -u <username> -p <password> --preserve-provider=<preserve_provider>
The username and password are optional flags. You will be prompted to enter your credentials if you do not provide these flags.
Flags:
- Required flags:
--insecure, -k : This a llows connections to SSL sites without certificates
--file, -f
--environment, -e : The environment to which you what to import the API to.
--preserve-provider (This does not have a short flag)
- Optional flags:
--username, -u
--password, -p
apimcli import-api -k -f dev/PhoneVerification_1.0.0.zip -e production -u admin -p admin --preserve-provider=false
The
--preserve-provider
flag is used to decide whether to keep the actual Provider as the provider of the API or change the provider to the user who is importing the API to a different environment.As an example, If
--preserve-provider
is set to true, when importing an API created by user-1 in environment-1 will be preserved as the provider when and after importing that API to environment-2 by user-2. If--preserve-provider
is set to false, when importing that API created by user-1 to the environment-2, the provider will be changed (not preserved) to user-2 who is importing the API.Troubleshooting
After importing, if the APIs are not visible in the API Publisher UI, do the following to re-index the artifacts in the registry.
Rename the
<lastAccessTimeLocation>
element in the<API-M_2.6.0_HOME>
/repository/conf/registry.xml
file. If you use a clustered/distributed API Manager setup, change the file in the API Publisher node. For example, change the/_system/local/repository/components/org.wso2.carbon.registry/indexing/lastaccesstime
registry path to/_system/local/repository/components/org.wso2.carbon.registry/indexing/lastaccesstime_1.
Shut down the API Manager 2.6.0, backup and delete the
<API-M_2.6.0_HOME>
/solr
directory.For more information, see Upgrading the API Manager to 2.6.0.
- Required flags:
Importing/exporting an API in a tenanted environment
The environments that you create will be common to the admin and the tenants. Therefore, you do not need to create environments again when exporting and importing APIs between tenanted environments.
To export an API from a tenant, follow the steps in Export an API. Use the tenant-specific encoded credentials in the CLI command. Here's an example:
apimcli export-api -n <API-name> -v <version> -r <provider> -e <environment> -u <username> -p <password> -k
apimcli export-api --name <API-name> -version <version> --provider <provider> --environment <environment> --username <username> --password <password> --insecure
The username and password are optional flags. You will be prompted to enter your credentials if you do not provide these flags.
Flags:
- Required flags:
--name, -n
--version, -v
--provider, -r
--environment, -e : The environment to which you what to export the API to.
--insecure, -k : This allows connections to SSL sites without certificates
- Optional flags:
--username, -u
--password, -p
apimcli export-api -n PizzaShackAPI -v 1.0.0 -r [email protected] -e dev -u [email protected] -p chris123 -k
Sample ResponseSuccesfully exported API! Find the exported API at /Users/kim/.wso2apimcli/exported/apis/dev/PizzaShackAPI_1.0.0.zip
- Required flags:
To import the API in another tenant, follow the steps in Importing an API. Use the encoded credentials for this tenant in the CLI command. Here's an example:
apimcli import-api -f <environment>/<file> -e <environment> -u <username> -p <password> --preserve-provider <preserve_provider>
apimcli import-api --file <environment>/<file> --environment <environment> --username <username> --password <password> --preserve-provider <preserve_provider>
The username and password are optional flags. You will be prompted to enter your credentials if you do not provide these flags.
Flags:
- Required flags:
--file, -f
--environment, -e : The environment to which you what to import the API to.
--insecure, -k : This allows connections to SSL sites without certificates
--preserve-provider
- Optional flags:
--username, -u
--password, -p
apimcli import-api -f dev/PizzaShackAPI_1.0.0.zip -e production -u [email protected] -p nick123 --preserve-provider=false -k
ZipFilePath: /Users/kim/.wso2apimcli/exported/apis/dev/PizzaShackAPI_1.0.0.zip Successfully imported API 'dev/PizzaShackAPI_1.0.0.zip' Succesfully imported API!
Note that the
--preserve-provider
flag value should be set tofalse
.- Required flags:
List APIs
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
- Run the following CLI command to list the APIs.
apimcli list apis -e <environment> -u <username> -p <password> -k
apimcli list apis --environment <environment> --username <username> --password <password> --insecure
apimcli list apis --environment <environment> --limit <maximum number of APIs> --insecure
Flags:
- Required flags:
--environment, -e
--insecure, -k
- Optional flags:
--username, -u
--password, -p
--limit, -l : Maximum number of APIs to return
The username and password are optional flags. You will be prompted to enter your credentials if you do not provide these flags.
apimcli list apis -e dev -u admin -p admin -k
apimcli list apis --environment dev --username admin --password admin --insecure
apimcli list apis --environment dev --limit 40 --insecure
Environment: dev No. of APIs: 2 +-------------------+---------+--------------+-----------+----------+--------------------------------------+ | NAME | VERSION | CONTEXT | STATUS | PROVIDER | ID | +-------------------+---------+--------------+-----------+----------+--------------------------------------+ | PhoneVerification | 1.0.0 | /phoneverify | PUBLISHED | admin | 2f25b332-4007-4c83-8249-b14b8af04848 | | PizzaShackAPI | 1.0.0 | /pizzashack | PUBLISHED | admin | 59e81b69-24d2-4fc4-9aaa-40665e119261 | +-------------------+---------+--------------+-----------+----------+--------------------------------------+
Migrating applications to different environments
Managing application lifecycle
The lifecycle of an application could be defined as the stages of an application between the development and production environments. The feature facilitates to manage the application life cycle by allowing the user to migrate the applications within desired environments. The user should have admin permissions in order to use this.
Exporting an application
You can export applications in the API Store and download them as a zipped file.
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
- Run the following CLI command to export an existing application as a
.zip
archive.
apimcli export-app -n <application-name> -o <owner> -e <environment> -u <username> -p <password> -k
apimcli export-app --name <application-name> --owner <owner> --environment <environment> --username <username> --password <password> --insecure
apimcli export-app --name <application-name> --owner <owner> --environment <environment> --withKeys=<with-keys> --username <username> --password <password> --insecure
The username and password are optional flags. You will be prompted to enter your credentials if you do not provide these flags.
Flags:
- Required flags:
--name, -n
--owner, -o
--environment, -e : The environment to which you what to export the application to.
--insecure, -k : This allows connections to SSL sites without certificates
- Optional flags:
--username, -u
--password, -p
--withKeys :
Export keys of the application. The default value is false.
apimcli export-app -n SampleApp -o admin -e dev -u admin -p admin -k
Succesfully exported Application! Find the exported Application at /Users/kim/.wso2apimcli/exported/apps/dev/admin_SampleApp.zip
The zipped file will be as follows:
<exported-Application>.zip
└── <Application-Name>
└── <Application-Name>.json
Importing an application
You can import an application to your environment as a zipped application. When you import an application as a zipped file, a new application is created within the target environment.
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
- Run the following CLI command to import an existing application as a
.zip
archive.
apimcli import-app -f <environment>/<file> -e <environment> -s <skip_subscriptions> -o <owner> -r <preserve_owner> -k
apimcli import-app --file <environment>/<file> --environment <environment> --skipSubscriptions <skip_subscriptions> --owner <owner> --preserveOwner <preserve_owner> --insecure
The username and password are optional flags. You will be prompted to enter your credentials if you do not provide these flags.
Flags:
- Required flags
--file, -f : The file path of the exported App. For example, if your file path is /Users/kim/.wso2apimcli/exported/apps/dev/admin_SampleApp.zip
,
then you need to enterdev/admin_SampleApp.zip
as the value for this flag.--environment, -e : The environment to which you what to import the application to.
--insecure, -k : This allows connections to SSL sites without certificates
- Optional flags
--skipSubscriptions, -s
You can opt to skip importing the subscriptions of the application by defining this flag. This parameter is set to false by default.--owner, -o
The owner of the imported application can be specified by providing an username of a valid user based on your preference. The application importer can set the preferred owner’s username as the value of the--owner
or-o
flag.--preserveOwner, -r
You can also import the application by preserving the application owner's information, from the previous environment. The application importer can add the --preserveOwner or -r flag in order to define that this flag is set to true. This parameter is set to false by default. Therefore, the default value is used when you do not define this flag. If you import the application without specifying any of the optional flags, you will be added as the owner of the application in the imported environment. If both the--owner
and the--preserveOwner
flags are set, then the--owner
flag gets higher priority over the--preserveOwner
flag.
apimcli import-app -f dev/admin_SampleApp.zip -e production -o admin --preserveOwner --skipSubscriptions -u admin -p admin -k
ZipFilePath: /Users/kim/.wso2apimcli/exported/apps/dev/admin_SampleApp.zip Completed importing the Application 'dev/admin_SampleApp.zip' Succesfully imported Application!
Importing applications in a single-tenant environment
Application A in environment 1 is migrated to environment 2. Some APIs may not be available in environment 2 (API B in this case) and the relevant subscriptions are not added in such cases (skipped).
- A different owner can be specified while importing an application to environment 2, without preserving the original user of environment 1.
- The original owner of the application can be preserved when the application is imported to environment 2 by adding the
--preserveOwner
flag.
Importing applications in a multi-tenant environment
In a situation where an application has API subscriptions in different tenant domains, such subscriptions are added if the relevant APIs with the target tier, are available in the importing environment. Note that the provider of the API may not be the same in the importing environment.
List apps
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
- Run the following CLI command to list the apps.
apimcli list apps -e <environment> -u <username> -o <owner> -p <password> -k
apimcli list apps --environment <environment> --owner <owner> --username <username> --password <password> --insecure
apimcli list apps --environment <environment> --limit <maximum number of applications> --insecure
Flags:
- Required flags
--environment, -e
--owner, -o
--insecure, -k : This allows connections to SSL sites without certificates
- Optional flags
--username, -u
--password, -p
--limit, -l : Maximum number of Applications to return
The username and password are optional flags. You will be prompted to enter your credentials if you do not provide these flags.
apimcli list apps -e dev -o admin -u admin -p admin -k
apimcli list apps --environment dev --username admin --password admin --insecure
apimcli list apps --environment dev --limit 40 --insecure
Environment: production No. of Applications: 2 +--------------------------------------+--------------------+-------+----------+----------+ | ID | NAME | OWNER | STATUS | GROUP-ID | +--------------------------------------+--------------------+-------+----------+----------+ | e13b5bcf-dee5-48fe-9f23-bf46fc17a378 | DefaultApplication | | APPROVED | | | 153ad3d3-fa26-4dda-af54-27eee3327848 | TestApp | | APPROVED | | +--------------------------------------+--------------------+-------+----------+----------+
Reset user
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
Run the following CLI command to reset user details.
apimcli reset-user -e <environment>
apimcli reset-user --environment <environment>
Flags:
- Required flags
--environment, -e
apimcli reset-user -e dev
Successfully cleared user data for environment: dev
- Required flags
Check the version of the CLI
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
Run the following CLI command to check the version of the CLI.
There are no flags for the following CLI command.apimcli version
apimcli Version: 1.1.0
Set HTTP request timeout
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
Run the following CLI command to set the HTTP request timeout.
apimcli set --http-request-timeout <http-request-timeout>
Flags:
--http-request-timeout
apimcli set --http-request-timeout 10000
Set TLS renegotiation mode
By default, TLS renegotiation is disabled for the CLI tool. However, the TLS renegotiation mode can be configured by running the following command, which will be applied globally to all subsequent TLS connections established by the CLI.
apimcli set --tls_renegotiation_mode <never|once|freely>
Flags:
--tls_renegotiation_mode
Allowed values for this flag are,
never: Disable TLS renegotiation
once: Allow TLS renegotiation once
freely: Allow unrestricted TLS renegotiation
apimcli set --tls_renegotiation_mode freely
Set export directory
- Make sure that WSO2 API Manager is started and that the CLI import/export tool is running.
Run the following CLI command to change the default location of the export directory.
apimcli set --export-directory <export-directory-path>
Flags:
--export-directory
apimcli set --export-directory /Users/kim/Downloads/MyExports
Understanding the API import/export tool
The API import/export tool uses a RESTful API, protected by basic authentication.
Only the following types of users are allowed to access the API import/export tool.
- A user with the admin role.
A user with a role that has the API-M Admin, Login, and API Create permissions.
To allow access to the import/export feature only for a particular tenant, log in to WSO2 API Manager's Management Console and add the downloaded archive file as a web application to the server.
The 'admin' role is the default role which is specified in the Realm configuration in the <API-M-HOME>/repository/conf/user-mgt.xml
file. It will be changed if you have changed the value of the <AdminRole>
parameter as shown below.
<Realm> <Configuration> <AddAdmin>true</AddAdmin> <AdminRole>admin</AdminRole> ..... </Configuration> </Realm>
The export functionality
The API export functionality retrieves the information required for the requested API from the registry and databases and generates a ZIP file, which the exporter can download. This exported ZIP file has the following structure:
The structure of the ZIP file is explained below:
Sub directory/File | Description |
---|---|
Meta Information |
|
Documents |
|
Image | Thumbnail image of the API |
WSDL | WSDL file of the API |
Sequences | The sequences available for the API |
The import functionality
The import functionality uploads the exported ZIP file of the API to the target environment. It creates a new API with all the registry and database resources exported from the source environment. Note the following:
- The lifecycle status of an imported API will always be
CREATED
even when the original API in the source environment has a different state. This is to enable the importer to modify the API before publishing it. - Tiers and sequences are provider-specific. If an exported tier is not already available in the imported environment, that tier is not added to the new environment. However, if an exported sequence is not available in the imported environment, it is added.
- The importer can decide whether to keep the original provider’s name or replace it. Set the
--preserve-provider
flag to true to keep it. If you set it to false, the original provider is replaced by the user who is sending the CLI command. - Cross-tenant imports are not allowed by preserving the original provider. For example, if an API is exported from tenant A and imported to tenant B, the value of the
--preserve-provider
flag must always befalse
.
/home/harsha/Pictures/tooling.png