Suggestion Rules
Suggestion rules allow for automated management of resources.
Suggestion rule can be configured to:
- Map resources to existing catalog service
- Map resources to a new catalog service
- Archive resources
System suggestion rules are built-in rules which are configured and managed by Kong.
List System Suggestion Rules
Returns a paginated collection of a system defined suggestion rules.
Query Parameters
The maximum number of items to include per page. The last page of a collection may include fewer items.
Example:10
Determines which page of the entities to retrieve.
Example:1
Path Parameters
Machine name of the integration.
Example:gateway-manager
Response
application/json
Response
A paginated list response for a collection of system defined suggestion rules.
returns the pagination information
Show Child Parameters
Contains information about the system defined suggestion rule.
Show Child Parameters
Authentication
Path Parameters
Query Parameters
Create Suggestion Rule
Creates a suggestion rule for the given integration.
Path Parameters
Machine name of the integration.
Example:gateway-manager
Body
application/json
Body
Request body schema for creating a suggestion rule for an integration.
SuggestionRulePayload
Payload to create a suggestion rule for an integration.
The display name of the suggestion rule
>= 1 characters<= 120 characters
The description of the suggestion rule
Default:null
>= 1 characters<= 2048 characters
Example:Suggestion rule description
The integration binding object name
Example:pagerduty_service
Determines if this suggestion rule should be evaluated when generating suggested actions.
Determines if the suggested action should be applied automatically.
true: Suggested action will be applied automaticallyfalse: Suggested action will not be automatically applied, user input required
A boolean string or JQ expression that must evaluate to a boolean value.
Supports JQ expressions syntax on discovered entity’s integration_record property.
<= 2048 characters
Example:.gateway_service.tags | contains(["_KonnectDeployment:"])
One OfShow Child Parameters
One OfDetermines how this suggestion rule ranks against existing suggestion rules for the integration.
When rank is not specified, this suggestion rule will placed as the lowest priority rule.
Show Child Parameters
Response
application/json
Response
A response containg a suggestion rule object.
SuggestionRule
Contains information about the suggestion rule.
The suggestion rule ID.
Example:22f72bd1-2897-473e-9471-302de3ccf38b
The display name of the suggestion rule.
>= 1 characters<= 120 characters
The description of the suggestion rule
Default:null
>= 1 characters<= 2048 characters
Example:Suggestion rule description
The integration binding object name
Example:pagerduty_service
Determines if this suggestion rule should be evaluated when generating suggested actions.
Determines if the suggested action should be applied automatically.
true: Suggested action will be applied automaticallyfalse: Suggested action will not be automatically applied, user input required
One OfThe action configuration for this system suggestion rule.
Show Child Parameters
An ISO-8601 timestamp representation of entity creation date.
Example:2022-11-04T20:10:06.927Z
An ISO-8601 timestamp representation of entity update date.
Example:2022-11-04T20:10:06.927Z
A boolean string or JQ expression that must evaluate to a boolean value.
Supports JQ expressions syntax on discovered entity’s integration_record property.
Example:.gateway_service.tags | contains(["_KonnectDeployment:"])
Authentication
Path Parameters
Body
List Suggestion Rules
Returns a paginated collection of a suggestion rules.
Query Parameters
The maximum number of items to include per page. The last page of a collection may include fewer items.
Example:10
Determines which page of the entities to retrieve.
Example:1
Filters a collection of suggestion rules.
Show Child Parameters
Path Parameters
Machine name of the integration.
Example:gateway-manager
Response
application/json
Response
A paginated list response for a collection of suggestion rules.
returns the pagination information
Show Child Parameters
Contains information about the suggestion rule.
Show Child Parameters
Authentication
Path Parameters
Query Parameters
Get a Suggestion Rule
Returns information about a suggestion rule from a given suggestion rule ID.
Path Parameters
Machine name of the integration.
Example:gateway-manager
ID of the suggestion rule.
Example:22f72bd1-2897-473e-9471-302de3ccf38b
Response
application/json
Response
A response containg a suggestion rule object.
SuggestionRule
Contains information about the suggestion rule.
The suggestion rule ID.
Example:22f72bd1-2897-473e-9471-302de3ccf38b
The display name of the suggestion rule.
>= 1 characters<= 120 characters
The description of the suggestion rule
Default:null
>= 1 characters<= 2048 characters
Example:Suggestion rule description
The integration binding object name
Example:pagerduty_service
Determines if this suggestion rule should be evaluated when generating suggested actions.
Determines if the suggested action should be applied automatically.
true: Suggested action will be applied automaticallyfalse: Suggested action will not be automatically applied, user input required
One OfThe action configuration for this system suggestion rule.
Show Child Parameters
An ISO-8601 timestamp representation of entity creation date.
Example:2022-11-04T20:10:06.927Z
An ISO-8601 timestamp representation of entity update date.
Example:2022-11-04T20:10:06.927Z
A boolean string or JQ expression that must evaluate to a boolean value.
Supports JQ expressions syntax on discovered entity’s integration_record property.
Example:.gateway_service.tags | contains(["_KonnectDeployment:"])