Versions Compared

Key

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

You can delete a cartridge using the CLI tool, REST API or the management console (UI) as shown below:

 

Localtabgroup
Localtab
activetrue
titleCLI

Delete a cartridge via the CLI

Overview
CLI command
remove-cartridge
DescriptionDelete a cartridge.
Command format
Code Block
remove-cartridge <CARTRIDGE_TYPE>
Parameter definition
Short optionLong optionDescriptionRequiredExample value
N/AN/AType of the cartridgeYes

wso2am-190

Example

Delete the cartridge with the type: wso2am-190.

Code Block
remove-cartridge wso2am-190
Sample output
Code Block
Cartridge deleted successfully: [cartridge-type] wso2am-190
Localtab
titleREST API

Delete a cartridge via the REST API

Overview
DescriptionDelete a cartridge.
Resource Path

/cartridges/{cartridgeType}

HTTP MethodDELETE
Request/Response Formatapplication/json
Command format
Code Block
curl -X DELETE -H "Content-Type: application/json" -k -v -u <USERNAME>:<PASSWORD> https://<PRIVATE_PAAS_HOST>:<PRIVATE_PAAS_HTTPS_PORT>/api/cartridges/{cartridgeType}
Info
  • 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

Delete the cartridge with the type: wso2am-190.

Code Block
curl -X DELETE -H "Content-Type: application/json" -k -v -u admin:admin https://localhost:9443/api/cartridges/wso2am-190
Sample output
Code Block
> DELETE /api/cartridges/wso2am-190 HTTP/1.1
> Host: localhost:9443
> Authorization: Basic YWRtaW46YWRtaW4=
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> 
< HTTP/1.1 200 OK
< Date: Tue, 06 Oct 2015 09:59:12 GMT
< Content-Type: application/json
< Transfer-Encoding: chunked
< Server: WSO2 Carbon Server
< 
{"status":"success","message":"Cartridge deleted successfully: [cartridge-type] wso2am-190"}

You will come across the following HTTP status codes while deleteing a cartridge:

HTTP status code

200, 404, 500

See the descriptions of the HTTP status codes here.

Localtab
titleManagement console

Delete a cartridge via the management console

 

...