This end-point provides resource permissions information.

Documents & examples

Get information about resource permissions.

Method: GET

URL: /rest_api/v1/auth/resource-permissions/

Query params:

  • permission (string)
  • resource (string)
  • ordering (string) Comma separated list of fields for ordering results.
    • To sort by a field in descending order, prefix its name with minus (e.g. -name).
    • Use double underscores for nested field names (e.g. parent__child for {"parent": {"child": ...}}).

Following filters can be used to show only specific fields. This can make response time faster. Format is list or single value (JSON: {"fields": ["a","b"]} or {"fields": "a"}, in URL: ?fields=a&fields=b).

  • fields (list | string) Fields to display (other fields will be hidden).
  • exclude_fields: (list | string) Fields NOT to display (overrules fields).

Response:

 # paged lists
{
    "count": int,
    "next": url,
    "previous": url,
    "results": [
        {
            "resource": string,
            "permission": string
        }
        ...
    ]
}

Browsable GET

GET /rest_api/v1/auth/resource-permissions/?page=2
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "count": 194,
    "next": "https://pdc.fedoraproject.org/rest_api/v1/auth/resource-permissions/?page=3",
    "previous": "https://pdc.fedoraproject.org/rest_api/v1/auth/resource-permissions/",
    "results": [
        {
            "resource": "bugzilla-components",
            "permission": "update"
        },
        {
            "resource": "build-image-rtt-tests",
            "permission": "read"
        },
        {
            "resource": "build-image-rtt-tests",
            "permission": "update"
        },
        {
            "resource": "build-images",
            "permission": "create"
        },
        {
            "resource": "build-images",
            "permission": "delete"
        },
        {
            "resource": "build-images",
            "permission": "read"
        },
        {
            "resource": "build-images",
            "permission": "update"
        },
        {
            "resource": "changesets",
            "permission": "read"
        },
        {
            "resource": "component-branches",
            "permission": "create"
        },
        {
            "resource": "component-branches",
            "permission": "delete"
        },
        {
            "resource": "component-branches",
            "permission": "read"
        },
        {
            "resource": "component-branches",
            "permission": "update"
        },
        {
            "resource": "component-branch-slas",
            "permission": "create"
        },
        {
            "resource": "component-branch-slas",
            "permission": "delete"
        },
        {
            "resource": "component-branch-slas",
            "permission": "read"
        },
        {
            "resource": "component-branch-slas",
            "permission": "update"
        },
        {
            "resource": "component-groups",
            "permission": "create"
        },
        {
            "resource": "component-groups",
            "permission": "delete"
        },
        {
            "resource": "component-groups",
            "permission": "read"
        },
        {
            "resource": "component-groups",
            "permission": "update"
        }
    ]
}