Manage Plan Entitlements
An entitlement is the relationship between an API and a plan, describing that a plan entitles a client application to invoke an API, and under what conditions.
Understand Plan Entitlements
An entitlement is the relationship between a plan and an API that defines how a client application can access the API.
There is a many-to-many relationship between plans and APIs. A given plan can have entitlements to multiple APIs; for example, to group related APIs. A given API can be entitled by multiple plans; for example, to provide different quality of service criteria. Note that two entitlements of the same plan cannot point to the same entire API, or to the same action in an API.
You must have a Plan Manager role to manage plan entitlements.
View Plan Entitlement Details
You can view the entitlements in a plan and details such as whether the entitlement is active or published.
- On the Plans List page, click the plan whose entitlements you want to view.
- Click the (Entitlements) tab.
- To filter the list for active or inactive entitlements, click the Active or Inactive tab.
- To filter the list for published or unpublished entitlements, click the Published or Unpublished tab.
- To see all entitlements, click the All tab.
- To view more details about an entitlement, click its name or the Expand icon to the right.
Add an API Entitlement to a Plan
A plan can have multiple entitlements.
- On the Plans List page, click the plan to which you want to add an entitlement.
- Click the (Entitlements) tab.
- Click Add Entitlement.
- Select the API or APIs to you want to add to the plan.
- Click Add.
Set Rate Limits for an Entitlement
You add rate limits on entitlements to control requests from a specific API to a plan. These rate limits only affect the API in the entitlement.
You can set multiple rate limit conditions. In this case, the most restrictive condition is the limiting factor. For example, you set two rate limit conditions, one for 1000 requests per second and another for 10000 requests per minute. The plan allows the full 10000 requests per minute, but if more than 1000 requests occur in any given second, the excess requests are rejected for that second.
If the API uses an Apiary specification, you can set rate limits for specific actions in the API. If the API does not use an Apiary specification, then you can only set rate limits at the API level.
To set a rate limit for a plan entitlement:
Publish and Unpublish an Entitlement in a Plan
Publishing an entitlement makes it available to application developers in the Developer Portal.
- On the Plans List page, click the plan for which you want to publish or unpublish an entitlement.
- Click the (Entitlements) tab.
- Click the entitlement that you want to publish or unpublish.
- Click the Publish or Unpublish button.
- Click Yes.
Activate and Deactivate an Entitlement in a Plan
A plan must be active for it to be available for use.
- On the Plans List page, click the plan for which you want to publish or unpublish an entitlement.
- Click the (Entitlements) tab.
- Click the entitlement that you want to publish or unpublish.
- Click the Activate or Deactivate button.
- Click Yes.
Remove an Entitlement from a Plan
Removing an entitlement removes access to all the APIs in the entitlement.
- On the Plans List page, click the plan for which you want to remove an entitlement.
- Click the (Entitlements) tab.
- Click the entitlement that you want to remove.
- Click the Remove button.
- Click Yes.