This documentation is for WSO2 Private PaaS 4.1.0. View documentation for the latest release.
Page Comparison - Updating an Application (v.6 vs v.7) - WSO2 Private PaaS 4.1.0 - WSO2 Documentation

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Localtab Group
Localtab
activetrue
titleCLI

Updating an application via the CLI

Overview
CLI command
update-application
DescriptionUpdate an application.
Command format
Code Block
update-application -p <JSON_FILE_PATH>
Info

The path to the JSON file that defines the application needs to be defined as the <JSON_FILE_PATH> value.

Parameter definition
Short optionLong optionDescriptionRequiredExample value
-p
--resource-pathFolder path where the JSON file that defines the application policy is stored.yes

<PRIVATE_PAAS_CARTRIDGES>/wso2am/1.9.0/samples/applications/
wso2am-190-application/artifacts/wso2am-190-application.json

Example

Update the application defined in the <PRIVATE_PAAS_CARTRIDGES>/wso2am/1.9.0/samples/ applications/wso2am-190-application/artifacts/wso2am-190-application.json file. 

Code Block
update-application -p <PRIVATE_PAAS_CARTRIDGES>/wso2am/1.9.0/samples/applications/wso2am-190-application/artifacts/wso2am-190-application.json
Sample output
Code Block
Application updated successfully: [application] wso2am-190-application
Localtab
titleREST API

Updating an application via the REST API

Overview
DescriptionUpdate an application definition.
Resource Path/applications
HTTP MethodPUT
Request/Response Formatapplication/json
Command format
Code Block
curl -X UT -H "Content-Type: application/json" -d @'<JSON_PAYLOAD>' -k -v -u <USERNAME>:<PASSWORD> https://<PRIVATE_PAAS_HOST>:<PRIVATE_PAAS_HTTPS_PORT>/api/applications
Info
  • The path to the JSON file that defines the application needs to be defined as the <JSON_PAYLOAD> value.
  • By default, <USERNAME>:<PASSWORD> is admin:admin.
  • By default, <PRIVATE_PAAS_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
  • By default, <PRIVATE_PAAS_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.
Example

Update the application defined in the <PRIVATE_PAAS_CARTRIDGES>/wso2am/1.9.0/samples/applications/wso2am-190-application/artifacts/wso2am-190-application.json file. 

Code Block
cd <PRIVATE_PAAS_CARTRIDGES>/wso2am/1.9.0/samples
curl -X PUT -H "Content-Type: application/json" -d @'applications/wso2am-190-application/artifacts/wso2am-190-application.json' -k -v -u admin:admin https://localhost:9443/api/applications
Sample output
Code Block
> PUT /api/applications HTTP/1.1
> Host: localhost:9443
> Authorization: Basic YWRtaW46YWRtaW4=
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Content-Length: 3193
> Expect: 100-continue
> 
< HTTP/1.1 100 Continue
< HTTP/1.1 201 Created
< Date: Thu, 08 Oct 2015 09:47:29 GMT
< Location: https://localhost:9443/api/applications/wso2am-190-application
< Content-Type: application/json
< Transfer-Encoding: chunked
< Server: WSO2 Carbon Server
< 
{"status":"success","message":"Application updated successfully: [application] wso2am-190-application"}

You will come across the following HTTP status codes while updating an application:

HTTP status code

200, 400, 409, 500

See the descriptions of the HTTP status codes here.

Location header URL

https://<PRIVATE_PAAS_HOST>:<PRIVATE_PAAS_HTTPS_PORT>/api/applications/<APPLICATION_ID>

 

...

Sample application definition JSON

Excerpt Include
Adding an Application
Adding an Application
nopaneltrue

...