⎈ k8s knowledge compiler

RoleBinding [page]deterministic

RoleBinding references a role, but does not contain it. It can reference a Role in the same namespace or a ClusterRole in the global namespace. It adds who information via Subjects and namespace information by which namespace it exists in. RoleBindings in a given namespace only have effect in that namespace.

referencesecurity

`apiVersion: rbac.authorization.k8s.io/v1`

`import "k8s.io/api/rbac/v1"`

## RoleBinding {#RoleBinding}

RoleBinding references a role, but does not contain it. It can reference a Role in the same namespace or a ClusterRole in the global namespace. It adds who information via Subjects and namespace information by which namespace it exists in. RoleBindings in a given namespace only have effect in that namespace.

<hr>

<table> <thead><tr><th>Field</th><th>Description</th></tr></thead> <tbody> <tr> <td><code>apiVersion</code><br/><em>string</em></td> <td>APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources</td> </tr> <tr> <td><code>kind</code><br/><em>string</em></td> <td>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. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds</td> </tr> <tr> <td><code>metadata</code><br/><em><a href="">ObjectMeta</a></em></td> <td>Standard object's metadata.</td> </tr> <tr> <td><code>roleRef</code>&nbsp;<strong>*</strong><br/><em><a href="">RoleRef</a></em></td> <td>RoleRef can reference a Role in the current namespace or a ClusterRole in the global namespace. If the RoleRef cannot be resolved, the Authorizer must return an error. This field is immutable.</td> </tr> <tr> <td><code>subjects</code><br/><em><a href="">Subject array</a></em></td> <td>Subjects holds references to the objects the role applies to.</td> </tr> </tbody> </table>

## RoleBindingList {#RoleBindingList}

RoleBindingList is a collection of RoleBindings

<hr>

<table> <thead><tr><th>Field</th><th>Description</th></tr></thead> <tbody> <tr> <td><code>apiVersion</code><br/><em>string</em></td> <td>APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources</td> </tr> <tr> <td><code>items</code>&nbsp;<strong>*</strong><br/><em><a href="">RoleBinding array</a></em></td> <td>Items is a list of RoleBindings</td> </tr> <tr> <td><code>kind</code><br/><em>string</em></td> <td>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. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds</td> </tr> <tr> <td><code>metadata</code><br/><em><a href="">ListMeta</a></em></td> <td>Standard object's metadata.</td> </tr> </tbody> </table>

## Operations {#Operations}

<hr>

### `post` Create

#### HTTP Request

POST /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/rolebindings

#### Path Parameters

<table> <thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead> <tbody> <tr> <td><code>namespace</code></td> <td><em>string</em></td> <td>object name and auth scope, such as for teams and projects</td> </tr> </tbody> </table>

#### Query Parameters

<table> <thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead> <tbody> <tr> <td><code>pretty</code></td> <td><em>string</em></td> <td>If 'true', then the output is pretty printed. Defaults to 'false' unless the user-agent indicates a browser or command-line HTTP tool (curl and wget).</td> </t …(trimmed)

Sources

reference/kubernetes-api/rbac/role-binding-v1.md · docRoleBinding

Related (15)

part_of RoleBinding {#RoleBinding}describes conf=1
part_of RoleBindingList {#RoleBindingList}describes conf=1
part_of Operations {#Operations}describes conf=1
part_of `post` Createdescribes conf=1
part_of `patch` Patchdescribes conf=1
part_of `put` Replacedescribes conf=1
part_of `delete` Deletedescribes conf=1
part_of `delete` Delete Collectiondescribes conf=1
part_of `get` Readdescribes conf=1
part_of `get` Listdescribes conf=1
part_of `get` List All Namespacesdescribes conf=1
part_of `get` Watchdescribes conf=1
part_of `get` Watch Listdescribes conf=1
part_of `get` Watch List All Namespacesdescribes conf=1
api_for Bindingdocuments API object conf=1

← all Docs