すべてのプロダクト
Search
ドキュメントセンター

Certificate Management Service:CreateServerCertificateWithCsr

最終更新日:Dec 24, 2025

カスタムの証明書署名要求 (CSR) に基づいてサーバー証明書を発行します。

操作説明

この操作を呼び出す前に、CreateRootCACertificate を呼び出してルート CA 証明書を作成し、CreateSubCACertificate を呼び出して中間 CA 証明書を作成する必要があります。サーバー証明書は、中間 CA 証明書によってのみ発行できます。

制限事項

この操作は、ユーザーあたり 1 秒あたり 10 リクエストのクエリ数 (QPS) 制限があります。この制限を超えると、レート制限がトリガーされ、ビジネスに影響を与える可能性があります。この操作は、必要な場合にのみ呼び出してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

yundun-cert:CreateServerCertificateWithCsr

create

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

Csr

string

必須

OpenSSL または Keytool を使用して CSR を生成できます。詳細については、「CSR ファイルの作成方法」をご参照ください。

-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----

Domain

string

任意

サーバー証明書の追加のドメイン名または IP アドレス。この情報を追加すると、証明書を複数のドメインまたは IP アドレスに適用できます。

複数のドメイン名と IP アドレスを入力できます。コンマ (,) で区切ります。

example.com

Organization

string

任意

組織名。デフォルト:Alibaba Inc.

阿里云

OrganizationUnit

string

任意

部署名。デフォルト:Aliyun CDN.

IT

Country

string

任意

国コード。例:CN

CN

CommonName

string

任意

証明書のコモンネームを設定します。中国語、英語、その他の文字をサポートします。

説明

Csr パラメーターを設定した場合、CommonName の値は Csr パラメーターの対応するフィールドから取得されます。

mtcsq.com

State

string

任意

組織が所在する州または省の名前を設定します。中国語、英語、その他の文字をサポートします。デフォルトでは、発行元の中間 CA 証明書の組織の州または省に設定されます。

Zhejiang

Locality

string

任意

証明書の組織が所在する市区町村。名前に中国語と英語の両方の文字を含めることができます。デフォルトでは、このパラメーターは発行元の中間認証局 (CA) の組織の市区町村に設定されます。

Hangzhou

Algorithm

string

任意

サーバー証明書のキーアルゴリズム。フォーマットは <暗号化アルゴリズム>_<キー長> を使用します。有効な値:

  • RSA_1024:署名アルゴリズムは Sha256WithRSA です。

  • RSA_2048:署名アルゴリズムは Sha256WithRSA です。

  • RSA_4096:署名アルゴリズムは Sha256WithRSA です。

  • ECC_256:署名アルゴリズムは Sha256WithECDSA です。

  • ECC_384:署名アルゴリズムは Sha256WithECDSA です。

  • ECC_512:署名アルゴリズムは Sha256WithECDSA です。

  • SM2_256:署名アルゴリズムは SM3WithSM2 です。

サーバー証明書の暗号化アルゴリズムは、中間 CA 証明書の暗号化アルゴリズムと一致する必要があります。キー長は異なっていてもかまいません。たとえば、中間 CA 証明書が RSA_2048 を使用する場合、サーバー証明書は RSA_1024、RSA_2048、または RSA_4096 を使用する必要があります。

説明

DescribeCACertificate を呼び出して、中間 CA 証明書のキーアルゴリズムを確認してください。

RSA_2048

ParentIdentifier

string

必須

この証明書を発行する中間 CA 証明書の一意の識別子。

説明

DescribeCACertificateList を呼び出して、中間 CA 証明書の一意の識別子を照会してください。

270oe6bb538d538c70c01f81hfd3****

Years

integer

任意

証明書の有効期間。単位:年。

1

Months

integer

任意

証明書の有効期間。単位:月。

12

Days

integer

任意

DaysBeforeTimeAfterTime パラメーターをすべて空にすることはできません。BeforeTimeAfterTime パラメーターは、両方とも空にするか、両方とも設定する必要があります。次のルールに従ってください:

  • Days を設定する場合、BeforeTimeAfterTime を任意で設定できます。

  • Days を設定しない場合、BeforeTimeAfterTime の両方を設定する必要があります。

説明
  • DaysBeforeTimeAfterTime を一緒に設定した場合、有効期間は Days の値を使用します。

  • サーバー証明書の有効期間は、中間 CA 証明書の有効期間を超えることはできません。DescribeCACertificate を呼び出して、中間 CA 証明書の有効期間を確認してください。

365

BeforeTime

integer

任意

サーバー証明書の発行時間 (UNIX タイムスタンプ形式)。デフォルト:この API を呼び出したときの現在時刻。単位:秒。

説明

BeforeTimeAfterTime パラメーターは、両方とも空にするか、両方とも設定する必要があります。

1634283958

AfterTime

integer

任意

サーバー証明書の有効期限 (UNIX タイムスタンプ形式)。単位:秒。

説明

BeforeTimeAfterTime パラメーターは、両方とも空にするか、両方とも設定する必要があります。

1665819958

Immediately

integer

任意

デジタル証明書をすぐに返すかどうか。

  • 0:返しません。デフォルト値。

  • 1:証明書を返します。

  • 2:証明書とその証明書チェーンを返します。

1

EnableCrl

integer

任意

CRL アドレスを含めるかどうか。

0:いいえ

1:はい

1

Tags

array<object>

任意

タグのリスト。

object

任意

タグのリスト。

Key

string

任意

タグキー。

account

Value

string

任意

タグ値。

test

ResourceGroupId

string

任意

リソースグループ ID。

rg-aek****wia

CustomIdentifier

string

任意

カスタム識別子。一意のキー。

***e6bb538d538c70c01f81hfd3****

この操作を呼び出す際は、このトピックで説明されているパラメーターに加えて、Alibaba Cloud API の共通リクエストパラメーターを含める必要があります。

リクエストのフォーマットについては、「例」セクションをご参照ください。

レスポンスフィールド

フィールド

説明

object

CreateCertificateResponse

X509Certificate

string

サーバー証明書の内容。

-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----

CertificateChain

string

CA 証明書チェーン。

-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n

Identifier

string

サーバー証明書の一意の識別子。

180ae6bb538d538c70c01f81dcf2****

SerialNumber

string

証明書のシリアル番号。

084bde9cd233f0ddae33adc438cfbbbd****

RequestId

string

この呼び出しに対して Alibaba Cloud によって生成されたリクエスト ID。問題のトラブルシューティングに使用します。

55C66C7B-671A-4297-9187-2C4477247A74

成功レスポンス

JSONJSON

{
  "X509Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n",
  "Identifier": "180ae6bb538d538c70c01f81dcf2****",
  "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
  "RequestId": "55C66C7B-671A-4297-9187-2C4477247A74"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。