Update Service Associated to a Specific Plugin

PATCH {{gateway}}/plugins/:pluginId/service

Update Service Associated to a Specific Plugin konghq

AttributesMandatoryTypeDescription
plugin idrequiredpathThe unique identifier of the Plugin associated to the Service to be updated

Request Body

AttributesMandatoryDescription
nameoptionalThe Service name
retriesoptionalThe number of retries to execute upon failure to proxy. Defaults to 5
protocolrequiredThe protocol used to communicate with the upstream. Accepted values are: "grpc", "grpcs", "http", "https", "tcp", "tls". Defaults to "http"
hostrequiredThe host of the upstream server
portrequiredThe upstream server port. Defaults to 80
pathoptionalThe path to be used in requests to the upstream server.
connect_timeoutoptionalThe timeout in milliseconds for establishing a connection to the upstream server. Defaults to 60000.
write_timeoutoptionalThe timeout in milliseconds between two successive write operations for transmitting a request to the upstream server. Defaults to 60000.
read_timeoutoptionalThe timeout in milliseconds between two successive read operations for transmitting a request to the upstream server. Defaults to 60000.
tagsoptionalAn optional set of strings associated with the Service, for grouping and filtering.
client_certificateoptionalCertificate to be used as client certificate while TLS handshaking to the upstream server. With form-encoded, the notation is client_certificate.id=. With JSON, use “"client_certificate":{"id":""}.
urlrequiredShorthand attribute to set protocol, host, port and path at once. This attribute is write-only (the Admin API never “returns” the url).

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring