GlobalEdgeCertificateRequest

Prev Next

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

Global Edge証明書を申し込みます。

リクエスト

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

メソッド URI
POST /certificate/requestGedCertificateIssuance

リクエストヘッダ

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

リクエストボディ

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

フィールド タイプ 必須の有無 説明
certificateName String Required 証明書名
commonName String Required 証明書の CN(Common Name)に含まれるドメイン
dnsName Array Optional 証明書 SAN(Subject Alternative Name)に含まれるドメインリスト

リクエスト例

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

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": "ncloudcertificatege",
    "commonName": "ncloud.com",
    "dnsName": ["naver.com","ncloud-docs.com"]
}'

レスポンス

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

レスポンスボディ

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

フィールド タイプ 必須の有無 説明
returnCode String - レスポンスコード
returnMessage String - レスポンスメッセージ
totalRows Integer - 照会されたリストの総数
certificate Object - 証明書申し込みの結果
certificate.certificateNo Integer - 証明書番号
certificate.certificateName Integer - 証明書名
certificate.statusCode Integer - 証明書検証の状態コード
certificate.statusName String - 証明書の検証状態
certificate.commonName String - 証明書の CN(Common Name)に含まれるドメイン
certificate.dnsName Array - 証明書 SAN(Subject Alternative Name)に含まれるドメインリスト

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

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

レスポンス例

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

{
    "returnCode": "0",
    "returnMessage": "Success",
    "totalRows": 1,
    "certificate": {
        "certificateNo": 55988,
        "certificateName": "ncloudcertificatege",
        "statusCode": "0",
        "statusName": "Ongoing",
        "commonName": "ncloud.com",
        "dnsName": "naver.com,ncloud-docs.com"
    }
}