本文へジャンプします。

ニフティクラウド APIリファレンス

CreateSslCertificate

処理概要

SSL証明書の新規作成または更新を行います。

申請法人情報が未登録の場合は、エラーが返されます。

パラメーター「fqdnId」を指定した場合、指定したSSL証明書を更新します。指定したSSL証明書の有効期間が更新可能ではない、アップロードした証明書を指定した、存在しないSSL証明書を指定した場合など、無効なSSL証明書を指定した場合は、エラーが返されます。

パラメーター「fqdnId」を指定しない場合、SSL証明書を新規作成します。作成可能なSSL証明書の上限数を超える場合は、エラーが返されます。

また申請法人情報を登録するには、API「RegisterCorporateInfoForCertificate」を実行します。

指定するパラメーター

パラメーター 説明 必須 サンプル値
FqdnId SSL証明書の識別子
Type : String

(SSL証明書の更新の場合)
 
Fqdn FQDN
Type : String

(SSL証明書の新規作成の場合)
aaa.aaa. aaa
※certAuthorityで「4」を選択した場合
*.bbb.cccc
CertAuthority 認証局
Type : Integer
値 : 1(cybertrust) | 2(GeoTrust) | 4(GeoTrustWildCard)

(SSL証明書の新規作成の場合)
1
Count SSL証明書の数量
Type : Integer
値 : cybertrust:0(数量無制限) | 1(数量1)
GeoTrust:0(数量無制限)
GeoTrustWildCard:0(数量無制限)
Default : 変更なし (SSL証明書の更新の場合)

(SSL証明書の新規作成の場合)
0
ValidityTerm SSL証明書の有効月数
Type : Integer
値 : cybertrust: 6(半年)| 12(1年)| 24(2年)
GeoTrust: 12(1年)
GeoTrustWildCard: 12(1年)
Default : 変更なし(SSL証明書の更新の場合)

(SSL証明書の新規作成の場合)
12
KeyLength SSL証明書の鍵長
Type : Integer
値 : 2048 (2048bit)
Default : 変更なし (SSL証明書の更新の場合)

(SSL証明書の新規作成の場合)
2048
ApproverEmailAddress 承認者メールアドレス
Type : String

(GeoTrust 証明書の場合)
 
CertInfo.
OrganizationName
申請組織(企業)名
Type : String
Default : 変更なし (SSL証明書の更新の場合)

(SSL証明書の新規作成の場合)
NIFTY
CertInfo.
OrganizationUnitName
申請部署名
Type : String
Default : 変更なし (SSL証明書の更新の場合)

(SSL証明書の新規作成の場合)
Center Department
CertInfo.
CountryName
※指定不可
Type : String
   
CertInfo.
StateName
事業所住所の都道府県名
Type : String
Default : 変更なし (SSL証明書の更新の場合)

(SSL証明書の新規作成の場合)
Tokyo
CertInfo.
LocationName
事業所住所の市区町村名
Type : String
Default : 変更なし (SSL証明書の更新の場合)

(SSL証明書の新規作成の場合)
Shinjuku-ku
CertInfo.
EmailAddress
※指定不可
Type : String
   

応答フィールド

フィールド(項目) 説明 サンプル値
CreateSslCertificate
Response
CreateSslCertificate レスポンス
Type : CreateSslCertificateResponseType
Ancestor : なし
Children : requestId, fqdnId, fqdn, certAuthority, validityTerm, certState, approverEmailAddress
 
requestId リクエスト識別子
Type : xsd:string
Ancestor : CreateSslCertificateResponse
Children : なし
f6dd8353-eb6b-6b4fd32e4f05
fqdnId SSL証明書の識別子
Type : xsd: string
Ancestor : CreateSslCertificateResponse
Children : なし
111
fqdn FQDN
Type : xsd: string
Ancestor : CreateSslCertificateResponse
Children : なし
aaa.aaa.aaa
certAuthority 認証局
Type : xsd:string
値 : cybertrust | GeoTrust | GeoTrustWildCard
Ancestor : CreateSslCertificateResponse
Children : なし
cybertrust
validityTerm SSL証明書の有効月数
Type : xsd:integer
Ancestor : CreateSslCertificateResponse
Children : なし
12
certState 発行ステータス
Type : xsd: string
値 : waiting (発行待ち)
Ancestor : CreateSslCertificateResponse
Children : なし
waiting
approverEmailAddress 承認者メールアドレス
Type : xsd:integer
Ancestor : CreateSslCertificateResponse
Children : なし
 

リクエストサンプル

https://cp.cloud.nifty.com/api/?Action=CreateSslCertificate&Fqdn=aaa.aaa.aaa
&certAuthority=1&Count=0
&ValidityTerm=12&KeyLength=2048&CertInfo.OrganizationName=NIFTY
&CertInfo.OrganizationUnitName=Center%20Department&CertInfo.StateName=Tokyo
&CertInfo.LocationName=Shinjuku-ku&CommonParams

応答サンプル

<CreateSslCertificateResponse xmlns="https://cp.cloud.nifty.com/api/">
 <requestId>f6dd8353-eb6b-6b4fd32e4f05</requestId>
 <fqdnId>111</fqdnId>
 <fqdn>aaa.aaa.aaa</fqdn>
 <certAuthority>cybertrust</certAuthority>
 <validityTerm>12</validityTerm>
 <certState>waiting</certState>
</CreateSslCertificateResponse>

ニフティクラウド サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフティクラウド公式フェイスブックページ

推奨画面サイズ 1024×768 以上