Help Center/ Data Encryption Workshop/ API Reference (Ally Region)/ APIs/ Key Pair Service/ Updating the Description About an SSH Key Pair
Updated on 2025-12-29 GMT+08:00

Updating the Description About an SSH Key Pair

Function

Update the description about an SSH key pair.

Calling Method

For details, see Calling APIs.

URI

PUT /v3/{project_id}/keypairs/{keypair_name}

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID

keypair_name

Yes

String

Key pair name

Request Parameters

Table 2 Request header parameter

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

It can be obtained by calling the IAM API. The value of X-Subject-Token in the response header is the user token.

Table 3 Request body parameter

Parameter

Mandatory

Type

Description

keypair

Yes

UpdateKeypairDescriptionReq object

Message body for updating the SSH key pair description

Table 4 UpdateKeypairDescriptionReq

Parameter

Mandatory

Type

Description

description

Yes

String

Description

Response Parameters

Status code: 400

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Error code

error_msg

String

Error description

Example Request

{
  "keypair" : {
    "description" : "description"
  }
}

Example Response

Status code: 400

Error response

{
  "error_code" : "KPS.XXX",
  "error_msg" : "XXX"
}

Status Codes

Status Code

Description

200

OK

400

Error response

Error Codes

For details, see Error Codes.