Modifying SSL of an Instance

This API is used to modify the SSL configuration of an instance.

POST /v2/{project_id}/{engine}/instances/{instance_id}/plain-ssl-switch

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID. For details about how to obtain it, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A
engine	Yes	String	Definition Engine. Constraints N/A Range rocketmq: RocketMQ message engine. reliability: RocketMQ message engine alias. Default Value N/A
instance_id	Yes	String	Definition Instance ID. You can call the API for querying all instances to obtain the instance ID. The instance ID is in the response body. Constraints N/A Range N/A Default Value N/A

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
tls_mode	No	String	Definition Protocol mode. Constraints N/A Range SSL: Ciphertext access with high security, but lower performance. PLAINTEXT: Plaintext access with high performance, but lower security. PERMISSIVE: Both ciphertext and plaintext access, depending on the client. Default Value N/A

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
job_id	String	Definition Task ID. Range N/A
tls_mode	String	Definition Protocol mode. Range SSL: Ciphertext access with high security, but lower performance. PLAINTEXT: Plaintext access with high performance, but lower security. PERMISSIVE: Both ciphertext and plaintext access, depending on the client.

'POST https://{endpoint}/v2/{project_id}/{engine}/instances/{instance_id}/plain-ssl-switch'

{
  "tls_mode" : "ssl"
}

Status code: 200

Modified.

{
  "job_id" : "8abfa7b3971f12a20197207ea77161af",
  "tls_mode" : "ssl"
}

Status Code	Description
200	Modified.

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.