역할 API

1장. 역할 API

1.1. ClusterRoleBinding [authorization.openshift.io/v1]

설명

ClusterRoleBinding은 ClusterRole을 참조하지만 포함하지 않습니다. 동일한 네임스페이스 또는 글로벌 네임스페이스에서 ClusterRole을 참조할 수 있습니다. 사용자 및 그룹 또는 주체를 통한 사용자 정보 및 해당 네임스페이스의 네임스페이스 정보를 추가합니다. 지정된 네임스페이스의 ClusterRoleBindings는 해당 네임스페이스에만 적용됩니다(모든 네임스페이스에 power가 있는 마스터 네임스페이스 제외).

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형

object

1.2. ClusterRole [authorization.openshift.io/v1]

설명

ClusterRole은 ClusterRoleBindings에서 하나의 단위로 참조할 수 있는 PolicyRules의 논리 그룹입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형

object

1.3. RoleBindingRestriction [authorization.openshift.io/v1]

설명: RoleBindingRestriction은 RoleBindingRestriction이 속한 네임스페이스에서 해당 주체의 rolebindings가 허용되는지 여부를 결정하는 주체(사용자, 그룹 또는 서비스 계정)와 일치할 수 있는 오브젝트입니다. 이러한 RoleBindingRestriction 오브젝트 중 하나가 제목과 일치하는 경우 네임스페이스의 해당 주체에 대한 rolebindings가 허용됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형: object

1.4. RoleBinding [authorization.openshift.io/v1]

설명

RoleBinding은 역할을 참조하지만 포함하지 않습니다. 동일한 네임스페이스 또는 글로벌 네임스페이스의 역할을 참조할 수 있습니다. 사용자 및 그룹 또는 주체를 통한 사용자 정보 및 해당 네임스페이스의 네임스페이스 정보를 추가합니다. 지정된 네임스페이스의 rolebindings는 해당 네임스페이스에만 적용됩니다(모든 네임스페이스에 권한이 있는 마스터 네임스페이스 제외).

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형

object

1.5. Role [authorization.openshift.io/v1]

설명

role은 RoleBindings를 통해 단위로 참조할 수 있는 PolicyRules의 논리 그룹입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형

object

2장. ClusterRoleBinding [authorization.openshift.io/v1]

설명

ClusterRoleBinding은 ClusterRole을 참조하지만 포함하지 않습니다. 동일한 네임스페이스 또는 글로벌 네임스페이스에서 ClusterRole을 참조할 수 있습니다. 사용자 및 그룹 또는 주체를 통한 사용자 정보 및 해당 네임스페이스의 네임스페이스 정보를 추가합니다. 지정된 네임스페이스의 ClusterRoleBindings는 해당 네임스페이스에만 적용됩니다(모든 네임스페이스에 power가 있는 마스터 네임스페이스 제외).

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형

object

필수 항목

제목
roleRef

2.1. 사양

속성	유형	설명
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`groupNames`	`배열(문자열)`	groupnames에는 역할에 직접 바인딩된 모든 그룹이 있습니다. 이 필드는 레거시 클라이언트 및 서버를 지원하는 경우에만 지정해야 합니다. 자세한 내용은 주체를 참조하십시오.
`kind`	`string`	kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`메타데이터`	`ObjectMeta`	메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`roleRef`	`ObjectReference`	RoleRef는 현재 네임스페이스와 글로벌 네임스페이스만 참조할 수 있습니다. ClusterRoleRef를 확인할 수 없는 경우 Authorizer에서 오류를 반환해야 합니다. 정책은 싱글톤이므로 역할을 찾을 수 있는 지식만으로도 충분합니다.
`제목`	`배열(ObjectReference)`	주체는 이 규칙에 대한 승인을 위해 오브젝트 참조를 보유합니다. 레거시 클라이언트 및 서버를 지원하도록 UserNames 또는 GroupNames가 지정된 경우 이 필드는 무시됩니다. 따라서 이전 버전과의 호환성을 지원할 필요가 없는 최신 클라이언트는 정규화된 주체만 전송해야 하며 UserNames 및 GroupNames 필드를 생략해야 합니다. 이전 버전과의 호환성을 지원해야 하는 클라이언트는 이 필드를 사용하여 UserNames 및 GroupNames를 빌드할 수 있습니다.
`userNames`	`배열(문자열)`	사용자 이름에는 역할에 직접 바인딩된 모든 사용자 이름이 있습니다. 이 필드는 레거시 클라이언트 및 서버를 지원하는 경우에만 지정해야 합니다. 자세한 내용은 주체를 참조하십시오.

