Versions Compared

Old Version 6

changes.mady.by.user Former user

Saved on

compared with

New Version 7

changes.mady.by.user Former user

Saved on

Key

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

...

Localtabgroup
Localtab
activetrue
titleCLI

Add a deployment policy via the CLI

Overview
CLI command
add-deployment-policy
DescriptionAdd a deployment policy definition.
Command format
Code Block
add-deployment-policy -p <JSON_FILE_PATH>
Info

The path to the JSON file that defines the deployment policy 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 deployment policy is stored.Yes
<PRIVATE_PAAS_SAMPLES>/common/samples/
deployment-policies/deployment-policy-1.json
Example

Add the deployment policy that is defined in the <PRIVATE_PAAS_SAMPLES>/common/samples/deployment-policies/deployment-policy-1.json file.

Code Block
add-deployment-policy -p <PRIVATE_PAAS_SAMPLES>/common/samples/deployment-policies/deployment-policy-1.json
Sample output
Code Block
Deployment policy added successfully: [deployment-policy-id] deployment-policy-1
Localtab
titleREST API

Add a deployment policy via the REST API

Overview
DescriptionAdd a deployment policy definition.
Resource Path

/deploymentPolicies

HTTP MethodPOST
Request/Response Format

application/json

Command format
Code Block
curl -X POST -H "Content-Type: application/json" -d @'<JSON_PAYLOAD>' -k -v -u <USERNAME>:<PASSWORD> https://<PRIVATE_PAAS_HOST>:<PRIVATE_PAAS_HTTPS_PORT>/api/deploymentPolicies
Info
  • The path to the JSON file that defines the deployment policy 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

Add the deployment policy that is defined in the <PRIVATE_PAAS_SAMPLES>/common/samples/deployment-policies/deployment-policy-1.json file.

Code Block
cd <PRIVATE_PAAS_SAMPLES>/common/samples
curl -X POST -H "Content-Type: application/json" -d @'deployment-policies/deployment-policy-1.json' -k -v -u admin:admin https://localhost:9443/api/deploymentPolicies
Sample output
Code Block
> POST /api/deploymentPolicies HTTP/1.1
> Host: localhost:9443
> Authorization: Basic YWRtaW46YWRtaW4=
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Content-Length: 432
> 
< HTTP/1.1 201 Created
< Date: Mon, 05 Oct 2015 04:34:35 GMT
< Location: https://localhost:9443/api/deploymentPolicies/deployment-policy-1
< Content-Type: application/json
< Transfer-Encoding: chunked
< Server: WSO2 Carbon Server
< 
{"status":"success","message":"Deployment policy added successfully: [deployment-policy-id] deployment-policy-1"}

You will come across the following HTTP status codes while adding a deployment policy:

HTTP status code

201, 400, 409, 500

See the descriptions of the HTTP status codes here.

Location header URLhttps://<STRATOS_HOST>:<STRATOS_HTTPS_PORT>/api/deploymentPolicies/<DEPLOYMENT_POLICY_ID>

...