Sign in
Plugins

Create a KafkaUpstream plugin

Create a KafkaUpstream plugin

post/{workspace}/plugins#KafkaUpstream

Request body

conditionstring nullable

An expression used for conditional control over plugin execution. If the expression evaluates to true during the request flow, the plugin is executed; otherwise, it is skipped.

created_atinteger nullable

Unix epoch when the resource was created.

enabledboolean nullable

Whether the plugin is applied.

idstring nullable

A string representing a UUID (universally unique identifier).

instance_namestring nullable

A unique string representing a UTF-8 encoded name.

name'kafka-upstream' required

The name of the Plugin that's going to be added. Currently, the Plugin must be installed in every Kong instance separately.

tagsstring[] nullable

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

updated_atinteger nullable

Unix epoch when the resource was last updated.

protocolsstring[]

A set of strings representing HTTP protocols.

Response

Created KafkaUpstream plugin

conditionstring nullable

An expression used for conditional control over plugin execution. If the expression evaluates to true during the request flow, the plugin is executed; otherwise, it is skipped.

created_atinteger nullable

Unix epoch when the resource was created.

enabledboolean nullable

Whether the plugin is applied.

idstring nullable

A string representing a UUID (universally unique identifier).

instance_namestring nullable

A unique string representing a UTF-8 encoded name.

name'kafka-upstream' required

The name of the Plugin that's going to be added. Currently, the Plugin must be installed in every Kong instance separately.

tagsstring[] nullable

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

updated_atinteger nullable

Unix epoch when the resource was last updated.

protocolsstring[]

A set of strings representing HTTP protocols.

Changes

Changed in 4 of the 11 revisions of this API.316

  • 28b1f8a59cdc17See the full diff
    • ●

      added the new OAUTHBEARER enum value to the allOf[KafkaUpstreamPluginConfig]/config/authentication/mechanism response property for the response status 201

      response-property-enum-value-added

    • ○

      added the new optional request property allOf[KafkaUpstreamPluginConfig]/config/authentication/oauthbearer

      new-optional-request-property

    • ○

      added the new optional request property allOf[KafkaUpstreamPluginConfig]/config/error_handling

      new-optional-request-property

    • ○

      added the new optional request property allOf[KafkaUpstreamPluginConfig]/config/headers

      new-optional-request-property

    • ○

      added the new OAUTHBEARER enum value to the request property allOf[KafkaUpstreamPluginConfig]/config/authentication/mechanism

      request-property-enum-value-added

    • ○

      added the optional property allOf[KafkaUpstreamPluginConfig]/config/authentication/oauthbearer to the response with the 201 status

      response-optional-property-added

    • ○

      added the optional property allOf[KafkaUpstreamPluginConfig]/config/error_handling to the response with the 201 status

      response-optional-property-added

    • ○

      added the optional property allOf[KafkaUpstreamPluginConfig]/config/headers to the response with the 201 status

      response-optional-property-added

  • 9555cbb8b2596See the full diff
    • ○

      added the new optional request property allOf[KafkaUpstreamPluginConfig]/config/security/ssl_verify

      new-optional-request-property

    • ○

      added the new optional request property allOf[PluginBase]/condition

      new-optional-request-property

    • ○

      the ssl_verify request property default value changed from false to true

      request-property-default-value-changed

    • ○

      added the optional property allOf[KafkaUpstreamPluginConfig]/config/security/ssl_verify to the response with the 201 status

      response-optional-property-added

    • ○

      added the optional property allOf[PluginBase]/condition to the response with the 201 status

      response-optional-property-added

    • ○

      the ssl_verify response's property default value changed from false to true for the status 201

      response-property-default-value-changed

  • 65f3141f166222See the full diff
    • ●

      removed the request property name

      request-property-removed

    • ●

      removed the optional property name from the response with the 201 status

      response-optional-property-removed

    • ○

      added the new optional request property allOf[KafkaUpstreamPluginConfig]/name

      new-optional-request-property

    • ○

      added the optional property allOf[KafkaUpstreamPluginConfig]/name to the response with the 201 status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 740b73588ef41See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 11 revisions, 1 has no diff computed.