ssh_key_list.md

ssh_key_list

List and filter on SSH keys in the Linode profile.

• Examples
• Parameters
• Return Values

Examples

- name: List all of the SSH keys for the current Linode Account
  linode.cloud.ssh_key_list: {}

- name: List the latest 5 SSH keys for the current Linode Account
  linode.cloud.ssh_key_list:

    count: 5
    order_by: created
    order: desc

- name: List filtered personal SSH keys for the current Linode Account
  linode.cloud.ssh_key_list:

    filters:
      - name: label-or-some-other-field
        values: MySSHKey1

- name: List filtered personal SSH keys for the current Linode Account
  linode.cloud.ssh_key_list:
    filters:
      - name: label-or-some-other-field
        values:
          - MySSHKey1
          - MySSHKey2

Parameters

Field	Type	Required	Description
order	str	Optional	The order to list ssh keys in. (Choices: desc, asc; Default: asc)
order_by	str	Optional	The attribute to order ssh keys by.
filters (sub-options)	list	Optional	A list of filters to apply to the resulting ssh keys.
count	int	Optional	The number of results to return. If undefined, all results will be returned.

filters

Field	Type	Required	Description
name	str	Required	The name of the field to filter on. Valid filterable attributes can be found here: https://www.linode.com/docs/api/profile/#ssh-keys-list
values	list	Required	A list of values to allow for this field. Fields will pass this filter if at least one of these values matches.

Return Values

• ssh_keys - The returned SSH keys.

  • Sample Response:

    [
        {
          "created": "2018-01-01T00:01:01",
          "id": 42,
          "label": "MySSHKey1",
          "ssh_key": "ssh-rsa AAAA_valid_public_ssh_key_123456785== user@their-computer"
        }
    ]

  • See the Linode API response documentation for a list of returned fields