2.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

/apis/authorization.openshift.io/v1/clusterrolebindings
- GET: ClusterRoleBinding 유형의 오브젝트 나열
- POST: ClusterRoleBinding 생성
/apis/authorization.openshift.io/v1/clusterrolebindings/{name}
- DELETE: ClusterRoleBinding 삭제
- GET: 지정된 ClusterRoleBinding 읽기
- PATCH: 지정된 ClusterRoleBinding을 부분적으로 업데이트
- PUT: 지정된 ClusterRoleBinding을 교체

2.2.1. /apis/authorization.openshift.io/v1/clusterrolebindings

HTTP 방법: GET
설명: ClusterRoleBinding 유형의 오브젝트 나열

표 2.1. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`ClusterRoleBindingList` 스키마
401 - 무단	빈

HTTP 방법: POST
설명: ClusterRoleBinding 생성

표 2.2. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 2.3. 본문 매개변수
매개변수	유형	설명
`body`	`ClusterRoleBinding` 스키마

표 2.4. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`ClusterRoleBinding` 스키마
201 - 생성됨	`ClusterRoleBinding` 스키마
202 - 승인됨	`ClusterRoleBinding` 스키마
401 - 무단	빈

2.2.2. /apis/authorization.openshift.io/v1/clusterrolebindings/{name}

표 2.5. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	ClusterRoleBinding의 이름

HTTP 방법: DELETE
설명: ClusterRoleBinding 삭제

표 2.6. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

표 2.7. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`상태` 스키마
202 - 승인됨	`상태` 스키마
401 - 무단	빈

HTTP 방법: GET
설명: 지정된 ClusterRoleBinding 읽기

표 2.8. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`ClusterRoleBinding` 스키마
401 - 무단	빈

HTTP 방법: PATCH
설명: 지정된 ClusterRoleBinding을 부분적으로 업데이트

표 2.9. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 2.10. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`ClusterRoleBinding` 스키마
201 - 생성됨	`ClusterRoleBinding` 스키마
401 - 무단	빈

HTTP 방법: PUT
설명: 지정된 ClusterRoleBinding을 교체

표 2.11. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 2.12. 본문 매개변수
매개변수	유형	설명
`body`	`ClusterRoleBinding` 스키마

표 2.13. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`ClusterRoleBinding` 스키마
201 - 생성됨	`ClusterRoleBinding` 스키마
401 - 무단	빈

3장. ClusterRole [authorization.openshift.io/v1]

설명

ClusterRole은 ClusterRoleBindings에서 하나의 단위로 참조할 수 있는 PolicyRules의 논리 그룹입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형

object

필수 항목

규칙

3.1. 사양

속성	유형	설명
`aggregationRule`	`AggregationRule`	AggregationRule는 이 ClusterRole에 대한 규칙을 빌드하는 방법을 설명하는 선택적 필드입니다. AggregationRule이 설정되면 컨트롤러가 규칙을 관리하고 규칙에 대한 직접 변경 사항이 컨트롤러에 의해 해제됩니다.
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`string`	kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`메타데이터`	`ObjectMeta`	메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`규칙`	`array`	규칙에는 이 ClusterRole에 대한 모든 PolicyRules가 있습니다.
`rules[]`	`object`	PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다.

3.1.1. .rules

설명: 규칙에는 이 ClusterRole에 대한 모든 PolicyRules가 있습니다.
유형: array

3.1.2. .rules[]

설명

PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다.

유형

object

필수 항목

verbs
resources

