Reminding Users of Risks for a DDM Kernel Version (a V3 API)

Function

Remind users of risks for a DDM kernel version.

Constraints

None

URI

URL format
GET /v3/{project_id}/instances/{instance_id}/show-risk-info

Parameter description

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID of a tenant in a region To obtain this value, see Obtaining a Project ID.
instance_id	Yes	String	DDM instance ID

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. You can obtain the token by calling the IAM API used to obtain a user token.

Example Request

Remind users of risks for a DDM kernel version.

GET https://{endpoint}/v3/{project_id}/instances/{instance_id}/show-risk-info

Response

Normal response

**Table 3** Response body parameters
Parameter	Type	Description
risks	Array of RiskInfo objects	Kernel risk information

**Table 4** RiskInfo
Parameter	Type	Description
instance_id	String	Instance ID
engine_name	String	Engine name
engine_version	String	Current engine version
level	Integer	Risk level
suggest	String	Upgrade reason
influence	String	Upgrade impact
guidance	String	Guidance link
service_impact_duration	String	Service impact duration
upgrade_duration	String	Upgrade duration

Normal response example

{
  "risks": [
    {
      "instance_id": "d697f4a676d64e68a323711e559b021din09",
      "engine_name": "ddm",
      "engine_version": "3.1.0.3",
      "level": 1,
      "suggest": "MySQL clients cannot end queries occasionally. Upgrading the version to 3.1.0.7 at off-peak hours is recommended.",
      "influence": "Multiple nodes of a DDM instance are upgraded in rolling mode. There will be a brief interruption (seconds) that the applications can detect. To minimize the impact, perform the upgrade during off-peak hours and ensure that your applications support automatic reconnection.",
      "guidance": "https://support.huaweicloud.com/usermanual-ddm/ddm_06_0042.html",
      "service_impact_duration: "The interruption is less than 60s for regular workloads.",
      "upgrade_duration: "The upgrade duration depends on how many instance nodes are upgraded. Upgrading a single node takes about 5 minutes."
    }
  ]
}