5장. ConfigMap [v1]


설명
ConfigMap에는 사용할 Pod의 구성 데이터가 있습니다.
유형
object

5.1. 사양

속성유형설명

apiVersion

string

APIVersion은 버전이 지정된 이 오브젝트 표현의 스키마를 정의합니다. 서버는 인식된 스키마를 최신 내부 값으로 변환해야 하며, 인식되지 않는 값을 거부할 수 있습니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

binaryData

오브젝트(문자열)

BinaryData에는 바이너리 데이터가 포함됩니다. 각 키는 영숫자 문자 '-', '_' 또는 '.'로 구성되어야 합니다. BinaryData는 UTF-8 범위에 없는 바이트 시퀀스를 포함할 수 있습니다. BinaryData에 저장된 키는 Data 필드에 있는 항목과 겹치지 않아야 하며 검증 프로세스 중에 적용됩니다. 이 필드를 사용하려면 1.10+ apiserver 및 kubelet이 필요합니다.

data

오브젝트(문자열)

데이터에는 구성 데이터가 포함되어 있습니다. 각 키는 영숫자 문자 '-', '_' 또는 '.'로 구성되어야 합니다. UTF-8이 아닌 바이트 시퀀스가 있는 값은 BinaryData 필드를 사용해야 합니다. 데이터에 저장된 키는 BinaryData 필드의 키와 겹치지 않아야 하며 유효성 검사 프로세스 중에 적용됩니다.

immutable

boolean

변경 불가능한 true로 설정하면 ConfigMap에 저장된 데이터를 업데이트할 수 없습니다(오브젝트 메타데이터만 수정할 수 있음). true로 설정하지 않으면 언제든지 필드를 수정할 수 있습니다. nil로 설정됩니다.

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

5.2. API 끝점

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

  • /api/v1/configmaps

    • GET: 종류 ConfigMap의 오브젝트 목록 또는 감시
  • /api/v1/watch/configmaps

    • GET: ConfigMap 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /api/v1/namespaces/{namespace}/configmaps

    • DELETE: ConfigMap의 컬렉션 삭제
    • GET: 종류 ConfigMap의 오브젝트 목록 또는 감시
    • POST: ConfigMap 생성
  • /api/v1/watch/namespaces/{namespace}/configmaps

    • GET: ConfigMap 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
  • /api/v1/namespaces/{namespace}/configmaps/{name}

    • DELETE: ConfigMap 삭제
    • GET: 지정된 ConfigMap 읽기
    • PATCH: 지정된 ConfigMap을 부분적으로 업데이트
    • PUT: 지정된 ConfigMap을 교체
  • /api/v1/watch/namespaces/{namespace}/configmaps/{name}

    • GET: kind ConfigMap의 오브젝트 변경 사항을 확인합니다. 더 이상 사용되지 않는 'watch' 매개변수를 목록 작업과 함께 대신 'fieldSelector' 매개변수를 사용하여 단일 항목으로 필터링합니다.

5.2.1. /api/v1/configmaps

HTTP 방법
GET
설명
종류의 오브젝트 목록 또는 감시 ConfigMap
표 5.1. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConfigMapList 스키마

401 - 무단

Empty

5.2.2. /api/v1/watch/configmaps

HTTP 방법
GET
설명
ConfigMap 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
표 5.2. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

Empty

5.2.3. /api/v1/namespaces/{namespace}/configmaps

HTTP 방법
DELETE
설명
ConfigMap의 컬렉션 삭제
표 5.3. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

표 5.4. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

401 - 무단

Empty

HTTP 방법
GET
설명
종류의 오브젝트 목록 또는 감시 ConfigMap
표 5.5. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConfigMapList 스키마

401 - 무단

Empty

HTTP 방법
POST
설명
ConfigMap 생성
표 5.6. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 5.7. 본문 매개변수
매개변수유형설명

body

ConfigMap 스키마

 
표 5.8. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConfigMap 스키마

201 - 생성됨

ConfigMap 스키마

202 - 승인됨

ConfigMap 스키마

401 - 무단

Empty

5.2.4. /api/v1/watch/namespaces/{namespace}/configmaps

HTTP 방법
GET
설명
ConfigMap 목록에 대한 개별 변경 사항을 확인합니다. 더 이상 사용되지 않는 경우 목록 작업과 함께 'watch' 매개변수를 대신 사용합니다.
표 5.9. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

Empty

5.2.5. /api/v1/namespaces/{namespace}/configmaps/{name}

표 5.10. 글로벌 경로 매개변수
매개변수유형설명

name

string

ConfigMap의 이름

HTTP 방법
DELETE
설명
delete a ConfigMap
표 5.11. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

표 5.12. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

상태 스키마

202 - 승인됨

상태 스키마

401 - 무단

Empty

HTTP 방법
GET
설명
지정된 ConfigMap 읽기
표 5.13. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConfigMap 스키마

401 - 무단

Empty

HTTP 방법
PATCH
설명
지정된 ConfigMap을 부분적으로 업데이트
표 5.14. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 5.15. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConfigMap 스키마

201 - 생성됨

ConfigMap 스키마

401 - 무단

Empty

HTTP 방법
PUT
설명
지정된 ConfigMap을 교체
표 5.16. 쿼리 매개변수
매개변수유형설명

dryRun

string

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

fieldValidation

string

FieldValidation은 알 수 없거나 중복된 필드가 포함된 요청(POST/PUT/PATCH)의 오브젝트를 처리하는 방법에 대해 서버에 지시합니다. 유효한 값은 다음과 같습니다. - 무시: 이는 오브젝트에서 자동으로 삭제된 알 수 없는 필드를 무시하고 디코더가 직면하는 마지막 중복 필드를 제외한 모든 필드를 무시합니다. v1.23 이전의 기본 동작입니다. - warn: 오브젝트에서 삭제된 각 알 수 없는 각 필드에 대한 표준 경고 응답 헤더와 발생하는 각 중복 필드에 대해 경고를 보냅니다. 다른 오류가 없는 경우에도 요청이 성공하고 중복 필드의 마지막 부분만 유지됩니다. v1.23+ - Strict: 알 수 없는 필드가 오브젝트에서 삭제되거나 중복 필드가 있는 경우 BadRequest 오류와 함께 요청이 실패합니다. 서버에서 반환된 오류에는 모든 알 수 없거나 중복된 필드가 포함됩니다.

표 5.17. 본문 매개변수
매개변수유형설명

body

ConfigMap 스키마

 
표 5.18. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

ConfigMap 스키마

201 - 생성됨

ConfigMap 스키마

401 - 무단

Empty

5.2.6. /api/v1/watch/namespaces/{namespace}/configmaps/{name}

표 5.19. 글로벌 경로 매개변수
매개변수유형설명

name

string

ConfigMap의 이름

HTTP 방법
GET
설명
더 이상 사용되지 않는 종류의 오브젝트 변경 사항을 확인합니다. 대신 'fieldSelector' 매개변수가 있는 단일 항목으로 필터링된 목록 작업과 함께 'watch' 매개변수를 사용합니다.
표 5.20. HTTP 응답
HTTP 코드리포지토리 본문

200 - OK

WatchEvent 스키마

401 - 무단

Empty

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

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

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동