Role [page]deterministic
Role is a namespaced, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding.
`apiVersion: rbac.authorization.k8s.io/v1`
`import "k8s.io/api/rbac/v1"`
## Role {#Role}
Role is a namespaced, logical grouping of PolicyRules that can be referenced as a unit by a RoleBinding.
<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>rules</code><br/><em><a href="">PolicyRule array</a></em></td> <td>Rules holds all the PolicyRules for this Role</td> </tr> </tbody> </table>
## RoleList {#RoleList}
RoleList is a collection of Roles
<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> <strong>*</strong><br/><em><a href="">Role array</a></em></td> <td>Items is a list of Roles</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}/roles
#### 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> </tr> <tr> <td><code>dryRun</code></td> <td><em>string</em></td> <td>When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed</td> </tr> <tr> <td><code>fieldManager</code></td> <td><em>string</em></td> <td>fieldManager is a name associated with the actor or entity that is making these changes. The value must be less than or 128 characters long, and only contain printabl …(trimmed)