readRbacAuthorizationV1NamespacedRole
read the specified Role
/apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles/{name}- Source
specs/apis__rbac.authorization.k8s.io__v1_openapi.json- Revision
9a79c3bd90f7- Active snapshot
2a9112600697
Request
Path Parameters
- name stringrequired
name of the Role
- namespace stringrequired
object name and auth scope, such as for teams and projects
Query Parameters
- pretty stringoptional
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).
Responses
OK
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
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
metadata is the standard object's metadata.
rules array[io.k8s.api.rbac.v1.PolicyRule object]optionalrules holds all the PolicyRules for this Role
rules holds all the PolicyRules for this Role
items io.k8s.api.rbac.v1.PolicyRule objectPolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
PolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
apiGroups is the name of the APIGroup that contains the resources. If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be allowed. "" represents the core API group and "*" represents all API groups.
nonResourceURLs is a set of partial urls that a user should have access to. *s are allowed, but only as the full, final step in the path Since non-resource URLs are not namespaced, this field is only applicable for ClusterRoles referenced from a ClusterRoleBinding. Rules can either apply to API resources (such as "pods" or "secrets") or non-resource URL paths (such as "/api"), but not both.
resourceNames is an optional white list of names that the rule applies to. An empty set means that everything is allowed.
resources is a list of resources this rule applies to. '*' represents all resources.
verbs is a list of Verbs that apply to ALL the ResourceKinds contained in this rule. '*' represents all verbs.
OK
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
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
metadata is the standard object's metadata.
rules array[io.k8s.api.rbac.v1.PolicyRule object]optionalrules holds all the PolicyRules for this Role
rules holds all the PolicyRules for this Role
items io.k8s.api.rbac.v1.PolicyRule objectPolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
PolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
apiGroups is the name of the APIGroup that contains the resources. If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be allowed. "" represents the core API group and "*" represents all API groups.
nonResourceURLs is a set of partial urls that a user should have access to. *s are allowed, but only as the full, final step in the path Since non-resource URLs are not namespaced, this field is only applicable for ClusterRoles referenced from a ClusterRoleBinding. Rules can either apply to API resources (such as "pods" or "secrets") or non-resource URL paths (such as "/api"), but not both.
resourceNames is an optional white list of names that the rule applies to. An empty set means that everything is allowed.
resources is a list of resources this rule applies to. '*' represents all resources.
verbs is a list of Verbs that apply to ALL the ResourceKinds contained in this rule. '*' represents all verbs.
OK
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
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
metadata is the standard object's metadata.
rules array[io.k8s.api.rbac.v1.PolicyRule object]optionalrules holds all the PolicyRules for this Role
rules holds all the PolicyRules for this Role
items io.k8s.api.rbac.v1.PolicyRule objectPolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
PolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
apiGroups is the name of the APIGroup that contains the resources. If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be allowed. "" represents the core API group and "*" represents all API groups.
nonResourceURLs is a set of partial urls that a user should have access to. *s are allowed, but only as the full, final step in the path Since non-resource URLs are not namespaced, this field is only applicable for ClusterRoles referenced from a ClusterRoleBinding. Rules can either apply to API resources (such as "pods" or "secrets") or non-resource URL paths (such as "/api"), but not both.
resourceNames is an optional white list of names that the rule applies to. An empty set means that everything is allowed.
resources is a list of resources this rule applies to. '*' represents all resources.
verbs is a list of Verbs that apply to ALL the ResourceKinds contained in this rule. '*' represents all verbs.
OK
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
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
metadata is the standard object's metadata.
rules array[io.k8s.api.rbac.v1.PolicyRule object]optionalrules holds all the PolicyRules for this Role
rules holds all the PolicyRules for this Role
items io.k8s.api.rbac.v1.PolicyRule objectPolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
PolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.
apiGroups is the name of the APIGroup that contains the resources. If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be allowed. "" represents the core API group and "*" represents all API groups.
nonResourceURLs is a set of partial urls that a user should have access to. *s are allowed, but only as the full, final step in the path Since non-resource URLs are not namespaced, this field is only applicable for ClusterRoles referenced from a ClusterRoleBinding. Rules can either apply to API resources (such as "pods" or "secrets") or non-resource URL paths (such as "/api"), but not both.
resourceNames is an optional white list of names that the rule applies to. An empty set means that everything is allowed.
resources is a list of resources this rule applies to. '*' represents all resources.
verbs is a list of Verbs that apply to ALL the ResourceKinds contained in this rule. '*' represents all verbs.
Unauthorized