ListCloudCertificates

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

보유 중인 Cloud DB Basic, Global Edge 인증서를 조회합니다.

요청

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

메서드	URI
GET	/certificate/certificates

요청 헤더

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

요청 예시

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

curl --location --request GET 'https://certificatemanager.apigw.ntruss.com/api/v2/certificate/certificates' \
--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' \
--header 'accept: application/json'

응답

응답 형식을 설명합니다.

응답 바디

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

필드	타입	필수 여부	설명
`returnCode`	String	-	응답 코드
`returnMessage`	String	-	응답 메시지
`totalCount`	Integer	-	조회된 목록의 총 개수
`sslCertificateList`	Array	-	인증서 목록

`sslCertificateList`

sslCertificateList에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`certificateNo`	Integer	-	인증서 번호
`certificateName`	String	-	인증서 이름
`memberNo`	String	-	네이버 클라우드 플랫폼 사용자 회원 번호
`commonName`	String	-	인증서 CN(Common Name)에 포함될 도메인
`dnsName`	String	-	인증서 SAN(Subject Alternative Name)에 포함될 도메인 목록
`statusCode`	String	-	인증서 상태 코드 `0` \| `1` \| `2` \| `3` \| `-1` \| `-2` \| `-3` \| `-4` \| `-5` \| `-6` \| `-7` \| `-11` \| `-12` \| `-20` `0`: ONGOING `1`: NORMAL `2`: NORMAL_UNREGISTERED_PRIVATE_KEY `3`: NORMAL_GLOBAL_EDGE_DEDICATED `-1`: FAILED `-2`: EXPIRE `-3`: VALIDATION_FAILED `-4`: VALIDATION_EXPIRE `-5`: REVOKE `-6`: DELETED `-7`: REQUEST_REVOKE `-11`: FAILED (LINT) `-12`: FAILED (CT) `-20`: FAILED (ORG_LOCK / DNS_TXT)
`statusName`	String	-	인증서 상태 `ONGOING` \| `NORMAL` \| `NORMAL_UNREGISTERED_PRIVATE_KEY` \| `NORMAL_GLOBAL_EDGE_DEDICATED` \| `FAILED` \| `EXPIRE` \| `VALIDATION_FAILED` \| `VALIDATION_EXPIRE` \| `REVOKE` \| `DELETED` \| `REQUEST_REVOKE` `ONGOING`: 진행 중 `NORMAL`: 정상 `NORMAL_UNREGISTERED_PRIVATE_KEY`: 정상 (개인 키 미등록) `NORMAL_GLOBAL_EDGE_DEDICATED`: 정상 (Global Edge Dedicated) `FAILED`: 실패 `FAILED (LINT)`: 실패 (LINT 체크) `FAILED (CT)`: 실패 (CT 체크) `FAILED (ORG_LOCK / DNS_TXT)`: 조직 정보 불일치 (DNS TXT) `EXPIRE`: 기간 만료 `VALIDATION_FAILED`: 검증 실패 `VALIDATION_EXPIRE`: 검증 시간 초과 `REVOKE`: 폐기 `DELETED`: 삭제 `REQUEST_REVOKE`: 폐기 중
`certificateType`	String	-	인증서 타입 `NCP_FREE_DV_01` \| `NCP_GLOBAL_EDGE_DEDICATED` `NCP_FREE_DV_01`: Cloud DB Basic 인증서 `NCP_GLOBAL_EDGE_DEDICATED`: Global Edge 인증서
`domainCode`	String	-	발급 기반 도메인 `PUB`: 네이버 클라우드 플랫폼(개인/일반 기업용)
`updateDate`	String	-	최근 변경 일시 yyyy-MM-dd HH:mm:ss(UTC+09:00) 형식
`issueType`	String	-	발급 상태: 해당 인증서를 이용하여 재발급 가능 여부를 확인하기 위해 사용 `ORIGINAL` \| `REPRESENTATIVE` \| `REISSUE` `ORIGINAL`: 원본 인증서 (대표 인증서가 없을 경우에 재발급 가능) `REPRESENTATIVE`: 대표 인증서 (재발급 가능) `REISSUE`: 재발급 인증서 (재발급 불가)
`subjectDN`	String	-	인증서 DN(Distinguished Name) 정보
`registDate`	String	-	인증서 등록 일시 yyyy-MM-dd HH:mm:ss(UTC+09:00) 형식

응답 상태 코드

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

응답 예시

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

{
  "returnCode": "0",
  "returnMessage": "Success",
  "totalCount": 42,
  "sslCertificateList": [
        {
            "certificateNo": 12345,
            "certificateName": "sample-certificate",
            "memberNo": "9999999",
            "commonName": "*.example.com",
            "dnsName": "example.com,example-docs.com",
            "statusCode": "1",
            "statusName": "Normal",
            "certificateType": "SAMPLE_DV_01",
            "domainCode": "PUB",
            "updateDate": "2026-01-01 10:00:00(UTC+09:00)",
            "issueType": "ORIGINAL",
            "subjectDN": "CN=*.example.com",
            "registDate": "2026-01-01 10:00:00(UTC+09:00)"
        },
  ]
  ...
}