Set log level of a single node

Change the log level of a node.

See the NGINX documentation for the list of possible return values.

put

Path Parameters

runtimeGroupIdstringrequired

The ID of your runtime group. This variable is available in the Konnect manager

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

log_levelstringrequired

Log levels are set in Kong’s configuration. Log levels increase in order of their severity

Allowed values:infonoticewarnerrorcrit

Example:warn

Response

200 application/json

OK

messagestring

A message confirming the log level change

Example:log level changed

put/runtime-groups/{runtimeGroupId}/core-entities/debug/node/log-level/{log_level}
 
200 application/json

Targets

Target routes

List all Targets associated with an Upstream

List all Targets associated with a an Upstream

get

Query Parameters

sizeinteger

Number of resources to be returned.

Default:100

>= 1<= 1000

offsetstring

Offset from which to return the next set of resources. Use the value of the ‘offset’ field from the response of a list operation as input here to paginate through all the resources

tagsstring

A list of tags to filter the list of resources on. Multiple tags can be concatenated using ‘,’ to mean AND or using ‘/’ to mean OR.

Example:tag1,tag2

Path Parameters

upstream_idstringrequired

ID or name of the related Upstream

runtimeGroupIdstringrequired

The ID of your runtime group. This variable is available in the Konnect manager

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

Response

200 application/json

A successful response listing Targets

Target

A target is an ip address/hostname with a port that identifies an instance of a backend service. Every upstream can have many targets, and the targets can be dynamically added, modified, or deleted. Changes take effect on the fly. To disable a target, post a new one with weight=0; alternatively, use the DELETE convenience method to accomplish the same. The current target object definition is the one with the latest created_at.

created_atnumber

Unix epoch when the resource was created.

Example:1422386534

updated_atinteger

Unix epoch when the resource was last updated.

Example:1422386534

idstring

The unique identifier or the name of the upstream for which to update the target.

Example:173a6cee-90d1-40a7-89cf-0329eca780a6

tagsarray[string]

An optional set of strings associated with the Target for grouping and filtering.

targetstring

The target address (ip or hostname) and port. If the hostname resolves to an SRV record, the port value will be overridden by the value from the DNS record.

upstreamobject

The unique identifier or the name of the upstream for which to update the target.

* Additional properties are NOT allowed.
Show Child Parameters
weightinteger

The weight this target gets within the upstream loadbalancer (0-65535). If the hostname resolves to an SRV record, the weight value will be overridden by the value from the DNS record.

Default:100

Example:100

get/runtime-groups/{runtimeGroupId}/core-entities/upstreams/{upstream_id}/targets
 
200 application/json

Create a new Target associated with an Upstream

Create a new Target associated with an Upstream

post

Path Parameters

upstream_idstringrequired

ID or name of the related Upstream

runtimeGroupIdstringrequired

The ID of your runtime group. This variable is available in the Konnect manager

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

Body

application/json
upstreamobject

The unique identifier or the name of the upstream for which to update the target.

Show Child Parameters
weightinteger

The weight this target gets within the upstream loadbalancer (0-65535). If the hostname resolves to an SRV record, the weight value will be overridden by the value from the DNS record.

Default:100

>= 0<= 65535

tagsarray[string]

An optional set of strings associated with the Target for grouping and filtering.

targetstring

The target IP address

Example:192.158.1.38

Response

application/json

Successfully created Target

Target

A target is an ip address/hostname with a port that identifies an instance of a backend service. Every upstream can have many targets, and the targets can be dynamically added, modified, or deleted. Changes take effect on the fly. To disable a target, post a new one with weight=0; alternatively, use the DELETE convenience method to accomplish the same. The current target object definition is the one with the latest created_at.

created_atnumber

Unix epoch when the resource was created.

Example:1422386534

updated_atinteger

Unix epoch when the resource was last updated.

Example:1422386534

idstring

The unique identifier or the name of the upstream for which to update the target.

Example:173a6cee-90d1-40a7-89cf-0329eca780a6

tagsarray[string]

An optional set of strings associated with the Target for grouping and filtering.

targetstring

The target address (ip or hostname) and port. If the hostname resolves to an SRV record, the port value will be overridden by the value from the DNS record.

upstreamobject

The unique identifier or the name of the upstream for which to update the target.

* Additional properties are NOT allowed.
Show Child Parameters
weightinteger

The weight this target gets within the upstream loadbalancer (0-65535). If the hostname resolves to an SRV record, the weight value will be overridden by the value from the DNS record.

Default:100

Example:100

post/runtime-groups/{runtimeGroupId}/core-entities/upstreams/{upstream_id}/targets

Body

{ "upstream": { "id": "fe335516-b679-44e5-8bf0-f9af0524e230" }, "target": "192.158.1.38", "weight": 100, "tags": [ "string" ] }
 
application/json

Delete a a Target associated with a an Upstream

Delete a a Target associated with a an Upstream using ID or target.

delete

Path Parameters

upstream_idstringrequired

The unique identifier of the Upstream associated to the Certificate to be retrieved.

Example:7fca84d6-7d37-4a74-a7b0-93e576089a41

target_idstringrequired

The id of an existing target entry.

Example:e94215b0-9198-42ce-bf0b-98afff31b2a7

runtimeGroupIdstringrequired

The ID of your runtime group. This variable is available in the Konnect manager

Example:9524ec7d-36d9-465d-a8c5-83a3c9390458

Response

204

Successfully deleted Target or the resource didn’t exist

delete/runtime-groups/{runtimeGroupId}/core-entities/upstreams/{upstream_id}/targets/{target_id}
 
204