getCertificateList
- 인쇄
- PDF
getCertificateList
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
SSL 인증서를 조회합니다.
요청
Method | Request URI |
---|---|
GET | https://certificatemanager.apigw.gov-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.gov-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. | 인증서 조회 결과가 없음 |
이 문서가 도움이 되었습니까?