# Description Documents the calls for the list, read, create, update and delete operations for GPG keys


GET /katello/api/gpg_keys
List gpg keys

Params

Param name Description
organization_id
required

organization identifier

Validations:

  • Must be a number.

name
optional

name of the GPG key

Validations:

  • String

search
optional

Search string

Validations:

  • String

page
optional

Page number, starting at 1

Validations:

  • Must be a number.

per_page
optional

Number of results per page to return

Validations:

  • Must be a number.

order
optional

Sort field and order, eg. 'id DESC'

Validations:

  • String

full_result
optional

Whether or not to show all results

Validations:

  • Must be one of: true, false, 1, 0.

sort_by
optional

Field to sort the results on

Validations:

  • String

sort_order
optional

How to order the sorted results (e.g. ASC for ascending)

Validations:

  • String

Search fields

Field name Type Possible values
name string
organization_id integer

POST /katello/api/gpg_keys
Create a gpg key

Params

Param name Description
organization_id
required

organization identifier

Validations:

  • Must be a number.

name
required

identifier of the gpg key

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

content
required

public key block in DER encoding

Validations:

  • String


GET /katello/api/gpg_keys/:id
Show a gpg key

Params

Param name Description
id
required

gpg key numeric identifier

Validations:

  • Must be a number.


PUT /katello/api/gpg_keys/:id
Update a repository

Params

Param name Description
id
required

gpg key numeric identifier

Validations:

  • Must be a number.

name
optional

identifier of the gpg key

Validations:

  • string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

content
optional

public key block in DER encoding

Validations:

  • String


DELETE /katello/api/gpg_keys/:id
Destroy a gpg key

Params

Param name Description
id
required

gpg key numeric identifier

Validations:

  • Must be a number.


GET /katello/api/gpg_keys/:id/content
Return the content of a gpg key, used directly by yum

Params

Param name Description
id
required

Validations:

  • Must be a number.


POST /katello/api/gpg_keys/:id/content
Upload gpg key contents

Params

Param name Description
id
required

gpg key numeric identifier

Validations:

  • Must be a number.

content
required

file contents

Validations:

  • File