getCertificateList

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

개요

SSL 인증서를 조회합니다.

요청

Method	Request URI
GET	`https://certificatemanager.apigw.fin-ntruss.com/api/v1/certificates`

요청 헤더

헤더명	설명
x-ncp-apigw-timestamp	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-iam-access-key	네이버 클라우드 플랫폼에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey
x-ncp-apigw-signature-v2	Body를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명 HMAC 암호화 알고리즘은 HmacSHA256 사용
accept	`application/json`으로 지정

요청 파라미터

파라미터명	필수 여부	타입	설명
certificateName	No	String	인증서 이름으로 필터링하여 조회 `Default : 모든 인증서 조회`
certificateNo	No	Integer	인증서 번호로 필터링하여 조회 `Default : 모든 인증서 조회`
instanceNo	No	Integer	인스턴스 번호로 필터링하여 조회 `Default : 모든 인증서 조회`

응답

응답 바디

필드명	타입	설명
returnCode	String	요청에 대한 처리 결과 코드
returnMessage	String	요청에 대한 처리 결과 메시지
totalRows	Integer	sslCertificateList의 object 개수
sslCertificateList[]	String	요청한 인증서 조회 결과 리스트에 object가 있을 경우: `해당 인증서 있음` 리스트에 object가 없을 경우: `해당 인증서 없음`

예시

요청 예시

curl -X GET "https://certificatemanager.apigw.ntruss.com/api/v1/certificates" 
-H "accept: application/json" 
-H "x-ncp-iam-access-key: 72A565A16F1827A27DD5" 
-H "x-ncp-apigw-timestamp: 1594646226859" 
-H "x-ncp-apigw-signature-v2: y0hqZ1RyFtJjTq7ZLcu6ds1d8HyzoTgT1XoPjkyoYA8=" 
-H "cache-control: no-cache" 
-H "pragma: no-cache"

응답 예시

응답 헤더

connection: keep-alive 
content-type: application/json;charset=UTF-8 
date: Mon, 13 Jul 2020 13:17:08 GMT 
referrer-policy: unsafe-url 
server: nginx 
transfer-encoding: chunked 
x-ncp-apigw-response-origin: ENDPOINT 
x-ncp-trace-id: 32e1m6kp3acr43gohj6li30e36

응답 바디

{
  "returnCode": "0",
  "returnMessage": "Success",
  "totalRows": 3,
  "sslCertificateList": [
    {
      "certificateNo": 3,
      "certificateName": "myCertificate-03",
      "memberNo": "1",
      "dnInfo": "CN=www.example.com, O=NAVER Cloud Corp., L=Bundang-gu, S=Seongnam-si, C=KR",
      "domainAddress": "www.example.com",
      "subDomainAddress": "",
      "regDate": "2020-07-13 13:52:36",
      "issueDate": null,
      "validStartDate": "2019-10-21 09:00:00",
      "validEndDate": "2021-10-20 21:00:00",
      "disuseDate": null,
      "disuseMsg": null,
      "requestId": null,
      "statusCode": "1",
      "statusName": "Normal",
      "externalYn": "N",
      "domainCode": "PUB",
      "caInfo": "NAVER Secure Certification Authority 1",
      "certSerialNumber": "e9af6050aea0e2af700519217c00f95",
      "certPublicKeyInfo": "Sun RSA public key, 2048 bits",
      "certSignAlgorithmName": "SHA256withRSA",
      "usedInstanceNoList": null
    },
    {
      "certificateNo": 2,
      "certificateName": "myCertificate-02",
      "memberNo": "1",
      "dnInfo": "CN=mail.example.com",
      "domainAddress": "mail.example.com",
      "subDomainAddress": "mail2.example.com",
      "regDate": "2020-07-13 13:36:57",
      "issueDate": null,
      "validStartDate": "2019-10-21 09:00:00",
      "validEndDate": "2021-10-20 21:00:00",
      "disuseDate": null,
      "disuseMsg": null,
      "requestId": null,
      "statusCode": "1",
      "statusName": "Normal",
      "externalYn": "Y",
      "domainCode": "PUB",
      "caInfo": "ABC RSA CA 2018",
      "certSerialNumber": "d9af6050bea0e2af700518217c00695",
      "certPublicKeyInfo": "Sun RSA public key, 2048 bits",
      "certSignAlgorithmName": "SHA256withRSA",
      "usedInstanceNoList": null
    },
    {
      "certificateNo": 1,
      "certificateName": "myCertificate-01",
      "memberNo": "1",
      "dnInfo": "CN=exmaple.net",
      "domainAddress": "exmaple.net",
      "subDomainAddress": "www.exmaple.net",
      "regDate": "2020-05-30 14:40:48",
      "issueDate": null,
      "validStartDate": "2019-07-10 09:00:00",
      "validEndDate": "2021-07-10 08:59:59",
      "disuseDate": null,
      "disuseMsg": null,
      "requestId": null,
      "statusCode": "1",
      "statusName": "Normal",
      "externalYn": "Y",
      "domainCode": "PUB",
      "caInfo": "XYZ RSA Domain Validation Secure Server CA",
      "certSerialNumber": "bfc9f64ca4532d9897d542c72988d61f",
      "certPublicKeyInfo": "Sun RSA public key, 2048 bits",
      "certSignAlgorithmName": "SHA256withRSA",
      "usedInstanceNoList": null
    }
  ]
}

오류 코드

아래 오류 코드는 이 액션(Action)에서 특징적으로 발생하는 오류입니다. 공통적으로 발생하는 오류에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해주세요

HTTP 응답 코드	errorCode	message	설명
200	2200	No certificate was found.	인증서 검색 결과가 없음

이 문서가 도움이 되었습니까?

What's Next

Certificate Manager 개요

개요
요청
응답
예시
오류 코드

태그