CloudBasicCertificateRequest

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

Cloud Basic証明書を申し込みます。

リクエスト

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

メソッド	URI
POST	/certificate/requestCertificateIssuance

リクエストヘッダ

Certificate Manager APIで共通して使用されるヘッダの詳細は、Certificate Managerの共通ヘッダをご参照ください。

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`certificateName`	String	Required	証明書名
`commonName`	String	Required	証明書の CN(Common Name)に含まれるドメイン
`dnsName`	Array	Optional	証明書 SAN(Subject Alternative Name)に含まれるドメインリスト
`validationMethod`	String	Required	証明書ドメイン所有権(DCV)の検証方法 `D`: DNS CNAMEレコードを利用した検証方式

リクエスト例

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

curl --location --request POST 'https://certificatemanager.apigw.ntruss.com/api/v2/certificate/requestCertificateIssuance' \
--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' \
--data '{
    "certificateName": "ncloudcertificate",
    "commonName": "*.ncloud.com",
    "dnsName": ["ncloud.com","ncloud-docs.com"],
    "validationMethod": "D"
}'

レスポンス

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

レスポンスボディ

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

フィールド	タイプ	必須の有無	説明
`returnCode`	String	-	レスポンスコード
`returnMessage`	String	-	レスポンスメッセージ
`totalRows`	Integer	-	照会されたリストの総数
`certificateName`	String	-	証明書名
`commonName`	String	-	証明書の CN(Common Name)に含まれるドメイン
`dnsName`	String	-	証明書 SAN(Subject Alternative Name)に含まれるドメインリスト
`validationMethod`	String	-	ドメイン所有権(DCV)の検証方法
`requestSn`	String	-	リクエストの固有 ID

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

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

レスポンス例

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

{
    "returnCode": "0",
    "returnMessage": "Success",
    "totalRows": 0,
    "certificateName": "ncloudcertificate",
    "commonName": "*.ncloud.com",
    "dnsName": "ncloud.com,ncloud-docs.com",
    "validationMethod": "D",
    "requestSn": "0f552ca604044887be19a3d4f7d74c6d"
}