Updated on 2022-02-22 GMT+08:00

Querying an SSH Key Pair (Native OpenStack API)

Function

This interface is used to query a specified SSH key pair based on the key pair name.

URI

GET /v2.1/{project_id}/os-keypairs/{keypair_name}

Table 1 lists the parameters.

Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

For details about how to obtain the project ID, see Obtaining a Project ID.

keypair_name

Yes

Specifies the key pair name.

You can obtain the key pair name by calling the Querying SSH Key Pairs (Native OpenStack API) API.

Request Message

  • Request parameters

    None

  • Example request
    1
    GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/os-keypairs/keypair-test
    

Response Message

  • Response parameters

    Parameter

    Type

    Description

    keypair

    Object

    Specifies the SSH key pair. For details, see Table 2.

    Table 2 keypair field data structure description

    Parameter

    Type

    Description

    public_key

    String

    Specifies information about the public key in the key pair.

    name

    String

    Specifies the key pair name.

    fingerprint

    String

    Specifies fingerprint information about the key pair.

    created_at

    String

    Specifies the time when the key pair was created.

    The timestamp format is ISO 8601, for example, 2019-05-07T12:06:13.681238.

    deleted

    Boolean

    Specifies the deleted key pair.

    • true: indicates that the key has been deleted.
    • false: indicates that the key is not deleted.

    deleted_at

    String

    Specifies the time when the key pair was deleted.

    The timestamp format is ISO 8601, for example, 2019-05-07T12:06:13.681238.

    id

    String

    Specifies the key pair ID.

    updated_at

    String

    Specifies the time when the key pair was updated.

    The timestamp format is ISO 8601, for example, 2019-05-07T12:06:13.681238.

    user_id

    String

    Specifies information about the user to which the key pair belongs.

  • Example response
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    {
        "keypair": {
            "created_at": "2019-05-07T12:06:13.681238",
            "deleted": false,
            "deleted_at": null,
            "fingerprint": "9d:00:f4:d7:26:6e:52:06:4c:c1:d3:1d:fd:06:66:01",
            "id": 1,
            "name": "keypair-3582d8b7-e588-4aad-b7f7-f4e76f0e4314",
            "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDYJrTVpcMwFqQy/oMvtUSRofZdSRHEwrsX8AYkRvn2ZnCXM+b6+GZ2NQuuWj+ocznlnwiGFQDsL/yeE+/kurqcPJFKKp60mToXIMyzioFxW88fJtwEWawHKAclbHWpR1t4fQ4DS+/sIbX/Yd9btlVQ2tpQjodGDbM9Tr9/+/3i6rcR+EoLqmbgCgAiGiVV6VbM2Zx79yUwd+GnQejHX8BlYZoOjCnt3NREsITcmWE9FVFy6TnLmahs3FkEO/QGgWGkaohAJlsgaVvSWGgDn2AujKYwyDokK3dXyeX3m2Vmc3ejiqPa/C4nRrCOlko5nSgV/9IXRx1ERImsqZnE9usB Generated-by-Nova",
            "updated_at": null,
            "user_id": "fake"
        }
    }
    

Returned Values

Normal values

Returned Values

Description

200

The server has successfully processed the request.

For details about other returned values, see Status Codes.

Error Codes

See Error Codes.