証明書リストの照会

Classic/VPC環境で利用できます。

プロビジョニングされた証明書リストを照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
GET	/api/v1/certificate/provisioning

リクエストヘッダ

Global Edge APIで共通して使用されるヘッダの詳細は、Global Edgeのリクエストヘッダをご参照ください。

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`pageNo`	Integer	Optional	ページ番号 0~N (デフォルト: 1)
`offset`	Integer	Optional	ページごとの項目数 1~N (デフォルト: 15)

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET 'https://edge.apigw.ntruss.com/api/v1/certificate/provisioning' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`slotId`	Long	-	証明書スロット ID
`commonName`	String	-	ドメイン名
`serviceRegion`	String	-	証明書の適用範囲 `KR_JP` \| `KR_JP_GLOBAL` `KR_JP`: 韓国、日本 `KR_JP_GLOBAL`: 韓国、日本、グローバル
`tlsVersion`	String	-	TLSプロトコルサポートバージョン
`cipherProfile`	String	-	有効なパスワードプロファイル
`certificateName`	String	-	証明書名
`expirationDate`	String	-	証明書の有効期限 ISO 8601形式(UTCを使用)
`provisionStatus`	String	-	プロビジョニングの状態 `READY` \| `PUBLISHING` \| `RUNNING` \| `DELETING` \| `DELETED` `READY`: 待機 `PUBLISHING`: 進行中(デプロイ中) `RUNNING`: 完了(運用中) `DELETING`: 削除中 `DELETED`: 削除完了
`provisionDate`	String	-	プロビジョニング日時 ISO 8601形式(UTCを使用)

レスポンスステータスコード

Global Edge APIで共通して使用されるレスポンスステータスコードの詳細は、Global Edgeのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
  "code": "0000",
  "message": "Success",
  "result": {
    "content": [
      {
        "slotId": 69,
        "commonName": "cert***********.kr",
        "serviceRegion": "KR_JP",
        "tlsVersion": "1.0,1.1,1.2,1.3",
        "cipherProfile": "GE-DEFAULT-v1",
        "certificateName": "cert*****2",
        "expirationDate": "2025-11-05T23:59:59Z",
        "provisionStatus": "RUNNING",
        "provisionDate": "2025-08-07T01:22:34.076Z"
      },
      {
        "slotId": 68,
        "commonName": "h************.kr",
        "serviceRegion": "KR_JP",
        "tlsVersion": "1.2,1.3",
        "cipherProfile": "GE-DEFAULT-v1",
        "certificateName": "cert*******l",
        "expirationDate": "2025-11-05T23:59:59Z",
        "provisionStatus": "RUNNING",
        "provisionDate": "2025-08-07T00:34:58.99Z"
      }
    ],
    "pageable": {
      "pageNo": 1,
      "offset": 15,
      "totalCount": 2
    }
  }
}