속성	유형	설명
`apiGroups`	`배열(문자열)`	APIGroups는 리소스가 포함된 APIGroup의 이름입니다. 이 필드가 비어 있으면 kubernetes 및 origin API 그룹 모두 가정합니다. 즉, kubernetes 또는 origin API 그룹에서 열거된 리소스 중 하나에 대해 작업이 요청되면 요청이 허용됩니다.
`attributeRestrictions`	`RawExtension`	AttributeRestrictions는 Authorizer/AuthorizationAttributeBuilder 쌍이 지원하는 내용에 따라 다릅니다. 작성자가 AttributeRestrictions를 처리하는 방법을 인식하지 못하는 경우 작성자는 오류를 보고해야 합니다.
`nonResourceURLs`	`배열(문자열)`	NonResourceURLsSlice는 사용자가 액세스해야 하는 부분적인 URL 세트입니다. *s는 경로의 전체 최종 단계로만 허용됩니다. 이 이름은 의도적으로 내부 유형과 다르므로 DefaultConvert가 잘 작동하고 순서가 다를 수 있습니다.
`resourceNames`	`배열(문자열)`	resourceNames는 규칙이 적용되는 선택적 이름 목록입니다. 빈 세트는 모든 것이 허용됨을 의미합니다.
`resources`	`배열(문자열)`	리소스는 이 규칙이 적용되는 리소스 목록입니다. ResourceAll는 모든 리소스를 나타냅니다.
`verbs`	`배열(문자열)`	동사는 이 규칙에 포함된 모든 ResourceKinds 및 AttributeRestrictions에 적용되는 Verbs 목록입니다. VerbAll는 모든 종류를 나타냅니다.

3.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

/apis/authorization.openshift.io/v1/clusterroles
- GET: ClusterRole 유형의 오브젝트 나열
- POST: ClusterRole 생성
/apis/authorization.openshift.io/v1/clusterroles/{name}
- DELETE: ClusterRole 삭제
- GET: 지정된 ClusterRole을 읽습니다.
- PATCH: 지정된 ClusterRole을 부분적으로 업데이트
- PUT: 지정된 ClusterRole을 교체

3.2.1. /apis/authorization.openshift.io/v1/clusterroles

HTTP 방법: GET
설명: ClusterRole 유형의 오브젝트 나열

표 3.1. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`ClusterRoleList` 스키마
401 - 무단	빈

HTTP 방법: POST
설명: ClusterRole을 생성

표 3.2. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 3.3. 본문 매개변수
매개변수	유형	설명
`body`	`ClusterRole` 스키마

표 3.4. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`ClusterRole` 스키마
201 - 생성됨	`ClusterRole` 스키마
202 - 승인됨	`ClusterRole` 스키마
401 - 무단	빈

3.2.2. /apis/authorization.openshift.io/v1/clusterroles/{name}

표 3.5. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	ClusterRole의 이름

HTTP 방법: DELETE
설명: ClusterRole 삭제

표 3.6. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

표 3.7. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`상태` 스키마
202 - 승인됨	`상태` 스키마
401 - 무단	빈

HTTP 방법: GET
설명: 지정된 ClusterRole 읽기

표 3.8. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`ClusterRole` 스키마
401 - 무단	빈

HTTP 방법: PATCH
설명: 지정된 ClusterRole을 부분적으로 업데이트

표 3.9. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 3.10. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`ClusterRole` 스키마
201 - 생성됨	`ClusterRole` 스키마
401 - 무단	빈

HTTP 방법: PUT
설명: 지정된 ClusterRole을 교체

표 3.11. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 3.12. 본문 매개변수
매개변수	유형	설명
`body`	`ClusterRole` 스키마

표 3.13. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`ClusterRole` 스키마
201 - 생성됨	`ClusterRole` 스키마
401 - 무단	빈

4장. RoleBindingRestriction [authorization.openshift.io/v1]

설명: RoleBindingRestriction은 RoleBindingRestriction이 속한 네임스페이스에서 해당 주체의 rolebindings가 허용되는지 여부를 결정하는 주체(사용자, 그룹 또는 서비스 계정)와 일치할 수 있는 오브젝트입니다. 이러한 RoleBindingRestriction 오브젝트 중 하나가 제목과 일치하는 경우 네임스페이스의 해당 주체에 대한 rolebindings가 허용됩니다. 호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.
유형: object

