A standalone Java application that is built with Maven to leverage the Apigee Management API.

• Java 8
• Maven

To run the application, you will need to package the JAR file using Maven:

$ mvn package

To execute the packaged JAR, you will need to run the following command:

$ java -jar apigee-utility.jar 

To use the application follow the prompts. E.g.

$ $ java -jar target/apigee-utility.jar

  Usage: action [-hV] [COMMAND]
  action to be performed
    -h, --help      Show this help message and exit.
    -V, --version   Print version information and exit.
  Commands:
    login      login to the Apigee API
    proxy      proxy action to be performed
    product    product action to be performed
    app        app action to be performed
    developer  developer action to be performed

Examples of the files needed to use this application can be found in the examples folder.

The following commands are examples of how to use the application:

To authenticate yourself and retrieve a token to perform all requests, execute the following command:

$ java -jar apigee-utility.jar login -o {organisationName} -e {emailAddress} -p

NOTE: the password field entry is interactive so there is no need to enter the password after the -p argument.

To import a proxy from a ZIP file containing xml files with an API Proxy configuration, execute the following command:

$ java -jar apigee-utility.jar proxy import -n {proxyName} -l {zipFileLocation} -t {token}

To deploy a specific revision of a registered API Proxy to a specific environment for an organization, execute the following command:

$ java -jar apigee-utility.jar proxy deploy -n {proxyName} -r {revisionNumber} -e {environment} -t {token}

To undeploy a specific revision of a registered API Proxy to a specific environment for an organization, execute the following command:

$ java -jar apigee-utility.jar proxy undeploy -n {proxyName} -r {revisionNumber} -e {environment} -t {token}

To delete a registered API Proxy from an organization, execute the following command:

$ java -jar apigee-utility.jar proxy delete -n {proxyName} -t {token}

To create an API Product for an organization from a JSON file containing the required configuration, execute the following command:

$ java -jar apigee-utility.jar product create -l {jsonFileLocation} -t {token}

An example of a JSON file that will be valid is seen below:

{
  "name" : "from_the_util",
  "displayName": "Util Test Product",
  "approvalType": "auto",
  "attributes": [
    {
      "name": "access",
      "value": "public"
    }
  ],
  "description": "This is a test API Product",
  "apiResources": [ "/test", "/dev/test" ],
  "environments": [ "dev", "prod" ],
  "proxies": ["test_from_util"]
}

To delete a registered API Product from an organization, execute the following command:

$ java -jar apigee-utility.jar product delete -n {productName} -t {token}

To create a developer for an organization from a JSON file containing the required configuration, execute the following command:

$ java -jar apigee-utility.jar developer create -l {jsonFileLocation} -t {token}

An example of a JSON file that will be valid is seen below:

{
 "email" : "[email protected]",
 "firstName" : "User",
 "lastName" : "Name",
 "userName" : "user"
}

To delete a registered developer from an organization, execute the following command:

$ java -jar apigee-utility.jar developer delete -e {developerEmail} -t {token}

To create an app for a registered developer for an organization from a JSON file containing the required configuration, execute the following command:

$ java -jar apigee-utility.jar app create -e {developerEmail} -l {jsonFileLocation} -t {token}

An example of a JSON file that will be valid is seen below:

{
 "name" : "user_app",
 "apiProducts": [ "from_the_util" ],
 "attributes" : [
  {
   "name" : "DisplayName",
   "value" : "Users App"
  }
 ]
}

To delete an app registered to a developer for an organization, execute the following command:

$ java -jar apigee-utility.jar app delete -e {developerEmail} -n {appName} -t {token}

If you need to execute all HTTP requests through an external proxy, this can be done for all commands by supplying the hostname and port number as arguments.

$ java -jar apigee-utility.jar login -o {organisationName} -e {emailAddress} -p --proxy-host https://zaproxy.mtn.com
$ java -jar apigee-utility.jar import -n {proxyName} -l {zipFileLocation} -t {token} --proxy-host https://zaproxy.mtn.com --proxy-port 9090

NOTE: if the proxy port argument is not supplied with the proxy host argument, the port number will default to 8080.

Feel free to open a Pull Request and we can improve this little utility!