Updated on 2022-10-27 GMT+08:00

Query the SSH key pair list

Function

This API is used to query the list of SSH key pairs.

URI

GET /v3/{project_id}/keypairs

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID.

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token. The token can be obtained by calling the IAM API (value of X-Subject-Token in the response header).

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

keypairs

Array of ListKeypairs objects

SSH key pair list.

Table 4 ListKeypairs

Parameter

Type

Description

keypair

Keypair object

Key pair information.

Table 5 Keypair

Parameter

Type

Description

name

String

SSH key pair name.

type

String

Type of the SSH key pair. The value can be ssh or x509.

scope

String

Tenant-level or user-level.

public_key

String

Public key information about an SSH key pair.

fingerprint

String

Fingerprint information about an SSH key pair.

is_key_protection

Boolean

Whether to host keys.

frozen_state

Integer

Frozen state. It can be:

  • 0: normal, not frozen

  • 1: frozen due to common causes

  • 2: frozen by the public security bureau

  • 3: frozen due to common causes and by the public security bureau

  • 4: frozen due to violations

  • 5: frozen due to common causes and violations

  • 6: frozen by the public security bureau and due to violations

  • 7: frozen by the public security bureau and due to common causes and violations

  • 8: frozen due to lack of real-name authentication

  • 9: frozen due to common causes and lack of real-name authentication

  • 10: frozen by the public security bureau and due to lack of real-name authentication

Status code: 400

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

None

Example Responses

Status code: 200

Request processing succeeded.

{
  "keypairs" : [ {
    "keypair" : {
      "name" : "1hprr3TI",
      "type" : "ssh",
      "scope" : "user",
      "public_key" : "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABjV8GvwpSs.....",
      "fingerprint" : "65:ca:87:0a:16:86:59:ea:57:ea:18:37:58:e2:04:b0",
      "is_key_protection" : false,
      "frozen_state" : 0
    }
  } ]
}

Status code: 400

Error occurred.

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

Status Codes

Status Code

Description

200

Request processing succeeded.

400

Error occurred.

Error Codes

See Error Codes.