VPC 환경에서 이용 가능합니다.
Config Group의 Kafka 상세 설정을 변경합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
메서드 | URI |
---|---|
POST | /api/v1/configGroup/setKafkaConfigGroupDetail/{configGroupNo} (수도권) |
POST | /api/krs-v1/configGroup/setKafkaConfigGroupDetail/{configGroupNo} (남부권) |
요청 헤더
Cloud Data Streaming Service API에서 공통으로 사용하는 헤더에 대한 정보는 Cloud Data Streaming Service 요청 헤더를 참조해 주십시오.
요청 경로 파라미터
요청 경로 파라미터에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
configGroupNo |
Integer | Required | Config Group 번호 |
요청 바디
요청 바디에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
kafkaVersionCode |
Integer | Required | Kafka 버전 코드
|
autoCreateTopicsEnable |
Boolean | Optional | 토픽 자동 생성의 활성화 여부
|
deleteTopicEnable |
Boolean | Optional | 토픽 삭제의 활성화 여부
|
offsetsTopicReplicationFactor |
Integer | Optional | 오프셋 토픽에 적용하는 복제 계수
|
logCleanerEnable |
Boolean | Optional | 로그 클리너 프로세스 활성화 여부
|
logCleanupPolicy |
String | Optional | 보존 기간을 초과한 로그의 정리 정책
|
logCleanerThreads |
Integer | Optional | 로그 정리를 수행할 백그라운드 스레드 수
|
logFlushIntervalMessages |
Number | Optional | 디스크 플러시 수행 전 누적 메시지 수
|
logRetentionBytes |
Number | Optional | 로그 유지 최대 용량
|
logRetentionHours |
Integer | Optional | 로그 유지 시간(시)
|
logSegmentBytes |
Integer | Optional | 단일 로그 최대 용량(Byte)
|
numIoThreads |
Integer | Optional | 서버 요청 처리에 사용되는 스레드 수
|
numNetworkThreads |
Integer | Optional | 서버의 요청 수신 및 응답 전송에 사용되는 스레드 수
|
numPartitions |
Integer | Optional | 토픽별 로그 파티션 수
|
authorizerClassName |
String | Optional | 인가 담당 클래스의 전체 경로
|
allowEveryoneIfNoAclFound |
Boolean | Optional | ACL 부재 시 모든 접근 허용 여부
|
요청 예시
요청 예시는 다음과 같습니다.
curl --location --request POST 'https://clouddatastreamingservice.apigw.gov-ntruss.com/api/v1/configGroup/setKafkaConfigGroupDetail/3**' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '{
"kafkaVersionCode": "3903006",
"autoCreateTopicsEnable": true,
"deleteTopicEnable": true,
"logCleanerEnable": true,
"logCleanupPolicy": "delete",
"logCleanerThreads": 1,
"logFlushIntervalMessages": 9223372036854775807,
"logRetentionBytes": -1,
"logRetentionHours": 168,
"logSegmentBytes": 1073741824,
"numIoThreads": 8,
"numNetworkThreads": 3,
"numPartitions": 3,
"allowEveryoneIfNoAclFound": true
}'
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
code |
Integer | - | 응답 코드 |
message |
String | - | 응답 메시지 |
result |
Object | - | 응답 결과 |
result.configGroupNo |
Integer | - | Config Group 번호 |
requestId |
String | - | 요청에 대한 아이디
|
응답 상태 코드
Cloud Data Streaming Service API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Cloud Data Streaming Service 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
{
"code": 0,
"message": "SUCCESS",
"result": {
"configGroupNo": 3**
},
"requestId": "548a94cf-****-****-****-53536d7cb48f"
}