4.1. 사양

속성	유형	설명
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`string`	kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`메타데이터`	`ObjectMeta`	표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec`	`object`	spec은 matcher를 정의합니다.

4.1.1. .spec

설명: spec은 matcher를 정의합니다.
유형: object

속성	유형	설명
`그룹 제한`	``	GroupRestriction은 그룹 주체와 일치합니다.
`serviceaccountrestriction`	``	ServiceAccountRestriction은 서비스 계정 주체와 일치합니다.
`userrestriction`	``	UserRestriction은 사용자 주체와 일치합니다.

4.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

/apis/authorization.openshift.io/v1/rolebindingrestrictions
- GET: RoleBindingRestriction 유형의 오브젝트 나열
/apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindingrestrictions
- DELETE: RoleBindingRestriction 컬렉션 삭제
- GET: RoleBindingRestriction 유형의 오브젝트 나열
- POST: RoleBindingRestriction 생성
/apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindingrestrictions/{name}
- DELETE: RoleBindingRestriction 삭제
- GET: 지정된 RoleBindingRestriction 읽기
- PATCH: 지정된 RoleBindingRestriction을 부분적으로 업데이트
- PUT: 지정된 RoleBindingRestriction을 교체

4.2.1. /apis/authorization.openshift.io/v1/rolebindingrestrictions

HTTP 방법: GET
설명: RoleBindingRestriction 유형의 오브젝트 나열

표 4.1. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBindingRestrictionList` schema
401 - 무단	빈

4.2.2. /apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindingrestrictions

HTTP 방법: DELETE
설명: RoleBindingRestriction 컬렉션 삭제

표 4.2. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`상태` 스키마
401 - 무단	빈

HTTP 방법: GET
설명: RoleBindingRestriction 유형의 오브젝트 나열

표 4.3. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBindingRestrictionList` schema
401 - 무단	빈

HTTP 방법: POST
설명: RoleBindingRestriction 생성

표 4.4. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 4.5. 본문 매개변수
매개변수	유형	설명
`body`	`RoleBindingRestriction` 스키마

표 4.6. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBindingRestriction` 스키마
201 - 생성됨	`RoleBindingRestriction` 스키마
202 - 승인됨	`RoleBindingRestriction` 스키마
401 - 무단	빈

4.2.3. /apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindingrestrictions/{name}

표 4.7. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	RoleBindingRestriction 이름

HTTP 방법: DELETE
설명: RoleBindingRestriction 삭제

표 4.8. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

표 4.9. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`상태` 스키마
202 - 승인됨	`상태` 스키마
401 - 무단	빈

HTTP 방법: GET
설명: 지정된 RoleBindingRestriction 읽기

표 4.10. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBindingRestriction` 스키마
401 - 무단	빈

HTTP 방법: PATCH
설명: 지정된 RoleBindingRestriction을 부분적으로 업데이트

표 4.11. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 4.12. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBindingRestriction` 스키마
401 - 무단	빈

HTTP 방법: PUT
설명: 지정된 RoleBindingRestriction을 교체

표 4.13. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 4.14. 본문 매개변수
매개변수	유형	설명
`body`	`RoleBindingRestriction` 스키마

