Update CA

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

CA 상태를 변경합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
PUT /ca/{caTag}

요청 헤더

Private CA API에서 공통으로 사용하는 헤더에 대한 정보는 Private CA 공통 헤더를 참조해 주십시오.

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
caTag String Required CA 태그 값

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
status String Required CA 상태
  • ACTIVE | DEACTIVATED | DESTROYING
    • ACTIVE: 활성
    • DEACTIVATED: 비활성
    • DESTROYING: 삭제 예정
주의

상태를 DESTROYING으로 변경하면, 72시간의 삭제 대기 시간이 지난 후 자동으로 해당 CA와 하위 CA가 삭제됩니다. 이 과정에서 CA가 발급한 인증서의 운영 상태나 만료 여부는 고려되지 않습니다. 삭제된 CA의 개인 키는 영구적으로 삭제되며, 복구가 불가능하므로 CA 삭제를 신중하게 결정해 주십시오. 또한, 삭제된 CA는 더 이상 신뢰되지 않으며, 해당 CA가 발급한 모든 인증서는 인증 목적으로 사용할 수 없습니다.

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request PUT 'https://privateca.apigw.gov-ntruss.com/api/v1/ca/********-********' \
--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 '{
    "status": "DESTROYING"
}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
code String - 응답 코드
msg String - 응답 메시지
data Object - 응답 결과
data.caInfo Object - CA 정보
data.caInfo.signingCount Number - CA로 서명한 인증서 개수
data.caInfo.caType String - CA 타입
  • PRIVATE_ROOT | PRIVATE_SUB
data.caInfo.caId Number - CA 식별자
data.caInfo.statusUpdateDate String - 최근 상태 변경 일시(Timestamp)
data.destroyDate String - 삭제 일시(Timestamp)
data.caInfo.alias String - CA 이름
data.caInfo.memo String - CA 메모
data.caInfo.urlInfo Object - URL 정보
data.caInfo.urlInfo.ocsp Array - OCSP(온라인 인증서 상태 프로토콜) URL
data.caInfo.urlInfo.crl Array - CRL(인증서 폐기 목록) URL
data.caInfo.urlInfo.ca Array - CA URL
data.caTag String - CA 태그 값
data.rgstDate Number - 등록 일시(Timestamp)
data.status String - CA 상태
  • ACTIVE | DEACTIVATED | DESTROYING
    • ACTIVE: 활성
    • DEACTIVATED: 비활성
    • DESTROYING: 삭제 예정

응답 상태 코드

Private CA API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Private CA 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "code": "SUCCESS",
    "msg": "Success",
    "data": {
        "signingCount": 0,
        "caType": "PRIVATE_ROOT",
        "caId": 17***,
        "statusUpdateDate": 1721106009601,
        "destroyDate": 1721368800000,
        "alias": "CA002",
        "memo": "",
        "urlInfo": {
            "ocsp": [],
            "crl": [
                "https://privateca.apigw.gov-ntruss.com/ext/********-********/crl"
            ],
            "ca": [
                "https://privateca.apigw.gov-ntruss.com/ext/********-********/ca"
            ]
        },
        "caTag": "********-********",
        "rgstDate": 1721105599000,
        "status": "DESTROYING"
    }
}