RevokeCertificate

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

Advanced 인증서를 폐지합니다.

요청

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

메서드	URI
POST	/api/v2/certificate/revoke

요청 헤더

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

요청 바디

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

필드	타입	필수 여부	설명
`orderId`	String	Required	폐지할 인증서가 포함된 오더 ID
`certificateNo`	Integer	Required	인증서 번호 0~N 오더 내 전체 인증서를 폐지할 경우: `0` 입력
`revokeType`	String	Required	폐지 유형 입력 값: `affiliationChanged` · `superseded` · `cessationOfOperation` · `unspecified` 중 하나
`revokeType`	String	Required	폐지 사유 `affiliationChanged` \| `superseded` \| `cessationOfOperation` \| `unspecified` `affiliationChanged`: 조직명 등의 식별 정보가 변경된 경우 `superseded`: 만료 전 신규 인증서로 대체됐거나 대체 예정인 경우 `cessationOfOperation`: 도메인 또는 서비스가 영구 중단되었거나 중단 예정인 경우 `unspecified`: 기타 (위 폐지 사유 중 해당하는 사유가 없는 경우에만 사용하는 것을 권장)

요청 예시

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

curl --location --request POST 'https://certificatemanager.apigw.ntruss.com/api/v2/certificate/revoke' \
--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 '{
    "orderId": "1",
    "certificateNo": 1,
    "revokeType": "superseded"
}'

응답

응답 형식을 설명합니다.

응답 바디

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

필드	타입	필수 여부	설명
`returnCode`	String	-	응답 코드
`returnMessage`	String	-	응답 메시지
`totalRows`	Integer	-	이번 폐지 요청에 포함된 인증서 수

응답 상태 코드

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

응답 예시

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

{
    "returnCode": "0",
    "returnMessage": "Success",
    "totalRows": 1
}