표 4.15. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBindingRestriction` 스키마
201 - 생성됨	`RoleBindingRestriction` 스키마
401 - 무단	빈

5장. RoleBinding [authorization.openshift.io/v1]

설명

RoleBinding은 역할을 참조하지만 포함하지 않습니다. 동일한 네임스페이스 또는 글로벌 네임스페이스의 역할을 참조할 수 있습니다. 사용자 및 그룹 또는 주체를 통한 사용자 정보 및 해당 네임스페이스의 네임스페이스 정보를 추가합니다. 지정된 네임스페이스의 rolebindings는 해당 네임스페이스에만 적용됩니다(모든 네임스페이스에 권한이 있는 마스터 네임스페이스 제외).

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형

object

필수 항목

제목
roleRef

5.1. 사양

속성	유형	설명
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`groupNames`	`배열(문자열)`	groupnames에는 역할에 직접 바인딩된 모든 그룹이 있습니다. 이 필드는 레거시 클라이언트 및 서버를 지원하는 경우에만 지정해야 합니다. 자세한 내용은 주체를 참조하십시오.
`kind`	`string`	kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`메타데이터`	`ObjectMeta`	메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`roleRef`	`ObjectReference`	RoleRef는 현재 네임스페이스와 글로벌 네임스페이스만 참조할 수 있습니다. RoleRef를 확인할 수 없는 경우 Authorizer에서 오류를 반환해야 합니다. 정책은 싱글톤이므로 역할을 찾을 수 있는 지식만으로도 충분합니다.
`제목`	`배열(ObjectReference)`	주체는 이 규칙에 대한 승인을 위해 오브젝트 참조를 보유합니다. 레거시 클라이언트 및 서버를 지원하도록 UserNames 또는 GroupNames가 지정된 경우 이 필드는 무시됩니다. 따라서 이전 버전과의 호환성을 지원할 필요가 없는 최신 클라이언트는 정규화된 주체만 전송해야 하며 UserNames 및 GroupNames 필드를 생략해야 합니다. 이전 버전과의 호환성을 지원해야 하는 클라이언트는 이 필드를 사용하여 UserNames 및 GroupNames를 빌드할 수 있습니다.
`userNames`	`배열(문자열)`	사용자 이름에는 역할에 직접 바인딩된 모든 사용자 이름이 있습니다. 이 필드는 레거시 클라이언트 및 서버를 지원하는 경우에만 지정해야 합니다. 자세한 내용은 주체를 참조하십시오.

5.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

/apis/authorization.openshift.io/v1/rolebindings
- GET: 종류 RoleBinding의 오브젝트 나열
/apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindings
- GET: 종류 RoleBinding의 오브젝트 나열
- POST: RoleBinding 생성
/apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindings/{name}
- DELETE: RoleBinding 삭제
- GET: 지정된 RoleBinding 읽기
- PATCH: 지정된 RoleBinding을 부분적으로 업데이트
- PUT: 지정된 RoleBinding을 교체

5.2.1. /apis/authorization.openshift.io/v1/rolebindings

HTTP 방법: GET
설명: 종류 RoleBinding의 오브젝트 나열

표 5.1. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBindingList` 스키마
401 - 무단	빈

5.2.2. /apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindings

HTTP 방법: GET
설명: 종류 RoleBinding의 오브젝트 나열

표 5.2. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBindingList` 스키마
401 - 무단	빈

HTTP 방법: POST
설명: RoleBinding 생성

표 5.3. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 5.4. 본문 매개변수
매개변수	유형	설명
`body`	`RoleBinding` 스키마

표 5.5. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBinding` 스키마
201 - 생성됨	`RoleBinding` 스키마
202 - 승인됨	`RoleBinding` 스키마
401 - 무단	빈

5.2.3. /apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindings/{name}

표 5.6. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	RoleBinding의 이름

HTTP 방법: DELETE
설명: RoleBinding 삭제

표 5.7. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

표 5.8. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`상태` 스키마
202 - 승인됨	`상태` 스키마
401 - 무단	빈

HTTP 방법: GET
설명: 지정된 RoleBinding 읽기

표 5.9. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBinding` 스키마
401 - 무단	빈

HTTP 방법: PATCH
설명: 지정된 RoleBinding을 부분적으로 업데이트

표 5.10. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 5.11. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBinding` 스키마
201 - 생성됨	`RoleBinding` 스키마
401 - 무단	빈

HTTP 방법: PUT
설명: 지정된 RoleBinding을 교체

표 5.12. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 5.13. 본문 매개변수
매개변수	유형	설명
`body`	`RoleBinding` 스키마

