Software AG Products 10.7 | Using API Gateway | API Packages and Plans | Creating a Plan
 
Creating a Plan
You must have the manage packages and plans functional privilege assigned to perform this task.
You can create a plan from the Manage packages and plans page.
*To create a plan
1. Click Packages in the title navigation bar.
2. Click Create in the Manage packages and plans section.
3. Select Plan.
4. Click Create.
5. Provide the following information in the Basic information section:
Field
Description
Name
Name of the plan.
Version
Version assigned for the plan.
Team
Team to which the application must be assigned to. You can select more than one team. To remove a team, click the icon next to the team.
Description
A brief description for the plan.
Icon
An icon that is displayed for the plan.
Click Browse and select the required image to be displayed as the icon for the plan. The icon size should not be more than 100 KB.
You can save the plan at this point and add the pricing and traffic optimization configurations at a later time.
6. Click Continue to Pricing.
Alternatively, click Pricing in the left navigation pane.
7. Provide the following information in the Pricing section:
Field
Description
Cost
Specifies the cost for the plan.
Terms
Specifies the terms of conditions for the pricing.
License
Specifies the license information.
You can save the plan at this point and provide traffic optimization configurations at a later time.
8. Click Continue to Quality of Service.
Alternatively, click Rate limits in the left navigation pane.
9. Click + Add Rule.
10. Provide the following information in the Create Rule section:
Field
Description
Maximum request count
Specifies the maximum number of requests handled.
Value provided should be an integer.
Interval
Specifies the value for the interval for which the maximum request count is handled.
Value provided should be an integer.
Interval unit
Specifies the unit of measurement of the time interval. For example:
*Minutes
*Hours
*Days
*Calendar Week. The plan starts on the first day of the week and ends on the last day of the week. By default, the start day of the week is set to Monday.
For example:
*If you subscribe to a package on a Wednesday and Interval is set to 1, the validity of the plan ends on Sunday, that is, 5 days.
*If you subscribe to a package on a Wednesday and Interval is set to 2, the validity of the plan still ends on Sunday, but the validity of the plan is two calendar weeks, that is 12 days.
You can change the start day of the week using the extended setting startDayOfTheWeek in the Administration > General > Extended settings section. Restart the API Gateway server for the changes to take effect.
*Calendar Month. Starts on the first day of the month and ends on the last day of the month.
For example:
*If you subscribe to a package in the month of August and Interval is set to 1, the validity of the plan ends on the last day of August.
*If you subscribe to a package in the month of August and Interval is set to 2, the validity of the plan ends in two calendar months, that is on the last day of September.
Alert frequency
Specifies how frequently to send alerts to API Gateway destination when the Rate limits condition is violated.
Select one of the options:
*Only Once. Triggers an alert only the first time one of the specified conditions is violated.
*Every Time. Triggers an alert every time one of the specified conditions is violated.
Violation message
Specifies the text that appears when the rule is violated.
11. Click Ok.
This creates the rule and displays it in the Configured rules table. Click + Add rule to add more rules. You can edit or delete the rules by clicking the Edit and the Delete icons respectively.
At a later time, when this plan is applied to an API through a package, the rules that you configured for this plan are enforced on the applied API.
12. Click Quota and provide the following information in the Quota settings section.
Field
Description
Maximum request quota
Specifies the maximum number of requests handled.
Value provided should be an integer.
Block on breach
When selected, it specifies that the access to the API is blocked when there is a rule violation. Also, a notification is sent to API Gateway destination depending on the Alert frequency.
By default, this option is not selected.
Interval
Specifies the value for the interval for which the maximum request quota is handled.
Value provided should be an integer.
Interval unit
Specifies the unit of measurement of the time interval. For example:
*Minutes
*Hours
*Days
*Calendar Week. The plan starts on the first day of the week and ends on the last day of the week. By default, the start day of the week is set to Monday.
For example:
*If you subscribe to a package on a Wednesday and Interval is set to 1, the validity of the plan ends on Sunday, that is, 5 days.
*If you subscribe to a package on a Wednesday and Interval is set to 2, the validity of the plan still ends on Sunday, but the validity of the plan is two calendar weeks, that is 12 days.
You can change the start day of the week using the extended setting startDayOfTheWeek in the Administration > General > Extended settings section. Restart the API Gateway server for the changes to take effect.
*Calendar Month. Starts on the first day of the month and ends on the last day of the month.
For example:
*If you subscribe to a package in the month of August and Interval is set to 1, the validity of the plan ends on the last day of August.
*If you subscribe to a package in the month of August and Interval is set to 2, the validity of the plan ends in two calendar months, that is on the last day of September.
Alert frequency
Specifies how frequently to send alerts to API Gateway destination when the Quota condition is violated.
Select one of the options:
*Only Once. Triggers an alert only the first time one of the specified conditions is violated.
*Every Time. Triggers an alert every time one of the specified conditions is violated.
Violation message
Specifies the text that displays when the policy is violated.
Notification settings
Specifies whether notifications are to be sent on rule violations.
Enable the toggle button to enable the notifications and provide the following information:
*Notify after (in %). Provide a value which is a number. A notification is sent to the configured email IDs once the total request count reaches the % value as provided in the maximum quota value.
*Violation message. Provide the content of the mail that is sent to the configured email Ids once the quota request count reaches the limit specified.
*Email Ids. Provide an email Id of the recipient to which notifications have to be sent once the quota request count reaches the limit specified. Click to add multiple recipients.
Note:
The SMTP settings under Administrator settings > Destinations has to be provided for an email to be sent.
Note:
The number of requests within a Quota interval is retained in case of server crash or restart. For example, if the number of requests against a Quota is 10 and if the server restarts or crashes, the number of requests for that Quota is retained when the server is up.
13. Click Save.
The plan is created and listed in the list of plans.