Help Center> Cloud Container Engine> API Reference> Kubernetes APIs> API Groups> Listing APIResources of GroupVersion rbac.authorization.k8s.io/v1beta1
View PDF

Listing APIResources of GroupVersion rbac.authorization.k8s.io/v1beta1

Function

This API is used to list APIResources of GroupVersion "rbac.authorization.k8s.io/v1beta1".

URI

GET /apis/rbac.authorization.k8s.io/v1beta1

Request

N/A.

Response

Response parameters:

Table 1 describes the response parameters.

Table 1 Parameter description

Parameter

Type

Description

kind

String

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated.

groupVersion

String

groupVersion specifies the API group and version in the form "group/version"

resources

resources object

Standard list resource
Table 2 Data structure of the resources field

Parameter

Type

Description

categories

Array of strings

categories is a list of the grouped resources this resource belongs to (e.g. 'all')

kind

String

kind is the kind for the resource (e.g. 'Foo' is the kind for a resource 'foo')

name

String

name is the plural name of the resource.

namespaced

Boolean

namespaced indicates if a resource is namespaced or not.

shortNames

Array of strings

shortNames is a list of suggested short names of the resource.

singularName

String

singularName is the singular name of the resource. This allows clients to handle plural and singular opaquely. The singularName is more correct for reporting status on a single item and both singular and plural are allowed from the kubectl CLI interface.

verbs

Array of strings

verbs is a list of supported kube verbs (this includes get, list, watch, create, update, patch, delete, deletecollection, and proxy)

Example response:

{
    "kind": "APIResourceList",
    "apiVersion": "v1",
    "groupVersion": "rbac.authorization.k8s.io/v1beta1",
    "resources": [
        {
            "name": "clusterrolebindings",
            "singularName": "",
            "namespaced": false,
            "kind": "ClusterRoleBinding",
            "verbs": [
                "create",
                "delete",
                "deletecollection",
                "get",
                "list",
                "patch",
                "update",
                "watch"
            ]
        },
        {
            "name": "clusterroles",
            "singularName": "",
            "namespaced": false,
            "kind": "ClusterRole",
            "verbs": [
                "create",
                "delete",
                "deletecollection",
                "get",
                "list",
                "patch",
                "update",
                "watch"
            ]
        },
        {
            "name": "rolebindings",
            "singularName": "",
            "namespaced": true,
            "kind": "RoleBinding",
            "verbs": [
                "create",
                "delete",
                "deletecollection",
                "get",
                "list",
                "patch",
                "update",
                "watch"
            ]
        },
        {
            "name": "roles",
            "singularName": "",
            "namespaced": true,
            "kind": "Role",
            "verbs": [
                "create",
                "delete",
                "deletecollection",
                "get",
                "list",
                "patch",
                "update",
                "watch"
            ]
        }
    ]
}

Status Code

Table 3 describes the status code of this API.

Table 3 Status code

Status Code

Description

200

This operation succeeds, and a list of APIResources is returned.

For the description about status codes, see Status Code.

Parent topic: API Groups