표 5.14. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleBinding` 스키마
201 - 생성됨	`RoleBinding` 스키마
401 - 무단	빈

6장. Role [authorization.openshift.io/v1]

설명

role은 RoleBindings를 통해 단위로 참조할 수 있는 PolicyRules의 논리 그룹입니다.

호환성 수준 1: 최소 12 개월 또는 3 개의 마이너 릴리스 (더 긴 버전) 동안 주요 릴리스 내에서 사용할 수 있습니다.

유형

object

필수 항목

규칙

6.1. 사양

속성	유형	설명
`apiVersion`	`string`	APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`string`	kind는 이 오브젝트가 나타내는 REST 리소스에 해당하는 문자열 값입니다. 서버는 클라이언트에서 요청을 제출한 끝점에서 이를 유추할 수 있습니다. CamelCase로 업데이트할 수 없습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`메타데이터`	`ObjectMeta`	메타데이터는 표준 오브젝트의 메타데이터입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`규칙`	`array`	규칙에는 이 역할에 대한 모든 PolicyRules가 있습니다.
`rules[]`	`object`	PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다.

6.1.1. .rules

설명: 규칙에는 이 역할에 대한 모든 PolicyRules가 있습니다.
유형: array

6.1.2. .rules[]

설명

PolicyRule은 정책 규칙을 설명하는 정보를 보유하고 있지만 규칙이 적용되는 사용자 또는 규칙이 적용되는 네임스페이스에 대한 정보는 포함하지 않습니다.

유형

object

필수 항목

verbs
resources

속성	유형	설명
`apiGroups`	`배열(문자열)`	APIGroups는 리소스가 포함된 APIGroup의 이름입니다. 이 필드가 비어 있으면 kubernetes 및 origin API 그룹 모두 가정합니다. 즉, kubernetes 또는 origin API 그룹에서 열거된 리소스 중 하나에 대해 작업이 요청되면 요청이 허용됩니다.
`attributeRestrictions`	`RawExtension`	AttributeRestrictions는 Authorizer/AuthorizationAttributeBuilder 쌍이 지원하는 내용에 따라 다릅니다. 작성자가 AttributeRestrictions를 처리하는 방법을 인식하지 못하는 경우 작성자는 오류를 보고해야 합니다.
`nonResourceURLs`	`배열(문자열)`	NonResourceURLsSlice는 사용자가 액세스해야 하는 부분적인 URL 세트입니다. *s는 경로의 전체 최종 단계로만 허용됩니다. 이 이름은 의도적으로 내부 유형과 다르므로 DefaultConvert가 잘 작동하고 순서가 다를 수 있습니다.
`resourceNames`	`배열(문자열)`	resourceNames는 규칙이 적용되는 선택적 이름 목록입니다. 빈 세트는 모든 것이 허용됨을 의미합니다.
`resources`	`배열(문자열)`	리소스는 이 규칙이 적용되는 리소스 목록입니다. ResourceAll는 모든 리소스를 나타냅니다.
`verbs`	`배열(문자열)`	동사는 이 규칙에 포함된 모든 ResourceKinds 및 AttributeRestrictions에 적용되는 Verbs 목록입니다. VerbAll는 모든 종류를 나타냅니다.

6.2. API 끝점

다음 API 끝점을 사용할 수 있습니다.

/apis/authorization.openshift.io/v1/roles
- GET: 종류의 역할 오브젝트 나열
/apis/authorization.openshift.io/v1/namespaces/{namespace}/roles
- GET: 종류의 역할 오브젝트 나열
- POST: 역할 생성
/apis/authorization.openshift.io/v1/namespaces/{namespace}/roles/{name}
- DELETE: 역할 삭제
- GET: 지정된 역할 읽기
- PATCH: 지정된 역할을 부분적으로 업데이트
- PUT: 지정된 역할 교체

6.2.1. /apis/authorization.openshift.io/v1/roles

HTTP 방법: GET
설명: 역할 유형의 오브젝트 나열

표 6.1. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleList` 스키마
401 - 무단	빈

6.2.2. /apis/authorization.openshift.io/v1/namespaces/{namespace}/roles

HTTP 방법: GET
설명: 역할 유형의 오브젝트 나열

표 6.2. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`RoleList` 스키마
401 - 무단	빈

HTTP 방법: POST
설명: 역할 생성

표 6.3. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 6.4. 본문 매개변수
매개변수	유형	설명
`body`	`역할` 스키마

표 6.5. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`역할` 스키마
201 - 생성됨	`역할` 스키마
202 - 승인됨	`역할` 스키마
401 - 무단	빈

6.2.3. /apis/authorization.openshift.io/v1/namespaces/{namespace}/roles/{name}

표 6.6. 글로벌 경로 매개변수
매개변수	유형	설명
`name`	`string`	역할의 이름

HTTP 방법: DELETE
설명: 역할 삭제

표 6.7. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.

표 6.8. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`상태` 스키마
202 - 승인됨	`상태` 스키마
401 - 무단	빈

HTTP 방법: GET
설명: 지정된 역할 읽기

표 6.9. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`역할` 스키마
401 - 무단	빈

HTTP 방법: PATCH
설명: 지정된 역할을 부분적으로 업데이트

표 6.10. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 6.11. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`역할` 스키마
201 - 생성됨	`역할` 스키마
401 - 무단	빈

HTTP 방법: PUT
설명: 지정된 역할 교체

표 6.12. 쿼리 매개변수
매개변수	유형	설명
`dryRun`	`string`	존재하는 경우 수정 사항이 유지되지 않아야 함을 나타냅니다. 유효하지 않거나 인식할 수 없는 dryRun 지시문으로 인해 오류 응답이 발생하고 요청을 추가로 처리하지 않습니다. 유효한 값은 다음과 같습니다. - 모두: 모든 시험 실행 단계가 처리됩니다.
`fieldValidation`	`string`	FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 6.13. 본문 매개변수
매개변수	유형	설명
`body`	`역할` 스키마

표 6.14. HTTP 응답
HTTP 코드	리포지토리 본문
200 - OK	`역할` 스키마
201 - 생성됨	`역할` 스키마
401 - 무단	빈

역할 API에 대한 참조 가이드

1장. 역할 API

1.1. ClusterRoleBinding [authorization.openshift.io/v1]

1.2. ClusterRole [authorization.openshift.io/v1]

1.3. RoleBindingRestriction [authorization.openshift.io/v1]

1.4. RoleBinding [authorization.openshift.io/v1]

1.5. Role [authorization.openshift.io/v1]

2장. ClusterRoleBinding [authorization.openshift.io/v1]

2.1. 사양

2.2. API 끝점

2.2.1. /apis/authorization.openshift.io/v1/clusterrolebindings

2.2.2. /apis/authorization.openshift.io/v1/clusterrolebindings/{name}

3장. ClusterRole [authorization.openshift.io/v1]

3.1. 사양

3.1.1. .rules

3.1.2. .rules[]

3.2. API 끝점

3.2.1. /apis/authorization.openshift.io/v1/clusterroles

3.2.2. /apis/authorization.openshift.io/v1/clusterroles/{name}

4장. RoleBindingRestriction [authorization.openshift.io/v1]

4.1. 사양

4.1.1. .spec

4.2. API 끝점

4.2.1. /apis/authorization.openshift.io/v1/rolebindingrestrictions

4.2.2. /apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindingrestrictions

4.2.3. /apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindingrestrictions/{name}

5장. RoleBinding [authorization.openshift.io/v1]

5.1. 사양

5.2. API 끝점

5.2.1. /apis/authorization.openshift.io/v1/rolebindings

5.2.2. /apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindings

5.2.3. /apis/authorization.openshift.io/v1/namespaces/{namespace}/rolebindings/{name}

6장. Role [authorization.openshift.io/v1]

6.1. 사양

6.1.1. .rules

6.1.2. .rules[]

6.2. API 끝점

6.2.1. /apis/authorization.openshift.io/v1/roles

6.2.2. /apis/authorization.openshift.io/v1/namespaces/{namespace}/roles

6.2.3. /apis/authorization.openshift.io/v1/namespaces/{namespace}/roles/{name}

Legal Notice

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Red Hat legal and privacy links

Red Hat legal and privacy links